summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/xsim/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-11-11 03:00:42 +0000
committerNorbert Preining <norbert@preining.info>2019-11-11 03:00:42 +0000
commit0e71c26d9aa79c6e92c3095d6c71f28a566e6054 (patch)
treeb7657bd03108b5ca35e61578ab27b67bd098bf4e /macros/latex/contrib/xsim/doc
parent838842fa4625160270947ca654e7492e3c7afc44 (diff)
CTAN sync 201911110300
Diffstat (limited to 'macros/latex/contrib/xsim/doc')
-rw-r--r--macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.pdfbin0 -> 42513 bytes
-rw-r--r--macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.tex75
-rw-r--r--macros/latex/contrib/xsim/doc/xsim-manual.cls14
-rw-r--r--macros/latex/contrib/xsim/doc/xsim.history3
-rw-r--r--macros/latex/contrib/xsim/doc/xsim_manual.pdfbin1229505 -> 1232911 bytes
-rw-r--r--macros/latex/contrib/xsim/doc/xsim_manual.tex24
6 files changed, 110 insertions, 6 deletions
diff --git a/macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.pdf b/macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.pdf
new file mode 100644
index 0000000000..99e8314406
--- /dev/null
+++ b/macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.pdf
Binary files differ
diff --git a/macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.tex b/macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.tex
new file mode 100644
index 0000000000..6716d52e7e
--- /dev/null
+++ b/macros/latex/contrib/xsim/doc/examples/xsim.texsx-498299.tex
@@ -0,0 +1,75 @@
+\documentclass{article}
+\usepackage[no-files]{xsim}
+\usepackage{tasks}
+
+\DeclareExerciseEnvironmentTemplate{item}
+ {\item[\GetExerciseProperty{counter}]}
+ {}
+
+\DeclareExerciseProperty{answer}
+
+\newcommand*\answer[1]{%
+ \XSIMexpandcode{%
+ \SetExerciseProperty{answer}
+ { (\noexpand\textit{\alph{task}}) \unexpanded{#1}}}%
+ #1%
+}
+
+\newcommand*\getanswers{%
+ \def\betweenanswers{\def\betweenanswers{\hspace{2em}}}%
+ \ForEachUsedExerciseByID{%
+ \betweenanswers##3\ExercisePropertyGet{##1}{##2}{answer}%
+ }%
+}
+
+\xsimsetup{
+ exercise/template = item,
+ exercise/the-counter = \arabic{exercise}.
+}
+
+\NewTasksEnvironment[
+ label = (\textit{\alph*}) ,
+ label-width = 14pt
+]{choice}[\choice]
+
+\newenvironment{questions}
+ {\itemize}
+ {\enditemize}
+
+\begin{document}
+
+\section{Problems}
+\begin{questions}
+ \begin{exercise}
+ What is the product of $-2$ and $3$?
+ \begin{choice}(4)
+ \choice \answer{$-6$}
+ \choice $6$
+ \choice $5$
+ \choice $-5$
+ \end{choice}
+ \end{exercise}
+ \begin{exercise}
+ What is the sum of the sides of a polygon called?
+ \begin{choice}(2)
+ \choice Leg
+ \choice \answer{Perimeter}
+ \choice Area
+ \choice Volume
+ \end{choice}
+ \end{exercise}
+ \begin{exercise}
+ What is the sum of $-2$ and $-3$?
+ \begin{choice}(4)
+ \choice $-6$
+ \choice $6$
+ \choice $5$
+ \choice \answer{$-5$}
+ \end{choice}
+ \end{exercise}
+\end{questions}
+
+\section{Answers}
+\getanswers
+
+\end{document}
diff --git a/macros/latex/contrib/xsim/doc/xsim-manual.cls b/macros/latex/contrib/xsim/doc/xsim-manual.cls
index 7e8fec1b67..3667dd11c6 100644
--- a/macros/latex/contrib/xsim/doc/xsim-manual.cls
+++ b/macros/latex/contrib/xsim/doc/xsim-manual.cls
@@ -29,7 +29,7 @@
% please ignore the contents of this file -- it is not a good example for
% coding...
%
-\ProvidesClass{xsim-manual}[2019/09/27]
+\ProvidesClass{xsim-manual}[2019/11/10]
\LoadClass[load-preamble,add-index]{cnltx-doc}
\RequirePackage{imakeidx}
@@ -169,6 +169,10 @@
UseExerciseTags ,
UseExerciseTagsX ,
UseExerciseTemplate ,
+ xprintexercise ,
+ xprintsolution ,
+ XSIMatbegindocument ,
+ XSIMatenddocument ,
XSIMexpandcode ,
XSIMsetfilebegin ,
XSIMfilewritestart ,
@@ -185,10 +189,12 @@
XSIMifeqT ,
XSIMifeqTF ,
XSIMmixedcase ,
+ xsimprint ,
XSIMputright ,
xsimsetup ,
xsimstyle ,
- XSIMtranslate
+ XSIMtranslate ,
+ xsimxprint
} ,
add-envs = { exercise , solution } ,
add-silent-cmds = {
@@ -829,7 +835,8 @@
\xsim@add@example{texsx-369803}{Layout adjustments}
\xsim@add@example{texsx-370642}{Minimalistic layout}
\xsim@add@example{texsx-391530}{Exercises and sub-exercises}
-\xsim@add@example{texsx-395273}{Different aspects of exercises. Highlighted solutions}
+\xsim@add@example{texsx-395273}{Different aspects of exercises, highlighted solutions}
+\xsim@add@example{texsx-498299}{Multiple choice questions with automated solutions}
\xsim@add@example{texwelt-6698}{Custom list of exercises}
\xsim@add@example{texwelt-15093}{Indicate difficulty level}
\xsim@add@example{texwelt-23968}{Long and short solutions}
@@ -858,6 +865,7 @@
\xsim@add@version{0.13} {2019-10-06}
\xsim@add@version{0.14} {2019-10-13}
\xsim@add@version{0.15} {2019-11-02}
+\xsim@add@version{0.16} {2019-11-10}
% ----------------------------------------------------------------------------
\newrobustcmd*\xsimauxfileinfo{%
diff --git a/macros/latex/contrib/xsim/doc/xsim.history b/macros/latex/contrib/xsim/doc/xsim.history
index c9e9623220..c3214cf573 100644
--- a/macros/latex/contrib/xsim/doc/xsim.history
+++ b/macros/latex/contrib/xsim/doc/xsim.history
@@ -131,3 +131,6 @@ HISTORY:
option
v0.15 2019/11/02 - use own auxiliary file per default and add option
`use-aux'
+ v0.16 2019/11/10 - fix issue due to usage of own auxiliary file
+ - \XSIMatbegindocument and \XSIMatenddocument
+ - \xprintexercise, \xprintsolution, \xsimprint, \xsimxprint
diff --git a/macros/latex/contrib/xsim/doc/xsim_manual.pdf b/macros/latex/contrib/xsim/doc/xsim_manual.pdf
index fc6659b04f..72711292c5 100644
--- a/macros/latex/contrib/xsim/doc/xsim_manual.pdf
+++ b/macros/latex/contrib/xsim/doc/xsim_manual.pdf
Binary files differ
diff --git a/macros/latex/contrib/xsim/doc/xsim_manual.tex b/macros/latex/contrib/xsim/doc/xsim_manual.tex
index 7296f6124d..5156221b0e 100644
--- a/macros/latex/contrib/xsim/doc/xsim_manual.tex
+++ b/macros/latex/contrib/xsim/doc/xsim_manual.tex
@@ -911,6 +911,9 @@ existing exercise, \ie, every exercise whose external file exists.
\command{printexercise}[\marg{type}\marg{id}]
Inserts the exercise of type \meta{type} with the \property{id}
\meta{id}.
+ \command{xprintexercise}[\marg{type}\marg{id}]
+ \sinceversion{0.16}The same as \cs{printexercise} but expands \meta{type}
+ and \meta{id} before it uses them.
\end{commands}
\begin{example}
\printexercise{exercise}{5}
@@ -1135,6 +1138,9 @@ There are different commands for printing the solutions to exercises:
\command{printsolution}[\oarg{options}\marg{type}\marg{id}]
Prints the solution of the exercise of type \meta{type} with the
\property{id} \meta{id}.
+ \command{xprintsolution}[\marg{type}\marg{id}]
+ \sinceversion{0.16}The same as \cs{printsolution} but expands \meta{type}
+ and \meta{id} before it uses them.
\end{commands}
\begin{example}
@@ -1509,7 +1515,7 @@ yourself in order to achieve certain layouts\footnote{I plan to incorporate
\item \code{\#5}: the \property{points} property of the exercise
\item \code{\#6}: the \property{bonus-points} property of the exercise
\end{itemize}
- \command{ForEachPrintedExerciseByID}
+ \command{ForEachPrintedExerciseByID}[\marg{code}]
Loops over each \emph{printed} exercise order by the exercise id. Inside
\meta{code} you can refer to several properties of the corresponding
exercise:
@@ -1521,7 +1527,7 @@ yourself in order to achieve certain layouts\footnote{I plan to incorporate
\item \code{\#5}: the \property{points} property of the exercise
\item \code{\#6}: the \property{bonus-points} property of the exercise
\end{itemize}
- \command{ForEachUsedExerciseByID}
+ \command{ForEachUsedExerciseByID}[\marg{code}]
Loops over each \emph{used} exercise order by the exercise id. Inside
\meta{code} you can refer to several properties of the corresponding
exercise:
@@ -1533,6 +1539,12 @@ yourself in order to achieve certain layouts\footnote{I plan to incorporate
\item \code{\#5}: the \property{points} property of the exercise
\item \code{\#6}: the \property{bonus-points} property of the exercise
\end{itemize}
+ \command{XSIMprint}[\Marg{exercise|solution}\marg{type}\marg{id}]
+ \sinceversion{0.16}Inserts the either the exercise or the solution of type
+ \meta{type} with the \property{id} \meta{id}.
+ \command{XSIMxprint}[\Marg{exercise|solution}\marg{type}\marg{id}]
+ \sinceversion{0.16}The same as \cs{XSIMprint} but expands \meta{type} and
+ \meta{id} before it uses them.
\expandable\command{XSIMtranslate}[\marg{keyword}]
Delivers the translation of \meta{keyword} according to the current
document language (in the meaning of a \pkg{babel}~\cite{pkg:babel} or
@@ -1562,7 +1574,13 @@ yourself in order to achieve certain layouts\footnote{I plan to incorporate
\meta{code 2} is the same tokenlist.
\expandable\command{XSIMifblank\TF}[\marg{code}\marg{true}\marg{false}]
Checks if the full expansion\footref{fn:romannumeral} of \meta{code} is
- blank (\ie, if it is empty or only consists of spaces).
+ blank (\ie, if it is empty or only consists of spaces).
+ \command{XSIMatbegindocument}[\marg{code}]
+ \sinceversion{0.15a}Adds \meta{code} to \xsim's begin document hook.
+ Should be used inside style files instead of \cs*{AtBeginDocument}.
+ \command{XSIMatenddocument}[\marg{code}]
+ \sinceversion{0.15a}Adds \meta{code} to \xsim's end document hook.
+ Should be used inside style files instead of \cs*{AtEndDocument}.
\end{commands}
\subsection{Declaring Templates}