table of contents
other versions
OPENSTACK-DOC-TEST(1) | OpenStack-doc-tools | OPENSTACK-DOC-TEST(1) |
NAME¶
openstack-doc-test - OpenStack documentation tools
OPENSTACK VALIDATION TOOL¶
SYNOPSIS¶
openstack-doc-test [options]
DESCRIPTION¶
openstack-doc-test allows to test the validity of the OpenStack documentation content.
OPTIONS¶
General options
- --api-site
- Special handling for api-site and other API repositories to handle WADL.
- --build-file-exception BUILD_FILE_EXCEPTION
- File that will be skipped during delete and build checks to generate dependencies. This should be done for invalid XML files only.
- --check-build
- Try to build books using modified files.
- --check-deletions
- Check that deleted files are not used.
- --check-links
- Check that linked URLs are valid and reachable.
- --check-niceness
- Check the niceness of files, for example whitespace.
- --check-syntax
- Check the syntax of modified files.
- --check-all
- Run all checks (default if no arguments are given).
- --config-file PATH
- Path to a config file to use. Multiple config files can be specified, with values in later files taking precedence.
- --debug
- Enable debug code.
- --file-exception FILE_EXCEPTION
- File that will be skipped during niceness and syntax validation.
- --force
- Force the validation of all files and build all books.
- -h, --help
- Show help message and exit.
- --ignore-dir IGNORE_DIR
- Directory to ignore for building of manuals. The parameter can be passed multiple times to add several directories.
- --language LANGUAGE, -l LANGUAGE
- Build translated manual for language in path generate/$LANGUAGE .
- --only-book ONLY_BOOK
- Build each specified manual.
- --parallel
- Build books in parallel (default).
- --print-unused-files
- Print list of files that are not included anywhere as part of check-build.
- --publish
- Setup content in publish-docs directory for publishing to external website.
- --verbose
- Verbose execution.
- --version
- Output version number.
FILES¶
Reads the file doc-test.conf in the top-level directory of the git repository for option processing.
Building of books will generate in the top-level directory of the git repository:
- a directory publish-docs with a copy of the build results.
- for each book build a log file named build-${book}.log.gz.
SEE ALSO¶
- •
- OpenStack Documentation
Bugs¶
- •
- openstack-doc-tools is hosted on Launchpad so you can view current bugs at Bugs : openstack-doc-tools
AUTHOR¶
OpenStack
COPYRIGHT¶
2018, OpenStack Foundation
August 23, 2018 |