Starting with Sphinx and reStructuredText


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 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.