cmlenz@39: = TracLinks in reStructuredText =
cmlenz@39: 
cmlenz@39: This document is for testing the ``..trac::`` directive. The page is written like
cmlenz@39: 
cmlenz@39: {{{
cmlenz@39: {{{
cmlenz@39: #!rst 
cmlenz@39: 
cmlenz@39: Examples
cmlenz@39: ...
cmlenz@39: ...
cmlenz@39: 
cmlenz@39: }}}
cmlenz@39: }}}
cmlenz@39: 
cmlenz@39: 
cmlenz@39: This is a list of example uses of the ''trac'' directive, providing use of TracLinks in WikiRestructuredText.
cmlenz@39: 
cmlenz@39: {{{
cmlenz@39: #!rst
cmlenz@39: 
cmlenz@39: Examples
cmlenz@39: --------
cmlenz@39: 
cmlenz@39: trac role
cmlenz@39: =========
cmlenz@39: Syntax is \`link\`\:trac: or :trac:\`link\`, and could be put anywhere in the text. 'link' has the same format as explain for the ``.. trac::`` directive below.
cmlenz@39: 
cmlenz@39: ``In the middle of my text `WikiFormatting`:trac: see!!!!`` 
cmlenz@39:    In the middle of my text `WikiFormatting`:trac: see!!!!
cmlenz@39: 
cmlenz@39: or
cmlenz@39: 
cmlenz@39: ``In the middle of my text :trac:`WikiFormatting` see!!!!`` 
cmlenz@39:    In the middle of my text :trac:`WikiFormatting` see!!!!
cmlenz@39: 
cmlenz@39: 
cmlenz@39: wiki
cmlenz@39: ====
cmlenz@39: ``.. trac:: WikiFormatting``
cmlenz@39: 	.. trac:: WikiFormatting
cmlenz@39: 
cmlenz@39: ``.. trac:: wiki:WikiFormatting``
cmlenz@39:        .. trac:: wiki:WikiFormatting
cmlenz@39: 
cmlenz@39: ``.. trac:: wiki:WikiFormatting WikiFormatting``
cmlenz@39: 	.. trac:: wiki:WikiFormatting WikiFormatting
cmlenz@39: 
cmlenz@39: ``.. trac:: wiki:WikiFormatting LinkText``
cmlenz@39: 	.. trac:: wiki:WikiFormatting LinkText
cmlenz@39: 
cmlenz@39: tickets
cmlenz@39: =======
cmlenz@39: 
cmlenz@39: ``.. trac:: #1``
cmlenz@39: 	.. trac:: #1
cmlenz@39: ``.. trac:: #1 ticket one``
cmlenz@39: 	.. trac:: #1 ticket one
cmlenz@39: ``.. trac:: ticket:1``
cmlenz@39: 	.. trac:: ticket:1
cmlenz@39: ``.. trac:: ticket:1 ticket one``
cmlenz@39: 	.. trac:: ticket:1 ticket one
cmlenz@39: 
cmlenz@39: reports
cmlenz@39: =======
cmlenz@39: 
cmlenz@39: ``.. trac:: {1}``
cmlenz@39: 	.. trac:: {1}
cmlenz@39: ``.. trac:: {1} report one``
cmlenz@39:         .. trac:: {1} report one
cmlenz@39: ``.. trac:: report:1``
cmlenz@39: 	.. trac:: report:1
cmlenz@39: ``.. trac:: report:1 report one``
cmlenz@39: 	.. trac:: report:1 report one
cmlenz@39: 
cmlenz@39: changesets
cmlenz@39: ==========
cmlenz@39: 
cmlenz@39: ``.. trac:: [42]``
cmlenz@39: 	.. trac:: [42]
cmlenz@39: ``.. trac:: [42] changeset 42``
cmlenz@39: 	.. trac:: [42] changeset 42
cmlenz@39: ``.. trac:: changeset:42``
cmlenz@39: 	.. trac:: changeset:42
cmlenz@39: ``.. trac:: changeset:42 changeset 42``
cmlenz@39: 	.. trac:: changeset:42 changeset 42
cmlenz@39: ``.. trac:: foo``
cmlenz@39: 	.. trac:: foo
cmlenz@39: 
cmlenz@39: files
cmlenz@39: =====
cmlenz@39: 
cmlenz@39: ``.. trac:: browser:/trunk/trac``
cmlenz@39: 	.. trac:: browser:/trunk/trac
cmlenz@39: 
cmlenz@39: The leading ``/`` can be omitted...
cmlenz@39: 
cmlenz@39: ``.. trac:: repos:trunk/trac trunk/trac``
cmlenz@39: 	.. trac:: repos:trunk/trac trunk/trac
cmlenz@39: ``.. trac:: source:trunk/trac Trac source code``
cmlenz@39: 	.. trac:: source:trunk/trac Trac source code
cmlenz@39: 
cmlenz@39: ``.. trac:: browser:trunk/README``
cmlenz@39: 	.. trac:: browser:trunk/README
cmlenz@39: ``.. trac:: repos:trunk/README trunk/README``
cmlenz@39: 	.. trac:: repos:trunk/README trunk/README
cmlenz@39: ``.. trac:: source:trunk/README README in trunk``
cmlenz@39: 	.. trac:: source:trunk/README README in trunk
cmlenz@39: 
cmlenz@39: Note that if ``hoo`` is a file, the link targets its revision log. In order to see the file's content, you need to specify the revision explicitely, like here:
cmlenz@39: 
cmlenz@39: ``.. trac:: browser:/trunk/README#latest latest of trunk/README``
cmlenz@39: 	.. trac:: browser:/trunk/README#latest latest of trunk/README
cmlenz@39: ``.. trac:: repos:trunk/README#42 trunk/README in rev 42``
cmlenz@39: 	.. trac:: repos:trunk/README#42 trunk/README in rev 42
cmlenz@39: }}}
cmlenz@39: 
cmlenz@39: ----
cmlenz@39: See also: WikiRestructuredTextLinks, TracLinks