[37343] | 1 | = InterTrac Links |
---|
[26484] | 2 | |
---|
[37343] | 3 | Trac supports a convenient way to refer to resources of other Trac servers, from within the Wiki markup. An !InterTrac link can be seen as a scoped TracLinks. It is used for referring to a Trac resource located in another Trac environment. A resource can be a wiki page, changeset, ticket or milestone. |
---|
[26484] | 4 | |
---|
[37343] | 5 | == List of Active InterTrac Prefixes |
---|
[26484] | 6 | |
---|
| 7 | [[InterTrac]] |
---|
| 8 | |
---|
[37343] | 9 | == Link Syntax |
---|
[26484] | 10 | |
---|
[37343] | 11 | Simply use the name of the other Trac environment as a prefix, followed by a colon, ending with the resource located in the other environment. |
---|
[26484] | 12 | |
---|
| 13 | {{{ |
---|
| 14 | <target_environment>:<TracLinks> |
---|
| 15 | }}} |
---|
| 16 | |
---|
| 17 | The other resource is specified using a regular TracLinks, of any flavor. |
---|
| 18 | |
---|
[37343] | 19 | That target environment name is either the real name of the environment or an alias for it. |
---|
[26484] | 20 | The aliases are defined in `trac.ini` (see below). |
---|
| 21 | The prefix is case insensitive. |
---|
| 22 | |
---|
[37343] | 23 | If the InterTrac link is enclosed in square brackets (like `[th:WikiExtrasPlugin]`), the InterTrac prefix is removed in the displayed link like a normal link resolver would be, ie the above would be displayed as `WikiExtrasPlugin`. |
---|
[26484] | 24 | |
---|
[37343] | 25 | For convenience, there's also some alternative short-hand form, where one can use an alias as an immediate prefix for the identifier of a ticket, changeset or report, eg `#T234`, `[T1508]`, `[trac 1508]`. |
---|
[26484] | 26 | |
---|
[37343] | 27 | == Examples |
---|
[26484] | 28 | |
---|
| 29 | It is necessary to setup a configuration for the InterTrac facility. |
---|
| 30 | This configuration has to be done in the TracIni file, `[intertrac]` section. |
---|
| 31 | |
---|
| 32 | Example configuration: |
---|
[37343] | 33 | {{{#!ini |
---|
[26484] | 34 | [intertrac] |
---|
| 35 | # -- Example of setting up an alias: |
---|
| 36 | t = trac |
---|
| 37 | |
---|
| 38 | # -- Link to an external Trac: |
---|
| 39 | trac.title = Edgewall's Trac for Trac |
---|
| 40 | trac.url = http://trac.edgewall.org |
---|
| 41 | }}} |
---|
| 42 | |
---|
| 43 | The `.url` is mandatory and is used for locating the other Trac. |
---|
[37343] | 44 | This can be a relative URL in case that Trac environment is located on the same server. |
---|
[26484] | 45 | |
---|
[37343] | 46 | The `.title` information will be used for providing an useful tooltip when moving the cursor over an InterTrac links. |
---|
[26484] | 47 | |
---|
| 48 | Now, given the above configuration, one could create the following links: |
---|
| 49 | * to this InterTrac page: |
---|
| 50 | * `trac:wiki:InterTrac` trac:wiki:InterTrac |
---|
| 51 | * `t:wiki:InterTrac` t:wiki:InterTrac |
---|
| 52 | * Keys are case insensitive: `T:wiki:InterTrac` T:wiki:InterTrac |
---|
| 53 | * to the ticket #234: |
---|
| 54 | * `trac:ticket:234` trac:ticket:234 |
---|
| 55 | * `trac:#234` trac:#234 |
---|
| 56 | * `#T234` #T234 |
---|
| 57 | * to the changeset [1912]: |
---|
| 58 | * `trac:changeset:1912` trac:changeset:1912 |
---|
| 59 | * `[T1912]` [T1912] |
---|
[37343] | 60 | * to the log range [3300:3330]: |
---|
[26484] | 61 | * `trac:log:@3300:3330` trac:log:@3300:3330 |
---|
[37343] | 62 | * `[trac 3300:3330]` [trac 3300:3330] |
---|
| 63 | * finally, to link to the start page of a remote trac, simply use its prefix followed by ':', inside an explicit link. Example: `[th: Trac Hacks]` (note that the ''remote'' Trac has to run Trac >= 0.11 for this to work'') |
---|
[26484] | 64 | |
---|
[37343] | 65 | The generic form `intertrac_prefix:module:id` is translated to the corresponding URL `<remote>/module/id`, shorthand links are specific to some modules (e.g. !#T234 is processed by the ticket module) and for the rest (`intertrac_prefix:something`), we rely on the TracSearch#quickjump facility of the remote Trac. |
---|
[26484] | 66 | |
---|
| 67 | ---- |
---|
[37343] | 68 | See also: TracLinks, InterWiki |
---|