| | |
| | | |
| | | # Configuration file for the Sphinx documentation builder. |
| | | # |
| | | # This file only contains a selection of the most common options. For a full |
| | |
| | | from subprocess import check_output |
| | | import sphinx_rtd_theme |
| | | |
| | | print(check_output(['pwd',]) |
| | | changesetid = check_output(["git", "rev-parse", "--short", "HEAD"]).decode("utf-8")[:7] |
| | | |
| | | numfig = True |
| | |
| | | |
| | | # -- Project information ----------------------------------------------------- |
| | | |
| | | project = 'Hostsharing Benutzerhandbuch' |
| | | project = 'Benutzerhandbuch' |
| | | copyright = '2019, Hostsharing eG' |
| | | author = 'Hostsharing eG' |
| | | |
| | | # The full version, including alpha/beta/rc tags |
| | | release = '1' |
| | | release = changesetid |
| | | |
| | | |
| | | # -- General configuration --------------------------------------------------- |
| | |
| | | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
| | | # ones. |
| | | extensions = [ |
| | | 'sphinx.ext.todo', |
| | | 'sphinx.ext.graphviz', |
| | | 'hs.theme.sphinx' |
| | | ] |
| | | |
| | | todo_include_todos = False |
| | | |
| | | # Add any paths that contain templates here, relative to this directory. |
| | | templates_path = ['_templates'] |
| | |
| | | # The theme to use for HTML and HTML Help pages. See the documentation for |
| | | # a list of builtin themes. |
| | | # |
| | | html_theme = 'sphinx_rtd_theme' |
| | | |
| | | html_theme = 'hostsharing' |
| | | html_theme_options = { |
| | | 'logo_only': False, |
| | | 'display_version': True, |
| | | 'style_external_links': True, |
| | | 'style_nav_header_background': '#4279bc', |
| | | } |
| | | # 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 = ['_static'] |
| | | |
| | | latex_basename = 'Software-Dokumentation-mit-Sphinx-%s.tex' % changesetid |
| | | html_extra_path = ['_static/robots.txt'] |
| | | html_logo = 'images/logos/hostsharing-logo-negativ.svg' |
| | | latex_logo = '_static/logo.png' |
| | | #latex_basename = 'Hostsharing-Benutzerhandbuch-%s.tex' % changesetid |
| | | latex_basename = 'Hostsharing-Benutzerhandbuch.tex' |
| | | |
| | | latex_engine = 'lualatex' |
| | | |
| | |
| | | \setmainfont{TeX Gyre Heros}% |
| | | \setsansfont{TeX Gyre Heros}% |
| | | % \setmonofont[RawFeature=-tlig]{TeX Gyre Cursor}% |
| | | % \setmonofont[Ligatures={NoRequired, NoCommon, NoContextual}]{TeX Gyre Cursor} |
| | | \setmonofont{Courier New}[Scale=MatchLowercase,ScaleAgain=0.9] |
| | | \setmonofont[Ligatures={NoRequired, NoCommon, NoContextual}]{TeX Gyre Cursor} |
| | | % \setmonofont{Courier New}[Scale=MatchLowercase,ScaleAgain=0.9] |
| | | ''', |
| | | 'preamble': r'\input{./mystyle.sty}', |
| | | 'releasename': 'Version', |
| | |
| | | latex_show_urls = 'footnote' |
| | | latex_use_xindy = False |
| | | |
| | | latex_documents = [ |
| | | ('index', latex_basename, project, |
| | | author, 'manual'), |
| | | ] |
| | | |
| | | def setup(app): |
| | | app.add_object_type('role', 'role', |
| | | objname='Rolle', |
| | | indextemplate='pair: %s; Rolle') |
| | | |
| | | rst_epilog = '.. |changesetid| replace:: %s' % changesetid |