Upstream documentation has been changed a few years ago to point to
https rather than http, but for example ubuntu-2023.10 still has only
http in its catalog file. So use http here, and change the catalog file
in blfs to have both http and https...
There is no navigation header on this page, and after scrolling
to the bottom, it is good to be able to click "Next" and not have
to scroll back to top to click on "Preface".
Since the box that may scroll does not contain that box now, it does
not move when the scrollbar is actioned. The only fixed window now is
the div containing sect2/text. Its top has to be adjusted by trial and
error. But the rendering seems ok for all borwsers I can try (epiphany,
falkon and firefox).
The padding for the containing box was not right/left symmetric because
the order of padding values is not trivial in css (top right bottom
left). Making right and left equal allows to center the Up/Home box more
precisely. Then some tweaks for Next and Prev boxes have to be removed.
- Have the section title stay visible always
- have a clicked link appear in full
- only scroll the sect2 and below (use overflow: auto so that falkon
does not display scrollbars when not needed)
- remove the footer that is not needed since we have the header
The template for sect3.titlepage generates:
<h3 class="sect3">
<a id="{id of sect3}" name="{id of sect3}"></a>
<h4 class="title">
<a id="{id of sect3}" name="{id of sect3}">i{title of sect3}</a>
</h4>
</h3>
resulting in double definition of the same id, which is a validity error
in XML documents.
Replace with the same template as for sect2, using h3 instead of h2.
The template named generate-basic-index in
{docbook-xsl}/xhtml/autoidx.xsl has a bug that generates a div element
with a wrong xmlns:xlink attribute. See
https://github.com/docbook/xslt10-stylesheets/issues/239.
Rather than fixing docbook-xsl, which would work only in LFS (but we
want to be able to render on other distros), copy the faulty template
to our customization files (lfs-index.xsl), so that this one is used.
We can also simplify it a lot since we don't need all the cases
covered in general docbook-xsl.
Also remove the sed for this bug in the Makefile.
Remove python2 remnants from six and make som minor text changes.
Remove legacy elements from lfs-xsl stylesheet.
Minor text change in pip3 xinclude file.