nix: Build the 'docs' in CI

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: 'Docs'
+on:
+  push:
+    branches:
+    - main
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install Nix
+      uses: DeterminateSystems/nix-installer-action@main
+
+    - name: Nix Cache
+      uses: DeterminateSystems/magic-nix-cache-action@main
+
+    - name: Build Docs
+      run: |
+        nix build .
+
+    - name: 'Upload Artifact'
+      uses: actions/upload-artifact@v4
+      with:
+        name: 'out'
+        path: result/

.gitignore

@@ -41,3 +41,4 @@ vim/plugged
 
 zsh/antigen.zsh
 *.sqlite
+result

docs/default.nix

@@ -0,0 +1,19 @@
+{
+  stdenv,
+  python3Packages,
+}:
+
+let awdur = python3Packages.awdur; in
+
+stdenv.mkDerivation {
+  pname = "dotfiles-site";
+  version = "1.0";
+
+  src = ./.;
+
+  buildCommand = ''
+    mkdir $out
+    ${awdur}/bin/awdur bind "$src/index.rst"
+    cp out.html $out
+  '';
+}

docs/index.rst

@@ -0,0 +1,4 @@
+Dotfiles
+========
+
+Here lies the dotfiles.

flake.nix

@@ -4,17 +4,23 @@
   inputs = {
     nixpkgs-stable.url = "github:NixOS/nixpkgs/nixos-23.11";
     nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
+
+    awdur = {
+      url = "github:swyddfa/awdur";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+
     home-manager = {
       url = "github:nix-community/home-manager";
       inputs.nixpkgs.follows = "nixpkgs";
     };
   };
 
-  outputs = { nixpkgs-stable, nixpkgs, home-manager, ... }:
+  outputs = { awdur, nixpkgs-stable, nixpkgs, home-manager, ... }:
     let
       system = "x86_64-linux";
       pkgs-stable = nixpkgs-stable.legacyPackages.${system};
-      pkgs = nixpkgs.legacyPackages.${system};
+      pkgs = import nixpkgs { inherit system; overlays = [awdur.overlays.default];};
     in {
       homeConfigurations."alex" = home-manager.lib.homeManagerConfiguration {
         # Use the latest and greatest for the user env.
@@ -28,9 +34,11 @@
         # to pass through arguments to home.nix
       };
 
-      # Use stable branch for the base system.
+      packages."${system}".default = pkgs.callPackage ./docs {};
+
       nixosConfigurations.alex-desktop = nixpkgs-stable.lib.nixosSystem {
         inherit system;
+        # Use stable branch for the base system.
         pkgs = pkgs-stable;
         modules = [ ./systems/alex-desktop/configuration.nix ];
       };