feat(modules/programs/dotfiles): install documentation as manpages

Improve documentation accessibility by installing it as manpages.

hosts/eachDefaultSystem.nix

@@ -68,6 +68,7 @@ inputs.homeManager.lib.homeManagerConfiguration {
         ../modules/homeManager/systemd/user/tmpfiles/rules
         ../modules/homeManager/wayland/windowManager/hyprland
         ../modules/homeManager/xdg
+        ../modules/programs/dotfiles
         ../modules/programs/nixvim
         ../modules/services/battery
         ../modules/stylix
@@ -161,7 +162,11 @@ inputs.homeManager.lib.homeManagerConfiguration {
             xdg.enable = true;
           };
 
-          programs.nixvim.enable = true;
+          programs = {
+            dotfiles.enable = true;
+            nixvim.enable = true;
+          };
+
           services.battery.enable = true;
           stylix.enable = true;
           wayland.enable = true;

modules/programs/dotfiles/default.nix

@@ -0,0 +1,47 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}: {
+  imports = [../../homeManager/programs/man];
+  options.modules.programs.dotfiles.enable = lib.mkEnableOption "dotfiles";
+
+  config = lib.mkIf config.modules.programs.dotfiles.enable {
+    modules.homeManager.programs.man.enable = true;
+
+    home.packages = [
+      (pkgs.stdenv.mkDerivation
+        {
+          installPhase = let
+            manDirectory = "share/man";
+            tmpDirectory = "assets";
+          in ''
+            mkdir --parent "$out/${tmpDirectory}"
+
+            trap "rm --force --recursive $out/${tmpDirectory}" EXIT
+
+            ${pkgs.fd.pname} \
+              --extension adoc \
+              -X \
+              ${pkgs.asciidoctor-with-extensions.meta.mainProgram} \
+              --backend manpage \
+              --destination-dir "$out/${tmpDirectory}"
+
+            ${pkgs.fd.pname} --type file . "$out/${tmpDirectory}" |
+              while read -r file; do
+                filename="$(basename --suffix .gz "$file")"
+                output_directory="$out/${manDirectory}/man''${filename##*.}"
+
+                mkdir --parent "$output_directory"
+                mv "$file" "$output_directory"
+              done
+          '';
+
+          name = "dotfiles";
+          nativeBuildInputs = with pkgs; [asciidoctor-with-extensions fd man];
+          src = ../../..;
+        })
+    ];
+  };
+}