archive/blender-archive
Archived
1
1
Fork 0
Code Pull Requests Packages Activity

PyDoc: support building without sphinx_rtd_theme

Browse Source 
This is no longer bundled with sphinx, support building without it.
This commit is contained in:
Campbell Barton
2020-10-08 12:31:26 +11:00
parent 9c8334acc1
commit 0b4aeffda9
1 changed files with 20 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
doc/python_api/sphinx_doc_gen.py
View File

@@ -1672,15 +1672,26 @@ def write_sphinx_conf_py(basepath):
fw("]\n\n") fw("]\n\n")
fw("html_title = 'Blender Python API'\n") fw("html_title = 'Blender Python API'\n")
fw("html_theme = 'sphinx_rtd_theme'\n")
fw("html_theme_options = {\n") fw("html_theme = 'default'\n")
fw(" 'canonical_url': 'https://docs.blender.org/api/current/',\n") # The theme 'sphinx_rtd_theme' is no longer distributed with sphinx by default, only use when available.
# fw(" 'analytics_id': '',\n") fw(r"""
# fw(" 'collapse_navigation': True,\n") try:
fw(" 'sticky_navigation': False,\n") __import__('sphinx_rtd_theme')
fw(" 'navigation_depth': 1,\n") html_theme = 'sphinx_rtd_theme'
# fw(" 'includehidden': True,\n") except ModuleNotFoundError:
# fw(" 'titles_only': False\n") pass
""")
fw("if html_theme == 'sphinx_rtd_theme':\n")
fw(" html_theme_options = {\n")
fw(" 'canonical_url': 'https://docs.blender.org/api/current/',\n")
# fw(" 'analytics_id': '',\n")
# fw(" 'collapse_navigation': True,\n")
fw(" 'sticky_navigation': False,\n")
fw(" 'navigation_depth': 1,\n")
# fw(" 'includehidden': True,\n")
# fw(" 'titles_only': False\n")
fw(" }\n\n") fw(" }\n\n")
# not helpful since the source is generated, adds to upload size. # not helpful since the source is generated, adds to upload size.