70cef7f849
Sphinx 1.8 introduced [1] the '--keep-going' argument which, as its name suggests, keeps the build running when it encounters non-fatal errors. This is exceptionally useful in avoiding a continuous edit-build loop when undertaking large doc reworks where multiple errors may be introduced. [1] https://github.com/sphinx-doc/sphinx/commit/e3483e9b045 Change-Id: Ief136815d6a0e1dfa0b8d1ffb42500fef38e39fe
Team and repository tags
OpenStack Doc Tools
This repository contains tools used by the OpenStack Documentation project.
For more details, see the OpenStack Documentation Contributor Guide.
- License: Apache License, Version 2.0
- Source: https://opendev.org/openstack/openstack-doc-tools
- Bugs: https://bugs.launchpad.net/openstack-doc-tools
Prerequisites
You need to have Python 2.7 installed for using the tools.
This package needs a few external dependencies including lxml. If you do not have lxml installed, you can either install python-lxml or have it installed automatically and build from sources. To build lxml from sources, you need a C compiler and the xml and xslt development packages installed.
To install python-lxml, execute the following based on your distribution.
On Fedora, RHEL 7, and CentOS 7:
$ yum install python-lxmlOn openSUSE:
$ zypper in python-lxmlOn Ubuntu:
$ apt-get install python-lxmlFor building from source, install the dependencies of lxml.
On Fedora, RHEL 7, and CentOS 7:
$ yum install python-devel libxml2-devel libxslt-develOn openSUSE:
$ zypper in libxslt-develOn Ubuntu:
$ apt-get install libxml2-dev libxslt-dev