Changes between Version 4 and Version 5 of InterWiki


Ignore:
Timestamp:
Jun 6, 2013 4:39:51 AM (16 months 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