Changes between Version 5 and Version 6 of WikiRestructuredText
- Timestamp:
- 2023-12-28T13:06:05+01:00 (12 months ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiRestructuredText
v5 v6 3 3 == Introduction 4 4 5 Trac supports [https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html reStructuredText (RST)] as an alternative to wiki markup where WikiFormatting is used. 5 6 Trac supports [http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html reStructuredText (RST)] as an alternative to wiki markup where WikiFormatting is used. 6 7 7 8 From the reStucturedText webpage: 8 9 "reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. It is useful for in-line program documentation (such as Python docstrings), for quickly creating simple web pages, and for standalone documents. reStructuredText is designed for extensibility for specific application domains." 9 10 10 If you want a file from your Subversion repository to be displayed as reStructuredText in the Trac source browser, set `text/x-rst` as the value for the Subversion property `svn:mime-type`, or add the extension `rst` to the filename. See [trac:source:branches/1. 2-stable/INSTALL.rst this example].11 If you want a file from your Subversion repository to be displayed as reStructuredText in the Trac source browser, set `text/x-rst` as the value for the Subversion property `svn:mime-type`, or add the extension `rst` to the filename. See [trac:source:branches/1.4-stable/INSTALL.rst this example]. 11 12 12 13 The examples will only be rendered as reStructuredText if docutils is installed. If Pygments is installed but docutils is not installed, the examples will be syntax-highlighted rather than rendered as reStructuredText. … … 18 19 === More information on RST 19 20 20 * [http s://docutils.sourceforge.io/rst.html reStructuredText Website]21 * [http s://docutils.sourceforge.io/docs/user/rst/quickref.html RST Quick Reference]21 * [http://docutils.sourceforge.net/rst.html reStructuredText Website] 22 * [http://docutils.sourceforge.net/docs/rst/quickref.html RST Quick Reference] 22 23 23 24 == Using RST in Trac 24 25 25 To specify that a block of text should be parsed using RST, use the ''rst'' processor. 26 To specify that a block of text should be parsed using RST, use the ''rst'' processor. 26 27 27 28 === TracLinks in reStructuredText … … 65 66 }}} 66 67 67 For a complete example of all uses of the `:trac:` role, see WikiRestructuredTextLinks. 68 For a complete example of all uses of the `:trac:` role, see WikiRestructuredTextLinks. 68 69 69 70 === Syntax highlighting in reStructuredText … … 82 83 def TestFunction(self): 83 84 pass 84 85 85 86 }}} 86 87 }}} … … 175 176 See also ticket `#42`:trac:. 176 177 177 .. _webpage: http s://docutils.sourceforge.io/rst.html178 .. _webpage: http://docutils.sourceforge.net/rst.html 178 179 }}}</pre> 179 180 }}} … … 203 204 See also ticket `#42`:trac:. 204 205 205 .. _webpage: http s://docutils.sourceforge.io/rst.html206 .. _webpage: http://docutils.sourceforge.net/rst.html 206 207 }}} 207 208 }}}