Mercurial > genshi > genshi-test
comparison examples/trac/wiki-default/InterTrac @ 39:71ecbe90aafc
Copy Trac to main branch.
| author | cmlenz |
|---|---|
| date | Mon, 03 Jul 2006 18:53:27 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 38:fec9f4897415 | 39:71ecbe90aafc |
|---|---|
| 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 |