Changes between Initial Version and Version 1 of TracLinks


Ignore:
Timestamp:
Sep 20, 2004, 6:01:32 PM (17 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracLinks

    v1 v1  
     1= Trac Links =
     2
     3As you might have guessed, TracLinks are a very fundamental feature of Trac.
     4
     5They allow easy hyperlinking to files, changesets, bugs/issues and wiki pages from anywhere in the system where WikiFormatting is used.
     6
     7TracLinks can refer to tickets, reports and changesets by simply writing the
     8ticket, report and changeset numbers in the following notation:
     9{{{
     10 * Ticket #1 or ticket:1
     11 * Report {1} or report:1
     12 * Changeset [1] or changeset:1
     13 * File source:trunk/COPYING.
     14}}}
     15Display:
     16 * Ticket #1 or ticket:1
     17 * Report {1} or report:1
     18 * Changeset [1] or changeset:1
     19 * File source:trunk/COPYING.
     20
     21Trac links can also be given a custom link title like this:
     22{{{
     23[ticket:1 This is a link to ticket number one].
     24}}}
     25
     26Display:
     27
     28[ticket:1 This is a link to ticket number one].
     29
     30It seems a simple enough concept at a glance, but actually allows quite a complex network of information.
     31
     32In practice, it's very intuitive and simple to use, and we've found the "link trail" extremely helpful to better understand what's happening in a project or why a particular change was made.
     33
     34== source: links ==
     35
     36The default behavior for a source:/some/path link is to open the directory browser if the path points
     37to a directory and otherwise open the log view. It's also possible to link directly to a specific
     38revision of a file like this: source:/some/file#123 or like this to link to the latest revision:
     39source:/some/file#latest.
     40
     41== Where to use TracLinks ==
     42You can use TracLinks in:
     43
     44 * Wiki pages
     45 * Ticket descriptions
     46 * Source code (Subversion) commit messages
     47
     48See also: WikiFormatting
     49