Apply conversion script to all *.md files. authored by Alexander Hansen Færøy's avatar Alexander Hansen Færøy
...@@ -8,16 +8,16 @@ InterWiki prefixes can even be used to simply introduce links to new protocols, ...@@ -8,16 +8,16 @@ InterWiki prefixes can even be used to simply introduce links to new protocols,
== Link Syntax == Link Syntax
{{{ ```
<target_wiki>(:<identifier>)+ <target_wiki>(:<identifier>)+
}}} ```
The link is composed by the targeted Wiki (or system) name, followed by a colon, eg `MeatBall:`, followed by a page specification in the target. The link is composed by the targeted Wiki (or system) name, followed by a colon, eg `MeatBall:`, followed by a page specification in the target.
Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''. Note that, as for InterTrac prefixes, **InterWiki prefixes are case insensitive**.
The target Wiki URL is looked up in the `[interwiki]` section of TracIni or in the InterMapTxt wiki page, modeled after MeatBall:InterMapTxt. If a prefix is defined in both the `[interwiki]` section and InterMapTxt, the `[interwiki]` section takes precedence. The target Wiki URL is looked up in the `[interwiki]` section of TracIni or in the InterMapTxt wiki page, modeled after MeatBall:InterMapTxt. If a prefix is defined in both the `[interwiki]` section and InterMapTxt, the `[interwiki]` section takes precedence.
In addition to traditional InterWiki links, where the target is simply ''appended'' to the URL, Trac supports parametric InterWiki URLs: In addition to traditional InterWiki links, where the target is simply _appended_ to the URL, Trac supports parametric InterWiki URLs:
identifiers `$1`, `$2`, ... in the URL will be replaced by corresponding arguments. identifiers `$1`, `$2`, ... in the URL will be replaced by corresponding arguments.
The argument list is formed by splitting the page identifier using the ":" separator. The argument list is formed by splitting the page identifier using the ":" separator.
...@@ -25,21 +25,21 @@ The argument list is formed by splitting the page identifier using the ":" separ ...@@ -25,21 +25,21 @@ The argument list is formed by splitting the page identifier using the ":" separ
Every option in the `[interwiki]` section in TracIni defines one InterWiki prefix. The option name defines the prefix. The option value defines the URL, optionally followed by a description separated from the URL by whitespace. Parametric URLs are supported as well. Every option in the `[interwiki]` section in TracIni defines one InterWiki prefix. The option name defines the prefix. The option value defines the URL, optionally followed by a description separated from the URL by whitespace. Parametric URLs are supported as well.
'''Example:''' **Example:**
{{{#!ini ```
[interwiki] [interwiki]
MeatBall = http://www.usemod.com/cgi-bin/mb.pl? MeatBall = http://www.usemod.com/cgi-bin/mb.pl?
PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1 PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1
tsvn = tsvn: Interact with TortoiseSvn tsvn = tsvn: Interact with TortoiseSvn
}}} ```
== Examples == Examples
If the following is an excerpt of the InterMapTxt page: If the following is an excerpt of the InterMapTxt page:
{{{ ```
= InterMapTxt = # InterMapTxt
== This is the place for defining InterWiki prefixes == ## This is the place for defining InterWiki prefixes
Currently active prefixes: [[InterWiki]] Currently active prefixes: [[InterWiki]]
...@@ -57,12 +57,12 @@ MetaWiki http://sunir.org/apps/meta.pl? ...@@ -57,12 +57,12 @@ MetaWiki http://sunir.org/apps/meta.pl?
MetaWikiPedia http://meta.wikipedia.org/wiki/ MetaWikiPedia http://meta.wikipedia.org/wiki/
MoinMoin http://moinmoin.wikiwikiweb.de/ MoinMoin http://moinmoin.wikiwikiweb.de/
... ...
}}} ```
}}} }}}
Then, Then,
* `MoinMoin:InterWikiMap` should be rendered as MoinMoin:InterWikiMap and the ''title'' for that link would be "!InterWikiMap in !MoinMoin". * `MoinMoin:InterWikiMap` should be rendered as MoinMoin:InterWikiMap and the _title_ for that link would be "InterWikiMap in MoinMoin".
* `Trac-ML:4346` should be rendered as Trac-ML:4346 and the ''title'' for that link would be "Message 4346 in Trac Mailing List". * `Trac-ML:4346` should be rendered as Trac-ML:4346 and the _title_ for that link would be "Message 4346 in Trac Mailing List".
---- ----
See also: InterTrac, InterMapTxt See also: InterTrac, InterMapTxt
\ No newline at end of file