cafkafk/nixpkgs
cafkafk/nixpkgs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2

doc: fix code to generate links for headings in the manual

Browse source
This commit is contained in:
DS 2024-03-21 02:53:14 -07:00
parent b2f2956473
commit cf94a85e99
2 changed files with 3 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
doc/anchor-use.js
View file

@ -1,3 +1,3 @@
document.addEventListener('DOMContentLoaded', function(event) { document.addEventListener('DOMContentLoaded', function(event) {
anchors.add('h1:not(div.note h1, div.warning h1, div.tip h1, div.caution h1, div.important h1), h2:not(div.note h2, div.warning h2, div.tip h2, div.caution h2, div.important h2), h3:not(div.note h3, div.warning h3, div.tip h3, div.caution h3, div.important h3), h4:not(div.note h4, div.warning h4, div.tip h4, div.caution h4, div.important h4), h5:not(div.note h5, div.warning h5, div.tip h5, div.caution h5, div.important h5), h6:not(div.note h6, div.warning h6, div.tip h6, div.caution h6, div.important h6)'); anchors.add('h1[id]:not(div.note h1, div.warning h1, div.tip h1, div.caution h1, div.important h1), h2[id]:not(div.note h2, div.warning h2, div.tip h2, div.caution h2, div.important h2), h3[id]:not(div.note h3, div.warning h3, div.tip h3, div.caution h3, div.important h3), h4[id]:not(div.note h4, div.warning h4, div.tip h4, div.caution h4, div.important h4), h5[id]:not(div.note h5, div.warning h5, div.tip h5, div.caution h5, div.important h5), h6[id]:not(div.note h6, div.warning h6, div.tip h6, div.caution h6, div.important h6)');
}); });

5
pkgs/tools/nix/nixos-render-docs/src/nixos_render_docs/html.py
View file

@ -181,7 +181,7 @@ class HTMLRenderer(Renderer):
if hstyle: if hstyle:
hstyle = f'style="{escape(hstyle, True)}"' hstyle = f'style="{escape(hstyle, True)}"'
if anchor := cast(str, token.attrs.get('id', '')): if anchor := cast(str, token.attrs.get('id', '')):
anchor = f'<span id="{escape(anchor, True)}"></span>' anchor = f'id="{escape(anchor, True)}"'
result = self._close_headings(hlevel) result = self._close_headings(hlevel)
tag = self._heading_tag(token, tokens, i) tag = self._heading_tag(token, tokens, i)
toc_fragment = self._build_toc(tokens, i) toc_fragment = self._build_toc(tokens, i)
@ -192,8 +192,7 @@ class HTMLRenderer(Renderer):
f' <div class="titlepage">' f' <div class="titlepage">'
f' <div>' f' <div>'
f' <div>' f' <div>'
f' <{htag} class="title" {hstyle}>' f' <{htag} {anchor} class="title" {hstyle}>'
f' {anchor}'
) )
def heading_close(self, token: Token, tokens: Sequence[Token], i: int) -> str: def heading_close(self, token: Token, tokens: Sequence[Token], i: int) -> str:
heading = self._headings[-1] heading = self._headings[-1]