As is mentioned in FAQ-BUILD.txt, TeX Live 2017/Debian under Ubuntu bionic needs manual upgrades of cleveref, epigraph, and glossaries-extra. Furthermore, glossaries-extra needs manual rollback to v1.48. LaTeX packages at CTAN tend to provide good backward compatibility with older TeX Live releases, but that is not a given. Furthermore, the manual rollback of glossaries-extra done in Dockerfile.bionic might fail once a future release changes its internal structure. As Ubuntu bionic went into its expanded security maintenance phase, let's advance the minimal requirement of TeX Live to 2019/Debian (Ubuntu focal). Remove Dockerfile.bionic and related notes in FAQ-BUILD.txt. Signed-off-by: Akira Yokosawa <akiyks@xxxxxxxxx> --- v2: Amend summary and changelog. -- FAQ-BUILD.txt | 43 +++++++----------------------- docker/Dockerfile.bionic | 57 ---------------------------------------- 2 files changed, 9 insertions(+), 91 deletions(-) delete mode 100644 docker/Dockerfile.bionic diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt index 5867acd9d4d3..e9719a606786 100644 --- a/FAQ-BUILD.txt +++ b/FAQ-BUILD.txt @@ -40,20 +40,12 @@ Alternatively, you can use the container image described in #13 below. Otherwise, instructions follow. - On Ubuntu Bionic and later, the following list should cover + On Ubuntu Focal and later, the following list should cover necessary packages (except for -doc packages): texlive-publishers texlive-pstricks texlive-science texlive-fonts-extra xfig inkscape graphviz - Ubuntu Bionic has a buggy/incompatible version of LaTeX - packages "cleveref" and "glossaries-extra". - See #10 below to install the latest one. - - On Ubuntu Bionic, you also need to fetch a version of - a2ping which is compatible with updated Ghostscript. - See #7 below. - On Fedora, installing the following set of packages suffices: texlive-collection-plaingeneric @@ -122,16 +114,12 @@ "nimbus15", "newtxtt", etc.; or an old version of font package "newtx". How can I install or update them? - A-1. First of all, building perfbook requires TeX Live 2017/Debian - (Ubuntu Bionic) or later. If you are told you don't have - "glossaries-extra" package, you need to upgrade your TeX - installation. - For other optional font packages, upgrading TeX Live - to 2017/Debian (Ubuntu Bionic) or later should suffice. + A-1. First of all, building perfbook requires TeX Live 2019/Debian + (Ubuntu Focal) or later. - Upgrading your Linux distribution (e.g. to Ubuntu Focal) - is one way to upgrade TeX Live (to 2019/Debian on Focal), - and might have many other benefits as well. + Upgrading your Linux distribution (e.g. to Ubuntu Jammy) + is one way to upgrade TeX Live and might have many other + benefits as well. However, on modern TeX Live, installing -fonts-extra consumes more than 1GB of your disk space. If you prefer to manually @@ -209,32 +197,19 @@ - dejavu-fonts-all - liberation-fonts -10. Building perfbook fails with a warning of buggy cleveref or - version mismatch of epigraph. +10. Building perfbook fails with a warning of version mismatch of epigraph. What can I do? - A. They are known issues on Ubuntu Bionic (cleveref, - glossaries-extra), and TeX Live releases prior to 2020 - (epigraph). + A. It is a known issue of TeX Live releases prior to 2020. This answer assumes Ubuntu, but it should work on other distros. - 1. Download whichever package from CTAN mirror: - http://mirrors.ctan.org/macros/latex/contrib/cleveref.zip + 1. Download package archive from CTAN mirror: http://mirrors.ctan.org/macros/latex/contrib/epigraph.zip - http://mirrors.ctan.org/macros/latex/contrib/glossaries-extra.zip 2. Install it by following instructions at: https://help.ubuntu.com/community/LaTeX#Installing_packages_manually - 3. Since October 2022, glossaries-extra uses a modern LaTeX - feature for backward compatibility, which was added in - TeX Live 2018. Unfortunately, TeX Live of Bionic is based - on TeX Live 2017, hence the glossaries-extra package at - CTAN does not work out of the box. - Still, you can manually rollback it to an older version. - See docker/Dockerfile.bionic for how to do it. - B. Instead of above manual steps, you could install the package using a script in this repository, './utilities/install_latex_package.sh'. For example: diff --git a/docker/Dockerfile.bionic b/docker/Dockerfile.bionic deleted file mode 100644 index e1c4c3a9696b..000000000000 --- a/docker/Dockerfile.bionic +++ /dev/null @@ -1,57 +0,0 @@ -FROM ubuntu:bionic - -RUN apt-get update && apt-get install -y locales && \ - localedef -i en_US -c -f UTF-8 -A /usr/share/locale/locale.alias en_US.UTF-8 && \ - rm -rf /var/lib/apt/lists/* -ENV LANG en_US.utf8 -RUN apt-get update && DEBIAN_FRONTEND=noninteractive TZ=UTC apt-get install -y tzdata && \ - rm -rf /var/lib/apt/lists/* -RUN apt-get update && apt-get install -y fig2ps inkscape xfig graphviz psutils \ - texlive-publishers texlive-pstricks texlive-science texlive-fonts-extra \ - make nano vim git curl gnuplot-nox time && \ - rm -rf /var/lib/apt/lists/* -COPY steel-city-comic.regular.ttf /usr/local/share/fonts/ -RUN fc-cache /usr/local/share/fonts/ -WORKDIR /opt -RUN curl https://mirrors.ctan.org/macros/latex/contrib/cleveref.zip -L -O && unzip cleveref.zip && \ - curl https://mirrors.ctan.org/macros/latex/contrib/epigraph.zip -L -O && unzip epigraph.zip && \ - curl https://mirrors.ctan.org/macros/latex/contrib/glossaries-extra.zip -L -O && unzip glossaries-extra.zip && \ - cd cleveref; latex cleveref.ins; cd .. && \ - mkdir -p /usr/local/share/texmf/tex/latex/cleveref && \ - cp cleveref/cleveref.sty /usr/local/share/texmf/tex/latex/cleveref && \ - cd epigraph; latex epigraph.ins; cd .. && \ - mkdir -p /usr/local/share/texmf/tex/latex/epigraph && \ - cp epigraph/epigraph.sty /usr/local/share/texmf/tex/latex/epigraph && \ - cd glossaries-extra; latex glossaries-extra.ins; cd .. && \ - mkdir -p /usr/local/share/texmf/tex/latex/glossaries-extra && \ - cp glossaries-extra/*.sty /usr/local/share/texmf/tex/latex/glossaries-extra && \ - texhash /usr/local/share/texmf && \ - curl https://mirrors.ctan.org/graphics/a2ping.zip -L -O && unzip a2ping.zip && \ - cp a2ping/a2ping.pl /usr/local/bin/a2ping -# Rollback glossaries-extra for pre-2018 TeX Live -RUN cd /usr/local/share/texmf/tex/latex/glossaries-extra/ \ - && mv glossaries-extra.sty glossaries-extra-latest.sty \ - && mv glossaries-extra-bib2gls.sty glossaries-extra-bib2gls-latest.sty \ - && mv glossaries-extra-stylemods.sty glossaries-extra-stylemods-latest.sty \ - && mv glossary-bookindex.sty glossary-bookindex-latest.sty \ - && mv glossary-longextra.sty glossary-longextra-latest.sty \ - && mv glossary-topic.sty glossary-topic-latest.sty \ - && ln -s glossaries-extra-2021-11-22.sty glossaries-extra.sty \ - && ln -s glossaries-extra-bib2gls-2021-11-22.sty glossaries-extra-bib2gls.sty \ - && ln -s glossaries-extra-stylemods-2021-11-22.sty glossaries-extra-stylemods.sty \ - && ln -s glossary-bookindex-2021-11-22.sty glossary-bookindex.sty \ - && ln -s glossary-longextra-2021-11-22.sty glossary-longextra.sty \ - && ln -s glossary-topic-2021-11-22.sty glossary-topic.sty \ - && texhash /usr/local/share/texmf -ARG uid=1000 -ARG gid=1000 -ARG user=perfbook -ARG group=perfbook -RUN if [ $uid -ne 0 ] ; then \ - groupadd -g $gid $group ; \ - useradd -u $uid -g $gid -m $user ; \ - fi -VOLUME /work -USER $uid:$gid -WORKDIR /work -CMD /bin/bash base-commit: 3dace505d308aad265ee0a0c3daa850dbf890966 -- 2.25.1
