mirror of
https://codeberg.org/openpgp/notes.git
synced 2025-09-09 19:29:41 +02:00
ace6499cbb
Add a logo, favicon and cover image for HTML and EPUB output. Add an author, so that metadata is set properly for EPUB. Extend copyright statement by reusing information and adding links to project and license. Format today as YYYY-MM-DD instead of language specific. Signed-off-by: David Runge <dave@sleepmap.de>
90 lines
3 KiB
Python
90 lines
3 KiB
Python
# SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project
|
|
# SPDX-License-Identifier: CC0-1.0
|
|
#
|
|
# 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
|
|
|
|
from datetime import date
|
|
|
|
# -- Project information -----------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
|
|
|
|
project = 'OpenPGP for application developers'
|
|
author = 'The "Notes on OpenPGP" project'
|
|
upstream_url = "https://codeberg.org/openpgp/notes"
|
|
license_url = "https://creativecommons.org/licenses/by-sa/4.0/"
|
|
copyright = f'{date.today().year}, <a href="{upstream_url}">{author}</a>, <a href="{license_url}">CC-BY-SA-4.0</a>'
|
|
version = "0.1"
|
|
suppress_warnings = [
|
|
'epub.unknown_project_files',
|
|
]
|
|
|
|
# -- General configuration ---------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
|
|
|
|
extensions = [
|
|
'myst_parser',
|
|
]
|
|
source_suffix = ['.md', '.rst']
|
|
|
|
templates_path = ['_templates']
|
|
exclude_patterns = []
|
|
|
|
# number code-blocks, figures and tables, if they have a caption
|
|
numfig = True
|
|
# number figures in flat hierarchy
|
|
numfig_secnum_depth = 0
|
|
|
|
# format today as YYYY-MM-DD instead of language specific
|
|
today_fmt = "%Y-%m-%d"
|
|
|
|
# -- Options for MyST-parser -------------------------------------------------
|
|
# https://myst-parser.readthedocs.io/en/latest/configuration.html
|
|
|
|
# we want to circumvent obscure warnings about footnotes following a heading:
|
|
# https://github.com/executablebooks/MyST-Parser/issues/352
|
|
myst_footnote_transition = False
|
|
|
|
# Enable definition lists
|
|
# https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#syntax-definition-lists
|
|
myst_enable_extensions = [
|
|
"deflist",
|
|
]
|
|
|
|
# -- Options for EPUB output -------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-epub-output
|
|
|
|
epub_copyright = f'{date.today().year}, {author} ({upstream_url}), CC-BY-SA-4.0'
|
|
epub_cover = ('_static/epub/img/cover.svg', 'cover.j2')
|
|
epub_css_files = [
|
|
'epub/css/custom.css'
|
|
]
|
|
epub_title = project.replace(" ", "_")
|
|
|
|
# -- Options for HTML output -------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
|
|
|
|
html_theme = 'alabaster'
|
|
html_static_path = ['_static']
|
|
html_css_files = [
|
|
('html/css/custom.css', {'priority': 1000})
|
|
]
|
|
|
|
html_favicon = '_static/html/img/favicon.ico'
|
|
html_logo = '_static/html/img/logo.svg'
|
|
html_show_sphinx = False
|
|
html_show_sourcelink = False
|
|
html_title = project
|
|
|
|
# https://github.com/sphinx-doc/alabaster/blob/0.x/alabaster/theme.conf
|
|
html_theme_options = {
|
|
'code_font_size': '9pt',
|
|
'extra_nav_links': {
|
|
'Sources on Codeberg': upstream_url,
|
|
'Download EPUB': f'https://openpgp.dev/epub/{epub_title}.epub',
|
|
},
|
|
'show_relbars': 'yes',
|
|
'show_powered_by': False,
|
|
}
|