Changes between Version 1 and Version 2 of WikiRestructuredTextLinks


Ignore:
Timestamp:
Jul 17, 2008 10:45:00 AM (12 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:` role in reStructuredText. The page is written like: 
     3This document illustrates how to use the ``..trac::`` directive in reStructureThe page is written like 
    44 
    55{{{ 
    66{{{ 
    77#!rst  
     8 
    89Examples: 
    9  
    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 
    23 An 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`. 
    2623}}} 
    2724}}} 
     
    3128{{{ 
    3229#!rst  
     30 
    3331Examples: 
    34  
    3532 * Tickets: :trac:`#1` or :trac:`ticket:1` 
    3633 * Ticket comments: :trac:`comment:ticket:1:2` 
     
    4643 * A particular line of a specific file revision: :trac:`source:/trunk/COPYING@200#L25` 
    4744 
    48 An 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`. 
    5145}}} 
    5246---- 
    5347 
    54 Note also that any of the above could have been written using substitution references and the `trac::` directive: 
     48Note also that any of the above could have been written using the alternate syntax for roles: 
    5549{{{ 
    5650{{{ 
    5751#!rst 
    58 See |ticket123|. 
    5952 
    60  .. |ticket123| trac:: ticket:123 this ticket 
     53See _`ticket:123` 
     54 
     55 .. trac:: ticket:123 Ticket 123 
    6156}}} 
    6257}}} 
    63  
    64 This renders as: 
    6558---- 
    6659 
    6760{{{ 
    6861#!rst 
    69 See |ticket123|. 
    7062 
    71  .. |ticket123| trac:: ticket:123 this ticket 
     63See _`ticket:123` 
     64 
     65.. trac:: ticket:123 Ticket 123 
    7266}}} 
     67---- 
     68The above form has the additional benefit of allowing you to specify an explicit label for the link. 
    7369 
    7470----