| Message ID | 20251211-build-docs-container-tlmgr-v2-0-58719c103a50@bootlin.com |
|---|---|
| Headers | show |
| Series | Add missing CentOS Stream / RockyLinux distros to the system-requirements.rst doc | expand |
On Thu, 11 Dec 2025 10:06:13 +0100, Antonin Godard wrote: > These two distros were missing so add a section for them along with > their list of requirements, which all and all are very similar to > AlmaLinux and Fedora. > > For these distros and AlmaLinux, we now provide a way to build the > documentation PDF using a local installation of TeX Live packages (using > the TeX Live package manager, tlmgr). This is not as nice as the other > distributions where we have a working list of packages for that, but > it's still better than the current nothing, and finding all the required > TeX packages proves to be quite hard. Using tlmgr is also what is > currently done for all the distros on the Autobuilder. > > [...] Applied, thanks! [1/5] tools/build-docs-container: move container files in their own directory commit: 4ee207aa6678812e93a625be84dff87df56610b2 [2/5] Makefile: fix rsvg-convert --format capitalization commit: ec588f83a38439bf4af7d6019169ec4445a72b9a [3/5] tools/build-docs-container: add CentOS Stream 9 support commit: 2989f2fcd9e81f9385fcd2431ec7f3d9e7e507ff [4/5] ref-manual/system-requirements.rst: fix AlmaLinux PDF build commit: 6751174d760a10dfe65d10dd3cc1c57395a10b0a [5/5] ref-manual/system-requirements.rst: add RockyLinux install instructions commit: 5919767adc4b2dbd97fd1506b5f7c7e13ad083dc Best regards, --
These two distros were missing so add a section for them along with their list of requirements, which all and all are very similar to AlmaLinux and Fedora. For these distros and AlmaLinux, we now provide a way to build the documentation PDF using a local installation of TeX Live packages (using the TeX Live package manager, tlmgr). This is not as nice as the other distributions where we have a working list of packages for that, but it's still better than the current nothing, and finding all the required TeX packages proves to be quite hard. Using tlmgr is also what is currently done for all the distros on the Autobuilder. This series also reorganizes the container files to put them in their own directory, along with the new entrypoint which is needed to setup the PATH. Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> --- Changes in v2: - Apply suggestions from Quentin, thanks! - Switch to environment variables directly set in the Containerfile, instead of an entrypoint. - Simplify tar extraction command. - Link to v1: https://patch.msgid.link/20251205-build-docs-container-tlmgr-v1-0-de30623e664d@bootlin.com --- Antonin Godard (5): tools/build-docs-container: move container files in their own directory Makefile: fix rsvg-convert --format capitalization tools/build-docs-container: add CentOS Stream 9 support ref-manual/system-requirements.rst: fix AlmaLinux PDF build ref-manual/system-requirements.rst: add RockyLinux install instructions documentation/Makefile | 4 +- documentation/ref-manual/system-requirements.rst | 102 +++++++++++++++++++-- documentation/tools/build-docs-container | 55 +++++++---- .../tools/containerfiles/Containerfile.almalinux | 1 + .../tools/{ => containerfiles}/Containerfile.apt | 0 .../{ => containerfiles}/Containerfile.debian | 0 .../tools/{ => containerfiles}/Containerfile.dnf | 3 + .../{ => containerfiles}/Containerfile.fedora | 0 .../tools/containerfiles/Containerfile.rocky | 1 + .../Containerfile.stream} | 0 .../{ => containerfiles}/Containerfile.ubuntu | 0 .../{ => containerfiles}/Containerfile.zypper | 0 .../tools/host_packages_scripts/almalinux_docs.sh | 2 +- .../host_packages_scripts/almalinux_docs_pdf.sh | 1 - .../host_packages_scripts/almalinux_essential.sh | 6 +- .../host_packages_scripts/centosstream_docs.sh | 1 + .../centosstream_essential.sh | 5 + .../tools/host_packages_scripts/rockylinux_docs.sh | 1 + .../host_packages_scripts/rockylinux_essential.sh | 5 + .../tools/host_packages_scripts/tlmgr_docs_pdf.sh | 7 ++ 20 files changed, 164 insertions(+), 30 deletions(-) --- base-commit: efa93ba6a9340cf3b3c52525de83aa74ca09c5c9 change-id: 20251205-build-docs-container-tlmgr-0bb2d0c4cce4