Merge branch 'feat/240315'

Author: boray-tw

.vscode/settings.json

@@ -6,6 +6,7 @@
   "cSpell.words": [
     "argmax",
     "argmin",
+    "biclique",
     "Biconditional",
     "bijective",
     "blkarray",
@@ -17,6 +18,7 @@
     "datetime",
     "extsizes",
     "graphicx",
+    "Herke",
     "Hsieh",
     "indegree",
     "injective",
@@ -37,7 +39,9 @@
     "pairwisely",
     "parbox",
     "Pregel",
+    "princ",
     "restatable",
+    "Sarada",
     "subfigure",
     "subfile",
     "subrefformat",

README.md

@@ -23,13 +23,12 @@ The handouts should be present by 4 ~ 10 days after the class, based on Ray's wo
 1.  If you've set up Docker, you could skip this sections, for the Docker image [rays2/gt-handout-env](https://hub.docker.com/r/rays2/gt-handout-env) handles all the LaTeX-related dependencies.
 
 1.  Install a TeX distribution which provides the [pdfTeX](https://tug.org/applications/pdftex/) engine. If you need to compile the syllabus, the TeX distro needs to provide XeLaTeX.
+> [!TIP]
+> You could install either [TeX Live](https://www.tug.org/texlive/) or [MikTeX](https://miktex.org/download).
+>
+> Some Linux distributions also provide TeX Live packages from the default package manager (like `apt install texlive` or `pacman -S texlive-bin`, you cannot use `tlmgr` to manage TeX packages).
 
-    > [!TIP]
-    > You could install either [TeX Live](https://www.tug.org/texlive/) or [MikTeX](https://miktex.org/download).
-    >
-    > Some Linux distributions also provide TeX Live packages from the default package manager (like `apt install texlive` or `pacman -S texlive-bin`).
-
-1.  Install the following packages with your TeX distribution.
+3.  Install the following packages with your TeX distribution.
 
     <!--
     When building a Docker image as the environment, the script accesses this package list, so make sure this list covers all required packages to build handouts in a Docker container.
@@ -40,15 +39,15 @@ 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 multirow xifthen ifmtarg
+    babel caption cleveref datetime2 environ geometry ifmtarg listings listingsutf8 mathabx mathtools multirow pdfcol pgf pgfplots preprint ragged2e subfiles tcolorbox tikzfill tools wrapfig xifthen
     ```
 
-    > [!TIP]
-    > With TeX Live, you could use `tlmgr install <packages>`, where `<packages>` is the package list above.
-    >
-    > Replace the package `tools` with `latex-tools` in MikTeX.
+> [!TIP]
+> With TeX Live, you could use `tlmgr install <packages>`, where `<packages>` is the package list above.
+>
+> Replace the package `tools` with `latex-tools` in MikTeX.
 
-1.  (Optional) Install an editor you prefer.
+4.  (Optional) Install an editor you prefer.
     <details>
     <summary>Some editors with LaTeX syntax highlighting (click to expand/hide):</summary>
 

doc/dev-notes.md

@@ -2,13 +2,26 @@
 
 ## Rules
 
-1.  To contribute to this repository, please install [latexindent.pl](https://github.com/cmhughes/latexindent.pl) for formatting TeX files.
+1.  To contribute to this repository, please install [latexindent.pl](https://github.com/cmhughes/latexindent.pl) or TeX package `latexindent` for formatting TeX files.
 
 1.  (Optional) Install the VS Code extension [LaTeX Workshop](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop).
 
-1.  With VS Code, if you're using Arch Linux, please install the following packages for `latexindent` to work.
+1. In Ubuntu, please also set up the dependencies of `latexindent` as follows.install the `apt` package `libyaml-tiny-perl` to provide `YAML::Tiny`. (ref. )
 
-        sudo pacman -S texlive-binextra perl-yaml-tiny
+    ```bash
+    # install the perl package management tool "cpanm" system-wide
+    sudo cpan -i App::cpanminus
+
+    # install the perl package dependencies system-wide
+    sudo cpanm YAML::Tiny
+    sudo cpanm File::HomeDir
+    ```
+
+1.  In Arch Linux, please install the following packages for `latexindent` to work.
+
+    ```bash
+    sudo pacman -S texlive-binextra perl-yaml-tiny
+    ```
 
     <details>
     <summary>Reasons (click to expand/hide):</summary>

src/build-handouts/env-image/Dockerfile

@@ -29,9 +29,10 @@ RUN cd /tmp && \
     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" && \
+    perl ./install-tl -scheme=scheme-basic --no-interaction -texdir="~/.texlive" -no-doc-install -no-src-install && \
     tlmgr backup -q --all --clean=0 && \
     rm -rf "$TL_DOC_PATH" && \
+    find ~/.texlive -name *src* -exec rm {} \; && \
     cd /tmp && \
     rm -rf ./*
 
@@ -40,7 +41,8 @@ ARG PACKAGES=mathtools
 RUN echo "Installing TeX Live packages: ${PACKAGES}" && \
     tlmgr install ${PACKAGES} && \
     tlmgr backup -q --all --clean=0 && \
-    rm -rf "$TL_DOC_PATH"
+    rm -rf "$TL_DOC_PATH" && \
+    find ~/.texlive -name *src* -exec rm {} \;
 
 # patch missing fonts
 ARG SCRIPT_PATCH_FONTS=/tmp/patch-missing-fonts.sh