From cb42abfe282a373540d018f44597e3b136946586 Mon Sep 17 00:00:00 2001 From: Minijackson Date: Mon, 27 Feb 2023 11:04:18 +0100 Subject: README: init --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..70eeb2a --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ +# nix-module-doc + +Generate documentation for your NixOS-like modules. + +`nix-module-doc` is capable of generating a markdown file, a manpage, and an +mkbook. + +## Usage + +In your `flake.nix` + +```nix +{ + inputs.nix-module-doc.url = "github:minijackson/nix-module-doc"; + + outputs = inputs: { + nixosModule.yourModule = let + docParams = { + # Where to store the outputs + outputAttrPath = ["your" "module" "outputs"]; + # Where to store the documentation options + optionsAttrPath = ["your" "module" "doc"]; + }; + in { + imports = [ + (inputs.nix-module-doc.lib.modules.doc-options-md docParams) + (inputs.nix-module-doc.lib.modules.manpage docParams) + (inputs.nix-module-doc.lib.modules.mdbook docParams) + ]; + } + }; +} +``` -- cgit v1.2.3