[ADD] conf: display version number in the switcher app

This commit is a cherry-pick of cd41235917 to 9.0
This commit is contained in:
Martin Trigaux 2018-10-29 15:19:12 +01:00
parent 1ee489b704
commit 898e602685

17
conf.py
View File

@ -326,11 +326,28 @@ def setup(app):
app.connect('html-page-context', analytics)
app.add_config_value('google_analytics_key', '', 'env')
app.connect('html-page-context', versionize)
app.add_config_value('versions', '', 'env')
app.connect('html-page-context', localize)
app.add_config_value('languages', '', 'env')
app.connect('doctree-resolved', tag_toctrees)
def versionize(app, pagename, templatename, context, doctree):
""" Adds a version switcher below the menu, requires ``canonical_root``
and ``versions`` (an ordered, space-separated lists of all possible
versions).
"""
if not (app.config.canonical_root and app.config.versions):
return
context['versions'] = [
(vs, _build_url(app.config.canonical_root, vs, pagename))
for vs in app.config.versions.split(',')
if vs != app.config.version
]
def analytics(app, pagename, templatename, context, doctree):
if not app.config.google_analytics_key:
return