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

learn more… | top users | synonyms

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 ...
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 ...
5
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 ...
5
votes
1answer
198 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 ...
4
votes
1answer
143 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. ...
3
votes
1answer
78 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 ...
2
votes
1answer
474 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
249 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 ...
2
votes
1answer
557 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 ...
2
votes
1answer
319 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. ...
1
vote
1answer
47 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
1answer
592 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 ...
1
vote
1answer
612 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 ...
1
vote
1answer
442 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 ...
1
vote
0answers
81 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 ...