mkdocs to manpage

build.sh

export BUILD_MANPAGE=true
export PERMALINK=false
export SHOW_SOURCE=false
mkdocs build

manpage.py

import os
import subprocess

pages = {}

if os.getenv("BUILD_MANPAGE"):
    def on_page_content(html, page, **kwargs):
        pages[page.file.src_uri] = html

    def on_post_build(**kwargs):
        combined = "\n\n".join(pages.values())
        with open("site.html", "w") as file:
            file.write(combined)
        subprocess.run("pandoc --standalone --to man site.html -o site.1".split())
        os.remove("site.html")

mkdocs.yml

hooks:
- manpage.py


markdown_extensions:
- toc:
    permalink: !ENV [PERMALINK, "¤"]
    
    
plugins:
- mkdocstrings:
    handlers:
      python:
        options:
          show_source: !ENV [SHOW_SOURCE, true]