diff options
author | Rob Austein <sra@hactrn.net> | 2020-09-13 23:15:43 +0000 |
---|---|---|
committer | Rob Austein <sra@hactrn.net> | 2020-09-13 23:21:33 +0000 |
commit | 13d0f55865f8b1b851ce1e84597b144c5fd41662 (patch) | |
tree | 7b6ff6916f6596f64ec0d2657ae040abd5e18ed9 /raw-wiki-dump/InterTrac.trac | |
parent | 3aa8b1dd6e0f504ef83da99f8c9cdb2532f948f5 (diff) |
GC
Diffstat (limited to 'raw-wiki-dump/InterTrac.trac')
-rw-r--r-- | raw-wiki-dump/InterTrac.trac | 67 |
1 files changed, 0 insertions, 67 deletions
diff --git a/raw-wiki-dump/InterTrac.trac b/raw-wiki-dump/InterTrac.trac deleted file mode 100644 index b5f400d..0000000 --- a/raw-wiki-dump/InterTrac.trac +++ /dev/null @@ -1,67 +0,0 @@ -= InterTrac Links - -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. - -== List of Active InterTrac Prefixes - -[[InterTrac]] - -== Link Syntax - -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: - -{{{ -<target_environment>:<TracLinks> -}}} - -The other resource is specified using a regular TracLinks, of any flavor. - -That target environment name is either the real name of the environment or an alias for it. -The aliases are defined in the `trac.ini` file, see below. -The prefix is case insensitive. - -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`. - -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]`. - -== Examples - -It is necessary to set up a configuration for the InterTrac facility. -This configuration has to be done in the TracIni file, `[intertrac]` section, for example: - -{{{#!ini -[intertrac] -# -- Example of setting up an alias: -t = trac - -# -- Link to an external Trac: -trac.title = Edgewall's Trac for Trac -trac.url = http://trac.edgewall.org -}}} - -The `.url` is mandatory and is used for locating the other Trac. -This can be a relative URL in case that Trac environment is located on the same server. - -The `.title` information is used in a tooltip, ie when hovering the cursor over an InterTrac link. - -Now, given the above configuration, one could create the following links: - * to this InterTrac page: - * `trac:wiki:InterTrac` trac:wiki:InterTrac - * `t:wiki:InterTrac` t:wiki:InterTrac - * Keys are case insensitive: `T:wiki:InterTrac` T:wiki:InterTrac - * to the ticket #234: - * `trac:ticket:234` trac:ticket:234 - * `trac:#234` trac:#234 - * `#T234` #T234 - * to the changeset [1912]: - * `trac:changeset:1912` trac:changeset:1912 - * `[T1912]` [T1912] - * to the log range [3300:3330]: - * `trac:log:@3300:3330` trac:log:@3300:3330 - * `[trac 3300:3330]` [trac 3300:3330] - * 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'') - -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. - ----- -See also: TracLinks, InterWiki
\ No newline at end of file |