diff --git a/doc/templating.rst b/doc/templating.rst index b25372319..3d80edd60 100644 --- a/doc/templating.rst +++ b/doc/templating.rst @@ -372,7 +372,16 @@ in the future. .. data:: sphinx_version - The version of Sphinx used to build. + The version of Sphinx used to build represented as a string for example "3.5.1". + +.. data:: sphinx_version_tuple + + The version of Sphinx used to build represented as a tuple of five elements. + For Sphinx version 3.5.1 beta 3 this would be `(3, 5, 1, 'beta', 3)``. + The fourth element can be one of: ``alpha``, ``beta``, ``rc``, ``final``. + ``final`` always has 0 as the last element. + + .. versionadded:: 4.2 .. data:: style diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py index 7265370bb..f169a499e 100644 --- a/sphinx/builders/html/__init__.py +++ b/sphinx/builders/html/__init__.py @@ -26,6 +26,7 @@ from docutils.nodes import Node from docutils.utils import relative_path from sphinx import __display_version__, package_dir +from sphinx import version_info as sphinx_version from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.config import ENUM, Config @@ -516,6 +517,7 @@ class StandaloneHTMLBuilder(Builder): 'language': self.config.language, 'css_files': self.css_files, 'sphinx_version': __display_version__, + 'sphinx_version_tuple': sphinx_version, 'style': self._get_style_filename(), 'rellinks': rellinks, 'builder': self.name,