diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex | 138 |
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 |