Edgewall Software

Version 7 (modified by Remy Blank, 15 years ago) ( diff )

Removed the example for the "alternate syntax for roles", which doesn't actually use roles, and added an example for specifying explicit link labels.

This page documents the 1.4 (latest stable) release. Documentation for other releases can be found here.

TracLinks in reStructuredText

This document illustrates how to use the :trac: directive in reStructuredText. The page is written like: 

{{{
#!rst 
Examples:

 * Tickets: :trac:`#1` or :trac:`ticket:1`
 * Ticket comments: :trac:`comment:ticket:1:2`
 * Reports: :trac:`{1}` or :trac:`report:1`
 * Changesets: :trac:`r1`, :trac:`[1]` or :trac:`changeset:1`
 * Revision log: :trac:`r1:3`, :trac:`[1:3]` or :trac:`log:@1:3`, :trac:`log:trunk@1:3`
 * Diffs (since version 0.10): :trac:`diff:@20:30`, :trac:`diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default` or :trac:`diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539`
 * Wiki pages: :trac:`CamelCase` or :trac:`wiki:CamelCase`
 * Milestones: :trac:`milestone:1.0`
 * Attachment: :trac:`attachment:ticket:944:attachment.1073.diff`
 * Files: :trac:`source:trunk/COPYING`
 * A specific file revision: :trac:`source:/trunk/COPYING@200`
 * A particular line of a specific file revision: :trac:`source:/trunk/COPYING@200#L25`

An explicit label can be specified, separated from the link by a space:

 * See :trac:`#1 ticket 1` and the :trac:`source:trunk/COPYING license`.
}}}

Provided you have docutils installed, the above block will render as:

Examples:

An explicit label can be specified, separated from the link by a space:

See also: WikiRestructuredText, TracLinks

Note: See TracWiki for help on using the wiki.