Add named id to all chapters, sections, and appendices so they are easier to link to. #292
Conversation
they are easier to link to.
|
Is it possible to expose these links to the user, so that you can actually copy a link in the browser, without hunting for the id in the HTML source? |
|
The associated issue is NixOS/nixpkgs#3082 |
doc/manual/builtins.xml
Outdated
| @@ -1,6 +1,6 @@ | |||
| <section xmlns="http://docbook.org/ns/docbook" | |||
| xmlns:xlink="http://www.w3.org/1999/xlink" | |||
| xml:id='ssec-builtins'> | |||
| xml:id='sec-builtins'> | |||
There was a problem hiding this comment.
Please don't change existing IDs, as that breaks existing hyperlinks to specific sections.
|
Why add all these anchors for backward compatibility? Why not just not change the existing anchors? |
|
I have about 100+ anchors coming along with customization to html generation which will make it easier to share the links by having them part of the title.. This way all the links have a similar naming scheme. It makes it easier to maintain, grep and so on. If you really wish I can change it all back, but I figured a consistent naming scheme would be good for all. I certainly do not wish to goldplate anything but I thought consistency was a good idea. :) |
Conflicts: doc/manual/release-notes.xml
|
This is kind-of superseeded by NixOS/nixos-homepage@e0a1c8b |
I have been running @NixOsTips and linking to various parts of the manual. However automaticic id generation can change so I went over all the items and attached more properly named ids like chap- sec- appx- and so on.