Starting with Sphinx and reStructuredText

Note

Don't know how to start with reStructuredText and Sphinx? You may want to check this reStructuredText Primer for TYPO3 Users. This is a brief introduction to reStructuredText (reST) concepts and syntax, intended to provide writers with enough information to author documents productively.

A few links to get started with Sphinx projects and reStructuredText:

Tips and tricks for PDF rendering

PDF rendering on https://docs.typo3.org is using LaTeX as described in chapter Rendering PDF from reStructuredText. As such, you should restrict yourself to using images either as JPG (image/jpeg) or PNG (image/png) and never use images as GIF (image/gif) which will hinder the PDF generation.