Changes between Version 2 and Version 3 of WikiRestructuredText


Ignore:
Timestamp:
10/27/11 13:54:15 (5 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiRestructuredText

    v2 v3  
    2727 
    2828 * Trac provides a custom RST directive `trac::` to allow TracLinks from within RST text. 
    29  
    30  Example: 
    31  {{{ 
    32  {{{ 
    33  #!rst 
    34  This is a reference to |a ticket| 
    35  
    36  .. |a ticket| trac:: #42 
    37  }}} 
    38  }}} 
     29   ||= Wiki Markup ||= Display || 
     30   {{{#!td 
     31     {{{ 
     32     {{{ 
     33     #!rst 
     34     This is a reference to |a ticket| 
     35 
     36     .. |a ticket| trac:: #42 
     37     }}} 
     38     }}} 
     39   }}} 
     40   {{{#!td 
     41     {{{ 
     42     #!rst 
     43     This is a reference to |a ticket| 
     44 
     45     .. |a ticket| trac:: #42 
     46     }}} 
     47   }}} 
    3948 
    4049 * Trac allows an even easier way of creating TracLinks in RST, using the custom `:trac:` role. 
    41  
    42  Example: 
    43  {{{ 
    44  {{{ 
    45  #!rst 
    46  This is a reference to ticket `#12`:trac: 
    47  
    48  To learn how to use Trac, see `TracGuide`:trac: 
    49  }}} 
    50  }}} 
     50   ||= Wiki Markup ||= Display || 
     51   {{{#!td 
     52     {{{ 
     53     {{{ 
     54     #!rst 
     55     This is a reference to ticket `#12`:trac: 
     56 
     57     To learn how to use Trac, see `TracGuide`:trac: 
     58     }}} 
     59     }}} 
     60   }}} 
     61   {{{#!td 
     62     {{{ 
     63     #!rst 
     64     This is a reference to ticket `#12`:trac: 
     65 
     66     To learn how to use Trac, see `TracGuide`:trac: 
     67     }}} 
     68   }}} 
    5169 
    5270 For a complete example of all uses of the `:trac:` role, please see WikiRestructuredTextLinks.  
    … …  
    5876code-block 
    5977 
    60 Example 
    61  
    62 {{{ 
    63 {{{ 
    64 #!rst 
    65  
    66 .. code-block:: python 
    67  
    68  class Test: 
    69  
    70     def TestFunction(self): 
    71         pass 
    72  
    73 }}} 
    74 }}} 
    75  
    76 Will result in the below. 
    77  
    78 {{{ 
    79 #!rst 
    80  
    81 .. code-block:: python 
    82  
    83  class Test: 
    84  
    85     def TestFunction(self): 
    86         pass 
    87  
    88 }}} 
     78||= Wiki Markup ||= Display || 
     79{{{#!td 
     80  {{{ 
     81  {{{ 
     82  #!rst 
     83 
     84  .. code-block:: python 
     85 
     86     class Test: 
     87 
     88         def TestFunction(self): 
     89             pass 
     90   
     91  }}} 
     92  }}} 
     93}}} 
     94{{{#!td 
     95  {{{ 
     96  #!rst 
     97 
     98  .. code-block:: python 
     99 
     100     class Test: 
     101 
     102         def TestFunction(self): 
     103             pass 
     104 
     105  }}} 
     106}}} 
     107Note the need to indent the code at least one character after the `.. code-block` directive. 
    89108 
    90109=== Wiki Macros in reStructuredText === 
    91110 
    92 For doing [WikiMacros Wiki Macros] in RST you use the same directive as for syntax highlighting i.e 
    93 code-block. To work you must use a version of trac that has [trac:ticket:801 #801] applied.  
    94  
    95 === Wiki Macro Example === 
    96  
    97 {{{ 
    98 {{{ 
    99 #!rst 
    100  
    101 .. code-block:: RecentChanges 
    102  
    103    Trac,3 
    104  
    105 }}} 
    106 }}} 
    107  
    108 Will result in the below: 
    109  
    110      [[RecentChanges(Trac,3)]] 
    111  
    112 Or a more concise Wiki Macro like syntax is also available: 
    113  
    114 {{{ 
    115 {{{ 
    116 #!rst 
    117  
    118 :code-block:`RecentChanges:Trac,3` 
    119 }}} 
     111For doing [WikiMacros Wiki Macros] in RST you use the same directive as for syntax highlighting i.e code-block. 
     112 
     113||= Wiki Markup ||= Display || 
     114{{{#!td 
     115  {{{ 
     116  {{{ 
     117  #!rst 
     118 
     119  .. code-block:: RecentChanges 
     120 
     121     Trac,3 
     122 
     123  }}} 
     124  }}} 
     125}}} 
     126{{{#!td 
     127  {{{ 
     128  #!rst 
     129 
     130  .. code-block:: RecentChanges 
     131 
     132     Trac,3 
     133 
     134  }}} 
     135}}} 
     136 
     137Or a more concise Wiki Macro like syntax is also available, using the `:code-block:` role: 
     138 
     139||= Wiki Markup ||= Display || 
     140{{{#!td 
     141  {{{ 
     142  {{{ 
     143  #!rst 
     144 
     145  :code-block:`RecentChanges:Trac,3` 
     146  }}} 
     147  }}} 
     148}}} 
     149{{{#!td 
     150  {{{ 
     151  #!rst 
     152 
     153  :code-block:`RecentChanges:Trac,3` 
     154  }}} 
    120155}}} 
    121156 
    122157=== Bigger RST Example === 
    123158The example below should be mostly self-explanatory: 
     159 
     160||= Wiki Markup ||= Display || 
     161{{{#!td 
    124162{{{ 
    125163#!html 
    … …  
    151189}}}</pre> 
    152190}}} 
    153  
    154  
    155 Results in: 
     191}}} 
     192{{{#!td 
    156193{{{ 
    157194#!rst 
    … …  
    180217.. _webpage: http://docutils.sourceforge.net/rst.html 
    181218}}} 
    182  
     219}}} 
    183220 
    184221----