diff options
author | Aaron Carlisle <carlisle.b3d@gmail.com> | 2017-07-17 00:05:29 +0300 |
---|---|---|
committer | Aaron Carlisle <carlisle.b3d@gmail.com> | 2017-07-17 00:11:05 +0300 |
commit | 2d0c9542fe0b7a8a76ae24376ebea5c376362351 (patch) | |
tree | 23ab4404397025dbfee784cb4fb0c99f700e5f59 /doc | |
parent | 7021aa245ddaae67fdc41450ea83b3643f50b28c (diff) |
BPY API: Fix usless links leading to compile errors
See https://github.com/sphinx-doc/sphinx/issues/3866 for more information
Diffstat (limited to 'doc')
-rw-r--r-- | doc/python_api/sphinx_doc_gen.py | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/python_api/sphinx_doc_gen.py b/doc/python_api/sphinx_doc_gen.py index 3b0e8f52c83..525eebe5790 100644 --- a/doc/python_api/sphinx_doc_gen.py +++ b/doc/python_api/sphinx_doc_gen.py @@ -1630,7 +1630,8 @@ def write_sphinx_conf_py(basepath): file = open(filepath, "w", encoding="utf-8") fw = file.write - fw("import sys, os\n\n") + fw("import sys, os\n") + fw("from sphinx.domains.python import PythonDomain\n\n") fw("extensions = ['sphinx.ext.intersphinx']\n\n") fw("intersphinx_mapping = {'blender_manual': ('https://docs.blender.org/manual/en/dev/', None)}\n\n") fw("project = 'Blender'\n") @@ -1653,6 +1654,15 @@ def write_sphinx_conf_py(basepath): fw("html_favicon = '__/static/favicon.ico'\n") fw("html_logo = '__/static/blender_logo.svg'\n\n") + fw("class PatchedPythonDomain(PythonDomain):\n") + fw(" def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):\n") + fw(" if 'refspecific' in node:\n") + fw(" del node['refspecific']\n") + fw(" return super(PatchedPythonDomain, self).resolve_xref(\n") + fw(" env, fromdocname, builder, typ, target, node, contnode)\n\n") + fw("def setup(sphinx):\n") + fw(" sphinx.override_domain(PatchedPythonDomain)\n\n") + # needed for latex, pdf gen fw("latex_elements = {\n") fw(" 'papersize': 'a4paper',\n") |