qm-handbuch/source/conf.py

# Configuration file for the Sphinx documentation builder.
#
# For the full list of built-in configuration values, see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information

import subprocess

project = 'Qualitätsmanagement-Handbuch'
copyright = '2023, Qualitätsmanagementbeauftragter (QMB)'
author = 'Qualitätsmanagementbeauftragter (QMB)'
version = '2.0'
release = '2.0-alpha'



# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

extensions = ['sphinx.ext.graphviz', 'sphinx.ext.todo', 'sphinx.ext.autosectionlabel', 'sphinx.ext.imgconverter', 'sphinx_git']
todo_include_todos = True
templates_path = ['_templates']
exclude_patterns = []

language = 'de'


show_sphinx = False

numfig = True

gitrevision = subprocess.run('git rev-parse --short HEAD'.split(' '), capture_output=True).stdout.decode('UTF-8')
gitlastauthor = subprocess.run('git log -1 --pretty=format:%an'.split(' '), capture_output=True).stdout.decode('UTF-8')


rst_prolog = """
.. |ISONORM| replace:: DIN EN ISO 9001:2015-11
.. |KVT| replace:: KVT Kurlbaum AG
.. |QM| replace:: Qualitätsmanagement
.. |QMH| replace:: Qualitätsmanagement-Handbuch
.. |QMB| replace:: Qualitätsmanagement-Beauftragter
.. |UVV| replace:: Unfall-Verhütungs-Vorschrift
.. |VA| replace:: Verfahrensanweisung
.. |AA| replace:: Arbeitsanweisung
.. |SP| replace:: Spezifikation
.. |Formular| replace:: Formblätter / Vorlagen
.. |gitrevision| replace:: {}
.. |gitauthor| replace:: {}
""".format(gitrevision, gitlastauthor)

rst_epilog = """


"""


# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

html_theme = 'sphinx_rtd_theme'
html_static_path = ['_static']
html_logo = 'kvt-logo.png'
html_css_files = [
    'css/custom.css',
]
html_context = {
    'show_sphinx': False,
    'gitrevision': gitrevision,
    'gitauthor': gitlastauthor
}
html_theme_options = {
    #'logo_only': True,
    'display_version': True,
    'prev_next_buttons_location': 'bottom',
    'style_external_links': False,
    'vcs_pageview_mode': '',
    #'style_nav_header_background': 'white',
    # Toc options
    'collapse_navigation': False,
    'sticky_navigation': True,
    'navigation_depth': 2,
    'includehidden': True,
    'titles_only': False
}



# -- Options for Latex/PDF export
latex_engine = 'xelatex'
latex_theme = 'howto'