feat(build): #940 mkdocs gh-deploy

.github/workflows/prod.yml

@@ -162,27 +162,17 @@ jobs:
         env:
           CACHIX_AUTH_TOKEN: ${{ secrets.CACHIX_AUTH_TOKEN }}
 
-  linux_docs:
+  linux_docs_deploy:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
       - uses: docker://docker.io/nixos/nix@sha256:1d13ae379fb8caf3f859c5ce7ec6002643d60cf8b7b6147b949cc34880c93bac
-        name: /docs
+        name: /docs/gh-deploy
         with:
           set-safe-directory: /github/workspace
-          args: sh -c "nix-env -if . && m . /docs"
+          args: sh -c "nix-env -if . && m . /docs gh-deploy"
         env:
           CACHIX_AUTH_TOKEN: ${{ secrets.CACHIX_AUTH_TOKEN }}
-      - name: deploy
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          force_orphan: true
-          full_commit_message: ${{ github.event.head_commit.message }}
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_branch: docs
-          publish_dir: docs/site
-          user_name: github-actions[bot]
-          user_email: github-actions[bot]@users.noreply.github.com
 
   linux_envVars_example:
     runs-on: ubuntu-latest

docs/mkdocs.yml → docs/mkdocs.yaml

@@ -6,8 +6,8 @@ repo_url: https://github.com/fluidattacks/makes
 repo_name: Makes
 copyright: Copyright © 2023 Fluid Attacks, We hack your software. All rights reserved.
 
-docs_dir: src
 strict: true
+docs_dir: src
 theme:
   name: material
 markdown_extensions:

makes/docs/entrypoint.sh

@@ -1,7 +1,9 @@
 # shellcheck shell=bash
 
 function main {
-  mkdocs build -f docs/mkdocs.yml
+  : \
+    && pushd docs \
+    && mkdocs "${@}"
 }
 
 main "${@}"

makes/docs/runtime/main.nix

@@ -5,7 +5,10 @@
   ...
 }:
 makeSearchPaths {
-  bin = [inputs.nixpkgs.mkdocs];
+  bin = [
+    inputs.nixpkgs.git
+    inputs.nixpkgs.mkdocs
+  ];
   source = [
     (makePythonPypiEnvironment {
       name = "docs-runtime-pypi";