Changes between Version 1 and Version 2 of WikiRestructuredText
- Timestamp:
- 02/06/14 17:20:59 (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiRestructuredText
v1 v2 27 27 28 28 * 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 }}} 39 48 40 49 * 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 }}} 51 69 52 70 For a complete example of all uses of the `:trac:` role, please see WikiRestructuredTextLinks. … … 58 76 code-block 59 77 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 }}} 107 Note the need to indent the code at least one character after the `.. code-block` directive. 89 108 90 109 === Wiki Macros in reStructuredText === … … 92 111 For doing [WikiMacros Wiki Macros] in RST you use the same directive as for syntax highlighting i.e code-block. 93 112 94 === Wiki Macro Example === 95 96 {{{ 97 {{{ 98 #!rst 99 100 .. code-block:: RecentChanges 101 102 Trac,3 103 104 }}} 105 }}} 106 107 Will result in the below: 108 109 [[RecentChanges(Trac,3)]] 110 111 Or a more concise Wiki Macro like syntax is also available: 112 113 {{{ 114 {{{ 115 #!rst 116 117 :code-block:`RecentChanges:Trac,3` 118 }}} 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 137 Or 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 }}} 119 155 }}} 120 156 121 157 === Bigger RST Example === 122 158 The example below should be mostly self-explanatory: 159 160 ||= Wiki Markup ||= Display || 161 {{{#!td 123 162 {{{ 124 163 #!html … … 150 189 }}}</pre> 151 190 }}} 152 153 154 Results in: 191 }}} 192 {{{#!td 155 193 {{{ 156 194 #!rst … … 179 217 .. _webpage: http://docutils.sourceforge.net/rst.html 180 218 }}} 181 219 }}} 182 220 183 221 ----