close
Warning:
Can't synchronize with repository "(default)" (/common/SVN/crkit does not appear to be a Subversion repository.). Look in the Trac log for more information.
- Timestamp:
-
Jan 30, 2019, 11:46:21 PM (5 years ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
v3
|
v4
|
|
1 | 1 | = InterTrac Links |
2 | 2 | |
3 | | Trac supports a convenient way to refer to resources of other Trac servers using Wiki markup. An !InterTrac link can be seen as a scoped [TracLinks TracLink]. It is used for referring to a Trac resource located in another Trac environment. |
| 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. |
| 4 | |
| 5 | == List of Active InterTrac Prefixes |
| 6 | |
| 7 | [[InterTrac]] |
4 | 8 | |
5 | 9 | == Link Syntax |
… |
… |
|
11 | 15 | }}} |
12 | 16 | |
13 | | The other resource is specified using a regular !TracLink, of any flavor. |
| 17 | The other resource is specified using a regular TracLinks, of any flavor. |
14 | 18 | |
15 | | That target environment name is either the real name of the environment or an alias. |
| 19 | That target environment name is either the real name of the environment or an alias for it. |
16 | 20 | The aliases are defined in the `trac.ini` file, see below. |
17 | 21 | The prefix is case insensitive. |
18 | 22 | |
19 | | 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. For example, the above would be displayed as `WikiExtrasPlugin`. |
| 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`. |
20 | 24 | |
21 | | For convenience, there is also an alternate short-hand form, where an alias can be used as an immediate prefix for the identifier of a ticket, changeset or report, eg `#T234`, `[T1508]`, `[trac 1508]`. |
| 25 | For convenience, there is also an alternative short-hand form, where an alias can be used as an immediate prefix for the identifier of a ticket, changeset or report, eg `#T234`, `[T1508]`, `[trac 1508]`. |
22 | 26 | |
23 | 27 | == Examples |
24 | 28 | |
25 | | The only prefix defined by default is `trac`, which points to trac.edgewall.org. Additional prefixes can be specified in the [TracIni#intertrac-section intertrac] section of TracIni. For example: |
| 29 | It is necessary to set up a configuration for the InterTrac facility. |
| 30 | This configuration has to be done in the TracIni file, `[intertrac]` section, for example: |
26 | 31 | |
27 | 32 | {{{#!ini |
… |
… |
|
31 | 36 | |
32 | 37 | # -- Link to an external Trac: |
33 | | genshi.title = Edgewall's Trac for Genshi |
34 | | genshi.url = http://genshi.edgewall.org |
| 38 | trac.title = Edgewall's Trac for Trac |
| 39 | trac.url = http://trac.edgewall.org |
35 | 40 | }}} |
36 | 41 | |
37 | 42 | The `.url` is mandatory and is used for locating the other Trac. |
38 | | It can be a relative URL when the Trac environment is located on the same server. |
| 43 | This can be a relative URL in case that Trac environment is located on the same server. |
39 | 44 | |
40 | 45 | The `.title` information is used in a tooltip, ie when hovering the cursor over an InterTrac link. |
… |
… |
|
44 | 49 | * `trac:wiki:InterTrac` trac:wiki:InterTrac |
45 | 50 | * `t:wiki:InterTrac` t:wiki:InterTrac |
46 | | * `genshi:InterTrac` genshi:InterTrac |
47 | 51 | * Keys are case insensitive: `T:wiki:InterTrac` T:wiki:InterTrac |
48 | 52 | * to the ticket #234: |
49 | 53 | * `trac:ticket:234` trac:ticket:234 |
50 | 54 | * `trac:#234` trac:#234 |
51 | | * `genshi:#234` genshi:#234 |
52 | 55 | * `#T234` #T234 |
53 | 56 | * to the changeset [1912]: |
… |
… |
|
59 | 62 | * 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'') |
60 | 63 | |
61 | | 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). For the rest (`intertrac_prefix:something`), we rely on the [TracSearch#quickjump quick jump] facility of the remote Trac. |
62 | | |
63 | | == List of Active InterTrac Prefixes |
64 | | |
65 | | The following InterTrac prefixes are available on this site: |
66 | | |
67 | | [[InterTrac]] |
| 64 | 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. |
68 | 65 | |
69 | 66 | ---- |