George Lambert
e401635fd6
Some checks are pending
offline / test (push) Waiting to run
Add missing package READMEs, expand Sphinx to all runtime modules, publish a LaTeX/PDF README book, and add verae-ops for Docker, Proxmox, VMs, dedicated hardware, and service linking. Catalog defaults to public PDF links for each module README and samples.
44 lines
1.2 KiB
Python
44 lines
1.2 KiB
Python
# Sphinx config for Verae × Zapier (HTML + LaTeX).
|
||
project = "Verae Time × Zapier"
|
||
author = "Verae"
|
||
release = "0.1.0"
|
||
extensions = ["myst_parser"]
|
||
myst_enable_extensions = ["colon_fence", "deflist", "tasklist"]
|
||
source_suffix = {".rst": "restructuredtext", ".md": "markdown"}
|
||
templates_path = ["_templates"]
|
||
exclude_patterns = ["_build"]
|
||
html_theme = "alabaster"
|
||
html_static_path = []
|
||
html_theme_options = {
|
||
"description": "Public module reference",
|
||
"fixed_sidebar": True,
|
||
}
|
||
master_doc = "index"
|
||
latex_engine = "pdflatex"
|
||
latex_elements = {
|
||
"papersize": "letterpaper",
|
||
"pointsize": "10pt",
|
||
"preamble": r"\usepackage{xcolor}\usepackage{booktabs}",
|
||
}
|
||
latex_documents = [
|
||
(
|
||
"latex-index",
|
||
"verae-zapier-modules.tex",
|
||
"Verae Time × Zapier Repository READMEs",
|
||
author,
|
||
"manual",
|
||
),
|
||
]
|
||
|
||
|
||
def _drop_svg_images(app, doctree, fromdocname):
|
||
from docutils import nodes
|
||
|
||
for node in list(doctree.findall(nodes.image)):
|
||
uri = node.get("uri") or ""
|
||
if uri.endswith(".svg"):
|
||
node.replace_self(nodes.paragraph(text=f"[SVG diagram {uri} — see HTML catalog]"))
|
||
|
||
|
||
def setup(app):
|
||
app.connect("doctree-resolved", _drop_svg_images)
|