Walter A. Boring IV e10b094db4 Add pdf documentation build in tox
This patch adds a new tox job/command for building the pdf version
of documentation.

tox -epdf-docs

In addition to adjusting the infra requirement for PDF build support,
the following changes are made to build a PDF doc.

- Inline sample config file is skipped for PDF doc
  to avoid an LaTeX error "TeX capacity exceeded".
- Download link of sample config and policy files are disabled
  for PDF doc as relative links do not make sense.
- "Search" and "genindex" page is only enabled for HTML doc
  as they work only for HTML doc.

Co-Authored-By: Akihiro Motoki <amotoki@gmail.com>
Change-Id: Ib8ce96f4d043dcf0cfe6d3f8b64879f07bc5958c
2019-08-28 20:37:56 +00:00

21 lines
538 B
ReStructuredText

===========
cinder.conf
===========
The ``cinder.conf`` file is installed in ``/etc/cinder`` by default.
When you manually install the Block Storage service, the options in the
``cinder.conf`` file are set to default values.
.. only:: html
The sample configuration file can also be viewed in
`file form <../../../_static/cinder.conf.sample>`_.
.. literalinclude:: ../../../_static/cinder.conf.sample
:language: ini
.. only:: latex
See the on-line version of this documentation for the full example
config file.