diff options
author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2013-07-03 09:39:52 +0000 |
---|---|---|
committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2013-07-03 09:39:52 +0000 |
commit | f245cbee666c5027d6337e37cf5a6e6067c23c9f (patch) | |
tree | adbcbdbd2d0ab92f94a6313f6cd89d8969240ff0 | |
parent | 75259abebd30ac06e7a785057169f5ae210616e6 (diff) | |
download | docutils-f245cbee666c5027d6337e37cf5a6e6067c23c9f.tar.gz |
Documentation update (links and tools).
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk/docutils@7677 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
-rw-r--r-- | FAQ.txt | 2 | ||||
-rw-r--r-- | docs/user/links.txt | 16 | ||||
-rw-r--r-- | docs/user/tools.txt | 12 |
3 files changed, 23 insertions, 7 deletions
@@ -447,6 +447,8 @@ order: * `Firedrop <http://www.voidspace.org.uk/python/firedrop2/>`__ * `PyBloxsom <http://pyblosxom.sourceforge.net/>`__ * `Lino WebMan <http://lino.sourceforge.net/webman.html>`__ +* `Pelican <http://blog.getpelican.com/>`__ + (also listed `on PyPi <http://pypi.python.org/pypi/pelican>`__) Please `let us know`_ of any other reStructuredText Blogs. diff --git a/docs/user/links.txt b/docs/user/links.txt index 43fe37ebe..2da1135ea 100644 --- a/docs/user/links.txt +++ b/docs/user/links.txt @@ -113,8 +113,8 @@ HTML variants created to translate the Python_ documentation, and is now `used by <http://sphinx.pocoo.org/examples.html>`__ a wide choice of projects. - Generates web sites (interlinked and indexed HTML pages) and/or PDF - from a set of rst source files. + It can generate complete web sites (interlinked and indexed HTML pages) + and/or PDF from a set of rst source files. * rst2ht_ by Oliver Rutherfurd, converts reStructuredText to an .ht template, for use with ht2html_. @@ -149,9 +149,11 @@ Others * restxsl_ by Michael Alyn Miller, lets you transform reStructuredText documents into XML/XHTML files using XSLT stylesheets. -* An `XSLT script`_ by Ladislav Lhotka enables reStructuredText annotations +* An `XSLT script`__ by Ladislav Lhotka enables reStructuredText annotations to be included in RELAG NG XML schemas. + __ http://www.cesnet.cz/doc/techzpravy/2006/rngrest/ + * `DocBook Writer`_ by Oliver Rutherfurd. * Nabu_, written by Martin Blais, is a publishing system which @@ -170,7 +172,10 @@ Others * For `confluence CMS`_ see https://github.com/cweiske/rst2confluence. -* Deploying into wikis might be aided by https://github.com/netresearch/deploy-rst. +* Deploying into wikis might be aided by deploy-rst__. + + __ https://github.com/netresearch/deploy-rst + Import ------ @@ -224,7 +229,7 @@ More extensions are in the `Docutils Sandbox`_. * zot4rst_ by Erik Hetzner is an extension that allows users to write reST documents using citations from a Zotero_ library. -* Quick and easy publishing reStructuredText source files as blog posts +* Quick and easy publishing reStructuredText source files as blog posts on blogger.com is possible with `rst2blogger`_ . Related Applications @@ -285,7 +290,6 @@ Presentations .. _PyLit: http://pylit.berlios.de .. _Pandoc: http://sophos.berkeley.edu/macfarlane/pandoc/ .. _restxsl: http://www.strangeGizmo.com/products/restxsl/ -.. _XSLT script: http://www.cesnet.cz/doc/techzpravy/2006/rngrest/ .. _ReSTedit: http://www.friday.com/bbum/index.php?s=restedit .. _ASCII art to SVG converter: http://docutils.sf.net/sandbox/cliechti/aafigure/ .. _LaTeX math for reST: diff --git a/docs/user/tools.txt b/docs/user/tools.txt index 110a8a49b..c7d7be4a9 100644 --- a/docs/user/tools.txt +++ b/docs/user/tools.txt @@ -301,7 +301,10 @@ rst2xml.py The ``rst2xml.py`` front end produces Docutils-native XML output. This can be transformed with standard XML tools such as XSLT -processors into arbitrary final forms. +processors into arbitrary final forms. An example is the xml2rst_ processor +in the Docutils sandbox. + +.. _xml2rst: ../../../sandbox/xml2rst ODF/OpenOffice-Generating Tools @@ -324,7 +327,14 @@ about how to use ``rst2odt.py``, the styles used ``rst2odt.py``, etc from `Odt Writer for Docutils <odt.html>`_. +reStructuredText-Generating Tools +================================= + +Currently, there is no reStructuredText writer in Docutils and therefore +an ``rst2rst.py`` tool is still missing. +To generate reStructuredText documents with Docutils, you can use +the XML (Docutils native) writer and the xml2rst_ processor. Testing/Debugging Tools |