Changes between Version 1 and Version 2 of InterWiki
- Timestamp:
- Mar 7, 2018, 4:17:33 PM (7 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
InterWiki
v1 v2 1 = Support for InterWiki links =1 = Support for InterWiki links 2 2 3 ''(since [trac:milestone:0.10 0.10])'' 3 == Definition 4 4 5 == Definition == 5 An InterWiki link can be used for referring to a Wiki page located in another Wiki system, and by extension, to any object located in any other Web application, provided a simple URL mapping can be done. 6 6 7 An InterWiki link can be used for referring to a Wiki page 8 located in another Wiki system, and by extension, to any object 9 located in any other Web application, provided a simple URL 10 mapping can be done. 7 InterWiki prefixes can even be used to simply introduce links to new protocols, such as `tsvn:` used by [trac:TortoiseSvn TortoiseSvn]. 11 8 12 At the extreme, InterWiki prefixes can even be used to simply introduce 13 links to new protocols, such as `tsvn:` used by [trac:TortoiseSvn TortoiseSvn]. 14 15 == Link Syntax == 9 == Link Syntax 16 10 17 11 {{{ … … 19 13 }}} 20 14 21 The link is composed by the targeted Wiki (or system) name, 22 followed by a colon (e.g. `MeatBall:`), 23 followed by a page specification in the target. 15 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. 24 16 Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''. 25 17 26 The target Wiki URL is looked up in the InterMapTxt wiki page, 27 modelled after MeatBall:InterMapTxt. 18 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. 28 19 29 In addition to traditional InterWiki links, where the target 30 is simply ''appended'' to the URL, 31 Trac supports parametric InterWiki URLs: 32 identifiers `$1`, `$2`, ... in the URL 33 will be replaced by corresponding arguments. 34 The argument list is formed by splitting the page identifier 35 using the ":" separator. 20 In addition to traditional InterWiki links, where the target is simply ''appended'' to the URL, Trac supports parametric InterWiki URLs: 21 identifiers `$1`, `$2`, ... in the URL will be replaced by corresponding arguments. 22 The argument list is formed by splitting the page identifier using the ":" separator. 36 23 37 == Examples == 24 === [interwiki] 25 26 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. 27 28 '''Example:''' 29 {{{#!ini 30 [interwiki] 31 MeatBall = http://www.usemod.com/cgi-bin/mb.pl? 32 PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1 33 tsvn = tsvn: Interact with TortoiseSvn 34 }}} 35 36 == Examples 38 37 39 38 If the following is an excerpt of the InterMapTxt page: … … 63 62 64 63 Then, 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" 64 * `MoinMoin:InterWikiMap` should be rendered as MoinMoin:InterWikiMap and the ''title'' for that link would be "!InterWikiMap in !MoinMoin". 65 * `Trac-ML:4346` should be rendered as Trac-ML:4346 and the ''title'' for that link would be "Message 4346 in Trac Mailing List". 69 66 70 67 ----