summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/exsheets
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-02-11 00:08:37 +0000
committerKarl Berry <karl@freefriends.org>2015-02-11 00:08:37 +0000
commit20bb32deefaa3ad8f476dd80e6b082cf7d6a6e6a (patch)
tree810191b66f514e4801caec4e3f5aaa14ed07d73b /Master/texmf-dist/doc/latex/exsheets
parent915ccaf4c28127e31df0ef870a9f993aafa4a890 (diff)
exsheets (9feb15)
git-svn-id: svn://tug.org/texlive/trunk@36252 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/exsheets')
-rw-r--r--Master/texmf-dist/doc/latex/exsheets/README8
-rw-r--r--Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdfbin677932 -> 683256 bytes
-rw-r--r--Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex88
3 files changed, 71 insertions, 25 deletions
diff --git a/Master/texmf-dist/doc/latex/exsheets/README b/Master/texmf-dist/doc/latex/exsheets/README
index 40dd109879c..00ebce19e10 100644
--- a/Master/texmf-dist/doc/latex/exsheets/README
+++ b/Master/texmf-dist/doc/latex/exsheets/README
@@ -1,9 +1,9 @@
--------------------------------------------------------------------------
-EXSHEETS 2014/10/14
+EXSHEETS 2015/02/09
bundled packages:
-the EXSHEETS package v0.17
+the EXSHEETS package v0.18
Yet another package for the creation of exercise sheets
-the EXSHEETS-LISTINGS package v0.17
+the EXSHEETS-LISTINGS package v0.18
Using listings in exsheets
--------------------------------------------------------------------------
@@ -11,7 +11,7 @@ Clemens Niederberger
Web: https://bitbucket.org/cgnieder/exsheets/
E-Mail: contact@mychemistry.eu
--------------------------------------------------------------------------
-Copyright 2011-2014 Clemens Niederberger
+Copyright 2011-2015 Clemens Niederberger
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
index 1be4dfe0ada..8dcb6b2f494 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
index 4780f0d809f..2a9be5269cb 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
@@ -1,7 +1,7 @@
% arara: pdflatex
-% !arara: biber
+% arara: biber
+% arara: pdflatex
% arara: pdflatex
-% !arara: pdflatex
% !arara: pdflatex
% --------------------------------------------------------------------------
% the EXSHEETS package
@@ -13,7 +13,7 @@
% Web: https://bitbucket.org/cgnieder/exsheets/
% E-Mail: contact@mychemistry.eu
% --------------------------------------------------------------------------
-% Copyright 2011-2014 Clemens Niederberger
+% Copyright 2011-2015 Clemens Niederberger
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
@@ -116,10 +116,10 @@
bigstar,bottomrule,
citetitle,cs,color,
DeclareInstance,DeclareTemplateInterface,
- endspacing,
+ endmdframed,endspacing,
keyis,
leftthumbsup,
- midrule,
+ mdframed,midrule,
rightarrow,rlap,
s,sample,setlength,
spacing,square,
@@ -180,7 +180,7 @@
\addbibresource{biblatex-examples.bib}
\addbibresource{\jobname.bib}
-\begin{filecontents}{\jobname.bib}
+\begin{filecontents*}{\jobname.bib}
@online{tex.sx:131546,
title = {Fixing lstlisting inside \ExSheets\ \code{question} and
\code{solution} environments} ,
@@ -197,7 +197,7 @@
date = {2013-09-18} ,
urldate = {2013-09-22}
}
-\end{filecontents}
+\end{filecontents*}
% ----------------------------------------------------------------------------
% example definitions that have to be done in the preamble:
@@ -467,6 +467,16 @@ in a full \TeX~Live or \hologo{MiKTeX} installation.
is described in section~\ref{sec:solutions} on
page~\pageref{option:use-saved-counter-format}.
\end{itemize}
+
+\item[Version 0.18]
+ The package now provides the correct Danish translations, thanks to Jonas
+ Nyrup.
+
+ The macro \cs{exsheetsprintsolution} is introduced, see
+ page~\pageref{exsheetsprintsolution} for a little bit of an explanation.
+
+ The option \option{no-skip-below} is introduced which disables the insertion
+ of vertical space after the question and solution environments.
\end{description}
@@ -483,7 +493,12 @@ first type are the classic package options which are used when you load
\begin{sourcecode}
\usepackage[<options>]{exsheets}
\end{sourcecode}
-These options are described in section~\ref{sec:options}.
+All general options can be used this way and most of them are described in
+section~\ref{sec:options}. All of those options also can be set via the setup
+command:
+\begin{commands}
+ \command{SetupExSheets}[\oarg{module}\marg{options}]
+\end{commands}
The second type are options that belong to a specific environment or command.
These options are either used directly with the environment/command
@@ -492,10 +507,10 @@ These options are either used directly with the environment/command
...
\end{env}
\end{sourcecode}
-or can be set with the setup command:
-\begin{commands}
- \command{SetupExSheets}[\oarg{module}\marg{options}]
-\end{commands}
+or can also be set with the setup command. In the first case they only act
+upon the environment or command where they're used. In the second case they
+are set for all following uses of the corresponding environment or command.
+
The options of the second type all belong to \module*{modules}. Let's say you
want to specify some options of the \env{question} environment. You can then
say the following:
@@ -516,7 +531,7 @@ an experimental and developping state. This means that the sytax of the
package may and possibly will change sometime in the future. I cannot foresee
what any consequences of that will be for \ExSheets.
-\section{Package Options}\label{sec:options}
+\section{General Options}\label{sec:options}
The package \ExSheets\ has some options, namely the following ones:
\begin{options}
%% counter-format
@@ -544,14 +559,14 @@ The package \ExSheets\ has some options, namely the following ones:
This code is placed immediately before the subtitle of the questions and
solutions. It only has an effect with a title instance that uses the
subtitle coffin, see section~\ref{sec:exsheets-headings}.
- % %% load-headings
- % \keybool{load-headings}\Default{false}
- % Loads additional styles for the headings. More on this is described in
- % section~\ref{sec:exsheets-headings}.
- % %% load-tasks
- % \keybool{load-tasks}\Default{false}
- % Loads additional styles for the \env{tasks} environment. See
- % the \href{tasks_en.pdf}{documentation of the \Tasks\ package}.
+ % skip-below
+ \keyval{skip-below}{dim}\Default{.5\cs*{baselineskip}}
+ \sinceversion{0.18}Sets the vertical space that is inserted after the
+ question and solution environments.
+ % no-skip-below
+ \keybool{no-skip-below}\Default{false}
+ \sinceversion{0.18}Disables the insertion of vertical space after the
+ question and solution environments.
%% totoc
\keybool{totoc}\Default{false}
This option adds the questions and solutions with their names and numbers
@@ -669,6 +684,12 @@ The \env{question} environment takes one or more of the following options:
Adds a subtitle \meta{subtitle} for the question that is used by headings
instances that make use of the subtitle coffin, see
section~\ref{sec:exsheets-headings}.
+ \keyval{skip-below}{dim}\Module{question}\Default{.5\cs*{baselineskip}}
+ \sinceversion{0.18}Sets the vertical space that is inserted after the
+ question environment.
+ \keybool{no-skip-below}\Module{question}\Default{false}
+ \sinceversion{0.18}Disables the insertion of vertical space after the
+ question environment.
\keybool{print}\Module{question}\Default{true}
Prints or hides the question.
\keyval{ID}{id}\Module{question}\Default
@@ -789,6 +810,12 @@ The \env{solutions} environment also has options, namely these:
Sets a custom name.
\keybool{print}\Module{solution}\Default{false}
Prints or hides the solution.
+ \keyval{skip-below}{dim}\Module{solution}\Default{.5\cs*{baselineskip}}
+ \sinceversion{0.18}Sets the vertical space that is inserted after the
+ solution environment.
+ \keybool{no-skip-below}\Module{solution}\Default{false}
+ \sinceversion{0.18}Disables the insertion of vertical space after the
+ solution environment.
\keyval{pre-hook}{code}\Module{solution}\Default
\sinceversion{0.16}Adds \meta{code} directly before the solution title.
\keyval{post-hook}{code}\Module{solution}\Default
@@ -1829,6 +1856,25 @@ 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
and its \cs*{surroundwithmdframed} command.
+\ExSheets{} also provides the options \option{pre-hook}, \option{post-hook},
+\option{pre-body-hook} and \option{post-body-hook} to both the question and
+the solution environment. With them it is rather straightforward to add a
+\pkg{mdframed} frame for instance:
+\begin{sourcecode}
+ \SetupExSheets{
+ solution/pre-hook = \mdframed ,
+ solution/post-hook = \endmdframed
+ }
+\end{sourcecode}
+
+Last\sinceversion{0.18} but not least 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
+\begin{sourcecode}
+ \newcommand\exsheetsprintsolution[2]{#1#2}
+\end{sourcecode}
+
\subsection{The \code{exsheets-headings} Object}\label{sec:exsheets-headings}
\ExSheets\ defines the object \code{exsheets-headings} and one template for it,
the `default' template. The package also defines two instances of this