improved abstract and preface

Author: thomasWeise

README.md

@@ -18,6 +18,6 @@ If you have any questions or suggestions, please contact
 Prof. Dr. [Thomas Weise](http://iao.hfuu.edu.cn/5) (汤卫思教授)
 at the Institute of Applied Optimization (应用优化研究所, [IAO](http://iao.hfuu.edu.cn))
 of the School of Artificial Intelligence and Big Data ([人工智能与大数据学院](http://www.hfuu.edu.cn/jsjx/))
-of [Hefei University](http://www.hfuu.edu.cn/english/) ([合肥学院](http://www.hfuu.edu.cn/)),
+of [Hefei University](http://www.hfuu.edu.cn/english/) ([合肥大学](http://www.hfuu.edu.cn/)),
 in Hefei, Anhui, China (中国安徽省合肥市)
 via email to [[email protected]](mailto:[email protected]) with CC to [[email protected]](mailto:[email protected]).

styles/colors.sty

@@ -9,8 +9,8 @@
 %% Link and Citation Colors
 %%
 \colorlet{href-linkcolor}{hfuu-red!60!black}%
-\colorlet{href-citecolor}{hfuu-red!60!black}%
-\colorlet{href-urlcolor}{hfuu-orange!40!black}%
+\colorlet{href-citecolor}{href-linkcolor}%
+\colorlet{href-urlcolor}{href-linkcolor}%
 %%
 %% Listings Colors
 %%

styles/keys.sty

@@ -23,4 +23,6 @@
 %
 %% Include a pdf with chinese characters
 %% the pdf should have 0.2pt space around the characters of height 11pt, font should be KaiTi
-\protected\gdef\cnPdf#1{(\raisebox{-0.4ex}{\includegraphics[height=2.1ex,keepaspectratio]{\currentDir/#1}})}
+\protected\gdef\cnPdfRaw#1{\raisebox{-0.4ex}{\includegraphics[height=2.1ex,keepaspectratio]{\currentDir/#1}}}%
+\protected\gdef\cnPdf#1{(\cnPdfRaw{#1})}%
+%

styles/listing.sty

@@ -199,11 +199,21 @@ language=bash,%
 %% #2 the local path
 %% #3 the command
 %% #4 the label (exec: will be pre-pended)
-%% #5 the caption
-\protected\gdef\gitOutput#1#2#3#4#5{%
+%% #5 the additional parameters, if any
+\protected\gdef\gitOutputRaw#1#2#3#4#5{%
 \gitExec{#1}{#2}{#3}%
 \expandafter\expandafter\expandafter\edef\expandafter\csname @pwp@gitFile:exec:#4\endcsname{\gitFile}%
-\lstinputlisting[float,style=text_style,label={exec:#4},caption={#5}]{\csname @pwp@gitFile:exec:#4\endcsname}%
+\lstinputlisting[style=text_style#5]{\csname @pwp@gitFile:exec:#4\endcsname}%
+}%
+%
+%% Use latexgit to place a listing with program output.
+%% #1 the git repository
+%% #2 the local path
+%% #3 the command
+%% #4 the label (exec: will be pre-pended)
+%% #5 the caption
+\protected\gdef\gitOutput#1#2#3#4#5{%
+\gitOutputRaw{#1}{#2}{#3}{#4}{,label={exec:#4},caption={#5},float}%
 }%
 %
 %% Use latexgit to place a listing with code and the program output.

text/front/preface/city.pdf

@@ -1,15 +1,59 @@
 \chapter*{Preface}%
 \pdfbookmark{Preface}{preface}%
 %
-This is work in progress.
+This book is intended to be read on an electronic devise.
+Please do not print it.
+Help preserving the environment.
 
-The text of the book itself is actively written and available in the repository \url{\programmingWithPythonRepo}.
-There, you can also submit \href{\programmingWithPythonRepo/issues}{issues}, such as change requests, suggestions, errors, typos, or you can inform me that something is unclear, so that I can improve the book.
+This book is work in progress.
+It will take years to be completed and I plan to keep improving and extending it for quite some time.
 
-This book is released under the \emph{Attribution-NonCommercial-ShareAlike~4.0 International license} (\href{http://creativecommons.org/licenses/by-nc-sa/4.0/}{\mbox{CC~BY-NC-SA~4.0}}).
+This book is freely available.
+You can download its newest version from \url{https://thomasweise.github.io/programmingWithPython/}.
+This version may change since this book is, well, work in progress.
+The book is released under the \emph{Attribution-NonCommercial-ShareAlike~4.0 International license} (\href{http://creativecommons.org/licenses/by-nc-sa/4.0/}{\mbox{CC~BY-NC-SA~4.0}}).
 You can freely share it.
-Please do not print it, though, to preserve the environment.
-
-This book was built using the software versions given in \cref{exec:versions}.
-
-\gitOutput{}{}{scripts/dependencyVersions.sh}{versions}{The versions of the software packages used to build this book.}
+You can also copy text or figures, as long as you cite the book as the original source, e.g., by using the following Bib\TeX:%
+%
+\begin{lstlisting}[style=text_style]
+@book{programmingWithPython,
+ author = {Thomas Weise},
+ title = {Programming with Python},
+ year = {2024},
+ publisher = {Institute of Applied Optimization,
+              School of Artificial Intelligence and Big Data,
+              Hefei University},
+ address = {Hefei, Anhui, China},
+ url = {https://thomasweise.github.io/programmingWithPython}
+}
+\end{lstlisting}
+%
+This book contains a lot of examples.
+You can find all of them in the repository \url{\programmingWithPythonCodeRepo}.
+You can clone this repository and play with these example codes.%
+%
+\begin{sloppypar}%
+The text of the book itself is also available in the repository \url{\programmingWithPythonRepo}.
+There, you can also submit \href{\programmingWithPythonRepo/issues}{issues}, such as change requests, suggestions, errors, typos, or you can inform me that something is unclear, so that I can improve the book.
+Such feedback is most welcome.
+The book is written using \LaTeX\ and this repository contains all the scripts, styles, graphics, and source files of the book (except the source files of the example programs).%
+\end{sloppypar}%
+%
+\strut\vfill\strut%
+%
+%
+\begin{flushleft}%
+Copyright \textcopyright\ 2024\\%
+Prof.~Dr.~\href{http://iao.hfuu.edu.cn/5}{Thomas Weise}~\cnPdf{profWeise}\\%
+at the Institute of Applied Optimization~(\cnPdfRaw{iao}, \href{http://iao.hfuu.edu.cn}{IAO})\\%
+of the School of Artificial Intelligence and Big Data~(\href{http://www.hfuu.edu.cn/jsjx/}{\cnPdfRaw{school}})\\%
+of \href{http://www.hfuu.edu.cn/english}{Hefei University}~(\href{http://www.hfuu.edu.cn}{\cnPdfRaw{uni}}),\\%
+in Hefei, Anhui, China~\cnPdf{city}\\%
+via email to \href{mailto:[email protected]}{[email protected]} with CC to \href{mailto:[email protected]}{[email protected]}.
+\end{flushleft}
+%
+\clearpage%
+%
+\strut\vfill\strut%
+This book was built using the following software versions:%
+\gitOutputRaw{}{}{scripts/dependencyVersions.sh}{versions}{}%

text/front/preface/city.svg

@@ -1,4 +1,10 @@
 %
-This is work in progress.
+The goal of this book is to teach practical programming with the Python language to high school, undergraduate, and graduate students alike.
+Hopefully, readers without prior knowledge can follow the text.
+Therefore, all concepts are introduced using examples and discussed comprehensively.
+All examples are available online in the GitHub repository associated with this book, so that readers can play with them easily.
+Actually, the goal of the book is not just to teach programming, but to teach programming as a part of the software development process.
+This means that from the very beginning, we will attempt to push the reader towards writing clean code with comments and documentation as well as to use various tools for finding potential issues.
+While this book is work in progress, we hope that it will eventually teach all the elements of Python software creation.
+We hope that it can enable readers without prior programming experience to develop beautiful and maintainable software.
 %
-