From 48f8b21c2d50f6df0ccca85645ed3d6f7f0dd4a0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 22 Jan 2013 23:46:45 +0000 Subject: exsheets/tasks 0.7a (22jan13) git-svn-id: svn://tug.org/texlive/trunk@28907 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/exsheets/README | 9 +- .../texmf-dist/doc/latex/exsheets/exsheets_en.pdf | Bin 654046 -> 669830 bytes .../texmf-dist/doc/latex/exsheets/exsheets_en.tex | 676 +++++++++++++-------- .../doc/latex/exsheets/grading-table.pdf | Bin 26406 -> 26483 bytes Master/texmf-dist/tex/latex/exsheets/exsheets.sty | 217 ++++--- .../tex/latex/exsheets/exsheets_tasks.cfg | 56 -- .../tex/latex/exsheets/exsheets_tasks.def | 356 ----------- Master/texmf-dist/tex/latex/exsheets/tasks.cfg | 55 ++ Master/texmf-dist/tex/latex/exsheets/tasks.sty | 445 ++++++++++++++ 9 files changed, 1043 insertions(+), 771 deletions(-) delete mode 100644 Master/texmf-dist/tex/latex/exsheets/exsheets_tasks.cfg delete mode 100644 Master/texmf-dist/tex/latex/exsheets/exsheets_tasks.def create mode 100644 Master/texmf-dist/tex/latex/exsheets/tasks.cfg create mode 100644 Master/texmf-dist/tex/latex/exsheets/tasks.sty (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/exsheets/README b/Master/texmf-dist/doc/latex/exsheets/README index 7c9d557ddf5..fcb6240ceae 100644 --- a/Master/texmf-dist/doc/latex/exsheets/README +++ b/Master/texmf-dist/doc/latex/exsheets/README @@ -1,5 +1,5 @@ -------------------------------------------------------------------------- -EXSHEETS v0.6b - 2013/01/06 +EXSHEETS v0.7a - 2013/01/21 bundled packages: the EXSHEETS package @@ -8,6 +8,8 @@ the TRANSLATIONS package v0.6 a simple translator the CNTFORMATS package v0.4 A different way to read counters. +the TASKS package v0.7 + Horizontal columned lists. All mentioned packages are described in exsheets_en.pdf -------------------------------------------------------------------------- @@ -31,7 +33,7 @@ The Current Maintainer of this work is Clemens Niederberger. -------------------------------------------------------------------------- The exsheets package consists of the files - exsheets.sty, exsheets_headings.def, exsheets_headings.cfg, - exsheets_tasks.def, exsheets_tasks.cfg, exsheets_configurations.cfg, + exsheets_configurations.cfg, - exsheets_en.tex, exsheets_en.pdf, grading-table.tex, - README -------------------------------------------------------------------------- @@ -41,6 +43,9 @@ The translations package consists of the files The cntformats package consists of the files - cntformats.sty -------------------------------------------------------------------------- +The tasks package consists of the files + - tasks.sty, tasks.cfg +-------------------------------------------------------------------------- If you have any ideas, questions, suggestions or bugs to report, please feel free to contact me. -------------------------------------------------------------------------- \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf index 64a94e6559f..3e953bde7ac 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 9147ad61bda..34ea299cfee 100644 --- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex +++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex @@ -28,7 +28,7 @@ % -------------------------------------------------------------------------- % The exsheets package consists of the files % - exsheets.sty, exsheets_headings.def, exsheets_headings.cfg, -% exsheets_tasks.def, exsheets_tasks.cfg, exsheets_configurations.cfg, +% exsheets_configurations.cfg, % - exsheets_en.tex, exsheets_en.pdf, % - README % -------------------------------------------------------------------------- @@ -49,7 +49,10 @@ \docsetup{ pkg = {[load-headings,load-tasks]exsheets} , url = {https://bitbucket.org/cgnieder/exsheets/} , - title = ExSheets , + title = the ExSheets bundle , + subtitle = {the packages \ExSheets, \Tasks, \translations and \cntformats\\ + \emph{or}\\ + Yet another package for the creation of exercise sheets and exams.} , name = ExSheets , language = en , modules = true , @@ -65,6 +68,7 @@ \makeatletter \edef\trnsltversion{\@trnslt@version} \edef\cntfmtsversion{\@cntfmts@version} +\edef\tasksversion{v\@tasks@version} \makeatother \cnpkgusecolorscheme{friendly} @@ -95,13 +99,13 @@ DeclareInstance, DeclareTemplateInterface, DeclareQuestionProperty, DebugExSheets, endspacing, examspace, ForEachQuestion, GetQuestionProperty, grade, includequestions, iflastquestion, - midrule, NewQuSolPair, NewTasks, numberofquestions, points, + midrule, NewQuSolPair, numberofquestions, points, PrintIfIncludeActiveF, PrintIfIncludeActiveT, PrintIfIncludeActiveTF, printsolutions, PrintSolutionsF, PrintSolutionsTF, PrintSolutionsT, QuestionNumber, RenewQuSolPair, rightarrow, s, sample, setlength, SetQuestionProperties, SetupExSheets, SetVariations, spacing, square, sumpoints, - tabcolsep, task, textcite, textcolor, toprule, totalpoints, + tabcolsep, textcite, textcolor, toprule, totalpoints, variant, vary } @@ -128,11 +132,22 @@ ReadCounterPatternFrom, SaveCounterPattern, tmpa, tmpb } +% tasks: +\newcommand*\Tasks{{\scshape\textcolor{main}{tasks}}\xspace} +\addcmds{ + leftthumbsup, NewTasks, settasks, task +} % ---------------------------------------------------------------------------- % other packages, bibliography, index -\usepackage{xcoffins,wasysym,enumitem,acro,booktabs,siunitx} -\DeclareAcronym{id}{id}{Identifier} -\DeclareAcronymFormat{id}{\scshape} +\usepackage{xcoffins,wasysym,enumitem,booktabs,siunitx} +\usepackage[accsupp]{acro} +\DeclareAcronym{id}{ + short = id , + long = Identifier , + format = \scshape , + pdfstring = ID , + accsupp = ID +} \usepackage{filecontents} \begin{filecontents}{\jobname.ist} @@ -226,6 +241,9 @@ } \usepackage{amssymb} +\let\checkmark\relax +\usepackage{dingbat} + \NewQuSolPair {question*}[name=\protect\llap{$\bigstar$\space}Bonus Question] {solution*}[name=\protect\llap{$\bigstar$\space}Solution] @@ -241,9 +259,7 @@ \DeclareTranslation{British}{foo}{bar} \usepackage{alphalph} -\makeatletter -\NewPatternFormat{aa}{\alphalph@alph} -\makeatother +\NewPatternFormat{aa}{\alphalph} \NewCounterPattern{testa}{ta} % ---------------------------------------------------------------------------- @@ -303,6 +319,7 @@ questions and solutions.}} \begin{document} + \part{Preliminary}\secidx{Preliminary} \section{Licence and Requirements} \secidx[Licence]{Preliminary}\secidx[Requirements]{Preliminary} @@ -312,8 +329,8 @@ It has the status ``maintained.'' \ExSheets loads and needs the following packages: \paket*{l3kernel}, \paket{xparse}, \paket{xtemplate}, \paket{l3sort}, \paket{l3keys2e}, -\paket{xcolor}, \paket{ulem}, \paket{etoolbox}, \paket{environ}, \paket{lcg} -and \paket{silence}. \ExSheets calls \cmd{normalem} (from the \paket{ulem} package). +\paket{xcolor}, \paket{ulem}, \paket{etoolbox}, \paket{environ}, and +\paket{pgfcore}. \ExSheets calls \cmd{normalem} (from the \paket{ulem} package). \section{Motivation}\secidx[Motivation]{Preliminary} There are already quite a number of packages that allow the creation of exercise @@ -337,7 +354,7 @@ in section~\ref{sec:additional_info}. Then there is --~at least in Germany~-- the habit of having lists of exercises aligned in columns but counting from the left to the right instead from up to -down. \ExSheets provides a possibility for that (see section~\ref{sec:tasks}). +down. \ExSheets provides a possibility for that (see part~\ref{part:tasks}). I am not quite content with it as it works now, though\footnote{There are still other possibilities, for example take a look here: \url{http://tex.stackexchange.com/questions/67966/enumerate-in-multicols} or at @@ -358,31 +375,56 @@ of writing (\today) there still are probably lots of rough edges let alone bugs so I am very interested in all kinds of feedback. \section{Additional Packages} -\ExSheets actually bundles three packages: \ExSheets, \translations and \cntformats. -\translations is described in part~\ref{part:translations} and \cntformats in -part~\ref{part:cntformats}. These two packages provide functionality that is used -by \ExSheets. They can, however, be used independently from \ExSheets. +\ExSheets actually bundles four packages: \ExSheets, \Tasks, \translations and +\cntformats. \Tasks is described in part~\ref{part:tasks}, \translations is +described in part~\ref{part:translations} and \cntformats in part~\ref{part:cntformats}. +These packages provide functionality that is used by \ExSheets. They can, however, +be used independently from \ExSheets. \section{Installation}\secidx[Installation]{Preliminary} If you install \ExSheets manually beware to put the files \begin{itemize} \item[]\verb+exsheets_headings.def+ \item[]\verb+exsheets_headings.cfg+ - \item[]\verb+exsheets_tasks.def+ - \item[]\verb+exsheets_tasks.cfg+ \end{itemize} in the same directory as the \code{exsheets.sty} file\footnote{That is, a directory like \code{texmf-local/tex/latex/exsheets}, probably}. You \emph{can} install the -other two packages, \translations and \cntformats, in different locations but since -they belong to \ExSheets they probably should be placed in the same directory. +other packages, \Tasks, \translations and \cntformats, in different locations but +since they belong to \ExSheets they probably should be placed in the same directory. + +You should put the file \code{tasks.cfg} in the same directory as the \code{tasks.sty} +file. As with every manual package installation you need to make sure to put the files in a directory where \TeX\ can find them and afterwards update the database. + +\section{News} +With version~0.7 there has been a potentially breaking change: the \code{tasks} +environment previously provided by \ExSheets has been extracted into a package +of its own. This does not change any syntax \emph{per se}. However, if you used +custom settings then you'll probably run into some problems. The options for the +environment are no longer set with \cmd{SetupExSheets} but with \cmd{settasks}. +Also the object that is used for the list template and its instances has been +renamed from \code{exsheets-tasks} into \code{tasks}. + +What's probably even more of a breaking change is a syntax difference of the +\code{tasks} environment: the optional argument for the number of columns is +\emph{no longer set in braces but parentheses}. This is deliberate as it +reflects the optional nature of the argument better and is consistent with the +syntax of \cmd{NewTasks}, too. + +Additionally the labels of the list got an additional offset of \code{1ex} from +the items which will lead to slightly different output. In some cases this might +actually lead to the most annoying changes. In this case say +\cmd{settasks}{label-offset=0pt} which should cure things again. + +I am very sorry for any inconvenience! I am trying to keep such changes as minimal +and rare as possibly. However, it is not always avoidable when a package is new +and still a child. It will grow up eventually. \secidx*{Preliminary} \part{The \ExSheets package}\label{part:exsheets}\secidx{\ExSheets}[ExSheets] -\section{Package Usage} -\subsection{Setup}\secidx{Setup} +\section{Setup}\secidx{Setup} The \ExSheets package has three different types of options, kind of. The first type are the classic package options which are used when you load \ExSheets: \begin{beispiel}[code only] @@ -418,7 +460,7 @@ the objects used be \ExSheets. This is explained in a little more detail in part~\ref{part:style} on page~\pageref{part:style}\,ff. \secidx*{Setup} -\subsection{Package Options}\label{sec:options}\secidx{Package Options} +\section{Package Options}\label{sec:options}\secidx{Package Options} The package \ExSheets has some options, namely the following ones: \begin{beschreibung} %% color @@ -430,6 +472,11 @@ The package \ExSheets has some options, namely the following ones: of string that is described in section~\ref{ssec:counter}. \Option{counter-within}{}\Default{} Resets the \code{question} counter with every step of \code{}. + %% auto-label + \Option{auto-label}{\default{true}|false}\Default{false} + If set to true \ExSheets will automatically place a \cmd*{label}{qu:} + for each question. It will also create the question properties \code{ref} + and \code{pageref}, see section~\ref{sec:additional_info} for more on this. %% headings \Option{headings}{}\Default{block} Choose the style of the questions' and solutions' headings. There are two @@ -444,7 +491,7 @@ The package \ExSheets has some options, namely the following ones: section~\ref{sec:exsheets-headings}. %% load-tasks \Option{load-tasks}{\default{true}|false}\Default{false} - Loads additional styles for the \code{tasks} environment. See section~\ref{sec:tasks}. + Loads additional styles for the \code{tasks} environment. See part~\ref{part:tasks}. %% totoc \Option{totoc}{\default{true}|false}\Default{false} This option adds the questions and solutions with their names and numbers to @@ -479,10 +526,10 @@ The \code{toc} options are demonstrated with section~\ref{sec:solutions:list} an the solutions printed there being listed in the table of contents. \secidx*{Package Options} -\subsection{Create Questions/Exercises and their Solutions} +\section{Create Questions/Exercises and their Solutions} Now, let's start with the most important part: the questions and (possibly) their respective solutions. -\subsubsection{The \code{question} Environment}\label{ssec:questions} +\subsection{The \code{question} Environment}\label{ssec:questions} Questions are written inside the \code{question} environment: \begin{beschreibung} \Umg{question}[]{\unskip\ma{} ... } @@ -526,7 +573,7 @@ commands that should behave differently if they're inside or outside of the \expandable\Befehl{IfInsideQuestionF}{} \end{beschreibung} -\subsubsection{Options to the \code{question} Environment}\secidx[options]{questions} +\subsection{Options to the \code{question} Environment}\secidx[options]{questions} The \code{question} environment takes one or more of the following options: \begin{beschreibung} \Option[question]{type}{exam|exercise}\Default{exercise} @@ -541,6 +588,9 @@ The \code{question} environment takes one or more of the following options: \Option[question]{ID}{}\Default{} assigns a custom \acs{id} to the question. See section~\ref{ssec:ids} for further information. + \Option[question]{label}{