DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
Introduction¶
What does it do?¶
This extension lets you build documentation projects written with Sphinx (the Python Documentation Generator used by the TYPO3 documentation team for all official documentation) from within the TYPO3 backend:
Sphinx was originally created for the Python documentation and a few features are worth highlighting:
- Output formats: HTML, JSON (a derivate from HTML :ter:`restdoc` is relying on), LaTeX (for printable PDF versions), plain text, ...
- Extensive cross-references: semantic markup and automatic links for citations, glossary terms and similar pieces of information. For instance, the official TYPO3 documentation provides resources to cross-link from your own documentation to virtually any chapter or section of any TYPO3 documentation. Please consult page Tips and Tricks in the TYPO3 wiki for more information.
- Hierarchical structure: easy definition of a document tree, with automatic links to siblings, parents and children
- Automatic index: general index of terms used in your documentation
- Extensions: the tool lets you extend it with your own modules
And this extension?¶
Setting up a Sphinx environment to build documentation may be complicated for some users. This extension takes for granted that Python interpreter is available on your web server and will install and configure Sphinx locally (thus in your website) in a few clicks.
In addition, this extension comes with a few goodies such as:
- Backend documentation viewer
- Backend module to kickstart and render custom documentation project
- Extends TYPO3 6.2 to render extension manuals on demand
- Integrated reStructuredText editor
- Wizard to convert an OpenOffice document (
manual.sxw
) to a Sphinx project (using an online tool on https://docs.typo3.org)
What can I do with a Sphinx project?¶
A lot! And above all, if you compile your documentation as JSON, you may easily integrate it to your website. Best way is to use TYPO3 extension :ter:`Sphinx Documentation Viewer Plugin (restdoc) <restdoc>`.