🤝 sync with sphinx doc templates

Author: chfw

templates/docs/conf.py_t

@@ -30,10 +30,16 @@ project = {{ project | repr }}
 copyright = {{ copyright | repr }}
 author = {{ author | repr }}
 
+{%- if version %}
+
 # The short X.Y version
 version = {{ version | repr }}
+{%- endif %}
+{%- if release %}
+
 # The full version, including alpha/beta/rc tags
 release = {{ release | repr }}
+{%- endif %}
 
 
 # -- General configuration ---------------------------------------------------
@@ -50,24 +56,28 @@ extensions = [
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['{{ dot }}templates']
 
+{% if suffix != '.rst' -%}
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
 source_suffix = {{ suffix | repr }}
 
-{% if master_doc != 'index' -%}
+{% endif -%}
+{% if master != 'index' -%}
 # The master toctree document.
 master_doc = {{ master | repr }}
 
 {% endif -%}
+{% if language -%}
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
 language = {{ language | repr }}
 
+{% endif -%}
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
@@ -101,24 +111,6 @@ html_static_path = ['{{ dot }}static']
 # 'searchbox.html']``.
 #
 # html_sidebars = {}
-
-
-# -- Options for Epub output -------------------------------------------------
-
-# Bibliographic Dublin Core info.
-epub_title = project
-
-# The unique identifier of the text. This can be a ISBN number
-# or the project homepage.
-#
-# epub_identifier = ''
-
-# A unique identification for the text.
-#
-# epub_uid = ''
-
-# A list of files that should not be packed into the epub file.
-epub_exclude_files = ['search.html']
 {%- if extensions %}
 
 
@@ -138,4 +130,3 @@ intersphinx_mapping = {'https://docs.python.org/': None}
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
 {%- endif %}
-

templates/docs/make.bat.jj2

@@ -33,4 +33,3 @@ goto end
 
 :end
 popd
-

templates/docs/master_doc.rst_t

@@ -18,4 +18,3 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-