summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex59
1 files changed, 44 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
index 442df6ef252..5c88bad6151 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
@@ -1028,10 +1028,10 @@ possibilities.
In the next subsections the usage of the following command is discussed.
\begin{commands}
\command{printsolutions}[\oarg{setting}]
- Print solutions of questions(exercises.
+ Print solutions of questions/exercises.
\end{commands}
-Before we do that a hint: remember that you can set the option \key{print}
+Before we do that a hint: remember that you can set the option \option{print}
globally:
\begin{sourcecode}
% in the preamble
@@ -1042,14 +1042,20 @@ Now if you want to typeset some text depending on the option being true or not
you can use the following commands:
\begin{commands}
\expandable\command{PrintSolutionsTF}[\marg{true code}\marg{false code}]
- Checks if inside of a \env{solution} environment and either leaves the
- \meta{true code} or the \meta{false code} in the input stream.
+ Either leaves \meta{true code} or \meta{false code} in the input stream
+ depending on wether solutions are printed or not, \ie, on the value of the
+ solution's option \option{print}. Inside a \env{solution} environment
+ this always prints \meta{true code}.
\expandable\command{PrintSolutionsT}[\marg{true code}]
- Checks if inside of a \env{solution} environment and either leaves the
- \meta{true code} in the input stream if yes.
+ Either leaves \meta{true code} or nothing in the input stream depending on
+ wether solutions are printed or not, \ie, on the value of the solution's
+ option \option{print}. Inside a \env{solution} environment this always
+ prints \meta{true code}.
\expandable\command{PrintSolutionsF}[\marg{false code}]
- Checks if inside of a \env{solution} environment and either leaves the
- \meta{false code} in the input stream if not.
+ Either leaves nothing or \meta{false code} in the input stream depending
+ on wether solutions are printed or not, \ie, on the value of the
+ solution's option \option{print}. Inside a \env{solution}environment this
+ always prints nothing.
\end{commands}
They might come in handy if you want two versions of an exercise sheet, one
with the exercises and one with the solutions, and you want to add different
@@ -1221,7 +1227,7 @@ the order given you can use the option
Sort solutions given by \acs{id} or don't.
\end{options}
-\section{Dividing Questions into Classes}\label{sec:dividing-concepts}
+\section{Conditional Printing of Questions}\label{sec:cond-print-quest}
\subsection{Using Classes}\label{sec:classes}
For creating different variants of a written exam or different difficulty
levels of an exercise sheet it comes in handy if one can assign certain
@@ -1348,6 +1354,22 @@ say. This is possible with the following commands:
\bool_set_false:N \g__exsheets_use_difficulties_bool
\ExplSyntaxOff
+\subsection{Tagging Questions}
+There\sinceversion{0.20} is another way of dividing questions: you can assign
+tags to questions:
+\begin{sourcecode}
+ \begin{question}[tags={foo,bar,baz}]
+ ...
+ \end{question}
+\end{sourcecode}
+You can then decide to print only questions with certain tags by using the
+following option:
+\begin{options}
+ \keyval{use-tags}{csv list of tags to include}
+ Select tags. When used only questions being tagged with at least one of
+ the tags in \meta{csv list of tags to include} are printed.
+\end{options}
+
\section{Adding and Using Additional Information to
Questions}\label{sec:additional_info}
\subsection{Question Properties -- the Basics}
@@ -1442,7 +1464,7 @@ It is now possible to recover these values later:
\end{example}
Please note that properties \emph{are not the same} as the dividing concepts
-explained in section~\ref{sec:dividing-concepts} although they may seem
+explained in section~\ref{sec:cond-print-quest} although they may seem
similar in meaning or even have the same name.
When properties are set they are also written to the \code{aux} file which
@@ -1697,7 +1719,7 @@ following commands for control:
\end{commands}
The selection can be refined further by selecting questions belonging to a
-specific class of questions (see section~\ref{sec:dividing-concepts}) before
+specific class of questions (see section~\ref{sec:cond-print-quest}) before
using \cs{includequestions}.
\sinceversion{0.8}After you've used \cs{includequestions} the \acp{id} of the
@@ -1852,7 +1874,7 @@ The \ExSheets\ package makes extensive use of \LaTeX3's coffins\footnote{See
documentation to the \pkg{xtemplate} package.}. The latter allows a
rather easy extension and customization of some of \ExSheets' environments.
To be more precise: you can define your own instances for the headings used
-for questions and solutions and for the \env{tasks} environment.
+for questions and solutions.
What this package doesn't provide is changing the background of questions or
framing them. But this is easily possible using the \pkg{mdframed} package
@@ -1869,7 +1891,7 @@ the solution environment. With them it is rather straightforward to add a
}
\end{sourcecode}
-Last\sinceversion{0.18} but not least there is the macro
+Then\sinceversion{0.18} there is the macro
\cs{exsheetsprintsolution}\marg{heading}\marg{body}\label{exsheetsprintsolution}
which may be redefined to suit your needs. The default definition is
equivalent to
@@ -1957,6 +1979,13 @@ handle pairs.
\caption{Available handles for a horizontal coffin.}\label{fig:handles}
\end{figure}
+It is possible\sinceversion{0.20} to add own static coffins:
+\begin{commands}
+ \command{DeclareExSheetsHeadingContainer}[\marg{name}\marg{code}]
+ Defines a new coffin \meta{name} containing \meta{code}. You can refer to
+ the current question's \ac{id} with \cs{CurrentQuestionID}.
+\end{commands}
+
The following subsections will show all definitions of the instances available
and how they look. This will hopefully give you enough ideas to create your
own instance if you want to have another heading style than the ones
@@ -2511,7 +2540,7 @@ this by writing the listing to a unique auxiliary file --
questions to \code{\cs*{jobname}-ex\meta{num}.lst} and solutions to
\code{\cs*{jobname}-sol\meta{num}.lst} where \meta{num} is an increasing
integer that ensures that each listing gets a unique file name. Those files
-are then included with \cs{lstinutlisting} if and when the question or
+are then included with \cs{lstinputlisting} if and when the question or
solution is printed.
\begin{environments}
@@ -2532,7 +2561,7 @@ loaded already.
% this uses my listings style used in this documentation for all pieces of
% code:
\begin{lstquestion}[%
- pre=Explain what this piece of \LaTeX\ code does:,
+ pre=Explain what this piece of \TeX\ code does:,
listings={style=cnltx}]
\begingroup\expandafter\expandafter\expandafter\endgroup
\expandafter\ifx\csname foo\endcsname\relax