vbatts/microblog.pub
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Tweak docs

Browse source
This commit is contained in:
Thomas Sileo 2022-07-05 21:35:39 +02:00
parent 665b7f5847
commit dbd2c8afea
5 changed files with 32 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

13
scripts/generate_docs.py → scripts/build_docs.py
View file

@ -10,7 +10,9 @@ from app.config import VERSION
def markdownify(content: str) -> str:
return markdown(content, extensions=["mdx_linkify", "fenced_code", "codehilite"])
return markdown(content, extensions=[
"mdx_linkify", "fenced_code", "codehilite", "toc"
])
def main() -> None:
@ -33,11 +35,18 @@ def main() -> None:
install = Path("docs/install.md")
template.stream(
content=markdownify(install.read_text().removeprefix("# microblog.pub")),
content=markdownify(install.read_text()),
version=VERSION,
path="/installing.html",
).dump("docs/dist/installing.html")
user_guide = Path("docs/user_guide.md")
template.stream(
content=markdownify(user_guide.read_text()),
version=VERSION,
path="/user_guide.html",
).dump("docs/dist/user_guide.html")
if __name__ == "__main__":
main()