Tools used by OpenStack Documentation
![]() Do not give sphinx-build as single argument, split it up. tox 2.5.0 currently complains that it cannot find "sphinx-build arg1 arg2" - so, pass this properly now. Add releasenote for this. Change-Id: I5da1d06866c16a8c56be23e87817d163b28803a8 |
||
---|---|---|
autogenerate_config_docs | ||
bin | ||
cleanup | ||
doc/source | ||
os_doc_tools | ||
releasenotes | ||
sitemap | ||
.gitignore | ||
.gitreview | ||
.mailmap | ||
.testr.conf | ||
CONTRIBUTING.rst | ||
doc-test.conf.sample | ||
HACKING.rst | ||
LICENSE | ||
MANIFEST.in | ||
openstack-common.conf | ||
pylintrc | ||
README.rst | ||
RELEASE_NOTES.rst | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
test-requirements.txt | ||
tox.ini |
OpenStack Doc Tools
This repository contains tools used by the OpenStack Documentation project.
For more details, see the OpenStack Documentation wiki page.
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:
$ yum install python-lxml
On openSUSE:
$ zypper in python-lxml
On Ubuntu:
$ apt-get install python-lxml
For building from source, install the dependencies of lxml.
On Fedora:
$ yum install python-devel libxml2-devel libxslt-devel
On openSUSE:
$ zypper in libxslt-devel
On Ubuntu:
$ apt-get install libxml2-dev libxslt-dev
- License: Apache License, Version 2.0
- Source: http://git.openstack.org/cgit/openstack/openstack-doc-tools
- Bugs: http://bugs.launchpad.net/openstack-manuals