Changes between Initial Version and Version 1 of WikiRestructuredText

Timestamp:

11/17/04 15:27:56 (20 years ago)

Author:

trac

Comment:

--

WikiRestructuredText

@@ +1 @@
+= reStructuredText Support in Trac =
+
+Since 0.6, Trac supports using ''reStructuredText'' (RST) as an alternative to wiki markup in any context where WikiFormatting is used.
+
+From the reStucturedText webpage:
+ "''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. ''"
+
+=== Requirements ===
+Note that to activate RST support in Trac, the python docutils package must be installed. 
+If not already available on your operating system, you can download it at the [http://docutils.sourceforge.net/rst.html RST Website].
+
+=== More information on RST ===
+
+ * reStructuredText Website -- http://docutils.sourceforge.net/rst.html
+ * RST Quick Reference -- http://docutils.sourceforge.net/docs/rst/quickref.html
+
+----
+
+== Using RST in Trac ==
+To specify that a block of text should be parsed using RST, use the ''rst'' processor. 
+
+=== TracLinks in reStructuredText ===
+Trac provides a custom RST reference-directive 'trac' to allow TracLinks from within RST text.
+
+Example:
+{{{
+{{{
+#!rst
+This is a reference to |a ticket|
+
+.. |a ticket| trac:: #42
+}}}
+}}}
+
+For a complete example of all uses of the ''trac''-directive, please see WikiRestructuredTextLinks. 
+
+=== Example ===
+The example below should be mostly self-explanatory:
+{{{
+#!html
+<pre class="wiki">{{{
+#!rst
+FooBar Header
+=============
+reStructuredText is **nice**. It has its own webpage_.
+
+A table:
+
+=====  =====  ======
+   Inputs     Output
+------------  ------
+  A      B    A or B
+=====  =====  ======
+False  False  False
+True   False  True
+False  True   True
+True   True   True
+=====  =====  ======
+
+RST TracLinks
+-------------
+
+See also ticket |#42|.
+
+.. |#42| trac:: #42
+
+.. _webpage: http://docutils.sourceforge.net/rst.html
+}}}</pre>
+}}}
+
+
+Results in:
+{{{
+#!rst
+FooBar Header
+=============
+reStructuredText is **nice**. It has its own webpage_.
+
+A table:
+
+=====  =====  ======
+   Inputs     Output
+------------  ------
+  A      B    A or B
+=====  =====  ======
+False  False  False
+True   False  True
+False  True   True
+True   True   True
+=====  =====  ======
+
+RST TracLinks
+-------------
+
+See also ticket |#42|.
+
+.. |#42| trac:: #42
+
+.. _webpage: http://docutils.sourceforge.net/rst.html
+}}}
+
+
+----
+See also: WikiRestructuredTextLinks, WikiProcessors, WikiFormatting