Changes between Version 1 and Version 2 of InterTrac


Ignore:
Timestamp:
Mar 12, 2015, 4:35:26 PM (10 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • InterTrac

    v1 v2  
    1 = InterTrac Links  =
     1= InterTrac Links
    22
    3 Trac supports a convenient way to refer to resources of other Trac servers, from within the Wiki markup, since version 0.10.
     3Trac supports a convenient way to refer to resources of other Trac servers, from within the Wiki markup.
    44
    5 == Definitions ==
     5== Definitions
    66
    77An InterTrac link can be seen as a scoped TracLinks.
    … …  
    1010Trac environment.
    1111
    12 == List of Active InterTrac Prefixes ==
     12== List of Active InterTrac Prefixes
    1313
    1414[[InterTrac]]
    1515
    16 == Link Syntax ==
     16== Link Syntax
    1717
    1818Simply use the name of the other Trac environment as a prefix,
    … …  
    3030The prefix is case insensitive.
    3131
     32If 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 (i.e. the above would be displayed as `WikiExtrasPlugin`).
     33
    3234For convenience, there's also some alternative short-hand form,
    3335where one can use an alias as an immediate prefix
    … …  
    3537(e.g. `#T234`, `[T1508]`, `[trac 1508]`, ...)
    3638
    37 == Examples ==
    38 
    39 {{{
    40 #!comment
    41  Besides the other environments run by the same server process
    42  (called ''sibling'' environments), which are automatically detected,
    43 Support for sibling environments has been disabled.
    44 See http://thread.gmane.org/gmane.comp.version-control.subversion.trac.devel/157
    45 }}}
     39== Examples
    4640
    4741It is necessary to setup a configuration for the InterTrac facility.
    … …  
    4943
    5044Example configuration:
    51 {{{
    52 ...
     45{{{#!ini
    5346[intertrac]
    5447# -- Example of setting up an alias:
    … …  
    5750# -- Link to an external Trac:
    5851trac.title = Edgewall's Trac for Trac
    59 trac.url = http://projects.edgewall.com/trac
    60 trac.compat = false
     52trac.url = http://trac.edgewall.org
    6153}}}
    6254
    … …  
    6961
    7062Finally, the `.compat` option can be used to activate or disable
    71 a ''compatbility'' mode:
    72  * If the targeted Trac is running a version below milestone:0.10
    73    (r3526 to be precise), then it doesn't know how to dispatch an InterTrac
     63a ''compatibility'' mode:
     64 * If the targeted Trac is running a version below [trac:milestone:0.10 0.10]
     65   ([trac:r3526 r3526] to be precise), then it doesn't know how to dispatch an InterTrac
    7466   link, and it's up to the local Trac to prepare the correct link.
    7567   Not all links will work that way, but the most common do.
    76    This is called the compatibility mode, and is `true` by default.
     68   This is called the compatibility mode, and is `false` by default.
    7769 * If you know that the remote Trac knows how to dispatch InterTrac links,
    78    you can explicitely disable this compatibility mode and then ''any''
     70   you can explicitly disable this compatibility mode and then ''any''
    7971   TracLinks can become an InterTrac link.
    8072
    … …  
    9486   * `trac:log:@3300:3330` trac:log:@3300:3330 
    9587   * `[trac 3300:3330]` [trac 3300:3330]
     88 * 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]` (''since 0.11; note that the ''remote'' Trac has to run 0.11 for this to work'')
    9689
    9790The generic form `intertrac_prefix:module:id` is translated
    … …  
    10295
    10396----
    104 === Discussion ===
    105 
    106 I think that the `trac` prefix could even be set as a default in the `[intertrac]` TracIni section. --CB
    107 
    108 ----
    10997See also: TracLinks, InterWiki