move to bookbase based building process

Author: thomasWeise

.github/workflows/build.yaml

@@ -1,15 +1,17 @@
 name: publish
 
 on:
-  push:    
+  push:
     branches:
       - main
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/[email protected]
+        with:
+          submodules: true
       - uses: xu-cheng/texlive-action@d9f893f837a29f066e3c70080540976b47263721
         with:
           scheme: full

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "bookbase"]
+	path = bookbase
+	url = https://github.com/thomasWeise/bookbase

README.md

@@ -44,7 +44,7 @@ This version may change since this course and book both are work in progress.
 You can freely share this.
 You can also copy text or figures under the license given below, as long as you cite the book as the original source, e.g., by using the following BibTeX:
 
-<pre>@book{programmingWithPython,<br/>&nbsp;author&nbsp;=&nbsp;{<a href="http://iao.hfuu.edu.cn/5">Thomas&nbsp;Weise</a>},<br/>&nbsp;title&nbsp;=&nbsp;{Programming&nbsp;with&nbsp;Python},<br/>&nbsp;year&nbsp;=&nbsp;{2024},<br/>&nbsp;publisher&nbsp;=&nbsp;{<a href="http://iao.hfuu.edu.cn">Institute&nbsp;of&nbsp;Applied&nbsp;Optimization</a>,<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.hfuu.edu.cn/aibd">School&nbsp;of&nbsp;Artificial&nbsp;Intelligence&nbsp;and&nbsp;Big&nbsp;Data</a>,<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.hfuu.edu.cn/">Hefei&nbsp;University</a>},<br/>&nbsp;address&nbsp;=&nbsp;{Hefei,&nbsp;Anhui,&nbsp;China},<br/>&nbsp;url&nbsp;=&nbsp;{<a href="https://thomasweise.github.io/programmingWithPython">https://thomasweise.github.io/programmingWithPython</a>}<br/>}</pre>
+<pre>@book{programmingWithPython,<br/>&nbsp;author&nbsp;=&nbsp;{<a href="http://iao.hfuu.edu.cn/5">Thomas&nbsp;Weise</a>},<br/>&nbsp;title&nbsp;=&nbsp;{Programming&nbsp;with&nbsp;Python},<br/>&nbsp;year&nbsp;=&nbsp;{2024--2025},<br/>&nbsp;publisher&nbsp;=&nbsp;{<a href="http://iao.hfuu.edu.cn">Institute&nbsp;of&nbsp;Applied&nbsp;Optimization</a>,<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.hfuu.edu.cn/aibd">School&nbsp;of&nbsp;Artificial&nbsp;Intelligence&nbsp;and&nbsp;Big&nbsp;Data</a>,<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.hfuu.edu.cn/">Hefei&nbsp;University</a>},<br/>&nbsp;address&nbsp;=&nbsp;{Hefei,&nbsp;Anhui,&nbsp;China},<br/>&nbsp;url&nbsp;=&nbsp;{<a href="https://thomasweise.github.io/programmingWithPython">https://thomasweise.github.io/programmingWithPython</a>}<br/>}</pre>
 
 **If you have any comments or suggestions regarding the book, or if you spotted an error or typo, please feel free to submit an [issue here](https://github.com/thomasWeise/programmingWithPython/issues).**
 Your feedback would help us to improve the book.

bibliography/bibliography.bib

@@ -1,36 +1,11 @@
 \pdfminorversion=7%
 \documentclass[a4paper,oneside,10pt]{memoir}%
 %
-\setsecnumdepth{subsubsection}%  number down to sub-sub-sections
-%
-%% prepare and set the book margins
-\setlrmarginsandblock{3cm}{3cm}{*}%
-\setulmarginsandblock{2.5cm}{2.5cm}{*}%
-\setlength{\parskip}{3pt}%
-%
-%% Allow more space per page to be consumed by floats.
-%% This is helpful when we later have larger programs as examples.
-\renewcommand{\topfraction}{.85}%
-\renewcommand{\bottomfraction}{.85}%
-\renewcommand{\textfraction}{.15}%
-\renewcommand{\floatpagefraction}{.8}%
-\renewcommand{\dbltopfraction}{.8}%
-\renewcommand{\dblfloatpagefraction}{.8}%
-\setcounter{topnumber}{9}%
-\setcounter{bottomnumber}{9}%
-\setcounter{totalnumber}{20}%
-\setcounter{dbltopnumber}{9}%
-%
-\checkandfixthelayout%
-%
-\usepackage{styles/styles}%  import our own basic styles
-\usepackage{notation/notation}%  import the book-specific notation
-%
-\makeglossaries%  make the glossary
+\xdef\bookbaseDir{./bookbase}%
+\usepackage{bookbase/styles/book}%  import our own basic styles
+\xdef\courseUrlQR{text/front/preface/courseUrl}%
 %
 \title{Programming with Python}%
-\author{Thomas Weise}%
-\date{\today}%
 %%
 \begin{document}%
 %

book.tex

@@ -2,47 +2,4 @@
 
 # Make a draft of the book.
 
-# strict error handling
-set -o pipefail  # trace ERR through pipes
-set -o errtrace  # trace ERR through 'time command' and other functions
-set -o nounset   # set -u : exit the script if you try to use an uninitialized variable
-set -o errexit   # set -e : exit the script if any statement returns a non-true return value
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Welcome to the draft building script."
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): First deleting the git cache."
-rm -rf __git__ || true
-
-currentDir="$(pwd)"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We are working in directory: '$currentDir'."
-scriptDir="$currentDir/scripts"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): The script directory is '$scriptDir'."
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We delete all left over data."
-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."
-venvDir="$(mktemp -d)"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Got temp dir '$venvDir', now creating environment in it."
-python3 -m venv --upgrade-deps --copies "$venvDir"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Activating virtual environment in '$venvDir'."
-source "$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 '$venvDir'."
-"$PYTHON_INTERPRETER" -m 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
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Finished printing all installed packages."
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We now execute the pdflatex compiler script."
-"$scriptDir/pdflatex.sh" "book.tex" quick
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Deactivating virtual environment."
-deactivate
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Deleting virtual environment."
-rm -rf "$venvDir"
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We have finished the book building process."
-evince book.pdf
+./bookbase/scripts/bookDraft.sh

bookbase

@@ -8,47 +8,4 @@ set -o errtrace  # trace ERR through 'time command' and other functions
 set -o nounset   # set -u : exit the script if you try to use an uninitialized variable
 set -o errexit   # set -e : exit the script if any statement returns a non-true return value
 
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Welcome to the book building script."
-
-argument="${1:-}"  # get command line argument, if any
-
-currentDir="$(pwd)"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We are working in directory: '$currentDir'."
-scriptDir="$currentDir/scripts"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): The script directory is '$scriptDir'."
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We delete all left over data."
-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."
-venvDir="$(mktemp -d)"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Got temp dir '$venvDir', now creating environment in it."
-python3 -m venv --upgrade-deps --copies "$venvDir"
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Activating virtual environment in '$venvDir'."
-source "$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 '$venvDir'."
-"$PYTHON_INTERPRETER" -m 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
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Finished printing all installed packages."
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We now execute the pdflatex compiler script."
-"$scriptDir/pdflatex.sh" "book.tex"
-
-if [ "$argument" == "--no-website" ]; then
-    echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Website generation has been disabled."
-else
-    echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We now execute the website building script."
-    "$scriptDir/website.sh"
-    echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Website has been generated."
-fi
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Deactivating virtual environment."
-deactivate
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): Deleting virtual environment."
-rm -rf "$venvDir"
-
-echo "$(date +'%0Y-%0m-%0d %0R:%0S'): We have finished the book building process."
+./bookbase/scripts/bookMake.sh "programmingWithPython" "Programming with Python" "https://thomasweise.github.io/programmingWithPython"