Changes between Version 1 and Version 2 of WikiRestructuredTextLinks


Ignore:
Timestamp:
04/18/11 00:07:14 (13 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiRestructuredTextLinks

    v1 v2  
    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----