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

= Turn text matching a certain regex into a link

== Description

A disadvantage of using InterWiki to link to external pages is that the user has to put a prefix before the link, for example MeatBall:InterMapTxt.

In some cases, the actual text to be linked is distinctive enough to be turned into a link without many false positives. For example, TOPdesk service management software uses identifiers like '0811 123' for incidents. When text of this form occurs, it could be automatically rendered into a link to the relevant TOPdesk page.

This Trac plugin allows these kinds of links to be made with a minimum of configuration, based on a regex that matches the external identifiers.

For example, when adding the following to your `trac.ini` file:
{{{#!ini
[regexlink]
regex1 = \b(?P<topdeskyymm>\d\d(?:0[1-9]|1[0-2])) (?P<topdesknr>\d{3})\b
url1 = http://topdesk/query=\g<topdeskyymm>%20\g<topdesknr>
regex2 = \bexample(?P<exampleid>\d+)\b
url2 = http://example.org/\g<exampleid>
}}}

then `0811 123` becomes [http://topdesk/query=0811%0123 0811 123], and `example123` becomes [http://example.org/123 example123].

The topdesk url is fictitious, this is an example only.

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=RegexLinkPlugin new ticket].

[[TicketQuery(component=RegexLinkPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:regexlinkplugin here].

== Source

You can check out RegexLinkPlugin from [/svn/regexlinkplugin/trunk here] using Subversion, or [source:regexlinkplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(regexlinkplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:ComaVN] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''