39
|
1 = InterTrac Extension for TracLinks =
|
|
2
|
|
3 ''(since [milestone:0.10])''
|
|
4
|
|
5 == Definitions ==
|
|
6
|
|
7 An InterTrac link is used for referring to a Trac object
|
|
8 (Wiki page, changeset, ticket, ...) located in another
|
|
9 Trac environment.
|
|
10
|
|
11 == List of Active InterTrac Prefixes ==
|
|
12
|
|
13 [[InterTrac]]
|
|
14
|
|
15 == Link Syntax ==
|
|
16
|
|
17 {{{
|
|
18 <target_environment>:<TracLinks>
|
|
19 }}}
|
|
20
|
|
21 The link is composed by the target environment name,
|
|
22 followed by a colon (e.g. `trac:`),
|
|
23 followed by a regular TracLinks, of any flavor.
|
|
24
|
|
25 That target environment name is either the real name of the
|
|
26 environment, or an alias for it.
|
|
27 The aliases are defined in `trac.ini` (see below).
|
|
28 The prefix is case insensitive.
|
|
29
|
|
30 For convenience, there's also an alternative short-hand form,
|
|
31 where one can use an alias as an immediate prefix
|
|
32 for the identifier of a ticket, changeset or report:
|
|
33 (e.g. `#T234`, `[T1508]`, `[trac 1508]`, ...)
|
|
34
|
|
35 == Configuration ==
|
|
36
|
|
37 It is necessary to setup a specific `[intertrac]` section in the TracIni for the InterTrac facility, in order to associate a prefix to other Trac sites, and for defining environment aliases.
|
|
38
|
|
39 Example configuration:
|
|
40 {{{
|
|
41 ...
|
|
42 [intertrac]
|
|
43 ## -- Example of setting up an alias:
|
|
44 t = trac
|
|
45
|
|
46 ## -- Link to an external Trac:
|
|
47 trac.title = Edgewall's Trac for Trac
|
|
48 trac.url = http://projects.edgewall.com/trac
|
|
49
|
|
50 #trac.svn = http://repos.edgewall.com/projects/trac
|
|
51 # Hint: .svn information could be used in the future to support svn:externals...
|
|
52 }}}
|
|
53
|
|
54 Now, given this configuration, one could create the following links:
|
|
55 * to the current InterTrac page:
|
|
56 * `trac:wiki:InterTrac` ->
|
|
57 [http://projects.edgewall.com/trac/wiki/InterTrac trac:wiki:InterTrac]
|
|
58 * `t:wiki:InterTrac` ->
|
|
59 [http://projects.edgewall.com/trac/wiki/InterTrac t:wiki:InterTrac]
|
|
60 * Keys are case insensitive: `T:wiki:InterTrac` ->
|
|
61 [http://projects.edgewall.com/trac/wiki/InterTrac T:wiki:InterTrac]
|
|
62 * to the ticket #234:
|
|
63 * `trac:ticket:234` ->
|
|
64 [http://projects.edgewall.com/trac/ticket/234 trac:ticket:234]
|
|
65 * `trac:#234` ->
|
|
66 [http://projects.edgewall.com/trac/ticket/234 trac:#234]
|
|
67 * `#T234` ->
|
|
68 [http://projects.edgewall.com/trac/search?q=#234 #T234]
|
|
69 * to the changeset [1912]:
|
|
70 * `trac:changeset:1912` ->
|
|
71 [http://projects.edgewall.com/trac/changeset/1912 trac:changeset:1912]
|
|
72 * `trac:[1912]` ->
|
|
73 [http:"//projects.edgewall.com/trac/search?q=[1912]" "trac:[1912]"]
|
|
74 * `[T1912]` ->
|
|
75 [http://projects.edgewall.com/trac/changeset/1912 "[T1912]"]
|
|
76
|
|
77 Anything not given as explicit links (intertrac_prefix:module:id)
|
|
78 is interpreted by the remote Trac, relying on its quickjump
|
|
79 facility.
|
|
80
|
|
81 ----
|
|
82 See also: TracLinks, InterWiki
|