manual: Integrate mdbook-linkcheck

flake.nix

@@ -56,8 +56,11 @@
     };
 
     devShell = pkgs.mkShell {
-      inputsFrom = [ defaultPackage ];
-      packages = with pkgs; [ clippy mdbook python3 editorconfig-checker rust-analyzer cargo-outdated ];
+      inputsFrom = [ defaultPackage packages.manualFast ];
+      packages = with pkgs; [
+        python3 editorconfig-checker
+        clippy rust-analyzer cargo-outdated
+      ];
       shellHook = ''
         export NIX_PATH=nixpkgs=${pkgs.path}
       '';

manual/book.stable.toml

@@ -10,6 +10,9 @@ site-url = "/colmena/@apiVersion@/"
 git-repository-url = "https://github.com/zhaofengli/colmena"
 edit-url-template = "https://github.com/zhaofengli/colmena/edit/main/manual/{path}"
 
+[output.linkcheck]
+follow-web-links = false
+
 [preprocessor.colmena]
 command = "python3 preprocess.py"
 renderer = [ "html", "epub" ]

manual/book.toml

@@ -10,6 +10,9 @@ site-url = "/colmena/unstable/"
 git-repository-url = "https://github.com/zhaofengli/colmena"
 edit-url-template = "https://github.com/zhaofengli/colmena/edit/main/manual/{path}"
 
+[output.linkcheck]
+follow-web-links = false
+
 [preprocessor.colmena]
 command = "python3 preprocess.py"
 renderer = [ "html", "epub" ]

manual/default.nix

@@ -1,4 +1,4 @@
-{ lib, stdenv, nix-gitignore, mdbook, python3, callPackage, writeScript
+{ lib, stdenv, nix-gitignore, mdbook, mdbook-linkcheck, python3, callPackage, writeScript
 , deploymentOptionsMd ? null
 , metaOptionsMd ? null
 , colmena ? null
@@ -40,7 +40,7 @@ in stdenv.mkDerivation {
 
   src = nix-gitignore.gitignoreSource [] ./.;
 
-  nativeBuildInputs = [ mdbook python3 ];
+  nativeBuildInputs = [ mdbook mdbook-linkcheck python3 ];
 
   outputs = [ "out" "redirectFarm" ];