Mercurial > genshi > genshi-test
comparison examples/trac/wiki-default/InterWiki @ 39:71ecbe90aafc
Copy Trac to main branch.
| author | cmlenz |
|---|---|
| date | Mon, 03 Jul 2006 18:53:27 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 38:fec9f4897415 | 39:71ecbe90aafc |
|---|---|
| 1 = Support for InterWiki links = | |
| 2 | |
| 3 ''(since [milestone:0.10])'' | |
| 4 | |
| 5 == Definition == | |
| 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. | |
| 11 | |
| 12 == Link Syntax == | |
| 13 | |
| 14 {{{ | |
| 15 <target_wiki>(:<identifier>)+ | |
| 16 }}} | |
| 17 | |
| 18 The link is composed by the targeted Wiki (or system) name, | |
| 19 followed by a column (e.g. {{{MeatBall:}}}), | |
| 20 followed by a page specification in the target. | |
| 21 Note that, as for InterTrac prefixes, InterWiki prefixes are case insensitive. | |
| 22 | |
| 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]. | |
| 26 | |
| 27 In addition to traditional InterWiki links, where the target | |
| 28 is simply ''appended'' to the URL, | |
| 29 Trac supports parametric InterWiki URLs: | |
| 30 identifiers `$1`, `$2`, ... in the URL | |
| 31 will be replaced by corresponding arguments. | |
| 32 The argument list is formed by splitting the page identifier | |
| 33 using the ":" separator. | |
| 34 | |
| 35 == Examples == | |
| 36 | |
| 37 If the following is an excerpt of the InterMapTxt page: | |
| 38 | |
| 39 {{{ | |
| 40 = InterMapTxt = | |
| 41 == This is the place for defining InterWiki prefixes == | |
| 42 | |
| 43 Currently active prefixes: [[InterWiki]] | |
| 44 | |
| 45 This page is modelled after the MeatBall:InterMapTxt page. | |
| 46 In addition, an optional comment is allowed after the mapping. | |
| 47 ---- | |
| 48 {{{ | |
| 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 | |
| 51 | |
| 52 ... | |
| 53 MeatBall http://www.usemod.com/cgi-bin/mb.pl? | |
| 54 MetaWiki http://sunir.org/apps/meta.pl? | |
| 55 MetaWikiPedia http://meta.wikipedia.org/wiki/ | |
| 56 MoinMoin http://moinmoin.wikiwikiweb.de/ | |
| 57 ... | |
| 58 }}} | |
| 59 }}} | |
| 60 | |
| 61 Then, | |
| 62 * `MoinMoin:InterWikiMap` should be rendered as | |
| 63 [http://moinmoin.wikiwikiweb.de/InterWikiMap MoinMoin:InterWikiMap] | |
| 64 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] | |
| 67 and the ''title'' for that link would be "Message 4346 in Trac Mailing List" |