bos #23972 [CEA 19980] sphinxcontrib_napoleon is not needed with Sphinx >= 1.3

This commit is contained in:
vsr 2021-02-19 09:52:32 +03:00
parent aa88721630
commit 907c315580
2 changed files with 21 additions and 13 deletions

View File

@ -130,8 +130,12 @@ IF(SALOME_BUILD_TESTS)
ENDIF() ENDIF()
IF(SALOME_BUILD_DOC) IF(SALOME_BUILD_DOC)
FIND_PACKAGE(SalomeDoxygen) FIND_PACKAGE(SalomeDoxygen)
SET(Sphinx_EXTENSIONS sphinxcontrib.napoleon)
FIND_PACKAGE(SalomeSphinx) FIND_PACKAGE(SalomeSphinx)
INCLUDE(UseSphinx)
SPHINX_CHECK_EXTENSIONS(sphinx_rtd_theme)
IF(SPHINX_VERSION VERSION_LESS "1.3")
SPHINX_CHECK_EXTENSIONS(sphinxcontrib.napoleon)
ENDIF()
SALOME_LOG_OPTIONAL_PACKAGE(Doxygen SALOME_BUILD_DOC) SALOME_LOG_OPTIONAL_PACKAGE(Doxygen SALOME_BUILD_DOC)
SALOME_LOG_OPTIONAL_PACKAGE(Sphinx SALOME_BUILD_DOC) SALOME_LOG_OPTIONAL_PACKAGE(Sphinx SALOME_BUILD_DOC)
ENDIF() ENDIF()

View File

@ -11,6 +11,7 @@
# All configuration values have a default; values that are commented out # All configuration values have a default; values that are commented out
# serve to show the default. # serve to show the default.
import importlib
import sys, os import sys, os
import sphinx import sphinx
@ -25,17 +26,20 @@ import sphinx
# Add any Sphinx extension module names here, as strings. They can be extensions # Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = ['sphinx.ext.autodoc','sphinx.ext.autosummary'] extensions = ['sphinx.ext.autodoc','sphinx.ext.autosummary']
try: # Optional extensions
import sphinxcontrib.napoleon extra_extensions = ['sphinx_rtd_theme']
extensions += ['sphinxcontrib.napoleon'] if sphinx.version_info[:2] < (1,3):
except: extra_extensions += ['sphinxcontrib.napoleon']
pass else:
try: extra_extensions += ['sphinx.ext.napoleon']
import sphinx_rtd_theme for ext in extra_extensions:
extensions += ['sphinx_rtd_theme'] try:
use_rtd_theme = True importlib.import_module(ext)
except: extensions.append(ext)
use_rtd_theme = False globals().update({'use_{}'.format(ext):True})
except:
globals().update({'use_{}'.format(ext):False})
#add pdfbuilder to build a pdf with rst2pdf #add pdfbuilder to build a pdf with rst2pdf
#extensions = ['rst2pdf.pdfbuilder'] #extensions = ['rst2pdf.pdfbuilder']
@ -111,7 +115,7 @@ pygments_style = 'sphinx'
# The theme to use for HTML and HTML Help pages. Major themes that come with # The theme to use for HTML and HTML Help pages. Major themes that come with
# Sphinx are currently 'default' and 'sphinxdoc'. # Sphinx are currently 'default' and 'sphinxdoc'.
if use_rtd_theme: if use_sphinx_rtd_theme:
html_theme = 'sphinx_rtd_theme' html_theme = 'sphinx_rtd_theme'
else: else:
html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic'