54 lines
1.1 KiB
Python
54 lines
1.1 KiB
Python
import os
|
|
# Configuration file for the Sphinx documentation builder.
|
|
|
|
# -- Project information
|
|
|
|
project = 'PGPainless'
|
|
copyright = '2022, Paul Schaub'
|
|
author = 'Paul Schaub'
|
|
|
|
master_doc = 'index'
|
|
|
|
# https://protips.readthedocs.io/git-tag-version.html
|
|
latest_tag = os.popen('git describe --abbrev=0').read().strip()
|
|
release = latest_tag
|
|
version = release
|
|
|
|
myst_substitutions = {
|
|
"repo_host" : "codeberg.org" # or 'github.com'
|
|
}
|
|
|
|
# -- General configuration
|
|
|
|
extensions = [
|
|
'myst_parser',
|
|
'sphinxcontrib.mermaid',
|
|
'sphinx.ext.duration',
|
|
'sphinx.ext.doctest',
|
|
'sphinx.ext.autodoc',
|
|
'sphinx.ext.autosummary',
|
|
]
|
|
|
|
source_suffix = ['.rst', '.md']
|
|
|
|
myst_enable_extensions = [
|
|
'colon_fence',
|
|
'substitution',
|
|
]
|
|
|
|
myst_heading_anchors = 3
|
|
|
|
templates_path = ['_templates']
|
|
|
|
# -- Options for HTML output
|
|
|
|
html_theme = 'sphinx_rtd_theme'
|
|
|
|
# Show URLs as footnotes
|
|
#epub_show_urls = 'footnote'
|
|
latex_show_urls = 'footnote'
|
|
|
|
# 'raw' does not work for epub and pdf, neither does 'svg'
|
|
mermaid_output_format = 'png'
|
|
mermaid_params = ['--theme', 'default', '--width', '1600', '--backgroundColor', 'transparent']
|