about summary refs log tree commit diff
path: root/users/sterni/htmlman/README.md
blob: 258233d4c4d2713aa0f003c1cd273b853b28ed10 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# htmlman

static site generator for man pages intended for
rendering man page documentation viewable using
a web browser.

## usage

If you have a nix expression, `doc.nix`, like this:

```nix
{ depot, ... }:

depot.users.sterni.htmlman {
  title = "foo project";
  pages = [
    {
      name = "foo";
      section = 1;
    }
    {
      name = "foo";
      section = 3;
      path = ../devman/foo.3;
    }
  ];
  manDir = ../man;
}
```

You can run the following to directly deploy the resulting
documentation output to a specific target directory:

```sh
nix-build -A deploy doc.nix && ./result target_directory
```