Ica6524895e38e1e54ae3207a1e58a97f53481a12
addressed Sphinx 8.x warnings related to
representing paths as strings
on python 3.9 we clamp sphinx to <8 because
8.0.0 bumps the min python to 3.10
this change bumps the sphinx version check from >= 7.0
to >=8.0 to aling it with the versions we use on py3.9
Change-Id: I62784d7ea2a7c3bee4727bc4bc05d22699f7bbc7
This is a little more realistic. Sphinx 6.0.0 was released in December
2022 [1]. In the absence of a lower-constraints job, I manually tested
that our own docs still build with this version.
[1] https://pypi.org/project/Sphinx/6.0.0/
Change-Id: I62dcc47b7053deb46139ca1f46c0d8e6fc2720d6
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
Resolve the following warning:
RemovedInSphinx90Warning: Sphinx 9 will drop support for representing
paths as strings. Use "pathlib.Path" or "os.fspath" instead.
Change-Id: Ica6524895e38e1e54ae3207a1e58a97f53481a12
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
We migrate 'hacking' from a local plugin to hacking's native plugin,
which has been around for some time now. We also stop setting the
default Python version: everything is Python 3 nowadays.
Change-Id: I50d2f0c9ac5808c2c91ecae978c80212ea9e6859
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
Zuul deprecated usage of perl-style regex.
```
All regular expressions must conform to RE2 syntax, but an
expression using the deprecated Perl-style syntax has been detected.
Adjust the configuration to conform to RE2 syntax.
```
Change-Id: Id6b8fbf145b7e933ce2e82cebbe3d6c9531943b6
Versions older than Zed are now either Unmaintained or EOL. In order to
avoid readers selecting those versions by mistake, bump the default
value for earliest_published_series from mitake to zed. Documentation
for older versions is still published and accessible via direct links.
Projects that want their readers to still access older documentation via
the version selector can do so by overriding the
earliest_published_series value in their docs config.
Change-Id: I5a0cfcdc787f7fcf814526de761ea54479ab30db
Currently series names like 2023.1 and later appear at the end of the
version selector, but they are the most recent releases and thus should
be sorted to appear at the beginning.
Also make sure that a series doesn't appear twice in the list, which can
currently happen if e.g. the stable/victoria and unmaintained/victoria
branches exist at the same time during the transition.
Change-Id: Ide82c6de41081b9adcea632e41a581db5bc340c4
Since stable/yoga renamed to unmaintained/yoga the version is not
shown in the dropdown list of the available versions on the
https://docs.openstack.org in almost all projects. This change fixes
the issue.
Change-Id: I4f5f1bec04be3152c0f23ac17e450a1fd6fe91d4
Signed-off-by: Maksim Malchuk <maksim.malchuk@gmail.com>
Environment.srcdir is now a pathlib.Path object rather than string [1].
[1] https://github.com/sphinx-doc/sphinx/commit/49d8304670
Change-Id: Ifd26e2dd2fa36bbc9b0335db08e698db638de26d
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
The intention here was probably to include basic.css from Sphinx'
basic theme, but the correct way to reference it is just "basic.css".
This is what sphinx/themes/basic/theme.conf in Sphinx itself does.
Using "css/basic.css" caused the file to be not copied, and the
reference was 404.
Change-Id: Ifd6a78cb2dce42027f404829e1865fdb90acdb4f
Now that we inherit from basic/layout.html, these files are included
automatically in scripts block, so no need to repeat them in footer.
Also, underscore.js is not shipped anymore in Sphinx ≥ 6, so including
it caused a broken reference.
Change-Id: If0ffae7ced13d68380570a7eee949ac6e06c1743
The 'href' attribute is not valid for a <button> element, while the
'aria-labelledby' attribute must point to a valid element. It does not.
While we're here, we also fix indentation.
Change-Id: I3e15062b0f0306fbdc2ef82376a07e2b6943aeda
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
A <li> HTML element "must be contained in a parent element: an ordered
list (<ol>), an unordered list (<ul>), or a menu (<menu>)." [1]
[1] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li
Change-Id: I9920b63d7dda2051ecfd4865cab4187533f70c07
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
In change I48b923a67010c92945c46ab00de0b090ba7cd465, way back in 2016,
we started hiding duplicate titles caused by us including the first h1
title we found at the top of the page. Unfortunately, the fix for this
was to hide *all* h1 titles found in the main docs body. Sphinx doesn't
insist on only a single h1 title (in fact, the sphinx-quickstart tool
produces an index.rst with two h1 titles) which means we were hiding a
lot of information unwittingly. Fix this by only hiding the first title,
as originally intended.
Also replace deprecated whitelist_externals by allowlist_externals
in tox.ini.
Change-Id: Ic8fc5e1256b4ab8925401fe6781210729a68d2aa
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
The footers haven't been refreshed in a while. Preferred links for
some things have changed, particularly since the foundation's
rename. Some of the old links in here have stopped working entirely.
Brush up everything to be more consistent with what's on the
foundation-maintained www.openstack.org site.
Change-Id: Iadc7642adb5d7e614ac022bd370bf46386a595e0
In Zed cycle testing runtime, we are targetting to drop the
python 3.6/3.7 support, project started adding python 3.8 as minimum,
example nova:
- 56b5aed08c/setup.cfg (L13)
Also indicates that we support python 3.9.
Change-Id: I55076ba0d27c5725e7bfe1db94758098598133d6
The top level MARKETPLACE link in many projects is broken.
It currently shows as: https://www.openstack.orgmarketplace/
This PR adds the missing forward slash.
Change-Id: I9da6ecf8c18546a9314b62b49058399f63de343a
changed links/texts to avoid sending people to the old Summit site
Signed-off-by: smarcet <smarcet@gmail.com>
Change-Id: I4fd61417093a1e452fbe3baf50d523e430e81142
The OpenStack project documentations pages that implement the "Search"
capability (:ref: 'search') are not working after the recent update to
sphinx 3.4.x. The search will never end and the browser will report a
Uncaught ReferenceError: Stemmer is not defined error.
This patch updates the openstackdocstheme to fix the search capability
by including the language_data.js that now provides the "Stemmer" function.
Closes-Bug: #1957717
Change-Id: If54b3b253ed7585f6f8b20f1e0f945101ef283a3
Previous commits addrressed some of the changes of Sphinx4 producting
different structure. The same is valid for the page heading where
instead of `<div class="section">` it produces `<section>`. This leads
to the css fix not to be appled and as such page heading present 2
times. Copy previous css fix with new path.
Change-Id: Ia9ab413280c2f98d041e0f5ae5c1df22c5a4a3f5
Sphinx 4.x changed how it includes some JavaScript files. Instead of
including them via the template, they are now injected using the
'add_js_file' function [1]. This relies on a custom Jinja2 function,
'js_tag' to generate the correct element with necessary attributes set.
Failure to use this results in missing attributes for some tags.
Rather than simply reworking our template to use this new function,
change how we use our 'layout.html' to instead override the 'basic'
template that Sphinx provides. This means we should get these kinds of
changes "for free" in the future, rather than having to worry about
them.
[1] https://github.com/sphinx-doc/sphinx/commit/a957d6f710
Change-Id: Idc0e6c1d38407fdadc29ea710069e74243c5c89a
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
Sphinx 4.0 includes a newer version of docutils, which makes some
changes to the HTML 5 writer. Among these is the change in HTML
generated for the 'ObjectDescription' directive, which is used to
generate definition-list style output for things like oslo.config.
Previously, the title of each entry would be styled like so:
<dt id="DEFAULT.internal_service_availability_zone">
<code class="sig-name descname">
<span class="pre">internal_service_availability_zone</span>
</code>
</dt>
Now the improper use of the 'code' element is dropped, in favour of a
'span', like so:
<dt class="sig sig-object oslo.config" id="DEFAULT.internal_service_availability_zone">
<span class="sig-name descname">
<span class="pre">internal_service_availability_zone</span>
</span>
...
</dt>
Change-Id: I9fb9fbce6299600c3085bea1b8f17ad796bec4f8
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
Commit 93cf1a57d [1] added a new parameter, 'name', to this function.
Include that when we detect Sphinx 4.x in use.
[1] https://github.com/sphinx-doc/sphinx/commit/93cf1a57d
Change-Id: I3b05df39f701280052d8a0d4f261e8749669ca11
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
Setuptools v54.1.0 introduces a warning that the use of dash-separated
options in 'setup.cfg' will not be supported in a future version [1].
Get ahead of the issue by replacing the dashes with underscores. Without
this, we see 'UserWarning' messages like the following on new enough
versions of setuptools:
UserWarning: Usage of dash-separated 'description-file' will not be
supported in future versions. Please use the underscore name
'description_file' instead
[1] https://github.com/pypa/setuptools/commit/a2e9ae4cb
Change-Id: I37ca13f2f2f0f5a063e64d389a30f3b61e6c25f0
Updated Nav Menu to match https://www.openstack.org/ nav Menu
Signed-off-by: smarcet <smarcet@gmail.com>
Change-Id: Ib4e13a7964d548ed6bd9da683c4b755188ae7d6a
StarlingX is using the rST rubric directive to style headings such as
'Prerequisites', 'Procedure', and 'Results' in tasks without having them
appear in the TOC. There is currently no support for rubrics in the
StarlingX theme. This file appears to be the correct place to add it.
Testing to see if merge is picked up by StarlingX tox builds.
Change-Id: Ia339ad02522891c2b0b593dc782b67220565b87f
Signed-off-by: Stone <ronald.stone@windriver.com>
OpenStack Foundation got renamed to Open Infrastructure Foundation,
follow the rename and update links as well.
Remove no longer working links.
Change-Id: Iee3bb16fb6554ad80a3263f4f364976bcb8c88e1