inital mdBook try

KGB33 · Feb 18, 2024 · 81d010f · 81d010f
1 parent f36561d
commit 81d010f
Show file tree

Hide file tree

Showing 8 changed files with 67 additions and 16 deletions.
diff --git a/.github/workflows/pages.yaml b/.github/workflows/pages.yaml
@@ -0,0 +1,36 @@
+name: Deploy Docs
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      # contents: write  # To push a branch 
+      pages: write  # To push to a GitHub Pages site
+      id-token: write # To update the deployment status
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install latest mdbook
+        run: |
+          tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name')
+          url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz"
+          mkdir mdbook
+          curl -sSL $url | tar -xz --directory=./mdbook
+          echo `pwd`/mdbook >> $GITHUB_PATH
+      - name: Build Book
+        run: |
+          mdbook build docs
+      - name: Setup Pages
+        uses: actions/configure-pages@v2
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: 'docs/book'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1
diff --git a/.gitignore b/.gitignore
@@ -22,3 +22,6 @@ cilium.yaml
 secrets.yaml
 
 vendor/
+
+# mdBook
+book/
diff --git a/docs/book.toml b/docs/book.toml
@@ -0,0 +1,6 @@
+[book]
+authors = ["Kelton Bassingthwaite"]
+language = "en"
+multilingual = false
+src = "src"
+title = "Homelab Docs"
diff --git a/docs/index.md b/docs/index.md
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
@@ -0,0 +1,3 @@
+# Summary
+
+- [Secrets](./secrets.md)
diff --git a/docs/src/secrets.md b/docs/src/secrets.md
@@ -0,0 +1,5 @@
+# Secrets
+
+## Terraform Proxmox API
+
+## Kubernetes Sealed Secrets
diff --git a/flake.lock b/flake.lock
diff --git a/flake.nix b/flake.nix
@@ -22,19 +22,20 @@
             pyPkgs.ansible-core
             pyPkgs.ansible
             pyPkgs.kubernetes
-            pkgs.ansible-lint
-            pkgs.opentofu
             pkgs.ansible-language-server
-            pkgs.talosctl
-            pkgs.kubectl
-            pkgs.kubeseal
+            pkgs.ansible-lint
+            pkgs.argocd
             pkgs.cilium-cli
             pkgs.jq
-            pkgs.yq-go
-            pkgs.argocd
             pkgs.jsonnet
             pkgs.jsonnet-bundler
             pkgs.just
+            pkgs.kubectl
+            pkgs.kubeseal
+            pkgs.mdbook
+            pkgs.opentofu
+            pkgs.talosctl
+            pkgs.yq-go
           ];
         };