close
Warning:
BrowserModule failed with ConfigurationError: Look in the Trac log for more information.
- Timestamp:
-
Feb 24, 2024, 4:07:16 PM (22 months ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
|
v5
|
v6
|
|
| 1 | 1 | = Support for InterWiki links |
| | 2 | [[PageOutline(2-5,Contents,pullout)]] |
| 2 | 3 | |
| 3 | 4 | == Definition |
| … |
… |
|
| 5 | 6 | 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 | 7 | |
| 7 | | InterWiki prefixes can even be used to simply introduce links to new protocols, such as `tsvn:` used by [trac:TortoiseSvn TortoiseSvn]. |
| | 8 | InterWiki prefixes can even be used to introduce links to new protocols, such as `tsvn:` used by [trac:TortoiseSvn TortoiseSvn]. |
| 8 | 9 | |
| 9 | 10 | == Link Syntax |
| … |
… |
|
| 16 | 17 | Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''. |
| 17 | 18 | |
| 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. |
| | 19 | The target Wiki URL is looked up in the [TracIni#interwiki-section "[interwiki]"] section of TracIni and 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. |
| 19 | 20 | |
| 20 | | In addition to traditional InterWiki links, where the target is simply ''appended'' to the URL, Trac supports parametric InterWiki URLs: |
| | 21 | In addition to traditional !InterWiki links, where the target is simply ''appended'' to the URL, Trac supports parametric !InterWiki URLs: |
| 21 | 22 | identifiers `$1`, `$2`, ... in the URL will be replaced by corresponding arguments. |
| 22 | 23 | The argument list is formed by splitting the page identifier using the ":" separator. |
| 23 | 24 | |
| 24 | | === [interwiki] |
| | 25 | == [TracIni#interwiki-section "[interwiki]"] |
| 25 | 26 | |
| 26 | 27 | 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. |
| … |
… |
|
| 36 | 37 | == Examples |
| 37 | 38 | |
| 38 | | If the following is an excerpt of the InterMapTxt page: |
| | 39 | For the following excerpt of the InterMapTxt page: |
| 39 | 40 | |
| 40 | 41 | {{{ |
| … |
… |
|
| 48 | 49 | ---- |
| 49 | 50 | {{{ |
| 50 | | PEP http://www.python.org/peps/pep-$1.html # Python Enhancement Proposal $1 |
| | 51 | PEP http://www.python.org/peps/pep-$1.html # Python Enhancement Proposal $1 |
| 51 | 52 | Trac-ML http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/$1 # Message $1 in Trac Mailing List |
| 52 | 53 | |
| … |
… |
|
| 61 | 62 | }}} |
| 62 | 63 | |
| 63 | | Then, |
| 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". |
| | 64 | Then, |
| | 65 | * `MoinMoin:InterWikiMap` will be rendered as MoinMoin:InterWikiMap and the ''title'' for that link will be "!InterWikiMap in !MoinMoin". |
| | 66 | * `Trac-ML:4346` will be rendered as Trac-ML:4346 and the ''title'' for that link will be "Message 4346 in Trac Mailing List". |
| | 67 | |
| | 68 | == List of Active Prefixes |
| | 69 | |
| | 70 | [[InterWiki]] |
| 66 | 71 | |
| 67 | 72 | ---- |