[[PageOutline(2-5,Contents,pullout)]]

= !WikiSyntax for revision links on Trac with multiple repositories =

== Description ==

When multiple repositories are configured, the 'r123' syntax doesn't enable you to specify the repository and the ![changeset:123:repo] or ![123/repo] syntax must be used instead. As I do find the 'r123' syntax more readable, I wrote this small plugin that lets you use 'r123repo' (simply add the repository name right after the changeset number), which is displayed as 'repo/!r123' with a link to the changeset. Parsing 'repo/!r123' syntax isn't possible (AFAIK) as the built-in parser parses the '!r123' part, so the syntax is 'r123repo' but it displays as 'repo/!r123'.

== Bugs/Feature Requests == 

I'm usually at #trac as shsek or shesek. My email is nadav at humaninternals /nospam/ com

Existing bugs and feature requests for RepoRevisionSyntaxPlugin are 
[report:9?COMPONENT=RepoRevisionSyntaxPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=RepoRevisionSyntaxPlugin&owner=shesek new ticket].

== Installation ==

Simply drop the source code as a .py file directly in your plugins directory

== Source ==
{{{
#!python
from trac.core import *
from trac.wiki import IWikiSyntaxProvider
from genshi.builder import tag

class RepoRevisionSyntax(Component):
    implements(IWikiSyntaxProvider)
    def get_wiki_syntax(self):
        yield ( r'[r#](?P<rev_id>\d+)(?P<repo>[a-zA-Z0-9_\/]+)', self._format_regex_link)
    def get_link_resolvers(self):
        pass
    def _format_regex_link(self, formatter, ns, match):
        return tag.a('%s/r%s' % (match.group('repo'), match.group('rev_id')),
            href=formatter.href.changeset('%s/%s'%(match.group('rev_id'), match.group('repo'))))
}}}

== Example ==

'Fixed by r78trac' (as a ticket comment, for example) would !get displayed as 'Fixed by trac/!r78', 'trac/!r78' being a link to the changeset.

== Recent Changes ==

[[ChangeLog(reporevisionsyntaxplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:shesek] / Nadav [[BR]]
'''Maintainer:''' [wiki:shesek] [[BR]]
'''Contributors:''' Jonathan