Changes between Version 2 and Version 3 of WikiRestructuredTextLinks


Ignore:
Timestamp:
Jul 27, 2010, 10:28:42 PM (14 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiRestructuredTextLinks

    v2 v3  
    11= TracLinks in reStructuredText =
    22
    3 This document illustrates how to use the ``..trac::`` directive in reStructureThe page is written like
     3This document illustrates how to use the `:trac:` role in reStructuredText. The page is written like:
    44
    55{{{
    66{{{
    77#!rst
     8Examples:
    89
    9 Examples:
    1010 * Tickets: :trac:`#1` or :trac:`ticket:1`
    1111 * Ticket comments: :trac:`comment:ticket:1:2`
     
    2121 * A particular line of a specific file revision: :trac:`source:/trunk/COPYING@200#L25`
    2222
     23An explicit label can be specified, separated from the link by a space:
     24
     25 * See :trac:`#1 ticket 1` and the :trac:`source:trunk/COPYING license`.
    2326}}}
    2427}}}
     
    2831{{{
    2932#!rst
     33Examples:
    3034
    31 Examples:
    3235 * Tickets: :trac:`#1` or :trac:`ticket:1`
    3336 * Ticket comments: :trac:`comment:ticket:1:2`
     
    4346 * A particular line of a specific file revision: :trac:`source:/trunk/COPYING@200#L25`
    4447
     48An explicit label can be specified, separated from the link by a space:
     49
     50 * See :trac:`#1 ticket 1` and the :trac:`source:trunk/COPYING license`.
    4551}}}
    4652----
    4753
    48 Note also that any of the above could have been written using the alternate syntax for roles:
     54Note also that any of the above could have been written using substitution references and the `trac::` directive:
    4955{{{
    5056{{{
    5157#!rst
     58See |ticket123|.
    5259
    53 See `ticket:123`_
    54 
    55  .. :trac: ticket:123 Ticket 123
     60 .. |ticket123| trac:: ticket:123 this ticket
    5661}}}
    5762}}}
     63
     64This renders as:
    5865----
    5966
    6067{{{
    6168#!rst
     69See |ticket123|.
    6270
    63 See _`ticket:123`
    64 
    65 .. trac:: ticket:123 Ticket 123
     71 .. |ticket123| trac:: ticket:123 this ticket
    6672}}}
    67 ----
    68 The above form has the additional benefit of allowing you to specify an explicit label for the link.
    6973
    7074----