filters: Fix examples tex

Modify the tex files/filters code so that the filters do indeed parse the given tex correctly.

Author: harens

.github/workflows/deploy-docs.yml

@@ -23,7 +23,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
     - uses: awalsh128/cache-apt-pkgs-action@v1.3.0
       with:
-        packages: texlive-latex-base
+        packages: texlive-latex-extra
         version: 1.0
     - name: Install Python Dependencies
       run: |

example.tex

@@ -1,8 +1,12 @@
 \documentclass{article}
 
-\begin{document}
+\usepackage{comment}
+
+% This is a common method for including/excluding solutions from the PDF.
+\includecomment{solution}
+%\excludecomment{solution}
 
-\newenvironment{SomeSolutionDividerName}{}{}
+\begin{document}
 
 \section*{Minimal Example}
 
@@ -12,25 +16,25 @@ \section*{Minimal Example}
 
 \begin{enumerate}
 
-    \item Here is some interesting information. Calculate the following:
+\item Here is some interesting information. Calculate the following:
 
-          \begin{enumerate}
-              \item $1+1$
-              \item $2+2$
-          \end{enumerate}
+\begin{enumerate}
+    \item $1+1$
+    \item $2+2$
+\end{enumerate}
 
-          \begin{SomeSolutionDividerName}
-              \begin{enumerate}
-                  \item $1+1=2$
-                  \item $2+2=4$
-              \end{enumerate}
-          \end{SomeSolutionDividerName}
+\begin{solution}
+    \begin{enumerate}
+        \item $1+1=2$
+        \item $2+2=4$
+    \end{enumerate}
+\end{solution}
 
-    \item This questions has no parts. What is the solution?
+\item This questions has no parts. What is the solution?
 
-          \begin{SomeSolutionDividerName}
-              This is the solution.
-          \end{SomeSolutionDividerName}
+\begin{solution}
+    This is the solution.
+\end{solution}
 
 \end{enumerate}
 

tex2lambda/filters/PartPartSolSol/example.tex

@@ -1,6 +1,9 @@
 #!/usr/bin/env python3
 
-"""A filter that parses files where solutions come after the whole questions and are broken down by part."""
+"""A filter that parses files where solutions come after the whole question and are broken down by part.
+
+i.e. Parts follow each other, and solutions for those parts follow next.
+"""
 
 from typing import Optional
 

tex2lambda/filters/PartPartSolSol/filter.py

@@ -0,0 +1,41 @@
+\documentclass[12pt]{article}
+
+\usepackage{comment}
+
+% This is a common method for including/excluding solutions from the PDF.
+\includecomment{solution}
+%\excludecomment{solution}
+
+\begin{document}
+
+\section*{Minimal Example}
+
+\begin{enumerate}
+
+\item Here is some interesting information. Calculate the following:
+
+\begin{enumerate}
+\item $1+1$
+
+\begin{solution}
+$1+1 = 2$
+\end{solution}
+
+
+\item $2+2$
+
+\begin{solution}
+$2+2=4$
+\end{solution}
+
+\end{enumerate}
+
+\item This questions has no parts. What is the solution?
+
+\begin{solution}
+This is the solution.
+\end{solution}
+
+\end{enumerate}
+
+\end{document}

tex2lambda/filters/PartSolPart/example.tex

@@ -59,5 +59,6 @@ def pandoc_filter(
         if pandoc_filter.question:
             module.add_question(main_text="\n".join(pandoc_filter.question))
             module.current_question.add_solution(pf.stringify(elem))
+            module.current_question._last_part["solution"] -= 1
         pandoc_filter.question = []
     return None

…x2lambda/filters/PartSolPart/__init__.py …ambda/filters/PartSolPartSol/__init__.pytex2lambda/filters/PartSolPart/__init__.py renamed to tex2lambda/filters/PartSolPartSol/__init__.py tex2lambda/filters/PartSolPart/__init__.py renamed to tex2lambda/filters/PartSolPartSol/__init__.py

@@ -1,6 +1,10 @@
 \documentclass[12pt]{article}
 
-\newenvironment{AnyName}{}{}
+\usepackage{comment}
+
+% This is a common method for including/excluding solutions from the PDF.
+\includecomment{solution}
+%\excludecomment{solution}
 
 \begin{document}
 
@@ -15,8 +19,7 @@ \subsection{}
     \item The filter still works even if there aren't any parts
 \end{enumerate}
 
-\begin{AnyName}
-    \paragraph{Solution}
+\begin{solution}
 
     This is the final answer. It contains the solutions for all parts without breaking them up.
 
@@ -26,14 +29,14 @@ \subsection{}
 
     The solution is copied across all parts.
 
-\end{AnyName}
+\end{solution}
 
 \subsection{}
 
 This is question 2.
 
-\begin{AnyName}
-    \paragraph{Solution} And here's the solution
-\end{AnyName}
+\begin{solution}
+    And here's the solution
+\end{solution}
 
 \end{document}