With sphinx release of 5.0.0, they changed default for language variable
to 'en' from None. With that current None valuable is not valid and should
not be used.
Change-Id: Ieb0129ffb8964eba380a5d829e4033f19c892451
The sync from https://review.opendev.org/733244 updated to
openstackdocstheme 2.2.1 and reno 3.1.0 versions.
Set openstackdocs_pdf_link to link to PDF file. Note that
the link to the published document only works on docs.openstack.org
where the PDF file is placed in the top-level html directory. The
site-preview places the PDF in a pdf directory.
openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.
See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html
Change-Id: I661ea2f75fdd0cac7ab57bea378a58e31e204cfe
New version of openstackdocstheme (Victoria+) respects pygments_style.
Since this repo is using now Victoria (master) requirements but has
not branched for Ussuri yet, it uses the new version.
Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.
Change-Id: I5fbadb836d7e1533f949601431fc5deacaec64b3
This repo is now testing only with Python
3, so let's make a few cleanups:
- Remove setup.* files, they are not needed for this repo
- Cleanup */source/conf.py to remove noww
obsolete content.
- Remove install_cmd, move constraints into deps.
Change-Id: I1ae008c4a959cfd6a834ccb05353027c45e3e696
This patch adds a `pdf-docs` tox target that will build
PDF versions of our docs. As per the Train community goal:
https://governance.openstack.org/tc/goals/selected/train/pdf-doc-generation.html
Add sphinxcontrib-svg2pdfconverter to doc/requirements.txt
to convert our SVGs.
Change-Id: If2171bb5ce432ca4576aad85b2b47ea830b8e6a0
Story: 2006105
sphinxmark is no longer compatible with the latest release of Sphinx
which is causing all of our documentation jobs to fail. This patch
removes it as our current usage of openstacktheme for documentation
already provides watermarks for current branch and notices for which
branch the documentation covers.
Change-Id: I4b4aabb6665567b944fe4da6d0ba834e4769ec68
This reverts commit 0aa4981305.
The repo_server and repo_build shouldn't assume to be configured
by openstack_hosts role yet, because their environment is incomplete.
On top of that, when artifacting will be introduced, these roles could
be running outside the openstack hosts (for example, on deploy nodes).
Change-Id: I47a58a46a695b504646bca8100758decb07cbb98
With addition of pip_install on every node, we don't
need to have pip_install as a meta dependency.
Depends-On: If3412bb888ebb854874bbc43eb76bfcb3e4a7868
Depends-On: I79ff70c438b44753be2a93f004ebbc46de0a963d
Change-Id: Iba21b464fc740639f2653a00d5bac7aff35b9a37
This patch implements an initial set of jobs intended to match
the current job execution method. It does not intend to improve
how the jobs are executed - only to replicate what is currently
in openstack-infra/openstack-zuul-jobs and provide the platform
to iterate on.
Change-Id: Ifa650996eb87c6519ea3dfc449ebde92a8d7802d
Currently when clicking on the small bug in the roles'
docs, we land on openstack-manuals launchpad.
This should solve it.
Change-Id: I3d61d6f6d3facc4becc3cfbe379f5406d32283a3
The 'docs' tox target executes the doc8 lint test which may result in
failures when testing documentation builds, but OpenStack-CI does not
execute that tox target.
In order to ensure that we catch all standard documentation syntax
errors and prevent them from merging, this patch includes the docs
target in the 'linters' chain of tests.
Fixes for any failures which result from executing this test are also
included in the patch.
Change-Id: I2789be3c39171c496d7b84ba30a10dd8adb80225
This patch updates the sphinx configuration for docs and releasenotes
to make it easier to replicate across repositories and to comply with
pep8 testing without exceptions.
Change-Id: I2ff29321fdef8e1b07c55a21f10aa4fd1047edba