!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

439 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
3 Jul 2023
@zmitchell:matrix.org@zmitchell:matrix.orgFeel free to post a comment if I got something wrong16:57:06
@pennae:matrix.eno.spacepennaedamn, has it been two months again 😨17:00:18
@zmitchell:matrix.org@zmitchell:matrix.org I too forgot that time marches forward regardless of my protests 17:01:37
@pennae:matrix.eno.spacepennaefwiw the docbook toolchain also allows fragmenting a document into multiple outputs (nixos manual and epubs used that), but it's horrid to configure and still all docbook :/17:20:07
@pennae:matrix.eno.spacepennae moving away from xhtml outputs going to fun. ncfavier, any idea how much that would break? 17:20:51
@pennae:matrix.eno.spacepennaeeg, does nixos-search use docbook/xhtml?17:21:39
@pennae:matrix.eno.spacepennaethe homepage runs xslt over manual xhtml, which is going to ... Great 😞17:22:39
@ncfavier:matrix.orgncfavier
In reply to @pennae:matrix.eno.space
eg, does nixos-search use docbook/xhtml?
i don't think so
17:37:04
@pennae:matrix.eno.spacepennaethat's good already :)17:38:14
@ncfavier:matrix.orgncfavierwe just render (previously docbook/) markdown snippets to html with pandoc. btw, it would be nice if we could use nixos-render-docs to do that17:38:18
@ncfavier:matrix.orgncfavierthat way we don't need to keep link-manpages.nix around17:38:39
@pennae:matrix.eno.spacepennaethat pretty much just needs a new options render mode that returns a collection of fragments instead of a document, shouldn't be that much work17:39:14
@pennae:matrix.eno.spacepennaethe infra needed to do that is there and used internally to speed up options rendering, it pretty much only needs exported as a mode17:39:48
@pennae:matrix.eno.spacepennae would still like to remove link-manpages.nix from nixpkgs soon, or rather: get that pr merged so it can't diverge and need rework 17:44:42
@m52957:matrix.orgNate joined the room.18:02:38
@ncfavier:matrix.orgncfavieron it18:11:17
@pennae:matrix.eno.spacepennaeawesome 💜18:12:58
@pennae:matrix.eno.spacepennaethanks!18:48:38
@pennae:matrix.eno.spacepennaeand now docbook is no longer 😌18:48:50
@jtojnar:matrix.orgJan Tojnargreat job19:01:04
@pennae:matrix.eno.spacepennaethere's a lot of issues that can be closed now19:03:26
4 Jul 2023
@asymmetric:matrix.dapp.org.ukasymmetricso has the markdown manual been deployed to nixos.org?09:01:20
@asymmetric:matrix.dapp.org.ukasymmetricor when will that happen?09:01:34
@asymmetric:matrix.dapp.org.ukasymmetrichttps://nixpk.gs/pr-tracker.html?pr=23963609:01:35
@pennae:matrix.eno.spacepennae not deployed yet in any case, you'd notice by `...` in lib docs turning into inline code blocks 09:29:56
5 Jul 2023
@pennae:matrix.eno.spacepennae
In reply to @asymmetric:matrix.dapp.org.uk
so has the markdown manual been deployed to nixos.org?
flake update that pulls the manual changes happens on sunday, or whenever someone triggers the necessary workflow
(not going to try)
00:01:12
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @pennae:matrix.eno.space
flake update that pulls the manual changes happens on sunday, or whenever someone triggers the necessary workflow
(not going to try)
It looks like that action only updated nixpkgs, which is not used for the manual
09:43:34
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @pennae:matrix.eno.space
flake update that pulls the manual changes happens on sunday, or whenever someone triggers the necessary workflow
(not going to try)
* It looks like that action only updates nixpkgs, which is not used for the manual
09:43:43
@asymmetric:matrix.dapp.org.ukasymmetrichttps://github.com/NixOS/nixos-homepage/blob/87127a734b9789c222d404e4515a498a31c69edc/.github/workflows/update-flake-lock.yml#L23C4-L23C409:43:51
@asymmetric:matrix.dapp.org.ukasymmetrichttps://github.com/NixOS/nixos-homepage/blob/87127a734b9789c222d404e4515a498a31c69edc/flake.nix#L8C1-L8C109:44:23

Show newer messages


Back to Room ListRoom Version: 6