close Warning: Can't synchronize with repository "(default)" (/common/SVN/wimax does not appear to be a Subversion repository.). Look in the Trac log for more information.

Changes between Version 3 and Version 4 of InterTrac


Ignore:
Timestamp:
Jan 30, 2019, 11:46:28 PM (19 months ago)
Author:
trac
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • InterTrac

    v3 v4  
    11= InterTrac Links
    22
    3 Trac supports a convenient way to refer to resources of other Trac servers using Wiki markup. An !InterTrac link can be seen as a scoped [TracLinks TracLink]. It is used for referring to a Trac resource located in another Trac environment.
     3Trac 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.
     4
     5== List of Active InterTrac Prefixes
     6
     7[[InterTrac]]
    48
    59== Link Syntax
     
    1115}}}
    1216
    13 The other resource is specified using a regular !TracLink, of any flavor.
     17The other resource is specified using a regular TracLinks, of any flavor.
    1418
    15 That target environment name is either the real name of the environment or an alias.
     19That target environment name is either the real name of the environment or an alias for it.
    1620The aliases are defined in the `trac.ini` file, see below.
    1721The prefix is case insensitive.
    1822
    19 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. For example, the above would be displayed as `WikiExtrasPlugin`.
     23If 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`.
    2024
    21 For convenience, there is also an alternate 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]`.
     25For 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]`.
    2226
    2327== Examples
    2428
    25 The only prefix defined by default is `trac`, which points to trac.edgewall.org. Additional prefixes can be specified in the [TracIni#intertrac-section intertrac] section of TracIni. For example:
     29It is necessary to set up a configuration for the InterTrac facility.
     30This configuration has to be done in the TracIni file, `[intertrac]` section, for example:
    2631
    2732{{{#!ini
     
    3136
    3237# -- Link to an external Trac:
    33 genshi.title = Edgewall's Trac for Genshi
    34 genshi.url = http://genshi.edgewall.org
     38trac.title = Edgewall's Trac for Trac
     39trac.url = http://trac.edgewall.org
    3540}}}
    3641
    3742The `.url` is mandatory and is used for locating the other Trac.
    38 It can be a relative URL when the Trac environment is located on the same server.
     43This can be a relative URL in case that Trac environment is located on the same server.
    3944
    4045The `.title` information is used in a tooltip, ie when hovering the cursor over an InterTrac link.
     
    4449   * `trac:wiki:InterTrac` trac:wiki:InterTrac
    4550   * `t:wiki:InterTrac` t:wiki:InterTrac
    46    * `genshi:InterTrac` genshi:InterTrac
    4751   * Keys are case insensitive: `T:wiki:InterTrac` T:wiki:InterTrac
    4852 * to the ticket #234:
    4953   * `trac:ticket:234` trac:ticket:234
    5054   * `trac:#234` trac:#234
    51    * `genshi:#234` genshi:#234
    5255   * `#T234` #T234
    5356 * to the changeset [1912]:
     
    5962   * 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'')
    6063
    61 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). For the rest (`intertrac_prefix:something`), we rely on the [TracSearch#quickjump quick jump] facility of the remote Trac.
    62 
    63 == List of Active InterTrac Prefixes
    64 
    65 The following InterTrac prefixes are available on this site:
    66 
    67 [[InterTrac]]
     64The 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.
    6865
    6966----