Changes between Version 4 and Version 5 of InterWiki


Ignore:
Timestamp:
Jun 6, 2013, 4:39:51 AM (2 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InterWiki

    v4 v5  
    11= Support for InterWiki links =
    22
    3 ''(since [milestone:0.10])''
     3''(since [trac:milestone:0.10 0.10])''
    44
    55== Definition ==
     
    1010mapping can be done.
    1111
     12At the extreme, InterWiki prefixes can even be used to simply introduce
     13links to new protocols, such as `tsvn:` used by [trac:TortoiseSvn TortoiseSvn].
     14
    1215== Link Syntax ==
    1316
     
    1720
    1821The link is composed by the targeted Wiki (or system) name,
    19 followed by a column (e.g. {{{MeatBall:}}}),
     22followed by a colon (e.g. `MeatBall:`),
    2023followed by a page specification in the target.
    21 Note that, as for InterTrac prefixes, InterWiki prefixes are case insensitive.
     24Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''.
    2225
    23 The target Wiki URL is looked up in a the InterMapTxt wiki page,
    24 modelled after
    25 [http://www.usemod.com/cgi-bin/mb.pl?InterMapTxt MeatBall:InterMapTxt].
     26The 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.
    2627
    2728In addition to traditional InterWiki links, where the target
     
    3233The argument list is formed by splitting the page identifier
    3334using the ":" separator.
     35
     36=== [interwiki] ===
     37Every 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.
     38
     39'''Example:'''
     40{{{
     41[interwiki]
     42MeatBall = http://www.usemod.com/cgi-bin/mb.pl?
     43PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1
     44tsvn = tsvn: Interact with TortoiseSvn
     45}}}
    3446
    3547== Examples ==
     
    4759----
    4860{{{
    49 PEP     http://www.python.org/peps/pep-$1.html                                       # Python Enhancement Proposal $1
    50 TracML  http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/$1  # Message $1 in Trac Mailing List
     61PEP      http://www.python.org/peps/pep-$1.html           # Python Enhancement Proposal $1
     62Trac-ML  http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/$1  # Message $1 in Trac Mailing List
    5163
     64tsvn     tsvn:                                            # Interact with TortoiseSvn
    5265...
    5366MeatBall http://www.usemod.com/cgi-bin/mb.pl?
     
    6073
    6174Then,
    62  * `MoinMoin:InterWikiMap` should be rendered as
    63    [http://moinmoin.wikiwikiweb.de/InterWikiMap MoinMoin:InterWikiMap]
     75 * `MoinMoin:InterWikiMap` should be rendered as MoinMoin:InterWikiMap
    6476   and the ''title'' for that link would be "!InterWikiMap in !MoinMoin"
    65  * {{{TracML:4346}}} should be rendered as
    66    [http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/4346 TracML:4346]
     77 * `Trac-ML:4346` should be rendered as Trac-ML:4346
    6778   and the ''title'' for that link would be "Message 4346 in Trac Mailing List"
     79
     80----
     81See also: InterTrac, InterMapTxt