diff options
Diffstat (limited to '')
-rw-r--r-- | doc/conf.py | 47 | ||||
-rw-r--r-- | doc/conf.py.in | 32 |
2 files changed, 35 insertions, 44 deletions
diff --git a/doc/conf.py b/doc/conf.py index 422386a..5efa4ab 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -4,26 +4,15 @@ # list see the documentation: # https://www.sphinx-doc.org/en/master/usage/configuration.html -# -- Path setup -------------------------------------------------------------- - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -# -# import os -# import sys -# sys.path.insert(0, os.path.abspath('.')) - # -- Project information ----------------------------------------------------- project = 'libnvme' copyright = '2020, Keith Busch' author = 'Keith Busch <kbusch@kernel.org>' -master_doc = 'libnvme' +master_doc = 'index' -# The full version, including alpha/beta/rc tags -release = '0.1' +release = '1.0' # -- General configuration --------------------------------------------------- @@ -40,34 +29,4 @@ templates_path = ['_templates'] # 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. -exclude_patterns = ['html', 'man', 'index.rst', 'Thumbs.db', '.DS_Store'] - - -# -- Options for HTML output ------------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -# -#html_theme = 'alabaster' - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['sphinx-static'] -html_context = { - 'css_files': [ - '_static/theme_overrides.css', - ], -} - -html_use_smartypants = False -pygments_style = 'sphinx' - -htmlhelp_basename = 'libnvme' - -try: - import sphinx_rtd_theme - html_theme = 'sphinx_rtd_theme' - html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] -except ImportError: - sys.stderr.write('Warning: The Sphinx \'sphinx_rtd_theme\' HTML theme was not found. Make sure you have the theme installed to produce pretty HTML output. Falling back to the default theme.\n') +exclude_patterns = ['html', 'man', 'Thumbs.db', '.DS_Store'] diff --git a/doc/conf.py.in b/doc/conf.py.in new file mode 100644 index 0000000..3415bbf --- /dev/null +++ b/doc/conf.py.in @@ -0,0 +1,32 @@ +# Configuration file for the Sphinx documentation builder. +# +# This file only contains a selection of the most common options. For a full +# list see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + + +# -- Project information ----------------------------------------------------- + +project = 'libnvme' +copyright = '2020, Keith Busch' +author = 'Keith Busch <kbusch@kernel.org>' +master_doc = 'index' + +release = '@VERSION@' + + +# -- General configuration --------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = [ +] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# 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. +exclude_patterns = ['html', 'man', 'Thumbs.db', '.DS_Store'] |