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.tex138
1 files changed, 86 insertions, 52 deletions
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
index 9add39fd108..9e8d9faf667 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
@@ -85,17 +85,20 @@
% code examples
% ExSheets:
\addcmds{
- acs, addpoints, blank, bigstar, bottomrule, checkedchoicebox, choice, choicebox,
- citetitle, cmd, color, correct,
+ acs, addpoints,
+ blank, bigstar, bottomrule,
+ checkedchoicebox, choice, choicebox, citetitle, cmd, color, correct,
DeclareInstance, DeclareTemplateInterface, DeclareQuestionProperty,
- DebugExSheets, endspacing, examspace, ForEachQuestion, GetQuestionProperty,
+ DebugExSheets, endspacing, examspace, ForEachQuestion, GetQuestionProperty,
grade, includequestions, iflastquestion,
midrule, NewQuSolPair, NewTasks, numberofquestions, points,
PrintIfIncludeActiveF, PrintIfIncludeActiveT, PrintIfIncludeActiveTF,
- printsolutions, PrintSolutionsF, PrintSolutionsTF, PrintSolutionsT,
+ printsolutions, PrintSolutionsF, PrintSolutionsTF, PrintSolutionsT,
QuestionNumber, RenewQuSolPair, rightarrow, s, sample, setlength,
- SetQuestionProperties, SetupExSheets, spacing, square, sumpoints,
- tabcolsep, task, textcite, textcolor, toprule, totalpoints
+ SetQuestionProperties, SetupExSheets, SetVariations, spacing, square,
+ sumpoints,
+ tabcolsep, task, textcite, textcolor, toprule, totalpoints,
+ variant, vary
}
% translations:
@@ -770,50 +773,6 @@ You have two possibilities to display and count them:
\end{beispiel}
\secidx*{Counting Points}
-\subsection{A Grade Distribution}\secidx{Grade Distribution}
-Probably this is a rather esoteric feature but it could proof useful in some cases.
-Suppose you are a German math teacher and want to grade exactly corresponding to
-the number of points relative to the sum of total points, regardless of how big
-that might be. You could do something like this to present your grading decisions
-for the exam:
-\begin{beispiel}
- % preamble:
- % \DeclareRelGrades{
- % 1 = 1 ,
- % {1,5} = .9167 ,
- % 2 = .8333 ,
- % {2,5} = .75 ,
- % 3 = .6667 ,
- % {3,5} = .5833 ,
- % 4 = .5
- % }
- \small\setlength\tabcolsep{2pt}
- \begin{tabular}{r|*8c}
- Punkte
- & $\grade*{1}$ & $\le\grade*{1}$ & $\le\grade*{1,5}$ & $\le\grade*{2}$
- & $\le\grade*{2,5}$ & $\le\grade*{3}$ & $\le\grade*{3,5}$ & $<\grade*{4}$ \\
- Note
- & 1 & 1--2 & 2 & 2--3 & 3 & 3--4 & 4 & 5
- \end{tabular}
-\end{beispiel}
-
-These are the available commands and options:
-\begin{beschreibung}
- \Befehl{DeclareRelGrades}{<grade>=<num>,...}\newline
- This command is used to define grades and assign the percentage of total
- points to them.
- \Befehl{grade}*{<grade>}\newline
- Gives the number of points corresponding to a grade depending on the value
- of \cmd{pointssum} with or without (starred version) ``unit''.
- \Option[grades]{round}{<num>}\Default{0}
- The number of decimals the points of a grade are rounded to. This doesn't apply
- to the maximum number of points if the rounded number would be bigger than the
- actual sum.
- \Option[grades]{half}{\default{true}|false}\Default{false}
- If set to \code{true} points are rounded either to full or to half points.
-\end{beschreibung}
-\secidx*{Grade Distribution}
-
\subsection{Printing Solutions}\label{sec:solutions}\secidx[print]{solutions}
You have already seen that you can print solutions where they are using the
\key[solution]{print} option. But \ExSheets offers you quite more possibilities.
@@ -943,8 +902,8 @@ has an \acs{id}. To see which \acs{id} a question has you can call the following
command:
\begin{beschreibung}
\Befehl{DebugExSheets}{true|false}
- \befehl{CurrentQuestionID} \sinceversion{0.4a}expands to the current question
- \acs{id} (after two expansions).
+ \Befehl{CurrentQuestionID}\sinceversion{0.4a}\newline
+ expands to the current question \acs{id} (after two expansions).
\end{beschreibung}
Let's create some more questions and take a look what this command does:
\begin{beispiel}
@@ -1036,6 +995,81 @@ supported yet.
\bool_set_false:N \g__exsheets_use_topics_bool
\ExplSyntaxOff
+\subsection{Variations of an Exam}\secidx{Variations}
+\noindent\sinceversion{0.6}It is a quite common task to design an exam in two
+different variants. This is of course possible with \ExSheets' classes (see
+section~\ref{sec:classes}). However, often not the whole question is to be
+different but only small details, the numbers in a maths exam, say. For this
+purpose \ExSheets provides the following commands:
+\begin{beschreibung}
+ \Befehl{SetVariations}{<num>}\newline
+ Set the number of different variants. This will determine how many arguments
+ the command \cmd*{vary} will get. \code{<num>} must at least be \code{2} and
+ is initially set to \code{2}.
+ \Befehl{variant}{<num>}\newline
+ Choose the active variant. The argument must be a number between \code{1}
+ and the number set with \cmd*{variations}. Initially set to \code{1}.
+ \Befehl{vary}{<variant 1>}\ma{<variant 2>}\newline
+ This command is the one actually used in the document. It has a number of
+ required arguments equal to the number set with \cmd*{variations}. All of its
+ arguments are discarded except the one specified with \cmd*{variant}.
+\end{beschreibung}
+
+\begin{beispiel}
+ \SetVariations{6}%
+ \variant{6}\vary{A}{B}{C}{D}{E}{F}
+ \variant{1}\vary{A}{B}{C}{D}{E}{F}
+ \variant{5}\vary{A}{B}{C}{D}{E}{F}
+ \variant{2}\vary{A}{B}{C}{D}{E}{F}
+ \variant{4}\vary{A}{B}{C}{D}{E}{F}
+ \variant{3}\vary{A}{B}{C}{D}{E}{F}
+\end{beispiel}
+\secidx*{Variations}
+
+\subsection{A Grade Distribution}\secidx{Grade Distribution}
+Probably this is a rather esoteric feature but it could proof useful in some cases.
+Suppose you are a German math teacher and want to grade exactly corresponding to
+the number of points relative to the sum of total points, regardless of how big
+that might be. You could do something like this to present your grading decisions
+for the exam:
+\begin{beispiel}
+ % preamble:
+ % \DeclareRelGrades{
+ % 1 = 1 ,
+ % {1,5} = .9167 ,
+ % 2 = .8333 ,
+ % {2,5} = .75 ,
+ % 3 = .6667 ,
+ % {3,5} = .5833 ,
+ % 4 = .5
+ % }
+ \small\setlength\tabcolsep{2pt}
+ \begin{tabular}{r|*8c}
+ Punkte
+ & $\grade*{1}$ & $\le\grade*{1}$ & $\le\grade*{1,5}$ & $\le\grade*{2}$
+ & $\le\grade*{2,5}$ & $\le\grade*{3}$ & $\le\grade*{3,5}$ & $<\grade*{4}$ \\
+ Note
+ & 1 & 1--2 & 2 & 2--3 & 3 & 3--4 & 4 & 5
+ \end{tabular}
+\end{beispiel}
+
+These are the available commands and options:
+\begin{beschreibung}
+ \Befehl{DeclareRelGrades}{<grade>=<num>,...}\newline
+ This command is used to define grades and assign the percentage of total
+ points to them.
+ \Befehl{grade}*{<grade>}\newline
+ Gives the number of points corresponding to a grade depending on the value
+ of \cmd{pointssum} with or without (starred version) ``unit''.
+ \Option[grades]{round}{<num>}\Default{0}
+ The number of decimals the points of a grade are rounded to. This doesn't apply
+ to the maximum number of points if the rounded number would be bigger than the
+ actual sum.
+ \Option[grades]{half}{\default{true}|false}\Default{false}
+ If set to \code{true} points are rounded either to full or to half points.
+\end{beschreibung}
+\secidx*{Grade Distribution}
+
\subsection{Adding and Using Additional Information to Questions}\label{sec:additional_info}
\secidx{Additional Information to Questions}
For managing lots of questions and corresponding solutions it can be very useful