the rename to neutronclient has been some time ago already. Also
the link was pointing to swift instead, which seems like an obvious
copy&paste mistake.
Change-Id: I2596e7500dedd01caa624377633754bf4a56fb48
When subprocess is monkey-patched using eventlet, trying to catch
subprocess.CalledProcessError exception won't work [1]. This breaks
doc build from a tarball, so let's catch all exceptions.
[1] https://github.com/eventlet/eventlet/issues/357
Change-Id: Ibcf535c6e4994a67fc3ec71631a81ecb91dd2845
Closes-Bug: #1693148
Amended developer documentation side navigation to add an option for
clearly returning to the project developer documentation home page.
Previously it was possible to return to the home page by clicking
'table of contents' however this is not obvious and makes it hard
to get around the complete project documentation once you have left
the homepage.
This patch removes the link from 'table of contents' which is
misleading, and a link is added beneath this header to say 'Return
to project home page'.
Change-Id: I7cf96acead62f00224ca9217a80760b4a65d42d6
Closes-bug: #1666323
Sphinx supports various notice blocks but the oslosphinx theme
does support only warning and note. openstackdoctheme used by
openstack-manuals project supports 'important', 'tip' and 'caution'
blocks. It would be nice if oslosphinx support these notices.
It reduces confusions on contributors to both types of projects.
Change-Id: I3e1db551b05fa681520763c24e2576f9ad5379d8
When git cmd fails, raw_version_list is set to empty 'str' and then
we are trying to decode it. This patch moves decoding inside try/catch
block, so we are decoding return value of subprocess call, which is bytes
in Python 3.
Change-Id: Ibd2f556355a6413beb21473ebfca3b836cbc1d73
Adds a new option that allows the "Other Versions" section to be removed
if a project isn't interested in showing links to older versions. The
default value is False which means that it will be hidden.
Even though the setting is not backward compatible there are enough
broken documentation links in the OpenStack projects that this should be
opt-in behavior.
Change-Id: Ic4b47b19aa9db38557c37aed7722174b7dbdf4a1
Closes-Bug: #1599260
Make the first one link to the current docs and the others
link with the appropriate prefix.
Filtered out previous versions that include "rc".
The number of versions is kept at 5 (current + 4 recent).
Closes-Bug: #1589731
Change-Id: I3a2e219913fc2c89634bcc2a757ccb4d3510883a
When later used the current code will break in
python3 due to:
TypeError: 'str' does not support the buffer
interface
Change-Id: I11572dd510ce8255ed66de56d5d9000755f7fee2
The last five tags (that start with a number) are used as version
numbers and linked to. This updates the sphinx extension so that
every user of the theme gets this info automatically with no need
to update the conf.py on a per-project basis.
Change-Id: I9bf17872bd23bed3cab9b5e2349d615c7001cb66
subprocess raises OSError if the command it is asked to run isn't found,
so trap that as well as the subprocess-specific error we were already
catching.
Change-Id: Ieb9c7f3ccc307250847104a7f97cfa28603fcf5d
Closes-Bug: #1521541
subprocess.check_output returns bytes, so we end up using '+' on a text
string (CGIT_BASE) and bytes (the output of parsed.path) in
_guess_cgit_link. Make sure we decode 'git_remote' in Python 3.
Change-Id: I9e846e2192ead41ca2328b8aa20994742096c51e
Closes-Bug: #1517525
The event handler should return a replacement template *name* or None.
Since we don't want to change the template, return None.
Change-Id: I3012ad22505230c488aa4babbd4141d903b7ab0d
Closes-Bug: 1516834
Add a configuration option to let projects set the URL to the cgit
browser for their source. Still try to guess at the location based on
our git URL.
Change-Id: I11455f8a137a029c28a864eb555f69f6c282840b
The event handler should return a string if it wants to replace the
template, but should otherwise return None and update the context in
place.
Change-Id: Ic4b19c7d19eda866ba139913cf817c99a65c8c08
Closes-Bug: #1505311
urlparse moved to urllib.parse, so the current code fails in
Python3. Using six to ensure compatibility.
Related-Bug: #1426898
Change-Id: I9297c886dcc361238e942cb8162f589072001094
In the table of contents the titles are covering words
in the page, this won't be a problem but the directories
that are in the table of contents are considered 1 word
so it does not word wrap automatically
Change-Id: I763aa1ba4418be1ea70d1ff48a321971630ec6e4
Closes-Bug: 1498654
The http://ci.openstack.org/ documentation site has been deprecated,
replaced by redirects to corresponding paths within
http://docs.openstack.org/infra/ where other Project Infrastructure
documentation already resides.
Change-Id: Ia914d1802b57f7101dd86b2098857dd714763dd1
Even on really large screens, the horizontal scrollbar is shown. This is
because the `div.related` class has a width of 100% in basic.css and in
tweaks.css a border is also defined. This causes the div to be two pixes
wider than the screen.
Change-Id: I2881d8eca99988ff8372b22aecc1a1a90c66a314
- Ensures tracking is across all openstack.org web properties
- Tracks only docs.openstack.org/developer/{{ project }} where
project name is taken from conf.py
Change-Id: Idfb2696f42ff17cbc6c3b72afcd2630b9ae01f0e
Closes-bug: 1441315
If the blueprint file is named beginning with the name of a project,
look there for the blueprint first.
Change-Id: I49cf48ed001945670ab900fcc76cd4c2087ddbb7
By default oslosphinx forces projects that use it to use the theme
contained in the package. The documentation team wants to provide a
separate theme for some parts of the docs.openstack.org site. They are
going to distribute it in their own package, but do still want to be
able to use other features of oslosphinx. This change allows any name
that starts "openstack" to be used, while retaining the default behavior
of inserting the "openstack" theme if a project is using a different
default or has not set a theme.
Change-Id: I7a2c5a5c3805685b8fa0baaa47393d5fec312f30
This new extension requires spec filenames to match blueprint names in
the relevant project. This is based on work originally done in
oslo-specs under https://review.openstack.org/#/c/138392/
Change-Id: Ifd58f4f71f661229f09ecf01047bc7a7b1dc0b08
Enhance the sidebar display to provide visual distinction between top
level items and lower level items. Top level items are now given a
space above them so they are visually clumped with their children, and
separated from each other. They are also emboldened for greater visual
distinction.
Ideally sphinx would actually tag li items with their depth as a class
tag, but as it currently doesn't do that we can work around it with
setting at ul li, and unsetting at ul li ul li.
Change-Id: I88d4317ec69fe7fd6f5c2198f89de624f0d093da
When using a link inside the h3.highlighted sidebar element the
text reverts to the default grey colour
Change-Id: I4e35abd6da42a5d9a7bb8c3b56fd4e8610e4e17c
This allows projects that are currently incubated to use oslosphinx
To use a project needs to set
'html_theme_options = {'incubating': True}'
in their sphinx conf.py
This is option reflected by changing the side bar to have a bar
at the top that shows 'Incubated Project'
Change-Id: Ib5a06ac1749fec475d326afe19f16fffb8c7d4a7
We don't need vim modelines in each source file, it can be set in
user's vimrc.
Change-Id: If4f0e93821e20ea837c1fc908845089dd192fcde
Closes-Bug: #1229324
Having the sphinx theme in the same namespace package
as the production code has been causing issues with
devstack installations. This change renames the package
to move it out of the namespace. Another change to the
openstack-infra/config repository will rename the
git repository and associated jobs.
Partial-bug: #1277168
Change-Id: I7788a9d6b5984fdfcc4678f2182104d2eb8a2be0