Changes between Version 1 and Version 2 of InterWiki


Ignore:
Timestamp:
Feb 7, 2016, 1:07:44 AM (22 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InterWiki

    v1 v2  
    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 colon (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
     61PEP      http://www.python.org/peps/pep-$1.html           # Python Enhancement Proposal $1
    5062Trac-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  * {{{Trac-ML:4346}}} should be rendered as
    66    [http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/4346 Trac-ML: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"
    6879
    6980----
    70 === Temporary notice (delete this when we sync) ===
    71 About full links vs. having the InterWiki link itself.
    72 
    73 Well, I'm not sure about that, since those InterWiki prefixes ''are'' (or will be when we sync) present in the default InterMapTxt, so those examples will work until the InterMapTxt gets locally edited, at which point it won't be a surprise that this links don't work anymore... OTOH, if those examples ''still'' work after the prefixes have been removed, this can also be a bit surprising ;)
    74 ----
     81See also: InterTrac, InterMapTxt