first try to use github pages

.github/workflows/book.yaml

@@ -0,0 +1,19 @@
+jobs:
+  deploy:
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: nixbuild/nix-quick-install-action@v29
+    - run: nix develop .#book -c mdbook build ./.
+    - if: ${{ github.ref == 'refs/heads/main' }}
+      uses: peaceiris/actions-gh-pages@v4
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./docs/book
+name: Deploy to GitHub Pages
+'on':
+  push:
+    branches:
+    - main

.gitignore

@@ -5,5 +5,11 @@ result
 .cache/
 .data/
 
+# mdbook
+docs/book/
+docs/cells/
+docs/index.html
+docs/README.md
+
 # nixago: ignore-linked-files
 /treefmt.toml

book.toml

@@ -0,0 +1,8 @@
+[book]
+language = "en"
+multilingual = false
+src = "docs"
+title = "Advent of Code 2024 - A report."
+
+[build]
+build-dir = "docs/book"

cells/code/challenges/day-01-part2.md

@@ -0,0 +1 @@
+# Part 2

cells/code/challenges/day-02-part2.md

@@ -0,0 +1 @@
+# Part 2

cells/repository/configs.nix

@@ -18,4 +18,49 @@ in {
       includes = ["*.nix"];
     };
   };
+
+  github-workflow-book = mkNixago {
+    output = ".github/workflows/book.yaml";
+    hook.mode = "copy";
+
+    data = {
+      name = "Deploy to GitHub Pages";
+      on.push.branches = ["main"];
+
+      jobs.deploy = {
+        runs-on = "ubuntu-latest";
+        concurrency.group = "\${{ github.workflow }}-\${{ github.ref }}";
+        steps = [
+          { uses = "actions/checkout@v4"; }
+          { uses = "nixbuild/nix-quick-install-action@v29"; }
+          { run = "nix develop .#book -c mdbook build ./."; }
+          {
+            uses = "peaceiris/actions-gh-pages@v4";
+            "if" = "\${{ github.ref == 'refs/heads/main' }}";
+            "with" = {
+              "github_token" = "\${{ secrets.GITHUB_TOKEN }}";
+              "publish_dir" = "./docs/book";
+            };
+          }
+        ];
+      };
+    };
+  };
+
+  mdbook = mkNixago {
+    output = "book.toml";
+    hook.mode = "copy";
+
+    packages = with pkgs; [ mdbook ];
+
+    data = {
+      book = {
+        title = "Advent of Code 2024 - A report.";
+        language = "en";
+        multilingual = false;
+        src = "docs";
+      };
+      build.build-dir = "docs/book";
+    };
+  };
 }

cells/repository/devshells.nix

@@ -11,4 +11,12 @@ in {
       treefmt
     ];
   };
+
+  book = mkShell {
+    name = "AoC 2024: Book";
+
+    nixago = with cell.configs; [
+      mdbook
+    ];
+  };
 }

docs/SUMMARY.md

@@ -0,0 +1,13 @@
+# Summary
+
+[Introduction](../README.md)
+
+# Challenges
+
+- [Day 1]()
+    - [Part 1](../cells/code/challenges/day-01-part1.md)
+    - [Part 2](../cells/code/challenges/day-01-part2.md)
+
+- [Day 2]()
+    - [Part 1](../cells/code/challenges/day-01-part1.md)
+    - [Part 2](../cells/code/challenges/day-01-part2.md)