Merge branch 'feat/240308'

Author: boray-tw

.vscode/settings.json

@@ -8,11 +8,47 @@
     "argmin",
     "Biconditional",
     "bijective",
+    "blkarray",
+    "cleveref",
+    "codomain",
     "colback",
+    "CSIE",
+    "currenvir",
+    "datetime",
+    "extsizes",
+    "graphicx",
+    "Hsieh",
+    "indegree",
     "injective",
+    "Königsberg",
+    "labelformat",
+    "Leonhard",
+    "libfontconfig",
+    "loopless",
+    "multiedge",
+    "multigraph",
+    "multigraphs",
+    "NCKU",
+    "NCTU",
+    "nonstopmode",
+    "noto",
+    "outdegree",
+    "OUTDIR",
+    "pairwisely",
     "parbox",
+    "Pregel",
     "restatable",
-    "subfile"
+    "subfigure",
+    "subfile",
+    "subrefformat",
+    "subsec",
+    "surjective",
+    "synctex",
+    "targetenvir",
+    "unrooted",
+    "upscalepics",
+    "xecjk",
+    "xifthen"
   ],
   "latex-workshop.message.latexlog.exclude": [
     "Unknown CJK family"

README.md

@@ -40,7 +40,7 @@ The handouts should be present by 4 ~ 10 days after the class, based on Ray's wo
     <div id="package-list"></div>
 
     ```
-    babel caption cleveref datetime2 environ geometry listings listingsutf8 mathabx mathtools pdfcol pgf pgfplots preprint ragged2e subfiles tcolorbox tikzfill tools
+    babel caption cleveref datetime2 environ geometry listings listingsutf8 mathabx mathtools pdfcol pgf pgfplots preprint ragged2e subfiles tcolorbox tikzfill tools multirow xifthen ifmtarg
     ```
 
     > [!TIP]
@@ -133,4 +133,4 @@ For content correctness related problems (like misleading definitions) or supple
 
 Contribution like [pull requests](https://github.com/coding-ray/gt-course/pulls) are welcomed.
 
-Please check the [rules and notes](doc/dev-notes.md) before
+Please check the [rules and notes](doc/dev-notes.md) in advance.

doc/dev-notes.md

@@ -37,7 +37,7 @@
 1.  Build the handout-environment image.
 
     ```bash
-    cd src/build-handouts/handout-env-image
+    cd src/build-handouts/env-image
     ./build-handout-env.sh
     ```
 

src/build-handouts/env-image/Dockerfile

@@ -23,25 +23,37 @@ USER ${USERNAME}
 ENV HOME="$HOME_DIR"
 ENV PATH="$HOME/.texlive/bin/x86_64-linux/:$PATH"
 ARG INSTALL_TL_URL="https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz"
+ARG TL_DOC_PATH=$HOME/.texlive/texmf-dist/doc/
 RUN cd /tmp && \
     echo "Downloading TeX Live installer..." && \
     wget -qO- "$INSTALL_TL_URL" --no-check-certificate | tar -xz && \
     cd install-tl-* && \
     echo "Installing TeX Live with basic scheme..." && \
     perl ./install-tl -scheme=scheme-basic --no-interaction -texdir="~/.texlive" && \
     tlmgr backup -q --all --clean=0 && \
+    rm -rf "$TL_DOC_PATH" && \
+    cd /tmp && \
     rm -rf ./*
 
+# install required packages to build the handouts
 ARG PACKAGES=mathtools
 RUN echo "Installing TeX Live packages: ${PACKAGES}" && \
     tlmgr install ${PACKAGES} && \
-    tlmgr backup -q --all --clean=0
+    tlmgr backup -q --all --clean=0 && \
+    rm -rf "$TL_DOC_PATH"
+
+# patch missing fonts
+ARG SCRIPT_PATCH_FONTS=/tmp/patch-missing-fonts.sh
+COPY --chown=$USERNAME:$USERNAME ./patch-missing-fonts.sh $SCRIPT_PATCH_FONTS
+RUN $SCRIPT_PATCH_FONTS && \
+    rm -rf /tmp/*
 
 USER root
 WORKDIR /app
 COPY entrypoint.sh ./entrypoint.sh
 RUN chmod +x ./entrypoint.sh && \
     apt autopurge -qqy wget perl
+# after uninstalling perl, you can not use tlmgr command any more
 
 USER ${USERNAME}
 ENTRYPOINT [ "./entrypoint.sh" ]