From dc7b2d5c71124a29182aea23977d7c79715f0f06 Mon Sep 17 00:00:00 2001 From: Andreas Jaeger Date: Wed, 3 Jun 2020 17:49:20 +0200 Subject: [PATCH] Use newer openstackdocstheme and reno versions 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: I0d9de98cde53132d4ca850af888bd5d36242b85d --- doc/source/conf.py | 7 ++++--- releasenotes/source/conf.py | 15 +++------------ 2 files changed, 7 insertions(+), 15 deletions(-) diff --git a/doc/source/conf.py b/doc/source/conf.py index e518b4a..39668bf 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -66,9 +66,10 @@ target_name = 'openstack-ansible-' + role_name title = 'OpenStack-Ansible Documentation: ' + role_name + ' role' # openstackdocstheme options -repository_name = 'openstack/' + target_name -bug_project = project.lower() -bug_tag = '' +openstackdocs_repo_name = 'openstack/' + target_name +openstackdocs_pdf_link = True +openstackdocs_bug_project = project.lower() +openstackdocs_bug_tag = '' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/releasenotes/source/conf.py b/releasenotes/source/conf.py index 7c87cad..ab3bba9 100644 --- a/releasenotes/source/conf.py +++ b/releasenotes/source/conf.py @@ -62,11 +62,6 @@ role_name = 'os_trove' target_name = 'openstack-ansible-' + role_name title = 'OpenStack-Ansible Release Notes: ' + role_name + 'role' -# The link to the browsable source code (for the left hand menu) -oslosphinx_cgit_link = ( - "https://opendev.org/openstack/{}".format(target_name) -) - # Release notes do not need a version number in the title, they # cover multiple releases. # The full version, including alpha/beta/rc tags. @@ -75,9 +70,9 @@ release = '' version = '' # openstackdocstheme options -repository_name = 'openstack/' + target_name -bug_project = project.lower() -bug_tag = '' +openstackdocs_repo_name = 'openstack/' + target_name +openstackdocs_bug_project = project.lower() +openstackdocs_bug_tag = '' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. @@ -158,10 +153,6 @@ html_static_path = ['_static'] # directly to the root of the documentation. # html_extra_path = [] -# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, -# using the given strftime format. -html_last_updated_fmt = '%Y-%m-%d %H:%M' - # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. # html_use_smartypants = True