dd02f75d56
The is one of community goals that each project could produce a single PDF file. The pdf should be in the output of openstack-tox-docs job. The list of changes: - add a new pdf-docs environment to enable PDF build, - sphinxcontrib-svg2pdfconverter is used to handle SVG properly, - poke versions for sphinx and openstackdocstheme, - disable usage of xindy for tex, - do not generate empty pages, - only build html for toctree and other content-less for pdf sections, - adjust README to firstly contain "About tripleo" then team & repo tags for the better view in PDF-generated contents. - move the Contributing chapter closer to the beginning for the better view in the long list of generated contents. More about the goal: https://governance.openstack.org/tc/goals/train/pdf-doc-generation.html https://etherpad.openstack.org/p/train-pdf-support-goal https://etherpad.openstack.org/p/pdf-goal-train-common-problems TeX and few more packages may be needed to build PDF locally (listed for bindep): inkscape [doc platform:dpkg] fonts-liberation [doc platform:dpkg] texlive-latex-base [doc platform:dpkg] texlive-latex-extra [doc platform:dpkg] texlive-xetex [doc platform:dpkg] texlive-fonts-recommended [doc platform:dpkg] xindy [doc platform:dpkg] latexmk [doc platform:dpkg] texlive [doc platform:rpm] texlive-fncychap [doc platform:rpm] texlive-titlesec [doc platform:rpm] texlive-tabulary [doc platform:rpm] texlive-framed [doc platform:rpm] texlive-wrapfig [doc platform:rpm] texlive-upquote [doc platform:rpm] texlive-capt-of [doc platform:rpm] texlive-needspace [doc platform:rpm] texlive-polyglossia [doc platform:rpm] latexmk [doc platform:rpm] python3-sphinxcontrib-svg2pdfconverter-common [doc platform:rpm] librsvg2-tools [doc platform:rpm] librsvg2-bin [doc platform:dpkg] Change-Id: Ib3bb34191582f581c28f2f8a0281cf3ae44003e8 Signed-off-by: Bogdan Dobrelya <bdobreli@redhat.com>
13 lines
600 B
ReStructuredText
13 lines
600 B
ReStructuredText
If you would like to contribute to the development of OpenStack,
|
|
you must follow the steps in the "If you're a developer, start here"
|
|
section of `How To Contribute Guide <https://wiki.openstack.org/wiki/How_To_Contribute>`_.
|
|
|
|
Once those steps have been completed, changes to OpenStack
|
|
should be submitted for review via the Gerrit tool, following
|
|
the documented `Development Workflow <https://docs.openstack.org/infra/manual/developers.html>`_.
|
|
|
|
Pull requests submitted through GitHub will be ignored.
|
|
|
|
Bugs should be filed on `TripleO at Launchpad <https://bugs.launchpad.net/tripleo>`_
|
|
not GitHub.
|