.gitignore

@@ -79,7 +79,7 @@ _minted*
 *.swp
 *.swo
 
-main-*.pdf
+main.pdf
 listings-mode.tex
 exercise-mode.tex
 public

Makefile

@@ -10,7 +10,7 @@ clean:
 	@echo Cleaning up temporary files.
 	@rm -rf public/*
 	@rm -rf temp/*
-	@rm -f main-{script,exercises,solutions}.{aux,loc,log,out,pdf,soc,toc}
+	@rm -f {main,script-only}.{aux,loc,log,out,pdf,soc,toc}
 
 # Compile listings (only needed when listings have changed)
 listings: listings/**/*
@@ -21,9 +21,10 @@ tasks: exercises/**/*
 	./compile_tasks
 
 # Compile a preview PDF containing all contents
-preview: main-script.tex
+preview: main.tex
+	echo "\newcommand\exercisemode{any}" > exercise-mode.tex
 	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
-	pdflatex -shell-escape main-script.tex
+	pdflatex -shell-escape main.tex
 	@echo
 	@echo
 	@echo Run \'make publication\' to generate PDF and ZIP file for publication.
@@ -41,61 +42,51 @@ publication-dir:
 	mkdir -p temp/
 
 # Compile a printable PDF without exercises
-publication-pdf-without-exercises: clean publication-dir main-script.tex
+publication-pdf-without-exercises: clean publication-dir main.tex
+	echo "\newcommand\exercisemode{none}" > exercise-mode.tex
 	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
-	pdflatex -shell-escape main-script.tex
-	pdflatex -shell-escape main-script.tex
-	pdflatex -shell-escape main-script.tex
-	mv main-script.pdf public/
+	pdflatex -shell-escape -jobname=script-only main.tex
+	pdflatex -shell-escape -jobname=script-only main.tex
+	pdflatex -shell-escape -jobname=script-only main.tex
+	mv script-only.pdf public/
 	
 # Compile a printable PDF with exercises and without solutions
-publication-pdf-with-exercises: clean publication-dir main-exercises.tex
+publication-pdf-with-exercises: clean publication-dir main.tex
+	echo "\newcommand\exercisemode{exercises}" > exercise-mode.tex
 	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
-	pdflatex -shell-escape main-exercises.tex
-	pdflatex -shell-escape main-exercises.tex
-	pdflatex -shell-escape main-exercises.tex
-	mv main-exercises.pdf public/
+	pdflatex -shell-escape -jobname=script-with-exercises main.tex
+	pdflatex -shell-escape -jobname=script-with-exercises main.tex
+	pdflatex -shell-escape -jobname=script-with-exercises main.tex
+	mv script-with-exercises.pdf public/
 
-# Compile a printable PDF with solutions
-publication-pdf-with-solutions: clean publication-dir main-solutions.tex
+# Compile a printable PDF with exercises and solutions
+publication-pdf-with-solutions: clean publication-dir main.tex
+	echo "\newcommand\exercisemode{solutions}" > exercise-mode.tex
 	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
-	pdflatex -shell-escape main-solutions.tex
-	pdflatex -shell-escape main-solutions.tex
-	pdflatex -shell-escape main-solutions.tex
-	mv main-solutions.pdf public/
-
-# Build a ZIP file without tasks
-publication-zip-without-exercises: clean publication-dir
-	rm -rf temp/*
-	cp --parents main-script.tex praeamble.tex commands.tex setup.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java,txt} titlepage.tex imprint.tex temp/
-	cd temp && zip ../public/project-without-exercises * **/* **/**/*
-
+	pdflatex -shell-escape -jobname=script-with-solutions main.tex
+	pdflatex -shell-escape -jobname=script-with-solutions main.tex
+	pdflatex -shell-escape -jobname=script-with-solutions main.tex
+	mv script-with-solutions.pdf public/
 
 # Build a ZIP file with tasks and without solutions
-publication-zip-with-exercises: clean publication-dir
-	rm -rf temp/* exercises/**/_*
-	cp --parents main-exercises.tex praeamble.tex commands.tex setup.tex graphics/* listings/**/*.{tex,pdf,bib,java,txt} titlepage.tex imprint.tex first-steps-with-latex.tex temp/
+publication-zip-with-exercises: clean publication-dir main.tex
+	rm -rf temp/*
+	cp --parents main.tex praeamble.tex commands.tex setup.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java,txt} temp/
 	cp --parents exercises/**/* temp/
-	rm -f temp/exercises/**/*.done.{tex,bib,synctex.gz}
+	rm -f temp/exercises/**/*.done.{tex,bib}
 	rm -f temp/exercises/**/*.rend.tex
-	rm -f temp/exercises/**/*.aux
 	find temp/ -name '*.raw.*' -exec bash -c 'sed "s/\.raw\./\./g" <<<{} | xargs mv {}' \;
 	find temp/ -name '*.tex' -exec sed -i -e 's/\.raw\./\./g' {} \;
-# TODO: Replacement of .raw not working.
-	sed -e 's/\.raw//g' temp/main-exercises.tex > temp/main-exercises.tex
 	cd temp && zip ../public/project-with-exercises * **/* **/**/*
 
 # Build a ZIP file with tasks and solutions
-publication-zip-with-solutions: clean publication-dir
-	rm -rf temp/* exercises/**/_*
-	cp --parents main-solutions.tex praeamble.tex commands.tex setup.tex graphics/* listings/**/*.{tex,pdf,bib,java,txt} titlepage.tex imprint.tex first-steps-with-latex.tex temp/
+publication-zip-with-solutions: clean publication-dir main.tex
+	rm -rf temp/*
+	cp --parents main.tex praeamble.tex commands.tex setup.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java,txt} temp/
 	cp --parents exercises/**/* temp/
-	rm -f temp/exercises/**/*.raw.{tex,bib,synctex.gz}
-	rm -f temp/exercises/**/*.aux
+	rm -f temp/exercises/**/*.raw.{tex,bib}
 	find temp/ -name '*.done.*' -exec bash -c 'sed "s/\.done\./\./g" <<<{} | xargs mv {}' \;
 	find temp/ -name '*.tex' -exec sed -i -e 's/(raw|done)//g' {} \;
-# TODO: Replacement of .done not working.
-	sed -e 's/\.done//g' temp/main-solutions.tex > temp/main-solutions.tex
 	cd temp && zip ../public/project-with-solutions  * **/* **/**/*
 
 	

commands.tex

@@ -241,3 +241,69 @@
 	\end{figure}
 }
 
+% Exercise mode
+% =============
+% The exercise mode can be chosen by writing one of the following to the exercise-mode.tex file before compilation:
+% \newcommand\exercisemode{none}      % for a blank script without exercises
+% \newcommand\exercisemode{exercises} % for a script with exercises only
+% \newcommand\exercisemode{solutions} % for a script with solutions only
+% \newcommand\exercisemode{any}       % for a script containing all available material
+% The following lines include that file or make \exercisemode default to 'any' so that any derivatives of this project will work even without the file.
+\IfFileExists{exercise-mode.tex}{
+	\input{exercise-mode.tex}
+}{
+	\newcommand\exercisemode{any}
+}
+
+% Exercises
+% =========
+% Includes the task.tex file within the given subfolder of exercises and adds a heading.
+\newcommand\exercise[1]{
+	\ifthenelse{\equal{\exercisemode}{none}}{
+		% Exercises disabled.
+	}{
+		\newpage
+		\definecolor{latexblue}{rgb}{0.9,0.925,0.95}
+		\pagecolor{latexblue}
+		%\definecolor{latexblue}{rgb}{0.73,0.84,0.92}
+		\section*{Exercise \thechapter}
+		\addcontentsline{toc}{section}{Exercise}%
+		\input{exercises/#1/task.tex}
+		\newpage
+		\nopagecolor
+	}
+}
+
+% Exercise Material
+% =================
+% Takes a project-relative path, and inserts matching exercise material and/or solutions, depending on the exercise mode.
+\newcommand\exercisematerial[1]{
+	% Mode 'exercises': raw material only
+	\ifthenelse{\equal{\exercisemode}{exercises}}{
+		\IfFileExists{#1.raw.tex}{
+			\input{#1.raw.tex}
+		}{}
+	}{}
+	% Mode 'solutions': completed material only
+	\ifthenelse{\equal{\exercisemode}{solutions}}{
+		\IfFileExists{#1.done.tex}{
+			\input{#1.done.tex}
+		}{}
+	}{}
+	% Mode 'any': all existing material. If both raw and completed material exist, headings are added for each.
+	\ifthenelse{\equal{\exercisemode}{any}}{
+		\IfFileExists{#1.raw.tex}{
+			\IfFileExists{#1.done.tex}{
+				\subsubsection*{Preview of the raw material}
+			}{}
+			\input{#1.raw.tex}
+		}{}
+		\IfFileExists{#1.done.tex}{
+			\IfFileExists{#1.raw.tex}{
+				\subsubsection*{Preview of the solution}
+			}{}
+			\input{#1.done.tex}
+		}{}
+	}{}
+}
+

content/first-steps-with-latex.tex

@@ -2,8 +2,6 @@
 \definecolor{latexblue}{rgb}{0.9,0.925,0.95}
 \pagecolor{latexblue}
 
-\todo{Refactor text for new exercise script.}
-
 \chapter*{First steps with \LaTeX}
 \addcontentsline{toc}{section}{First steps with \LaTeX}
 

content/titlepage.tex

@@ -1,3 +1,7 @@
+\thispagestyle{empty}
+
+\includepdf{graphics/cover.pdf}
+
 \newpage
 \thispagestyle{empty}
 
@@ -10,4 +14,4 @@
 	& It is licensed under Creative Commons \enquote{Attribution-ShareAlike 4.0 International} (CC BY-SA 4.0): \\
 	\href{http://creativecommons.org/licenses/by-sa/4.0/}{\includegraphics[height=.5cm]{graphics/cc-by-sa}} & \url{http://creativecommons.org/licenses/by-sa/4.0/} \\ \\
 	& Upon request, allowances exceeding the limitations of this license may be granted.
-\end{tabular}
+\end{tabular}

exercises/basic-document-structure/task.tex

@@ -1,5 +1,3 @@
-\section{Structure your document and text}
-
 \begin{enumerate}
 	\item In the directory \file{exercises/basic-document-structure}, you can find a file named \file{document-structure.tex}. Wrap the text of the file in a \code{latex}{document} environment and add the following preamble. Afterwards, compile the document. 
 	\codeblock{latex}{./exercises/basic-document-structure/preamble.code.tex}
@@ -15,3 +13,5 @@
 	a table of contents for your document. 
 	\item Afterwards, comment out the preamble, the document environment, and the table of contents. 
 \end{enumerate}
+
+\exercisematerial{exercises/basic-document-structure/document-structure}

exercises/footnotes/task.tex

@@ -1,10 +1,20 @@
-\section{Footnotes and references}
-
-\subsection{Inserting footnotes}
-
+\section*{Exercise \thechapter .1}
 Make the text \enquote{March 2021} of the file 
 \file{exercises/footnotes/footnotes.tex} appear as a footnote instead of in 
 parentheses. Additionally, insert a clickable URL to the Java Development Kit 
 as footnote.
 
-\texttt{https://www.oracle.com/java/technologies/javase-downloads.html}
+\texttt{https://www.oracle.com/java/technologies/javase-downloads.html}
+
+\exercisematerial{exercises/footnotes/footnotes}
+
+\section*{Exercise \thechapter .2}
+In file \file{exercises/references/references.tex}, replace \enquote{in the 
+figure} and \enquote{the following source code listing} with suited references. 
+Use the command \code{latex}{\textbackslash cref}. Do not forget to first 
+introduce labels for the elements that you want to reference. To do so, first 
+of all, wrap the source code listing in a \code{latex}{listing} environment.
+Also, insert a caption for the source code listing. 
+Make sure to use suitable prefixes before the labels.
+
+\exercisematerial{exercises/references/references}

exercises/graphics/task.tex

@@ -1,8 +1,9 @@
-\section{Inserting graphics}
-
 In the \file{exercises/graphics} directory you can find an image file 
 \file{latex-logo.png}. Insert the image into the 
 \file{exercises/graphics/graphics.tex} file. Make sure that the image is placed 
 exactly where you have specified it. On top of that, the picture shall be 
 centered, and a caption shall be added. Adapt the image width to the text width 
 (\code{latex}{\textbackslash textwidth}).
+
+
+\exercisematerial{exercises/graphics/graphics}

exercises/lists/task.tex

@@ -1,7 +1,7 @@
-\section{Adding enumerations}
-
 Format the recipe you can find in \file{exercises/lists/lists.tex} as an 
 unordered list (\code{latex}{itemize}) with sub-lists \emph{Ingredients} 
 and \emph{Instructions}. 
 Within these, there shall be an unordered list of ingredients and an ordered list of 
 instructions, respectively.
+
+\exercisematerial{exercises/lists/lists}

exercises/literature/task.tex

@@ -1,5 +1,3 @@
-\section{Creating and inserting references}
-
 \begin{enumerate}
   \item Create a new Bib\TeX{} file called \file{literature.bib} in the \file{exercises/literature} folder.
   \item Use Google Scholar or \url{dblp.org} to retrieve Bib\TeX{} entries for the following \LaTeX{}
@@ -17,3 +15,5 @@
   \item \textbf{Note}: If compiling fails, it may help to remove all auxiliary 
   files \\(\mono{main.aux/bbl/blg/loc/out/pdf/soc/toc}) before compiling again.
 \end{enumerate}
+
+\exercisematerial{exercises/literature/literature}

exercises/maths/task.tex

@@ -1,8 +1,4 @@
-\section{Typesetting mathematics}
-
 Use \LaTeX{} math mode to typeset the following formulas.
 Pay attention to the size of brackets.
 
-\todo{Strange indent}
-
-\vspace{1cm}
+\exercisematerial{exercises/maths/math-formulas}

exercises/project-structure/task.tex

@@ -1,4 +1,4 @@
-\section{A structured project}
-
 Within the directory \file{exercises/project-structure} you can find the file 
 \file{main.tex}.
+
+\exercisematerial{exercises/project-structure/tasks}

exercises/references/task.tex

@@ -1,10 +0,0 @@
-% same chapter as footnotes
-\subsection{Inserting references}
-
-In file \file{exercises/references/references.tex}, replace \enquote{in the 
-figure} and \enquote{the following source code listing} with suited references. 
-Use the command \code{latex}{\textbackslash cref}. Do not forget to first 
-introduce labels for the elements that you want to reference. To do so, first 
-of all, wrap the source code listing in a \code{latex}{listing} environment.
-Also, insert a caption for the source code listing. 
-Make sure to use suitable prefixes before the labels.

exercises/source-code-listings/task.tex

@@ -1,5 +1,3 @@
-\section{Listings}
-
 In the folder \file{exercises/source-code-listings}, you will find a file called \file{Source.java}.
 We will now include it into our document and adjust its display to fit our needs.
 If you have questions, consult the \pkg{minted} or \pkg{listings} package documentation.
@@ -29,6 +27,8 @@ If you have questions, consult the \pkg{minted} or \pkg{listings} package docume
   \item Don't show special characters for spaces in strings.
 \end{enumerate}
 
+\exercisematerial{exercises/source-code-listings/source-code-listings}
+
 % Reset experiments from exercise material if minted is used
 \ifthenelse{\equal{\listingsmode}{minted}}{%
   \usemintedstyle{default} 

exercises/special-characters/task.tex

@@ -1,6 +1,4 @@
-\section{Insert special characters}
-
-\todo{Adjust to new page layout.}
+% breakanywhere doesn't seem to work.
 For this task, we are using the file \file{exercises/special-characters.tex}.
 To be able to see your results here within the script,
 compile the \file{main.tex} file.
@@ -14,3 +12,6 @@ This applies for the subsequent tasks, as well.
 	\item Add quotation marks around the words \emph{Studi-Ticket} and 
 	\emph{Studi-Karte} using the \code{latex}{\textbackslash enquote} command. 
 \end{enumerate}
+
+\exercisematerial{exercises/special-characters/special-characters}
+

exercises/tables/task.tex

@@ -1,8 +1,10 @@
-\section{Typesetting tables}
-
 The following list shows some key data about a few courses of the \acro{WIAI} faculty.
 However, the overview is not as clear as it could be.
 To improve it, convert the list into a table with columns for \emph{name}, \emph{abbreviation} and \emph{term}.
 Insert an additional \emph{centered column} that numbers the courses. 
 Add a caption to the table.
 You find the table in \file{exercises/tables/tables.tex}.
+
+\exercisematerial{exercises/tables/tables}
+
+

exercises/text-markup/task.tex

@@ -1,5 +1,3 @@
-\section{Emphasising text}
-
 \begin{enumerate}
   \item In \file{exercies/text-markup/markup.tex}, emphasize the words 
   ``recursion'' and ``recursive.''
@@ -7,3 +5,5 @@
   \item Of course, you can also experiment with the other commands that you learned for text markup. However, you might want to remove them afterwards to keep your document nice and tidy.
 \end{enumerate}
 
+\exercisematerial{exercises/text-markup/markup}
+

main-exercises.tex

@@ -1,79 +0,0 @@
-\input{setup.tex} % Setup
-\input{praeamble.tex} % Preamble
-\input{commands.tex} % Custom commands
-
-\title{Script for the Fachschaft \acro{WIAI} \LaTeX{} Workshop}
-\author{Evelyn Fradtschuk \and Florian Knoch \and Christian Kremitzl \and Bernhard Luedtke}
-
-\begin{document}
-\selectlanguage{english}
-\frenchspacing
-
-% Custom headline prefix
-\renewcommand{\thesection}{E\arabic{section}}
-\renewcommand{\thesubsection}{\arabic{subsection}}
-
-% Title page
-\input{titlepage.tex}
-% or simply 
-% \maketitle
-\thispagestyle{empty}
-\newpage
-\setcounter{page}{1} % Don't count title page.
-\setcounter{tocdepth}{2}
-\tableofcontents
-\newpage
-
-\input{first-steps-with-latex.tex}
-
-% Align exercise numbers with chapters
-\setcounter{section}{3}
-
-\input{exercises/basic-document-structure/task}
-\input{exercises/basic-document-structure/document-structure.raw}
-
-\newpage
-\input{exercises/project-structure/task}
-\input{exercises/project-structure/tasks.raw}
-
-\newpage
-\input{exercises/special-characters/task}
-\input{exercises/special-characters/special-characters.raw}
-
-\newpage
-\input{exercises/text-markup/task}
-\input{exercises/text-markup/markup.raw}
-
-\newpage
-\input{exercises/lists/task}
-\input{exercises/lists/lists.raw}
-
-\newpage
-\input{exercises/maths/task}
-\input{exercises/maths/math-formulas.raw}
-
-\newpage
-\input{exercises/graphics/task}
-\input{exercises/graphics/graphics.raw}
-
-\newpage
-\input{exercises/tables/task}
-\input{exercises/tables/tables.raw}
-
-\newpage
-\input{exercises/source-code-listings/task}
-\input{exercises/source-code-listings/source-code-listings.raw}
-
-\newpage
-\input{exercises/footnotes/task}
-\input{exercises/footnotes/footnotes.raw}
-
-\newpage
-\input{exercises/references/task}
-\input{exercises/references/references.raw}
-
-\newpage
-\input{exercises/literature/task}
-\input{exercises/literature/literature.raw}
-
-\end{document}

main-solutions.tex

@@ -1,79 +0,0 @@
-\input{setup.tex} % Setup
-\input{praeamble.tex} % Preamble
-\input{commands.tex} % Custom commands
-
-\title{Script for the Fachschaft \acro{WIAI} \LaTeX{} Workshop}
-\author{Evelyn Fradtschuk \and Florian Knoch \and Christian Kremitzl \and Bernhard Luedtke}
-
-\begin{document}
-\selectlanguage{english}
-\frenchspacing
-
-% Custom headline prefix
-\renewcommand{\thesection}{E\arabic{section}}
-\renewcommand{\thesubsection}{\arabic{subsection}}
-
-% Title page
-\input{titlepage.tex}
-% or simply 
-% \maketitle
-\thispagestyle{empty}
-\newpage
-\setcounter{page}{1} % Don't count title page.
-\setcounter{tocdepth}{2}
-\tableofcontents
-\newpage
-
-\input{first-steps-with-latex.tex}
-
-% Align exercise numbers with chapters
-\setcounter{section}{3}
-
-\input{exercises/basic-document-structure/task}
-\input{exercises/basic-document-structure/document-structure.done}
-
-\newpage
-\input{exercises/project-structure/task}
-\input{exercises/project-structure/tasks.done}
-
-\newpage
-\input{exercises/special-characters/task}
-\input{exercises/special-characters/special-characters.done}
-
-\newpage
-\input{exercises/text-markup/task}
-\input{exercises/text-markup/markup.done}
-
-\newpage
-\input{exercises/lists/task}
-\input{exercises/lists/lists.done}
-
-\newpage
-\input{exercises/maths/task}
-\input{exercises/maths/math-formulas.done}
-
-\newpage
-\input{exercises/graphics/task}
-\input{exercises/graphics/graphics.done}
-
-\newpage
-\input{exercises/tables/task}
-\input{exercises/tables/tables.done}
-
-\newpage
-\input{exercises/source-code-listings/task}
-\input{exercises/source-code-listings/source-code-listings.done}
-
-\newpage
-\input{exercises/footnotes/task}
-\input{exercises/footnotes/footnotes.done}
-
-\newpage
-\input{exercises/references/task}
-\input{exercises/references/references.done}
-
-\newpage
-\input{exercises/literature/task}
-\input{exercises/literature/literature.done}
-
-\end{document}

main.tex

@@ -10,7 +10,7 @@
 \frenchspacing
 
 % Title page
-\input{titlepage.tex}
+\input{content/titlepage.tex}
 % or simply 
 % \maketitle
 \thispagestyle{empty}
@@ -20,19 +20,31 @@
 \tableofcontents
 \newpage
 
+\input{content/first-steps-with-latex.tex}
 \input{content/why-use-latex.tex}
 \input{content/basic-functionality.tex}
 \input{content/basic-document-structure.tex}
+\exercise{basic-document-structure}
 \input{content/project-structure.tex}
+\exercise{project-structure}
 \input{content/special-characters.tex}
+\exercise{special-characters}
 \input{content/text-markup.tex}
+\exercise{text-markup}	
 \input{content/lists.tex}
+\exercise{lists}
 \input{content/maths.tex}
+\exercise{maths}
 \input{content/graphics.tex}
+\exercise{graphics}
 \input{content/tables.tex}
+\exercise{tables}
 \input{content/source-code-listings.tex}
+\exercise{source-code-listings}
 \input{content/footnotes.tex}
+\exercise{footnotes}
 \input{content/literature.tex}
+\exercise{literature}
 \input{content/prospects.tex}
 
 \end{document}

titlepage.tex

@@ -1,7 +0,0 @@
-\thispagestyle{empty}
-
-\includepdf{graphics/cover.pdf}
-
-\todo{Adjust cover for different versions.}
-
-\input{imprint}