Add initial docs website
This commit is contained in:
parent
cb157b9dce
commit
6854d37560
3 changed files with 70 additions and 0 deletions
42
website/flake.nix
Normal file
42
website/flake.nix
Normal file
|
|
@ -0,0 +1,42 @@
|
|||
{
|
||||
# This is a separate flake file from the one at the root because we don't
|
||||
# want to depend on nixpkgs
|
||||
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.05";
|
||||
|
||||
outputs = { nixpkgs, ... }: let
|
||||
pkgs = import nixpkgs { system = "x86_64-linux"; };
|
||||
lib = pkgs.lib;
|
||||
|
||||
combinatorDocs = lib.pipe
|
||||
{
|
||||
pkgs = throw "Docs must not depend on pkgs";
|
||||
lib = throw "Docs must not depend on lib";
|
||||
helpers = throw "Docs must not depend on helpers";
|
||||
}
|
||||
[
|
||||
(import ../combinators.nix)
|
||||
(lib.filterAttrs (_: v: !(v ? deprecated && v.deprecated)))
|
||||
(lib.mapAttrsToList (k: v: "## ${k}\n**${k} :: ${v.sig}**\n\n${v.doc}"))
|
||||
(lib.concatStringsSep "\n\n")
|
||||
(docs: "# Combinators\n\n${docs}")
|
||||
];
|
||||
|
||||
mkdocsSettings = {
|
||||
site_name = "jail-nix";
|
||||
repo_url = "https://git.sr.ht/~alexdavid/jail.nix";
|
||||
theme = {
|
||||
name = "readthedocs";
|
||||
hljs_languages = [ "nix" ];
|
||||
};
|
||||
};
|
||||
in {
|
||||
packages.x86_64-linux.default = pkgs.runCommand "website" { buildInputs = [ pkgs.mkdocs ]; } ''
|
||||
mkdir -p docs
|
||||
cp ${../README.md} docs/index.md
|
||||
echo ${lib.escapeShellArg combinatorDocs} > docs/combinators.md
|
||||
echo ${lib.escapeShellArg (builtins.toJSON mkdocsSettings)} > mkdocs.yml
|
||||
mkdocs build
|
||||
mv site $out
|
||||
'';
|
||||
};
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue