Merge pull request #15 from Nadrieril/nix

Author: Nadrieril

.github/workflows/mdbook.yml

@@ -46,6 +46,12 @@ jobs:
           crate: mdbook-linkcheck
           git: https://github.com/schilkp/mdbook-linkcheck
           rev: ed981be6ded11562e604fff290ae4c08f1c419c5
+      - name: Install mdbook-backlinks
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: mdbook-backlinks
+          git: https://github.com/Nadrieril/mdbook-backlinks
+          rev: 526e94fd747d712c75baea840d23f513233e0927
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5

Justfile

@@ -0,0 +1,2 @@
+serve:
+    mdbook serve

book.toml

@@ -19,3 +19,6 @@ level = 0
 [output.linkcheck]
 # This might be too annoying.
 warning-policy = "error"
+
+[preprocessor.backlinks] # https://github.com/Nadrieril/mdbook-backlinks
+optional = true

flake.lock

@@ -0,0 +1,45 @@
+{
+  description = "Beyond Refs";
+
+  inputs = {
+    nixpkgs.url = "nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+    mdbook-backlinks.url = "github:nadrieril/mdbook-backlinks";
+  };
+
+  outputs = inputs @ { self, ... }:
+    inputs.flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = import inputs.nixpkgs { inherit system; };
+
+        # Temporarily pull the fix for https://github.com/Michael-F-Bryan/mdbook-linkcheck/pull/98
+        mdbook-linkcheck = with pkgs; rustPlatform.buildRustPackage {
+          pname = "mdbook-linkcheck";
+          version = "PR-98";
+
+          src = fetchFromGitHub {
+            owner = "schilkp";
+            repo = "mdbook-linkcheck";
+            rev = "ed981be6ded11562e604fff290ae4c08f1c419c5";
+            sha256 = "sha256-GTVWc/vkqY9Hml2fmm3iCHOzd/HPP1i/8NIIjFqGGbQ=";
+          };
+
+          cargoHash = "sha256-+73aI/jt5mu6dR6PR9Q08hPdOsWukb/z9crIdMMeF7U=";
+
+          buildInputs = if stdenv.hostPlatform.isDarwin then [ Security ] else [ openssl ];
+          nativeBuildInputs = lib.optionals (!stdenv.hostPlatform.isDarwin) [ pkg-config ];
+
+          OPENSSL_NO_VENDOR = 1;
+          doCheck = false;
+        };
+      in
+      {
+        devShells.default = pkgs.mkShell {
+          packages = [
+            pkgs.mdbook
+            mdbook-linkcheck
+            inputs.mdbook-backlinks.packages.${system}.default
+          ];
+        };
+      });
+}