As everybody here is probably aware of, the current Nixpkgs and NixOS manual user experience is not ideal. While there are official solutions being worked on, it might still be quite some time until they are complete. In the meantime, I decided to implement a temporary “band-aid” solution that will improve the manual experience for now.
There’s a link in the GitHub readme “installation” section (it simply links to the latest release). After installing it just open the Nixpkgs or NixOS manual like you usually would, and you’ll see the enhanced interface.
It works via a userscript manager, which is an add-on, yes. Firefox for Android supports add-ons, so it would be possible to make it work there. However, it does not support the ‘:has()’ selector, which is used in this userscript. I could attempt making it work without it if people are interested.
Though, just to make sure, why is the page-per-section most important on mobile for you? If it’s to save bandwidth, this will not affect that. This works by injecting some JavaScript into the manual page after it’s loaded, splitting the content by sections, and saving it to memory. So the whole manual is still downloaded.
If you want a true page-per-section experience, you’ll need to wait for something like mmdoc (Nixpkgs PR, NixOS PR). There are some demo renders which you can browse anywhere, but those are incomplete (transition to CommonMark still ongoing) and outdated as soon as there is new content in the manual (at least until the demos are re-rendered), which is why I took this approach instead.
