Re: [PATCH 0/2] Documentation: html: show sections in the sidebar

Hi Jonathan,

On Mon Aug 3, 2026 at 9:13 PM CEST, Jonathan Corbet wrote:
[...]
> This looks like it could be a nice improvement, but I have a couple of
> thoughts...
>
> - Did you check the PDF build to be sure that the captions don't intrude
>   in some sort of obnoxious ways?

It isn't a problem for the Yocto Project documentation PDF. You can have a =
look
at the current PDF for it (with the ":caption:" properties):
https://docs.yoctoproject.org/dev/_static/theyoctoproject.pdf

And here would be the equivalent PDF with the ":caption:" properties _remov=
ed_:
https://lufi.bootlin.com/r/JbwZLTrHzJ#s/bmg9ZecGftbwZjvfJzaeh/ustGIzT1mKYJf=
5Yayu8=3D

I can't spot any differences.

I'm struggling to get things right to build the PDF for the kernel docs, so=
 I
wasn't able to test it :-/ If you have some container image that I could us=
e, it
might help as it seems to be related to my host packages versions.

For ePUBs, as Randy mentioned, TOC is handled differently and the captions =
are
not seen in odd places.

> - I'd tweak the CSS to remove the white space below the section
>   headings, just to bind them to their subsections properly.

Got it, I added that for the next version.

Thanks!
Antonin