summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/handout/handout.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/handout/handout.tex')
-rw-r--r--Master/texmf-dist/doc/latex/handout/handout.tex23
1 files changed, 19 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/handout/handout.tex b/Master/texmf-dist/doc/latex/handout/handout.tex
index 37a3852c54e..dc483101d14 100644
--- a/Master/texmf-dist/doc/latex/handout/handout.tex
+++ b/Master/texmf-dist/doc/latex/handout/handout.tex
@@ -16,8 +16,8 @@
subtitle={to support your talk},
email={maieul <at> maieul <dot> net},
author={Maïeul Rouquette},
- revision={1.5.0},
- date={15/11/2016},
+ revision={1.6.0},
+ date={21/04/2017},
url={https://github.com/maieul/handout}}
@@ -145,10 +145,11 @@ The package option \opt{disabled} allows you to disable the handout's generation
The argument of a \cmd{onlyhandout} command will be printed only in the handout. Conversely, the argument of a command \cmd{nothandout} will be printed only in the main text. See example~6.
\subsection{Insert code in the handout}
-
+\subsubsection{\cmd{forhandout} and \cmd{forhandout*}}\label{forhandout}
The argument of the \cmd{forhandout} command will be added to the handout, even if used outside any included file.
-\emph{Be careful}: if the content of the argument starts with a command, this command won't be run before the handout.
+All the commands inside will be expanded, except the one which starts argument..
+
The \cmd{forhandout} command is quite complex to manage, but can be useful if you want to insert bibliographic references automatically into your handout. If you use \emph{biblatex} to manage your bibliography, you can define a \cmd{citehandout} command with this code:
@@ -176,10 +177,24 @@ You can call the \cmd{citehandout} command before citation commands when you wan
Note that the citation tracker is automatically reset at the beginning of the handout.
+The starred version of \cmd{citehandout} command will not expand any macro inside the argument. For example, if you need to write instructions for readers:
+\begin{minted}{latex}
+\forhandout{Read the three following texts, looking for:
+\begin{itemize}
+ \item Places.
+ \item Topics.
+ \item Characters.
+\end{itemize}
+}
+\end{minted}
+\subsubsection{\cmd{AtEveryHandout}}\label{forhandout}
You can also add define a \cs{AtEveryHandout} command to be executed in the handout, before each content added to the handout.
\section{Change history}
\begin{changelog}
+\begin{release}{1.6.0}{2017-04-21}
+\item Add starred version of \cs{forhandout} macro \see{forhandout}.
+\end{release}
\begin{release}{1.5.0}{2016-11-15}
\item Reset automatically table and figure counters before typesetting handout.