!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

351 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation NixOS teams calendar: https://calendar.google.com/calendar/embed?src=b9o52fobqjak8oq8lfkhg3t0qg%40group.calendar.google.com Documentation office hours are open for anyone interested in solving problems, getting contributions reviewed in real time, or becoming a maintainer. Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 80 Servers

Load older messages


SenderMessageTime
29 Nov 2024
@lassulus:lassul.uslassulus changed their profile picture.18:30:24
30 Nov 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk

You have to add entries to nixos/doc/manual/redirects.json, which look like this:

  "<identifier>": [
    "index.html#<identifier>",
  ]

Rationale and design documentation: https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/ni/nixos-render-docs/README.md

Once the page-split is performed, you'll also have to consider the output path of the element referred to by <identifier>, then the shape will have to be

  "<identifier>": [
    "<path/to/output/location>.html#<identifier>",
  ]
15:14:04
2 Dec 2024
@pyrox:pyrox.devdish [Fox/It/She] changed their profile picture.19:59:19
3 Dec 2024
@getchoo:matrix.orggetchoo changed their profile picture.06:06:36
7 Dec 2024
@tek:tryp.io@tek:tryp.io left the room.20:23:19
9 Dec 2024
@karlericsson:matrix.orgkarlericsson joined the room.08:01:46
14 Dec 2024
@yut0:matrix.orgyut0 joined the room.22:42:39
@yut0:matrix.orgyut0Anyone know if there is a way to generate the Appendix A page for nixpkgs (and also home-manager, nix-darwin) using the local pinned version in my flake? I don't update my flake inputs too often, so sometimes the online Appendix A pages drift from my local nixpkgs22:44:40
@toonn:matrix.orgtoonn yut0: Are you maybe looking for `man configuration.nix`? 23:46:31
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.orgdimitarnestorov 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

There are no newer messages yet.


Back to Room ListRoom Version: 6