| 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 |
At the extreme, InterWiki prefixes can even be used to simply introduce |
|---|
| 13 |
links to new protocols, such as `tsvn:` used by TortoiseSvn. |
|---|
| 14 |
|
|---|
| 15 |
== Link Syntax == |
|---|
| 16 |
|
|---|
| 17 |
{{{ |
|---|
| 18 |
<target_wiki>(:<identifier>)+ |
|---|
| 19 |
}}} |
|---|
| 20 |
|
|---|
| 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. |
|---|
| 24 |
Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''. |
|---|
| 25 |
|
|---|
| 26 |
The target Wiki URL is looked up in the InterMapTxt wiki page, |
|---|
| 27 |
modelled after MeatBall:InterMapTxt. |
|---|
| 28 |
|
|---|
| 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. |
|---|
| 36 |
|
|---|
| 37 |
== Examples == |
|---|
| 38 |
|
|---|
| 39 |
If the following is an excerpt of the InterMapTxt page: |
|---|
| 40 |
|
|---|
| 41 |
{{{ |
|---|
| 42 |
= InterMapTxt = |
|---|
| 43 |
== This is the place for defining InterWiki prefixes == |
|---|
| 44 |
|
|---|
| 45 |
Currently active prefixes: [[InterWiki]] |
|---|
| 46 |
|
|---|
| 47 |
This page is modelled after the MeatBall:InterMapTxt page. |
|---|
| 48 |
In addition, an optional comment is allowed after the mapping. |
|---|
| 49 |
---- |
|---|
| 50 |
{{{ |
|---|
| 51 |
PEP http://www.python.org/peps/pep-$1.html # Python Enhancement Proposal $1 |
|---|
| 52 |
Trac-ML http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/$1 # Message $1 in Trac Mailing List |
|---|
| 53 |
|
|---|
| 54 |
tsvn tsvn: # Interact with TortoiseSvn |
|---|
| 55 |
... |
|---|
| 56 |
MeatBall http://www.usemod.com/cgi-bin/mb.pl? |
|---|
| 57 |
MetaWiki http://sunir.org/apps/meta.pl? |
|---|
| 58 |
MetaWikiPedia http://meta.wikipedia.org/wiki/ |
|---|
| 59 |
MoinMoin http://moinmoin.wikiwikiweb.de/ |
|---|
| 60 |
... |
|---|
| 61 |
}}} |
|---|
| 62 |
}}} |
|---|
| 63 |
|
|---|
| 64 |
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" |
|---|
| 69 |
|
|---|
| 70 |
---- |
|---|
| 71 |
See also: InterTrac, InterMapTxt |
|---|
