nix-sphinx-template

Nix Sphinx template with:

• myst-parser
• sphinx-rtd-theme
• sphinxcontrib-drawio
• sphinxcontrib-mermaid

Quickstart

1. nix build
2. see generated site at result/index.html

or live updates with uncommited git changes:

1. impure-sphinx-autobuild # default port 8000 or pass --port n
2. see http://localhost:8000 # or specified port

NixOS Flake

1. flake.nix

     inputs = {
       sphinx.url = "github:womfoo/nix-sphinx-template";
     }

     modules = [
        inputs.sphinx.nixosModules.default
        {services.sphinx-nginx.enable = true;}
        {services.sphinx-nginx.virtualHost = "your.doc.site.com";}
     ];