updated latexgit versions

Author: thomasWeise

.github/workflows/build.yaml

@@ -14,7 +14,7 @@ jobs:
         with:
           scheme: full
           run: |
-            apk add rust cargo gcc linux-headers musl-dev py3-pip python3 python3-dev 
+            apk add cargo gcc linux-headers musl-dev py3-pip python3 python3-dev rust
             ./make.sh
 # deploy to github pages
       - name: deploy documentation

make.sh

@@ -20,14 +20,14 @@ rm "book.pdf" || true
 rm -rf "$currentDir/website" || true
 
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We setup a virtual environment in a temp directory."
-tempDir="$(mktemp -d)"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Got temp dir '$tempDir', now creating environment in it."
-python3 -m venv --system-site-packages "$tempDir"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Activating virtual environment in '$tempDir'."
-. "$tempDir/bin/activate"
-export PYTHON_INTERPRETER="$tempDir/bin/python3"
+venvDir="$(mktemp -d)"
+echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Got temp dir '$venvDir', now creating environment in it."
+python3 -m venv --system-site-packages "$venvDir"
+echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Activating virtual environment in '$venvDir'."
+. "$venvDir/bin/activate"
+export PYTHON_INTERPRETER="$venvDir/bin/python3"
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Setting python interpreter to '$PYTHON_INTERPRETER'."
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We install all required Python packages from requirements.txt to virtual environment in '$tempDir'."
+echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We install all required Python packages from requirements.txt to virtual environment in '$venvDir'."
 pip install --no-input --timeout 360 --retries 100 -r requirements.txt
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Finished installing the requirements, now printing all installed packages."
 pip freeze
@@ -42,6 +42,6 @@ echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We now execute the website building script
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Deactivating virtual environment."
 deactivate
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Deleting virtual environment."
-rm -rf "$tempDir"
+rm -rf "$venvDir"
 
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We have finished the book building process."

requirements.txt

@@ -6,7 +6,7 @@
 # You can find it at https://thomasweise.github.io/latexgit_py,
 # https://github.com/thomasWeise/latexgit_py, or at
 # https://pypi.org/project/latexgit.
-latexgit == 0.8.13
+latexgit == 0.8.14
 
 # minify_html is needed to minify html output.
 minify_html == 0.15.0
@@ -15,4 +15,4 @@ minify_html == 0.15.0
 markdown == 3.6
 
 # for converting files to HTML
-Pygments == 2.16.1
+Pygments == 2.18.0

scripts/filterPdf.sh

@@ -14,6 +14,9 @@ fileOut="$2"
 
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We will filter '$fileIn' to '$fileOut using ghostscript."
 
+tempFileA="$(mktemp --suffix=.pdf)"
+echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We will first filter '$fileIn' to '$tempFileA' using ghostscript."
+
 gs -dAntiAliasColorImages=true \
    -dAntiAliasGrayImages=true \
    -dAntiAliasMonoImages=true \
@@ -54,8 +57,58 @@ gs -dAntiAliasColorImages=true \
    -dSubsetFonts=true \
    -dUNROLLFORMS \
    -sDEVICE=pdfwrite \
-   -sOutputFile="$fileOut" "$fileIn" \
+   -sOutputFile="$tempFileA" "$fileIn" \
    -c "<</NeverEmbed [ ]>> setdistillerparams" \
    -q
 
+echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We now filter '$tempFileA' to '$fileOut' using ghostscript."
+
+gs -dAntiAliasColorImages=true \
+   -dAntiAliasGrayImages=true \
+   -dAntiAliasMonoImages=true \
+   -dAutoFilterColorImages=false \
+   -dAutoFilterGrayImages=false \
+   -dAutoRotatePages=/None \
+   -dBATCH \
+   -dCannotEmbedFontPolicy=/Error \
+   -dColorConversionStrategy=/LeaveColorUnchanged \
+   -dColorImageFilter=/FlateEncode \
+   -dCompressFonts=true \
+   -dCompressStreams=true \
+   -dDetectDuplicateImages=true \
+   -dDownsampleColorImages=false \
+   -dDownsampleGrayImages=false \
+   -dDownsampleMonoImages=false \
+   -dEmbedAllFonts=true \
+   -dFastWebView=false \
+   -dGrayImageFilter=/FlateEncode \
+   -dHaveTransparency=true \
+   -dMaxBitmap=2147483647 \
+   -dNOPAUSE \
+   -dOptimize=true \
+   -dPassThroughJPEGImages=true \
+   -dPassThroughJPXImages=true \
+   -dPDFSTOPONERROR=true \
+   -dPDFSTOPONWARNING=true \
+   -dPreserveCopyPage=false \
+   -dPreserveEPSInfo=false \
+   -dPreserveHalftoneInfo=false \
+   -dPreserveOPIComments=false \
+   -dPreserveOverprintSettings=false \
+   -dPreserveSeparation=false \
+   -dPreserveDeviceN=false \
+   -dPrinted=false \
+   -dQUIET \
+   -dSAFER \
+   -dSubsetFonts=true \
+   -dUNROLLFORMS \
+   -sDEVICE=pdfwrite \
+   -sOutputFile="$fileOut" "$tempFileA" \
+   -c "<</NeverEmbed [ ]>> setdistillerparams" \
+   -q
+
+echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Now deleing '$tempFileA'."
+
+rm "$tempFileA"
+
 echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Successfully finished filtering '$fileIn' to '$fileOut using ghostscript."

styles/latexgit.sty

@@ -6,9 +6,9 @@
 %%
 %% latexgit.dtx  (with options: `package')
 %% This is a generated file.
-%%
-%% Copyright (C) 2023 by Thomas Weise <http://iao.hfuu.edu.cn/5>
-%%
+%% 
+%% Copyright (C) 2023--24 by Thomas Weise <http://iao.hfuu.edu.cn/5>
+%% 
 %% This file may be distributed and/or modified under the conditions of the
 %% GNU GENERAL PUBLIC LICENSE, Version 3, 29 June 2007.
 %% The license can be found at
@@ -19,7 +19,7 @@
 %% This work is author-maintained, i.e., it can only be maintained by
 %% Thomas Weise.
 \NeedsTeXFormat{LaTeX2e}[1999/12/01]%
-\ProvidesPackage{latexgit}[2023/12/05 0.8.1 A version with slightly improved documentation.]%
+\ProvidesPackage{latexgit}[2024/08/02 0.8.4 Improved Build Process.]%
 %%
 %%
 %%
@@ -35,6 +35,7 @@
 
 \end{filecontents*}
 \protected\gdef\@latexgit@gitFile#1#2#3{}%
+\protected\gdef\@latexgit@process#1#2#3{}%
 %%
 %% Define a query to load and post-process a file from a |git| repository.
 %% #1 is the repository URL
@@ -61,6 +62,31 @@
 \xdef\gitUrl{http://example.com}%
 \fi%  If we get here, the |\gitUrl| holds a valid URL.
 }%
+%%
+%% Define a query to execute a command, optionally in a |git| repository.
+%% #1 is the repository URL, or empty if no repository is needed
+%% #2 is the path to a directory inside the repository or empty
+%% #3 is a command to be executed
+\protected\gdef\gitExec#1#2#3{%
+\edef\@latexgit@pA{#1}%  fully expand the repository URL
+\edef\@latexgit@pB{#2}%  fully expand the path into the repository
+\edef\@latexgit@pC{#3}%  fully expand the (optional) shell command
+\immediate\write\@mainaux{%
+\noexpand\@latexgit@process{\@latexgit@pA}{\@latexgit@pB}{\@latexgit@pC}}%
+\advance\@latexgit@counter by 1\relax%
+\edef\@latexgit@pathCmd{@latexgit@path\alphalph{\the\@latexgit@counter}}%
+\expandafter\ifcsname\@latexgit@pathCmd\endcsname\relax%
+\xdef\gitFile{\csname\@latexgit@pathCmd\endcsname}%
+\else%
+\xdef\gitFile{\@latexgit@dummyPath}%
+\fi%  If we get here, the |\gitFile| command holds a valid path.
+\edef\@latexgit@urlCmd{@latexgit@url\alphalph{\the\@latexgit@counter}}%
+\expandafter\ifcsname\@latexgit@urlCmd\endcsname\relax%
+\xdef\gitUrl{\csname\@latexgit@urlCmd\endcsname}%
+\else%
+\xdef\gitUrl{}%
+\fi%  If we get here, the |\gitUrl| holds a valid URL or is empty.
+}%
 \endinput
 %%
 %% End of file `latexgit.sty'.

text/main/basics/simpleDataTypesAndOperations/str/str.tex

@@ -21,7 +21,7 @@
 The quotation marks are only used to delimit the strings, i.e., to tell \python\ where the string begins or ends.
 They are not themselves part of the string.
 
-\bestPractice{strDoubleQuote}{When defining a string literal, the double-quotation mark variant~(\pythonil{"..."}\pythonIdx{\textquotedbl}) is usually preferred over the single-quotation mark variant~(\pythonil{'...'}\pythonIdx{\textquotesingle}).}
+\bestPractice{strDoubleQuote}{When defining a string literal, the double-quotation mark variant~(\pythonil{"..."}\pythonIdx{\textquotedbl}) may be preferred over the single-quotation mark variant~(\pythonil{'...'}\pythonIdx{\textquotesingle}); see also~\cref{bp:longstrDoubleQuote}.}
 
 One basic operation is string concatenation\pythonIdx{str!concatenation}\pythonIdx{str!+}\pythonIdx{+}:
 \pythonil{"Hello" + ' ' + "World"}\pythonIdx{\textquotedbl}\pythonIdx{\textquotesingle} concatenates the three strings \pythonil{"Hello"}, \pythonil{" "}, and \pythonil{"World"}.