I'm converting a 200 pages manual from MS Word to Sphinx - a bit of an adventure! My goal in doing this is to be able to produce both HTML and PDF (via the latexpdf builder) from the same source. Unfortunately, I keep running into inconsistencies between these two generators that make it difficult or impossible to get acceptable output from both. Here's a sampling of things I've run into.
* The PDF output appends "Figure #:" before the caption of every figure. HTML output does. * When I include a "bibliography" directive, the PDF automatically adds a title above it and an entry for it in the table of contents. The HTML does neither. * The position of the "toctree" directive within index.rst has a completely different meaning for the two formats. For HTML, it determines the position of the table of contents relative to the rest of the text in that file. For PDF, the table of contents always appears before all text in that file. Instead, it determines the position of all text in all other files mentioned in the toctree relative to the text in index.rst. * I can easily customize the HTML formatting: just use a "compound" or "rst-class" directive to assign a class to any part of the document, then adjust it through the style sheet. Not so with PDF. As far as I can tell, that builder completely ignores those directives. They have no effect on the generated LaTeX. Am I missing something? Surely I'm not the first person to run into these things. Is there a recommended strategy for writing my documentation so I can get acceptable output in both formats? Thanks for your help! Peter -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/groups/opt_out.
