diff --git a/doc/intro.rst b/doc/intro.rst index 69d49d94f..16dcb42b3 100644 --- a/doc/intro.rst +++ b/doc/intro.rst @@ -15,6 +15,25 @@ Though there is limited support for that kind of docs as well (which is intended to be freely mixed with hand-written content), if you need pure API docs have a look at `Epydoc `_, which also understands reST. + +Conversion from other systems +----------------------------- + +This section is intended to collect helpful hints for those wanting to migrate +to reStructuredText/Sphinx from other documentation systems. + +* Gerard Flanagan has written a script to convert pure HTML to reST; it can be + found at `Launchpad + `_. + +* For converting the old Python docs to Sphinx, a converter was written which + can be found at `the Python SVN repository + `_. It contains generic + code to convert Python-doc-style LaTeX markup to Sphinx reST, but also code + specific to the layout of the Python docs which needs to be removed in order + to be useful for other docs. + + Prerequisites -------------