>From a439bdb6aedf1ba06600c060e865d872580b0596 Mon Sep 17 00:00:00 2001 From: Akira Yokosawa <akiyks@xxxxxxxxx> Date: Wed, 6 Jan 2021 19:03:55 +0900 Subject: [PATCH v2 2/2 -perfbook] FAQ-BUILD: Add Q&A on Docker image The template Dockerfile and the usage explained is a tutorial level. Suggestions from Docker-savvy people are more than welcome. Signed-off-by: Akira Yokosawa <akiyks@xxxxxxxxx> --- FAQ-BUILD.txt | 38 +++++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt index 2eeb9fbb..f6c720b8 100644 --- a/FAQ-BUILD.txt +++ b/FAQ-BUILD.txt @@ -36,7 +36,11 @@ find it? A. The "pdflatex" package is a variant of Don Knuth's - digital typesetting program. On Ubuntu Xenial, + digital typesetting program. + If you'd like to use a Docker container, See #14 below. + Otherwise, instructions follow. + + On Ubuntu Xenial, installing the following set of packages suffices: texlive-latex-base texlive-latex-extra psutils @@ -71,8 +75,10 @@ On other Linux distributions such as RHEL/CentOS and Scientific Linux, where support of TeX Live packages - is insufficient, installing upstream TeX Live should - be a reasonable choice. + is insufficient, using a Docker container is the easiest + choice for you. Again, see #14 below. + + Of course, you can install upstream TeX Live. See: https://www.tug.org/texlive/quickinstall.html NOTE: In doing so, you might end up in having @@ -273,3 +279,29 @@ sudo updmap-sys --syncwithtrees --force sudo updmap-sys + +14. I want a stable environment to build perfbook.pdf. + Isn't some container image available in that regard? + + A. You can find a template Dockerfile under the docker/ + subdirectory. + A docker image built from it can be pulled by: + + docker pull akiyks/perfbook-build-focal:latest + + It can be run with the command: + + docker run --rm -it -v <path to perfbook dir>:/work \ + -u $(id -u):$(id -g) \ + akiyks/perfbook-build-focal:latest bash + + Note: + The prebuilt Docker image assumes <uid:pid> = <1000:1000>. + If you have different ids, bash prompt will be in the + form of "I have no name!@abcdef012345:/work$". + There is no problem in building perfbook. + If you'd like, you can build a docker image on your own. + + cd docker + docker build -t <docker image tag> \ + --build-arg uid=$(id -u) --build-arg gid=$(id -g) . -- 2.17.1
