Fix doc, releasenotes plus build pdf

This patch enables building .pdf documentation using new 'pdf-docs'
tox environment. The newly created tox environment creates latex
source codes using sphinx-build and then builds the pdf
documentation using make.
The patch also fixes documentation to reflect change from openstack
to osf organization fixes copy-paste mistakes in the doc configs.

Change-Id: I15a03442c2a2c355c8e7f1658c1b2329eb38c7df
This commit is contained in:
Martin Kopec 2020-11-14 17:00:53 +00:00
parent fd593bd8b2
commit e8fac460b8
20 changed files with 118 additions and 15 deletions

View File

@ -9,6 +9,6 @@ based on your cloud.
- Free software: Apache license - Free software: Apache license
- Documentation: https://docs.openstack.org/python-tempestconf/latest/ - Documentation: https://docs.openstack.org/python-tempestconf/latest/
- Source: https://opendev.org/openstack/python-tempestconf - Source: https://opendev.org/osf/python-tempestconf
- Bugs: https://storyboard.openstack.org/#!/project/912 - Bugs: https://storyboard.openstack.org/#!/project/912
- Release notes: https://docs.openstack.org/releasenotes/python-tempestconf - Release notes: https://docs.openstack.org/releasenotes/python-tempestconf

View File

@ -2,3 +2,4 @@ openstackdocstheme>=2.2.0 # Apache-2.0
reno>=3.1.0 # Apache-2.0 reno>=3.1.0 # Apache-2.0
sphinx>=2.0.0,!=2.1.0 # BSD sphinx>=2.0.0,!=2.1.0 # BSD
sphinx-argparse>=0.2.2 # MIT sphinx-argparse>=0.2.2 # MIT
sphinxcontrib-svg2pdfconverter>=0.1.0 # BSD

View File

@ -21,13 +21,15 @@ extensions = [
'openstackdocstheme', 'openstackdocstheme',
#'sphinx.ext.intersphinx', #'sphinx.ext.intersphinx',
'sphinx.ext.autodoc', 'sphinx.ext.autodoc',
'sphinxcontrib.rsvgconverter',
'sphinxarg.ext' 'sphinxarg.ext'
] ]
html_theme = 'openstackdocs' html_theme = 'openstackdocs'
# openstackdocstheme options # openstackdocstheme options
openstackdocs_repo_name = 'openstack/python-tempestconf' openstackdocs_repo_name = 'osf/python-tempestconf'
openstackdocs_pdf_link = True
openstackdocs_use_storyboard = True openstackdocs_use_storyboard = True
# autodoc generation is a bit aggressive and a nuisance when doing heavy # autodoc generation is a bit aggressive and a nuisance when doing heavy
@ -70,10 +72,15 @@ htmlhelp_basename = '%sdoc' % project
# [howto/manual]). # [howto/manual]).
latex_documents = [ latex_documents = [
('index', ('index',
'%s.tex' % project, 'doc-%s.tex' % project,
u'%s Documentation' % project, u'%s Documentation' % project,
u'Red Hat, Inc.', 'manual'), u'Red Hat, Inc.', 'manual'),
] ]
latex_use_xindy = False
latex_elements = {
'extraclassoptions': 'openany,oneside',
}
# Example configuration for intersphinx: refer to the Python standard library. # Example configuration for intersphinx: refer to the Python standard library.
#intersphinx_mapping = {'http://docs.python.org/': None} #intersphinx_mapping = {'http://docs.python.org/': None}

View File

@ -7,7 +7,7 @@ Git
1. Clone and change to the directory:: 1. Clone and change to the directory::
$ git clone https://opendev.org/openstack/python-tempestconf $ git clone https://opendev.org/osf/python-tempestconf
$ cd python-tempestconf $ cd python-tempestconf
2. Create a virtual environment using :command:`virtualenv`:: 2. Create a virtual environment using :command:`virtualenv`::

View File

@ -8,7 +8,7 @@ based on your cloud.
- Free software: Apache license - Free software: Apache license
- Documentation: - Documentation:
https://docs.openstack.org/python-tempestconf/latest/ https://docs.openstack.org/python-tempestconf/latest/
- Source: https://opendev.org/openstack/python-tempestconf - Source: https://opendev.org/osf/python-tempestconf
- Bugs: https://storyboard.openstack.org/#!/project/912 - Bugs: https://storyboard.openstack.org/#!/project/912
- Release notes: https://docs.openstack.org/releasenotes/python-tempestconf - Release notes: https://docs.openstack.org/releasenotes/python-tempestconf

View File

@ -43,7 +43,7 @@ extensions = [
] ]
# openstackdocstheme options # openstackdocstheme options
openstackdocs_repo_name = 'openstack/python-tempestconf' openstackdocs_repo_name = 'osf/python-tempestconf'
openstackdocs_use_storyboard = True openstackdocs_use_storyboard = True
# Add any paths that contain templates here, relative to this directory. # Add any paths that contain templates here, relative to this directory.
@ -59,7 +59,8 @@ source_suffix = '.rst'
master_doc = 'index' master_doc = 'index'
# General information about the project. # General information about the project.
copyright = u'2016, OpenStack Foundation' project = 'python-tempestconf'
copyright = u'2016, Red Hat'
# The language for content autogenerated by Sphinx. Refer to documentation # The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages. # for a list of supported languages.
@ -182,7 +183,7 @@ html_static_path = ['_static']
# html_file_suffix = None # html_file_suffix = None
# Output file base name for HTML help builder. # Output file base name for HTML help builder.
htmlhelp_basename = 'GlanceReleaseNotesdoc' htmlhelp_basename = '%sReleaseNotesdoc' % project
# -- Options for LaTeX output --------------------------------------------- # -- Options for LaTeX output ---------------------------------------------
@ -202,8 +203,8 @@ latex_elements = {
# (source start file, target name, title, # (source start file, target name, title,
# author, documentclass [howto, manual, or own class]). # author, documentclass [howto, manual, or own class]).
latex_documents = [ latex_documents = [
('index', 'GlanceReleaseNotes.tex', u'Glance Release Notes Documentation', ('index', '%s.tex' % project, u'%s Release Notes Documentation' % project,
u'Glance Developers', 'manual'), u'Red Hat, Inc.', 'manual'),
] ]
# The name of an image file (relative to this directory) to place at the top of # The name of an image file (relative to this directory) to place at the top of
@ -232,8 +233,9 @@ latex_documents = [
# One entry per manual page. List of tuples # One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section). # (source start file, name, description, authors, manual section).
man_pages = [ man_pages = [
('index', 'glancereleasenotes', u'Glance Release Notes Documentation', ('index', '%sReleasenotes' % project,
[u'Glance Developers'], 1) u'%s Release Notes Documentation' % project,
[u'Red Hat, Inc.'], 1)
] ]
# If true, show URL addresses after external links. # If true, show URL addresses after external links.
@ -246,9 +248,10 @@ man_pages = [
# (source start file, target name, title, author, # (source start file, target name, title, author,
# dir menu entry, description, category) # dir menu entry, description, category)
texinfo_documents = [ texinfo_documents = [
('index', 'GlanceReleaseNotes', u'Glance Release Notes Documentation', ('index', '%sReleaseNotes' % project,
u'Glance Developers', 'GlanceReleaseNotes', u'%s Release Notes Documentation' % project,
'One line description of project.', u'Red Hat, Inc.', '%sReleaseNotes' % project,
'%s will automatically generate the tempest configuration.' % project,
'Miscellaneous'), 'Miscellaneous'),
] ]

View File

@ -6,3 +6,15 @@
:maxdepth: 1 :maxdepth: 1
unreleased unreleased
v3.0.0
v2.5.0
v2.4.0
v2.3.0
v2.2.1
v2.2.0
v2.1.0
v2.0.0
v1.1.4
v1.1.2
v1.1.0
v1.0.0

View File

@ -0,0 +1,6 @@
====================
v1.0.0 Release Notes
====================
.. release-notes:: 1.0.0 Release Notes
:version: 1.0.0

View File

@ -0,0 +1,6 @@
====================
v1.1.0 Release Notes
====================
.. release-notes:: 1.1.0 Release Notes
:version: 1.1.0

View File

@ -0,0 +1,6 @@
====================
v1.1.2 Release Notes
====================
.. release-notes:: 1.1.2 Release Notes
:version: 1.1.2

View File

@ -0,0 +1,6 @@
====================
v1.1.4 Release Notes
====================
.. release-notes:: 1.1.4 Release Notes
:version: 1.1.4

View File

@ -0,0 +1,6 @@
====================
v2.0.0 Release Notes
====================
.. release-notes:: 2.0.0 Release Notes
:version: 2.0.0

View File

@ -0,0 +1,6 @@
====================
v2.1.0 Release Notes
====================
.. release-notes:: 2.1.0 Release Notes
:version: 2.1.0

View File

@ -0,0 +1,6 @@
====================
v2.2.0 Release Notes
====================
.. release-notes:: 2.2.0 Release Notes
:version: 2.2.0

View File

@ -0,0 +1,6 @@
====================
v2.2.1 Release Notes
====================
.. release-notes:: 2.2.1 Release Notes
:version: 2.2.1

View File

@ -0,0 +1,6 @@
====================
v2.3.0 Release Notes
====================
.. release-notes:: 2.3.0 Release Notes
:version: 2.3.0

View File

@ -0,0 +1,6 @@
====================
v2.4.0 Release Notes
====================
.. release-notes:: 2.4.0 Release Notes
:version: 2.4.0

View File

@ -0,0 +1,6 @@
====================
v2.5.0 Release Notes
====================
.. release-notes:: 2.5.0 Release Notes
:version: 2.5.0

View File

@ -0,0 +1,6 @@
====================
v3.0.0 Release Notes
====================
.. release-notes:: 3.0.0 Release Notes
:version: 3.0.0

View File

@ -44,6 +44,14 @@ commands =
deps = -r{toxinidir}/doc/requirements.txt deps = -r{toxinidir}/doc/requirements.txt
commands = sphinx-build -b html doc/source doc/build/html commands = sphinx-build -b html doc/source doc/build/html
[testenv:pdf-docs]
deps = {[testenv:docs]deps}
whitelist_externals =
make
commands =
sphinx-build -W -b latex doc/source doc/build/pdf
make -C doc/build/pdf
[testenv:releasenotes] [testenv:releasenotes]
deps = -r{toxinidir}/doc/requirements.txt deps = -r{toxinidir}/doc/requirements.txt
commands = commands =