From e533034626aa12a7d01144a888de7aacca481033 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 10 Apr 2013 22:44:54 +0000 Subject: exsheets (10apr13) git-svn-id: svn://tug.org/texlive/trunk@29840 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/exsheets/README | 6 +- .../texmf-dist/doc/latex/exsheets/exsheets_en.pdf | Bin 686568 -> 691187 bytes .../texmf-dist/doc/latex/exsheets/exsheets_en.tex | 123 +++++++++++---- Master/texmf-dist/tex/latex/exsheets/exsheets.sty | 94 +++++++----- .../tex/latex/exsheets/exsheets_headings.cfg | 10 ++ Master/texmf-dist/tex/latex/exsheets/tasks.cfg | 4 +- Master/texmf-dist/tex/latex/exsheets/tasks.sty | 166 ++++++++++++++------- .../texmf-dist/tex/latex/exsheets/translations.sty | 10 +- 8 files changed, 287 insertions(+), 126 deletions(-) diff --git a/Master/texmf-dist/doc/latex/exsheets/README b/Master/texmf-dist/doc/latex/exsheets/README index 8bf29bafce0..02c40c8c448 100644 --- a/Master/texmf-dist/doc/latex/exsheets/README +++ b/Master/texmf-dist/doc/latex/exsheets/README @@ -1,14 +1,14 @@ -------------------------------------------------------------------------- -EXSHEETS v0.8a - 2013/04/04 +EXSHEETS v0.9a - 2013/04/08 bundled packages: the EXSHEETS package Yet another package for the creation of exercise sheets -the TRANSLATIONS package v0.8a +the TRANSLATIONS package v0.9a a simple translator the CNTFORMATS package v0.4 A different way to read counters. -the TASKS package v0.8a +the TASKS package v0.9 Horizontal columned lists. All mentioned packages are described in exsheets_en.pdf diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf index fe8fc148d19..f459bbf0559 100644 Binary files a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf and b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf differ diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex index dc93fd78468..6d2ff8a691d 100644 --- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex +++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex @@ -105,9 +105,9 @@ lastvariant, midrule, NewQuSolPair, numberofquestions, points, PrintIfIncludeActiveF, PrintIfIncludeActiveT, PrintIfIncludeActiveTF, printsolutions, PrintSolutionsF, PrintSolutionsTF, PrintSolutionsT, - questionsincludedlast, QuestionNumber, RenewQuSolPair, rightarrow, + questionsincludedlast, QuestionNumber, RenewQuSolPair, rightarrow, rlap, s, sample, setlength, SetQuestionProperties, SetupExSheets, SetVariations, - spacing, square, sumpoints, + spacing, square, startnewitemline, sumpoints, tabcolsep, textcite, textcolor, toprule, totalpoints, variant, vary } @@ -1398,14 +1398,16 @@ following macro: \secidx*{Include from External Files} \section{Own Question/Solution Pairs} -\noindent\sinceversion{0.3}\ExSheets provides he possibility to create new +\noindent\changedversion{0.9}\ExSheets provides he possibility to create new environments that behave like the \code{question} and \code{solution} environments. This would allow, for example, to define a \code{question*}/\code{solution*} environment pair for bonus questions. The following commands may be used in the document preamble: \begin{beschreibung} - \Befehl{NewQuSolPair}{}\oa{}\ma{}\oa{} - \Befehl{RenewQuSolPair}{}\oa{}\ma{}\oa{} + \Befehl{NewQuSolPair}{}\oa{}\oa{}% + \ma{}\oa{}\oa{} + \Befehl{RenewQuSolPair}{}\oa{}\oa{}% + \ma{}\oa{}\oa{} \end{beschreibung} The standard environments are defined as follows: \begin{beispiel}[code only] @@ -1447,7 +1449,8 @@ be some more lines: \blank[width=5\linewidth]{} The options are these: \begin{beschreibung} \Option[blank]{style}{line|wave|dline|dotted|dashed}\Default{line} - The style of the line. + The style of the line. This uses the corresponding command from the \paket{ulem} + package and is the whole reason why \ExSheets loads it in the first place. \Option[blank]{scale}{}\Default{1} Scales the width of the blank by factor \code{} unless the width is explicitly set. @@ -1664,6 +1667,23 @@ The following examples use a sample text defined as follows: A `simple' heading. \sample \end{question} +\subsubsection{The `empty' Instance} +\sinceversion{0.9a} +\begin{beispiel}[code only] + \DeclareInstance{exsheets-heading}{empty}{default} + { + runin = true , + above = \parskip , + below = \parskip , + attach = + { main[l,vc] points[l,vc] (\linewidth + \marginparsep,0pt) } + } +\end{beispiel} +\SetupExSheets{headings=empty} +\begin{question}{1} + An `empty' heading. \sample +\end{question} + \subsubsection{The `block-rev' Instance} \begin{beispiel}[code only] \DeclareInstance{exsheets-heading}{block-rev}{default} @@ -1737,7 +1757,6 @@ The following examples use a sample text defined as follows: A `block-nr' heading. \sample \end{question} -\newpage% FIXME \subsubsection{The `block-nr-wp' Instance} \begin{beispiel}[code only] \DeclareInstance{exsheets-heading}{block-nr-wp}{default} @@ -1868,7 +1887,6 @@ The following examples use a sample text defined as follows: A `runin-nr-wp' heading. \sample \end{question} -\newpage% FIXME \subsubsection{The `inline' Instance} \sinceversion{0.5} \begin{beispiel}[code only] @@ -1916,7 +1934,6 @@ Text before \end{question} Text after -\newpage% FIXME \subsubsection{The `inline-nr' Instance} \sinceversion{0.5} \begin{beispiel}[code only] @@ -2107,6 +2124,7 @@ primarily is for. If you don't need this feature you're better off using traditi part~\ref{part:cntformats}}, \paket{xtemplate} and \paket{environ}. \section{How it works} +\subsection{The Basics} The \code{tasks} environment is similar to a list like \code{enumerate} but not the same: \begin{itemize} @@ -2162,7 +2180,41 @@ number of columns used by the environment is specified. \task \sample \task \s\par\s \end{tasks} - + +\subsection{Introducing a New Row} +\noindent\sinceversion{0.9}Sometimes it may come in handy if the current +row of items could be terminated and a new one is started. This is possible +with the following command: +\begin{beschreibung} + \Befehl{startnewitemline} +\end{beschreibung} +\begin{beispiel}[code only] + \begin{tasks}(4) + \task the first + \task the second + \task the third + \task the fourth + \task \rlap{the fifth item is way too long for this so we start a new row} \startnewitemline + \task the sixth + \task the seventh + \task \rlap{the eighth item also is too long} \startnewitemline + \task the nineth + \task the tenth + \end{tasks} +\end{beispiel} +\begin{tasks}(4) + \task the first + \task the second + \task the third + \task the fourth + \task \rlap{the fifth item is way too long for this so we start a new row} \startnewitemline + \task the sixth + \task the seventh + \task \rlap{the eighth item also is too long} \startnewitemline + \task the nineth + \task the tenth +\end{tasks} + \section{Available Options}\secidx[Options]{\Tasks}[tasks]\label{sec:tasks:options} The \Tasks package has one package option which also is called when you load \ExSheets with the \key{load-tasks} option. @@ -2176,15 +2228,20 @@ The environment itself has some more options, namely these: \begin{beschreibung} \Option{style}{}\Default{} Choose the instance to be used. Read more on this in section~\ref{sec:tasks}. - \Option{label}{