This patch series fix Sphinx to allow it to build the media documentation as a
PDF
file.
The first patch is actually a bug fix: one of the previous patch broke
compilation
for PDF as a hole, as it added an extra parenthesis to a function call.
The second patch just removes a left over code for rst2pdf.
The other patches change from "pdflatex" to "xelatex" and address several
issues that prevent building the media books.
Jon,
I think this patch series belong to docs-next. Feel free to merge them there, if
you agree. There's one extra patch that touches Documentation/conf.py,
re-adding the media book to the PDF build, but IMHO this one would be better
to be merged via the media tree, after the fixes inside the media documentation
to fix the build.
I'm sending the media-specific patches on a separate patch series, meant to
be merged via the media tree.
As on the previous experimental patch series, I'm pushing the entire stuff
on my development tree, at:
https://git.linuxtv.org//mchehab/experimental.git/log/?h=docs-next
The generated PDF file is at:
https://mchehab.fedorapeople.org/media.pdf
Please notice that lots of tables are broken. Fixing them would require manual
work, as we'll need to add tags to specify the column size via tabularcolumns,
long tables should use the cssclass:: longtable, and very wide tables will need
to be rotated and size-adjusted.
Anyway, at least *some* PDF support for media books are now possible.
Mauro Carvalho Chehab (9):
docs-rst: fix a breakage when building PDF documents
docs-rst: remove a rst2pdf left over code
docs-rst: allow generating some LaTeX pages in landscape
docs-rst: improve output for .. notes:: on LaTeX
docs-rst: Don't mangle with UTF-8 chars on LaTeX/PDF output
docs-rst: better adjust margins and font size
docs-rst: parse-heraders.pl: escape LaTeX characters
docs-rst: Don't go to interactive mode on errors
docs-rst: enable the Sphinx math extension
Documentation/Makefile.sphinx | 8 ++---
Documentation/conf.py | 66 +++++++++++++++++++++++++++++------
Documentation/sphinx/parse-headers.pl | 2 +-
3 files changed, 60 insertions(+), 16 deletions(-)
--
2.7.4
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
