Test runs are currently failing on a missing `xindy` binary.
Mend the situation by adding the required packages for rpm
and dpkg platforms.
As the test requires a recent version of `xindy` to work with
`xelatex` markup, bind the base job to a nodeset with recent
operating system release.
Change-Id: I461a8769af2a6879d1a96db13aa91fbc8ace8c54
Closes-Bug: #1792237
We recently switched to using python3, so let's add the files to
bindep.txt as well so that the packages get installed if needed.
Note this is a nop in OpenStack CI since python3 is available already.
But this is important to document dependencies.
Change-Id: Ic6c1c9adcec938c0db4f207d1d8e523e96ffe740
With the new openstackdocstheme used, we can simplify conf.py.
Also, update our docs for it.
Note that Sphinx 1.6 needs latexmk for building, add it.
Sphinx 1.6 introduces a few new warnings, fix them so that the guides
built.
Change-Id: If2e431725eb54f8be79b9fa4bf9ede2089f321a5
Since this repo is now completely RST docs based, we do not need the
tools for XML handling anymore, remove all the dependencies from
installation.
Add python-devel for RPM platforms.
Note that this test is self-testing - the new config will be used
directly in the OpenStack CI system.
Change-Id: I13f822b7f1f93fe16997c07671ea3ab18c006528
This commit proposes PDF generation with pdflatex.
Executing Sphinx with latex option generates .tex files will
be performed first, and pdflatex converts from .tex to .pdf files.
More details are as followings:
- Adds texlive related package binary dependency (>= Trusty)
: inkscape texlive-latex-base texlive-latex-extra
texlive-fonts-recommended
- build-rst.sh: --pdf option is added
- install-guide PDF support using --pdf option
- PDF support for serveral documents
: arch-design, cli-reference, ha-guide, ops-guide, user-guide,
networking-guide, arch-design-draft
(testable using like "tox -e build -- networking-guide --pdf")
- Intermidiate files for building .tex (required for converting into
.pdf) are stored in "build/pdf" folder.
Change-Id: I66242f44bb13f1a09be0904a491c84f42f25c3a2
Implements: blueprint build-pdf-from-rst-guides