!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

374 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
15 Dec 2024
@yut0:matrix.orgyut0Oh hell yeah thank you11:19:39
@yut0:matrix.orgyut0Do you know if there's a way to generate the html pages as well / if the equivalent exists for home-manager?11:21:27
@toonn:matrix.orgtoonn yut0: `man home-configuration.nix` I have no idea about generation of the html pages I'm sure someone else will chime in though. 11:26:28
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @yut0:matrix.org
Do you know if there's a way to generate the html pages as well / if the equivalent exists for home-manager?
For figuring out how the appendix is built, check the Nixpkgs repo in doc/default.nix and follow the call graph from there. Home Manager uses the same source code, check its source code starting from default.nix, there’s a doc attribute that builds the module documentation
17:36:09
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @yut0:matrix.org
Do you know if there's a way to generate the html pages as well / if the equivalent exists for home-manager?
* For figuring out how the appendix is built, check the Nixpkgs repo in doc/default.nix and follow the call graph from there. Home Manager uses the same tooling, check its source code starting from default.nix, there’s a doc attribute that builds the module documentation
17:36:24
@mel:rnrd.euMel changed their profile picture.21:38:58
18 Dec 2024
@dmiskovic:matrix.org@dmiskovic:matrix.org joined the room.19:37:53
21 Dec 2024
@stablejoy:matrix.org@stablejoy:matrix.org left the room.05:08:24
@dmiskovic:matrix.org@dmiskovic:matrix.org left the room.05:13:53
@stablejoy:matrix.org@stablejoy:matrix.org joined the room.06:43:12
@dimitarnestorov:matrix.orgDimitar joined the room.19:42:45
22 Dec 2024
@stablejoy:matrix.org@stablejoy:matrix.org left the room.13:25:00
@allrealmsoflife:matrix.orgallrealmsoflife joined the room.15:55:13
24 Dec 2024
@yut0:matrix.orgyut0 What's the canonical way of generating the options html pages? pkgs.nixpkgs-manual.override { nixpkgs = <your current instance>; } seems like the way to go for the main manual page, but it doesn't build the options page. pkgs.nixpkgs-manual.optionsDoc has derivations for asciidoc, markdown, and json, but no html.
Alternatively, it looks like you can directly call the same derivation hydra uses to build these pages, i.e. "${(import "${nixpkgs}/nixos/release.nix" { inherit nixpkgs; }).manualHTML.x86_64-linux}/share/doc/nixos", which does build all of the manual pages, but this seems cursed..
02:13:35
@karlthane:matrix.orgkarlthane joined the room.14:11:28
26 Dec 2024
@elikoga:matrix.orgelikoga changed their display name from elikoga to elikoga (@38c3 πŸ“ž448{0,1}.15:21:37
@elikoga:matrix.orgelikoga changed their display name from elikoga (@38c3 πŸ“ž448{0,1} to elikoga (@38c3 πŸ“ž448{0,1}).15:25:56
@elikoga:matrix.orgelikoga changed their display name from elikoga (@38c3 πŸ“ž448{0,1}) to elikoga (@38c3 πŸ“ž488{0,1}).15:26:34
@phaer:matrix.orgphaer changed their display name from phaer to phaer (8650 at 38c3).17:41:23
@lorenzleutgeb:matrix.orgLorenz Leutgeb πŸ“ž6343 changed their display name from Lorenz Leutgeb to Lorenz Leutgeb (πŸ“ž6343).19:33:21
@lorenzleutgeb:matrix.orgLorenz Leutgeb πŸ“ž6343 changed their display name from Lorenz Leutgeb (πŸ“ž6343) to Lorenz Leutgeb πŸ“ž6343.19:36:36
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki
In reply to @yut0:matrix.org
What's the canonical way of generating the options html pages? pkgs.nixpkgs-manual.override { nixpkgs = <your current instance>; } seems like the way to go for the main manual page, but it doesn't build the options page. pkgs.nixpkgs-manual.optionsDoc has derivations for asciidoc, markdown, and json, but no html.
Alternatively, it looks like you can directly call the same derivation hydra uses to build these pages, i.e. "${(import "${nixpkgs}/nixos/release.nix" { inherit nixpkgs; }).manualHTML.x86_64-linux}/share/doc/nixos", which does build all of the manual pages, but this seems cursed..
I think markdown is the html its just badly named
20:22:36
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiYou can use this: https://noogle.dev/f/pkgs/nixosOptionsDoc You need to look into the source Code for documentation unfortunately 20:24:13
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiIt depends what you want to do really. If you give more details what you want to do there might be a better way20:27:31
27 Dec 2024
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius to raitobezarius (DECT: 3538 / EPVPN 2681).07:33:13
@garbas:matrix.org@garbas:matrix.org left the room.10:29:14
@dimitarnestorov:matrix.orgDimitar set a profile picture.11:41:11
@dimitarnestorov:matrix.orgDimitar changed their display name from dimitarnestorov to Dimitar.11:42:10
28 Dec 2024
@matthewcroughan:defenestrate.itmatthewcroughan changed their display name from matthewcroughan to matthewcroughan (DECT: 56490).18:39:33
29 Dec 2024
@elikoga:matrix.orgelikoga changed their display name from elikoga (@38c3 πŸ“ž488{0,1}) to elikoga (@38c3 πŸ“ž488{0,1,9}).11:02:52

Show newer messages


Back to Room ListRoom Version: 6