ac931d4507
Add a new "merge requests" page and move all related pages under that page to give the docs more structure. Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org> Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
48 lines
1.4 KiB
Python
48 lines
1.4 KiB
Python
# Configuration file for the Sphinx documentation builder.
|
|
|
|
import datetime
|
|
from pathlib import Path
|
|
import subprocess
|
|
|
|
project = "pmaports"
|
|
copyright = str(datetime.date.today().year) + ", postmarketOS contributors"
|
|
exclude_patterns = ["_build", "_out", "Thumbs.db", ".DS_Store", ".venv", "README.md"]
|
|
|
|
extensions = [
|
|
"myst_parser",
|
|
"sphinx.ext.autodoc",
|
|
"sphinx.ext.autosummary",
|
|
"sphinx.ext.doctest",
|
|
"sphinx_reredirects",
|
|
"sphinxcontrib.autoprogram",
|
|
"sphinxcontrib.jquery",
|
|
]
|
|
myst_enable_extensions = ["colon_fence"]
|
|
|
|
html_theme = "pmos"
|
|
html_theme_options = {
|
|
"source_edit_link": "https://gitlab.postmarketos.org/postmarketOS/pmaports/-/blob/main/docs/{filename}",
|
|
}
|
|
|
|
# Set the explicit title of the HTML output
|
|
html_title = "postmarketOS Packaging"
|
|
|
|
# Redirects for moved pages
|
|
redirects = {
|
|
"approval-rules": "merge-requests/approval-rules.html",
|
|
"ci-tags": "ci/ci-tags.html",
|
|
"hardware-ci": "ci/hardware-ci.html",
|
|
"releases/backporting": "merge-requests/stable-branches.html",
|
|
}
|
|
|
|
def run_dint_doc(app):
|
|
docs_dir = Path(__file__).parent
|
|
|
|
with docs_dir.joinpath("deviceinfo-reference.md").open("w") as f:
|
|
schema_path = docs_dir.parent / "deviceinfo_schema.toml"
|
|
|
|
subprocess.run(["dint", "doc"], stdout=f, check=True, env={"DINT_SCHEMA_PATH": schema_path})
|
|
|
|
|
|
def setup(app):
|
|
app.connect("builder-inited", run_dint_doc)
|