Changes between Version 1 and Version 2 of InterTrac

Timestamp:

10/12/2017 05:25:58 PM (7 years ago)

Author:

trac

Comment:

--

InterTrac

@@ -1 @@
-= InterTrac Links  =
+= InterTrac Links
 
-Trac supports a convenient way to refer to resources of other Trac servers, from within the Wiki markup, since version 0.10.
+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.
 
-== Definitions ==
+== Link Syntax
 
-An InterTrac link can be seen as a scoped TracLinks.
-It is used for referring to a Trac resource 
-(Wiki page, changeset, ticket, ...) located in another
-Trac environment.
-
-== 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.
+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:
 
 {{{
@@ -23 +11 @@
 }}}
 
-The other resource is specified using a regular TracLinks, of any flavor.
+The other resource is specified using a regular !TracLink, 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 `trac.ini` (see below).
+That target environment name is either the real name of the environment or an alias. 
+The aliases are defined in the `trac.ini` file, see below.
 The prefix is case insensitive.
 
-When a TracLink is enclosed in brackets, the alias is expanded.  That is, `[th:ticket:1]` is displayed as `trachacks:ticket:1`, since `th` is an alias for `trachacks`.  If the TracLink is not enclosed in brackets, then the alias is displayed as it is typed.
+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`.
 
-For convenience, there's also some alternative short-hand form, 
-where one can use an alias as an immediate prefix 
-for the identifier of a ticket, changeset or report:
-(e.g. `#T234`, `[T1508]`, `[trac 1508]`, ...)
+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]`.
 
-== Examples ==
+== Examples
 
-It is necessary to setup a configuration for the InterTrac facility.
-This configuration has to be done in the TracIni file, `[intertrac]` section.
+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:
 
-Example configuration:
-{{{
-...
+{{{#!ini
 [intertrac]
 # -- Example of setting up an alias:
@@ -50 +31 @@
 
 # -- Link to an external Trac:
-trac.title = Edgewall's Trac for Trac
-trac.url = http://trac.edgewall.org
+genshi.title = Edgewall's Trac for Genshi
+genshi.url = http://genshi.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.
+It can be a relative URL when the Trac environment is located on the same server.
 
-The `.title` information will be used for providing an useful tooltip
-when moving the cursor over an InterTrac links.
-
-Finally, the `.compat` option can be used to activate or disable
-a ''compatibility'' mode:
- * If the targeted Trac is running a version below [trac:milestone:0.10 0.10] 
-   ([trac:r3526 r3526] to be precise), then it doesn't know how to dispatch an InterTrac 
-   link, and it's up to the local Trac to prepare the correct link. 
-   Not all links will work that way, but the most common do. 
-   This is called the compatibility mode, and is `true` by default. 
- * If you know that the remote Trac knows how to dispatch InterTrac links, 
-   you can explicitly disable this compatibility mode and then ''any'' 
-   TracLinks can become an InterTrac link.
+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:
@@ -76 +44 @@
    * `trac:wiki:InterTrac` trac:wiki:InterTrac
    * `t:wiki:InterTrac` t:wiki:InterTrac
+   * `genshi:InterTrac` genshi: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 
+   * `genshi:#234` genshi:#234
    * `#T234` #T234
  * to the changeset [1912]:
    * `trac:changeset:1912` trac:changeset:1912
    * `[T1912]` [T1912]
- * to the log range [3300:3330]: '''(Note: the following ones need `trac.compat=false`)'''
+ * 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]` (''since 0.11; note that the ''remote'' Trac has to run 0.11 for this to work'')
+   * `[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.
+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.
+
+== List of Active InterTrac Prefixes
+
+The following InterTrac prefixes are available on this site:
+
+[[InterTrac]]
 
 ----