Edgewall Software

Changes between Version 15 and Version 16 of InterTrac


Ignore:
Timestamp:
Jan 28, 2006, 5:26:02 PM (18 years ago)
Author:
Christian Boos
Comment:

Update the documentation in order to match the current implementation.

Legend:

Unmodified
Added
Removed
Modified
  • InterTrac

    v15 v16  
    11= InterTrac Extension for TracLinks =
    22
    3 ''This is a proposal for implementing #234''.
    4 ''It's candidate for integration in the trunk, after the 0.9 release (see #2041)''
     3''(since [milestone:0.10])''
    54
    65== Definitions ==
     
    3433Besides the other environments run by the same server process
    3534(called ''sibling'' environments), which are automatically detected,
    36 (''Note: currently only in `tracd`''),
    3735it is necessary to setup a configuration for the InterTrac facility:
    3836 * in order to refer to a remote Trac
     
    5856
    5957Now, given this configuration, one could create the following links:
    60  * to the current InterTrac page:
     58 * to this InterTrac page:
    6159   * `trac:wiki:InterTrac` ->
    6260     [http://projects.edgewall.com/trac/wiki/InterTrac trac:wiki:InterTrac]
     
    6967     [http://projects.edgewall.com/trac/ticket/234 trac:ticket:234]
    7068   * `trac:#234` ->
    71      [http://projects.edgewall.com/trac/ticket/234 trac:#234]
     69     [http://projects.edgewall.com/trac/ticket/234 trac:#234] ''(deprecated)''
    7270   * `#T234` ->
    7371     [http://projects.edgewall.com/trac/search?q=#234 #T234]
     
    7573   * `trac:changeset:1912` ->
    7674     [http://projects.edgewall.com/trac/changeset/1912 trac:changeset:1912]
    77    * `trac:[1912]` ->
    78      [http:"//projects.edgewall.com/trac/search?q=[1912]" "trac:[1912]"]
    7975   * `[T1912]` ->
    8076     [http://projects.edgewall.com/trac/changeset/1912 "[T1912]"]
     
    8278Anything not given as explicit links (intertrac_prefix:module:id)
    8379is interpreted by the remote Trac, relying on its quickjump
    84 facility.
    85 
    86 
    87 
    88 See also: TracLinks, InterWiki
     80facility. ''(deprecated)''
    8981
    9082----
    91 == Implementation Notes ==
    92 
    93 Currently, the `[intertrac]` configuration has to be repeated
    94 for each Trac environment, but there's work in progress concerning a
    95 [ticket:1051 centralized trac.ini], which would help greatly here.
    96 
    97 This idea was first proposed as a patch for #234, and
    98 has been implemented in the following branch:
    99 source:sandbox/intertrac
    100 
    101 The general idea is that any `[a-zA-Z.+-]+:` prefix,
    102 followed by anything which is not a space, has to be interpreted as:
    103  1. maybe an alias to something else; if yes, it is dereferenced
    104     before going on
    105  1. then, it's maybe a link prefix given by an `IWikiSyntaxProvider` component
    106  1. if not, it's maybe an environment name (!InterTrac link)
    107  1. if not, it's maybe an !InterWiki link
    108  1. if not, it is not a link
     83See also: TracLinks, InterWiki