diff options
author | Karl Berry <karl@freefriends.org> | 2022-02-12 21:16:42 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-02-12 21:16:42 +0000 |
commit | 34ae39d969c759aab9b3d41b0bd830ab717e8b65 (patch) | |
tree | 5be7ffd55cd376ac091ec8cbd08f31db1490e8a7 /Master/texmf-dist/doc/latex/xsim | |
parent | e693cca0faa732710182c7d86d1663a62dcbeb7f (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/xsim')
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/HISTORY | 23 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/README | 8 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.pdf | bin | 95608 -> 103971 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/examples/xsim.issues-49.tex | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/examples/xsim.texsx-391530-exercises.tex | 12 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf | bin | 1353993 -> 1372251 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xsim/xsim-manual.tex | 56 |
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 Binary files differindex 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 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 Binary files differindex 45529ae8d5f..4c701f0a5cb 100644 --- a/Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf +++ b/Master/texmf-dist/doc/latex/xsim/xsim-manual.pdf 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}}% |