Migrate to Sphinx docs

.github/workflows/book-gh-pages.yml

@@ -27,8 +27,8 @@ jobs:
       - uses: cachix/install-nix-action@ba0dd844c9180cbf77aa72a116d6fbc515d0e87b # v27
       - name: "Build documentation book"
         run: |
-          nix build '.#book' --print-build-logs
-          cp -Lr --no-preserve=mode,ownership ./result/ ./book
+          nix build '.#docs' --print-build-logs
+          cp -Lr --no-preserve=mode,ownership ./result/share/doc/epnix/html ./book
       - name: Setup Pages
         uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
       - name: Upload artifact

.gitlab-ci.yml

@@ -31,8 +31,8 @@ formatting:
 manpages:
   stage: deploy
   script:
-    - nix build $NIX_BUILD_FLAGS '.#manpages'
-    - cp -Lr ./result manpages
+    - nix build $NIX_BUILD_FLAGS '.#docs'
+    - cp -Lr ./result/share/man manpages
   artifacts:
     name: "manpages-$CI_COMMIT_REF_SLUG"
     paths:
@@ -41,8 +41,8 @@ manpages:
 pages:
   stage: deploy
   script:
-    - nix build $NIX_BUILD_FLAGS '.#book'
-    - cp -Lr ./result public
+    - nix build $NIX_BUILD_FLAGS '.#docs'
+    - cp -Lr ./result/share/doc/epnix/html public
   artifacts:
     name: "book"
     paths:

.vale.ini

@@ -1,12 +1,12 @@
-StylesPath = doc/_vale
+StylesPath = docs/_vale
 MinAlertLevel = suggestion
 
 Vocab = EPNix
 
 # External packages
 Packages = alex, Google, Microsoft, proselint, RedHat, write-good
-# Only Markdown and .txt files; change to whatever you're using.
-[*.md]
+
+[*.{md,rst}]
 # List of styles to load.
 BasedOnStyles = alex, Google, Microsoft, proselint, RedHat, Vale, write-good