Edgewall Software

Changes between Version 2 and Version 3 of WikiRestructuredTextLinks


Ignore:
Timestamp:
Oct 8, 2004, 6:22:28 PM (20 years ago)
Author:
cboos@…
Comment:

addtional documentation for file links and linked to #801

Legend:

Unmodified
Added
Removed
Modified

  • WikiRestructuredTextLinks

    v2 v3  
    1616
    1717This is a list of example uses of the ''trac'' directive, providing use of TracLinks in WikiRestructuredText.
     18Note that not all that functionality has been merged yet. The patch attached to #801 provides all of these.
    1819
    1920
    … …  
    2627trac role
    2728=========
    28 Syntax is \`link\`\:trac: and could be put anywhere int the text. 'link' has the same format as below.
     29Syntax 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.
    2930
    30 ``In the middle of my text `WikiFormatting`:trac:`` see!!!!:
     31``In the middle of my text `WikiFormatting`:trac: see!!!!``
    3132   In the middle of my text `WikiFormatting`:trac: see!!!!
    3233
     34or
     35
     36``In the middle of my text :trac:`WikiFormatting` see!!!!``
     37   In the middle of my text :trac:`WikiFormatting` see!!!!
    3338
    3439
    3540wiki
    3641====
    37 ``.. trac:: WikiFormatting``:
     42``.. trac:: WikiFormatting``
    3843        .. trac:: WikiFormatting
    3944
    … …  
    4146       .. trac:: wiki:WikiFormatting
    4247
    43 ``.. trac:: wiki:WikiFormatting WikiFormatting``:
     48``.. trac:: wiki:WikiFormatting WikiFormatting``
    4449        .. trac:: wiki:WikiFormatting WikiFormatting
    4550
    46 ``.. trac:: wiki:WikiFormatting LinkText``:
     51``.. trac:: wiki:WikiFormatting LinkText``
    4752        .. trac:: wiki:WikiFormatting LinkText
    4853
    … …  
    5055=======
    5156
    52 ``.. trac:: #1``:
     57``.. trac:: #1``
    5358        .. trac:: #1
    54 ``.. trac:: #1 ticket one``:
     59``.. trac:: #1 ticket one``
    5560        .. trac:: #1 ticket one
    56 ``.. trac:: ticket:1``:
     61``.. trac:: ticket:1``
    5762        .. trac:: ticket:1
    58 ``.. trac:: ticket:1 ticket one``:
     63``.. trac:: ticket:1 ticket one``
    5964        .. trac:: ticket:1 ticket one
    6065
    … …  
    6267=======
    6368
    64 ``.. trac:: {1}``:
     69``.. trac:: {1}``
    6570        .. trac:: {1}
    66 ``.. trac:: {1} report one``:
     71``.. trac:: {1} report one``
    6772        .. trac:: {1} report one
    68 ``.. trac:: report:1``:
     73``.. trac:: report:1``
    6974        .. trac:: report:1
    70 ``.. trac:: report:1 report one``:
     75``.. trac:: report:1 report one``
    7176        .. trac:: report:1 report one
    7277
    … …  
    7479==========
    7580
    76 ``.. trac:: [42]``:
     81``.. trac:: [42]``
    7782        .. trac:: [42]
    78 ``.. trac:: [42] changeset 42``:
     83``.. trac:: [42] changeset 42``
    7984        .. trac:: [42] changeset 42
    80 ``.. trac:: changeset:42``:
     85``.. trac:: changeset:42``
    8186        .. trac:: changeset:42
    82 ``.. trac:: changeset:42 changeset 42``:
     87``.. trac:: changeset:42 changeset 42``
    8388        .. trac:: changeset:42 changeset 42
    84 ``.. trac:: foo``:
     89``.. trac:: foo``
    8590        .. trac:: foo
    8691
    … …  
    8893=====
    8994
    90 ``.. trac:: browser:foo/hoo``:
    91         .. trac:: browser:foo/hoo
    92 ``.. trac:: repos:foo/hoo foo/hoo``:
    93         .. trac:: repos:foo/hoo foo/hoo
    94 ``.. trac:: source:foo/hoo hoo in foo``:
    95         .. trac:: source:foo/hoo hoo in foo
    96 ``.. trac:: browser:foo/hoo#latest latest of foo/hoo``:
    97         .. trac:: browser:foo/hoo#latest latest of foo/hoo
    98 ``.. trac:: repos:foo/hoo#42 foo/hoo in rev 42``:
    99         .. trac:: repos:foo/hoo#42 foo/hoo in rev 42
     95``.. trac:: browser:/trunk/trac``
     96        .. trac:: browser:/trunk/trac
     97
     98The leading ``/`` can be omitted...
     99
     100``.. trac:: repos:trunk/trac trunk/trac``
     101        .. trac:: repos:trunk/trac trunk/trac
     102``.. trac:: source:trunk/trac Trac source code``
     103        .. trac:: source:trunk/trac Trac source code
     104
     105``.. trac:: browser:trunk/README``
     106        .. trac:: browser:trunk/README
     107``.. trac:: repos:trunk/README trunk/README``
     108        .. trac:: repos:trunk/README trunk/README
     109``.. trac:: source:trunk/README README in trunk``
     110        .. trac:: source:trunk/README README in trunk
     111
     112Note 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:
     113
     114``.. trac:: browser:/trunk/README#latest latest of trunk/README``
     115        .. trac:: browser:/trunk/README#latest latest of trunk/README
     116``.. trac:: repos:trunk/README#42 trunk/README in rev 42``
     117        .. trac:: repos:trunk/README#42 trunk/README in rev 42
    100118}}}
    101119