Changes between Initial Version and Version 1 of InterWiki


Ignore:
Timestamp:
2008-08-18 20:36:20 (16 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InterWiki

    v1 v1  
     1= Support for InterWiki links =
     2
     3''(since [milestone:0.10])''
     4
     5== Definition ==
     6
     7An InterWiki link can be used for referring to a Wiki page
     8located in another Wiki system, and by extension, to any object
     9located in any other Web application, provided a simple URL
     10mapping can be done.
     11
     12At the extreme, InterWiki prefixes can even be used to simply introduce
     13links to new protocols, such as `tsvn:` used by TortoiseSvn.
     14
     15== Link Syntax ==
     16
     17{{{
     18<target_wiki>(:<identifier>)+
     19}}}
     20
     21The link is composed by the targeted Wiki (or system) name,
     22followed by a colon (e.g. `MeatBall:`),
     23followed by a page specification in the target.
     24Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''.
     25
     26The target Wiki URL is looked up in the InterMapTxt wiki page,
     27modelled after MeatBall:InterMapTxt.
     28
     29In addition to traditional InterWiki links, where the target
     30is simply ''appended'' to the URL,
     31Trac supports parametric InterWiki URLs:
     32identifiers `$1`, `$2`, ... in the URL
     33will be replaced by corresponding arguments.
     34The argument list is formed by splitting the page identifier
     35using the ":" separator.
     36
     37== Examples ==
     38
     39If the following is an excerpt of the InterMapTxt page:
     40
     41{{{
     42= InterMapTxt =
     43== This is the place for defining InterWiki prefixes ==
     44
     45Currently active prefixes: [[InterWiki]]
     46
     47This page is modelled after the MeatBall:InterMapTxt page.
     48In addition, an optional comment is allowed after the mapping.
     49----
     50{{{
     51PEP      http://www.python.org/peps/pep-$1.html           # Python Enhancement Proposal $1
     52Trac-ML  http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/$1  # Message $1 in Trac Mailing List
     53
     54tsvn     tsvn:                                            # Interact with TortoiseSvn
     55...
     56MeatBall http://www.usemod.com/cgi-bin/mb.pl?
     57MetaWiki http://sunir.org/apps/meta.pl?
     58MetaWikiPedia http://meta.wikipedia.org/wiki/
     59MoinMoin http://moinmoin.wikiwikiweb.de/
     60...
     61}}}
     62}}}
     63
     64Then,
     65 * `MoinMoin:InterWikiMap` should be rendered as MoinMoin:InterWikiMap
     66   and the ''title'' for that link would be "!InterWikiMap in !MoinMoin"
     67 * `Trac-ML:4346` should be rendered as Trac-ML:4346
     68   and the ''title'' for that link would be "Message 4346 in Trac Mailing List"
     69
     70----
     71See also: InterTrac, InterMapTxt