Sphinx is a documentation generator which converts reStructuredText files into several formats, including HTML, LaTeX, PDF, EPub and man.

learn more… | top users | synonyms

0
votes
0answers
28 views

Include Sphinx-generated documentation in master file

I'm currently working on a project (for university) that will be documented with LaTeX. About one third of the documentation will be about a python module that I've written. I'm looking for a clean ...
1
vote
1answer
61 views

Argument of \@item has an extra }

I get the error ! Argument of \@item has an extra }. <inserted text> \par l.135 \emph{class} \bfcode{C}} when translating a LaTeX file generated by Sphinx documentation ...
1
vote
0answers
84 views

Setting default image dpi using sphinx and texi2pdf

In QGIS project, we are using Sphinx to create our documentation as HTML and PDF. We are having a bit of a problem with figures as they show a bit blurry in PDF. I found out that the reason is ...
4
votes
1answer
160 views

Tikz + Verbatim + Sphinx , output drawn twice with slight offset. Works great Tikz + Verbatim

I'm working on a piece of software that outputs IPython Notebooks as tex documents. One of my requirements is to be able to draw code input output blocks that look like the Notebook's UI. ...
5
votes
1answer
227 views

Including .tex files that need a different style file than the main text

EDIT: Substantial edit of the original version has been done to clarify the question. Background I've written two small python package manuals with sphinx (http://sphinx-doc.org/) a program that ...
2
votes
1answer
534 views

Writing conditional equations with braces in sphinx

I want to write conditional statement with one-sided curly brackets in Sphinx as shown below: In Latex, the best I could do is given below: \[ x = \begin{cases} \begin{split} ...
2
votes
1answer
353 views

error on generating pdf by Latex with CJK support

After adding unicode characters to \title{} micro: \title{标题} the following error occurs when running make all-pdf with a .tex file: Writing index file mybook.idx No file mybook.aux. ...
2
votes
1answer
306 views

How to modify the default LaTeX package parameters of Sphinx?

I want to generate pdf by using Sphinx. Sphinx generates pdf through LaTeX. But I have to add unicode=true to package hyperref of LaTeX: \usepackage[unicode=true]{hyperref} But Sphinx has generated ...
3
votes
1answer
81 views

Inter-word spacing issue with long code tags

I'm having an issue with the Sphinx Documentation Generator, you may be asking what this has to do with LaTeX. Well, we were hoping to use it for our specification documentation which needs to be ...
1
vote
1answer
507 views

Sphinx: Overriding the document class

I am using Sphinx to generate multi-output documents (Epub, HTML, LaTeX). How can I change the use documentclass? The following snippet should (in my opinion) override the used class but results in ...
2
votes
1answer
615 views

Changing fonts for heads and subheads in Sphinx LaTeX

In pdf export the AvantGarde font is used a lot for heads and subheads. I would like to use a modern font like Helvetica. Is it possible to just exchange AvantGarde with Helvetica. If possible I ...
10
votes
2answers
2k views

Set standard default scaling of \includegraphics

I am using Sphinx and the plantuml package to include UML diagrams. The plantuml package for Sphinx generates the following LaTeX code: \includegraphics{%s} Anyways - the diagrams are to big, so ...
1
vote
1answer
615 views

Override global page style? [duplicate]

Possible Duplicate: Change paper size in mid-document How can I use default \documentclass[a4paper] styles in Title page, index pages, header and footer - but the text itself as if I ...
6
votes
1answer
1k views

How to make latex recognize tick and cross symbols

I'm looking for a way of making latex recognize the tick and cross symbols as apposed to having to use commands in latex code to make these symbols. Is there anything you can add in the preamble that ...
1
vote
1answer
640 views

Sphinx in-line math equation alignment

As suggested by the answer to my question here, I am using the Sphinx tool in order to multi-target PDF and HTML output. For HTML, I'm using the pngmath extension. The vertical alignment of inline ...
6
votes
2answers
1k views

How to use Unicode characters with Sphinx rst documents and properly generate PDF files?

I discovered that if I use some Unicode characters inside .rst files, I will loose them when I convert the documentation to pdf using Sphinx. Example chars: "șț". When I run make latexpdf I get a ...