summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-02-12 21:16:42 +0000
committerKarl Berry <karl@freefriends.org>2022-02-12 21:16:42 +0000
commit34ae39d969c759aab9b3d41b0bd830ab717e8b65 (patch)
tree5be7ffd55cd376ac091ec8cbd08f31db1490e8a7 /Master/texmf-dist/doc/latex
parente693cca0faa732710182c7d86d1663a62dcbeb7f (diff)
xsim (12feb22)
git-svn-id: svn://tug.org/texlive/trunk@61988 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/xsim/HISTORY23
-rw-r--r--Master/texmf-dist/doc/latex/xsim/README8
-rw-r--r--Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.pdfbin95608 -> 103971 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.tex2
-rw-r--r--Master/texmf-dist/doc/latex/xsim/examples/xsim.texsx-391530-exercises.tex12
-rw-r--r--Master/texmf-dist/doc/latex/xsim/xsim-manual.pdfbin1353993 -> 1372251 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xsim/xsim-manual.tex56
7 files changed, 74 insertions, 27 deletions
diff --git a/Master/texmf-dist/doc/latex/xsim/HISTORY b/Master/texmf-dist/doc/latex/xsim/HISTORY
index 37068a327ab..b3ac707e962 100644
--- a/Master/texmf-dist/doc/latex/xsim/HISTORY
+++ b/Master/texmf-dist/doc/latex/xsim/HISTORY
@@ -5,9 +5,9 @@ XSIM -- eXercise Sheets IMproved
--------------------------------------------------------------------------
Clemens Niederberger
Web: https://github.com/cgnieder/xsim
-E-Mail: contact@mychemistry.eu
+E-Mail: clemens@cnltx.de
--------------------------------------------------------------------------
-Copyright 2017--2021 Clemens Niederberger
+Copyright 2017--2022 Clemens Niederberger
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3c
@@ -181,3 +181,22 @@ HISTORY:
v0.20b 2021/02/02 - fix issue #78
v0.20c 2021/02/03 - fix issue #80
- add missing test in \xsim_if_exist:nnnTF
+ v0.21 2022/02/12 - make \__xsim_set_file_signature:nnn public
+ - make \l__xsim_file_path_and_name_tl, \l__xsim_file_name_tl
+ and \l__xsim_file_path_tl public
+ - introduce XSIMsetfilebeginX and XSIMsetfileendX (xsimverb)
+ - reduce comment line in automated comments in exercise and
+ solution files
+ - add option <tag>/use-unmatched
+ - document option `blank/fill'
+ - add counter foreach type and collection that holds the
+ number of exercises of a type in a collection
+ - fix issue #90
+ - correct file hooks
+ - implement issue #88
+ - fix issue #96
+ - `use!' and `print!' had gone lost. Add them back in.
+ - add new options `match-all'/`match-any' for the collection
+ conditions. Resolves issue #94.
+ - new \ForEachUsedExerciseByOrder, used in the table
+ templates which resolves issue #85
diff --git a/Master/texmf-dist/doc/latex/xsim/README b/Master/texmf-dist/doc/latex/xsim/README
index 7399405eaab..99a1f2cd5e5 100644
--- a/Master/texmf-dist/doc/latex/xsim/README
+++ b/Master/texmf-dist/doc/latex/xsim/README
@@ -1,15 +1,15 @@
--------------------------------------------------------------------------
-XSIM 2021/02/03 v0.20c
-XSIMVERB 2021/01/31 v0.3
+XSIM 2022/02/12 v0.21
+XSIMVERB 2022/02/12 v0.4
eXercise Sheets IMproved
--------------------------------------------------------------------------
Clemens Niederberger
Web: https://github.com/cgnieder/xsim
-E-Mail: contact@mychemistry.eu
+E-Mail: clemens@cnltx.de
--------------------------------------------------------------------------
-Copyright 2017--2021 Clemens Niederberger
+Copyright 2017--2022 Clemens Niederberger
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3c
diff --git a/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.pdf b/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.pdf
index 3ea1c70ace8..8ea46e93f00 100644
--- a/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.pdf
+++ b/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.tex b/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.tex
index f9baf0a6015..b10d57a36a3 100644
--- a/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.tex
+++ b/Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.tex
@@ -9,7 +9,7 @@
\usepackage{tasks,fontawesome,fmtcount,multicol}
\NewTasksEnvironment[label=\Alph*),label-width=12pt]{choices}[\choice]
-\newcommand*\correct{\thetask\expanded{\SetExerciseProperty{choice}{\thetask}}}
+\newcommand*\correct{\refstepcounter{task}\thetask\expanded{\SetExerciseProperty{choice}{\thetask}}}
\NewTasksEnvironment[label=\Roman*,label-width=12pt]{options}[\option]
diff --git a/Master/texmf-dist/doc/latex/xsim/examples/xsim.texsx-391530-exercises.tex b/Master/texmf-dist/doc/latex/xsim/examples/xsim.texsx-391530-exercises.tex
deleted file mode 100644
index 716921adc01..00000000000
--- a/Master/texmf-dist/doc/latex/xsim/examples/xsim.texsx-391530-exercises.tex
+++ /dev/null
@@ -1,12 +0,0 @@
-\begin{question}
- Who is the Defence Minister?
-\end{question}
-\begin{question}
- Who is the Home Minister?
-\end{question}
-\begin{question}
- Who is the Finance Minister?
-\end{question}
-\begin{question}
- Who is the External Affairs Minister?
-\end{question}
diff --git a/Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf b/Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf
index 45529ae8d5f..4c701f0a5cb 100644
--- a/Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf
+++ b/Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xsim/xsim-manual.tex b/Master/texmf-dist/doc/latex/xsim/xsim-manual.tex
index 00ad03acc8d..2b43735d366 100644
--- a/Master/texmf-dist/doc/latex/xsim/xsim-manual.tex
+++ b/Master/texmf-dist/doc/latex/xsim/xsim-manual.tex
@@ -1,5 +1,5 @@
-% !arara: pdflatex: { interaction: nonstopmode }
-% !arara: biber
+% arara: pdflatex: { interaction: nonstopmode }
+% arara: biber
% arara: pdflatex: { interaction: nonstopmode }
% arara: pdflatex: { interaction: nonstopmode }
% !arara: pdflatex: { interaction: nonstopmode }
@@ -771,7 +771,8 @@ following code:
\DeclareExerciseTagging{topics}
\xsimsetup{tags/ignore-untagged=false}
\end{sourcecode}
-This means that these options are available:
+For each new tag new options are defined and available. They are described
+for the two predefined tags:
\begin{options}
\keyval{tags}{csv list of tags}
Choose the set of tags whose associated exercises should be printed.
@@ -783,6 +784,12 @@ This means that these options are available:
\keybool{ignore-untagged}\Module{topics}\Default{true}
If set to true exercises with no topics will be printed even if topics
have been chosen with the option \option{topics}.
+ \keybool{use-unmatched}\Module{tags}\Default{false}
+ \sinceversion{0.21}If set to true exercises with no matching tags will be
+ used (i.e., for example the counter gets stepped).
+ \keybool{use-untagged}\Module{topics}\Default{true}
+ \sinceversion{0.21}If set to true exercises with no matching topics will
+ be used (i.e., for example the counter gets stepped).
\end{options}
It may happen that you choose certain tags for printing and want one or two
@@ -981,6 +988,17 @@ collection can be printed as often as needed.
exercises which fit the tags are automatically added to the new
collection.
\end{commands}
+You\sinceversion{0.21} have a choice whether \emph{any} or \emph{all} of the
+tags sould match. So \Oarg{topics=algebra,level=1} should probably match
+\emph{all} conditions but the choice is up to you. For each defined collection
+an option exists:
+\begin{options}
+ \keybool{match-all}\Module{collection/\meta{name}}\Default{true}
+ If set to \code{true} \emph{all} conditions must be met.
+ \keybool{match-any}\Module{collection/\meta{name}}\Default{false}
+ The inverse option to \option{match-all}. If set to \code{true} \emph{any} of
+ the conditions must be met.
+\end{options}
\subsubsection{Activating collections}
If a collection is not activated per default in can be activated (or
@@ -999,7 +1017,7 @@ These commands do not influence exercises in other ways other than adding them
to collections.
\begin{commands}
\command{collectexercises}[\marg{collection name}]
- Activates the collection \meta{collection name} which now collects all
+ Activates the collectiocollectexercisesn \meta{collection name} which now collects all
exercises until the collection is deactivated, starts a group with
\cs*{begingroup} and sets the option \option{collect}, see below.
\command{collectexercisesstop}[\marg{collection name}]
@@ -1576,6 +1594,19 @@ 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{ForEachUsedExerciseByOrder}[\marg{code}]
+ Loops\sinceversion{0.21} over each \emph{used} exercise ordered by the
+ exercise types and within each type by the order they have been used in
+ the document. Inside \meta{code} you can refer to several properties of
+ the corresponding exercise:
+ \begin{itemize}
+ \item \code{\#1}: the type of the exercise
+ \item \code{\#2}: the id of the exercise
+ \item \code{\#3}: the \property{counter} property of the exercise
+ \item \code{\#4}: the \property{subtitle} property of the exercise
+ \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}[\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
@@ -2148,7 +2179,7 @@ Those are the options for customization:
Shortcut for setting both \option{blank-style} and \option{filled-style}
at once.
\keyval{scale}{decimal number}\Module{blank}\Default{\code{1}}
-\textsc{} Scales the blank to \meta{decimal number} times its natural width.
+ Scales the blank to \meta{decimal number} times its natural width.
\keyval{width}{dim}\Module{blank}\Default
Sets the blank to a width of \meta{dim}. This takes precendence over
\option{scale}.
@@ -2161,7 +2192,10 @@ Those are the options for customization:
end up with a non-ending compilation. Experiment with values to find the
suiting one for your use case.
\keyval{line-minimum-length}{dim}\Module{blank}\Default{\code{2em}}
- The minimal length a line must have before it is built step by step.
+ The minimal length a line must have before it is built step by step.
+ \keybool{fill}\Module{blank}\Default{false}
+ If set to true, this will show the correct answers in the blanks within
+ an exercise as well.
\end{options}
\begin{example}
@@ -2350,10 +2384,16 @@ also available in \xsim, too):
This command can be used to write something to the external file
\emph{before} the environment contents. Must be set before
\cs{XSIMfilewritestart} in the \emph{begin} definition.
+ \command{XSIMsetfilebeginX}[\marg{code}]
+ \sinceversion{0.21}The same as \cs{XSIMsetfilebegin} but expands its
+ argument first.
\command{XSIMsetfileend}[\marg{code}]
This command can be used to write something to the external file
\emph{after} the environment contents. Must be set before
\cs{XSIMfilewritestart} in the \emph{begin} definition.
+ \command{XSIMsetfileendX}[\marg{code}]
+ \sinceversion{0.21}The same as \cs{XSIMsetfileend} but expands its
+ argument first.
\command{XSIMgobblechars}[\marg{integer}]
Determines how many characters are cut off of the beginning of each line
of the environment body before it is written to the file. The default
@@ -2368,8 +2408,8 @@ The following code shows an example of how to use those commands:
\makeatletter
\NewDocumentEnvironment{example}{o}
{%
- \XSIMsetfilebegin{\@percentchar\space file `\jobname.tmp'}%
- \XSIMsetfileend{\@percentchar\space bye bye}%
+ \XSIMsetfilebeginX{\@percentchar\space file `\jobname.tmp'}%
+ \XSIMsetfileendX{\@percentchar\space bye bye}%
\IfNoValueTF{#1}
{\XSIMfilewritestart*{\jobname.tmp}}
{\XSIMfilewritestart{\jobname.tmp}}%