summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-09-18 22:55:40 +0000
committerKarl Berry <karl@freefriends.org>2014-09-18 22:55:40 +0000
commitef7bdbe006ddc82d3fdaadc3b96f366063a88901 (patch)
tree654b93839e73295c8485ebf6409cbfd2881d321c
parent72a3407f1f7f62a992b22e01e21ee984c3a45327 (diff)
dynblocks (18sep14)
git-svn-id: svn://tug.org/texlive/trunk@35193 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/dynblocks/README4
-rw-r--r--Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdfbin279514 -> 280192 bytes
-rw-r--r--Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex29
-rw-r--r--Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty26
4 files changed, 30 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/latex/dynblocks/README b/Master/texmf-dist/doc/latex/dynblocks/README
index 9303f961104..76058cc6c00 100644
--- a/Master/texmf-dist/doc/latex/dynblocks/README
+++ b/Master/texmf-dist/doc/latex/dynblocks/README
@@ -1,9 +1,9 @@
% * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
% Dynblocks package
%
-% Copyright (C) 2012 Claudio Fiandrino
+% Copyright (C) 2012-2014 Claudio Fiandrino
%
-% v0.2a - 2012/27/09
+% v0.2b - 2014/18/09
%
% * A simple way to create dynamic blocks *
%
diff --git a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf
index a78a438d264..b0931fd5558 100644
--- a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf
+++ b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex
index 3aaf5fcdf7a..cff9e74b38b 100644
--- a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex
+++ b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex
@@ -43,8 +43,8 @@
\renewcommand\labelitemii{\color{DodgerBlue1!60}$\circ$}
\newcommand{\name}{\textsf{dynblocks}}
-\newcommand{\version}{0.2a}
-\newcommand{\versiondate}{27/09/2012}
+\newcommand{\version}{0.2b}
+\newcommand{\versiondate}{187/09/2014}
\author{Claudio Fiandrino \\ \footnotesize{\href{mailto:claudio.fiandrino@gmail.com}{claudio.fiandrino@gmail.com}}}
\title{The \name{} package \footnote{This package has version number \textit{v}\version{} of \versiondate{}; it is released under and subject to the \href{http://www.latex-project.org/lppl/}{\LaTeX\ Project Public License (LPPL)}.}}
@@ -54,13 +54,13 @@
\begin{abstract}
The \name{} package allows to fully customize blocks aspect and dimension inside a presentation.
-The original idea for this package came from \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer}{this question} in \href{http://tex.stackexchange.com/}{TeX.SE} and the core of the package is based on \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer/53797#53797}{this answer}.
+The package originated from \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer}{this question} in \href{http://tex.stackexchange.com/}{TeX.SE}. The core functionalities of the package are based on \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer/53797#53797}{this answer}.
\end{abstract}
\tableofcontents
\section{Introduction}
-The purpose of the package is to have an instrument to customize several aspects of blocks (here called \emph{dynblocks}):
+The purpose of the package is to provide an instrument to customize several aspects of blocks (here called \emph{dynblocks}):
\begin{itemize}
\item the width;
\item the color
@@ -74,7 +74,7 @@ The purpose of the package is to have an instrument to customize several aspects
\item opacity
\end{itemize}
\end{itemize}
-Notice that \emph{dynblocks} defined by \name{} differ mainly from usual beamer's blocks because no title is given.
+Notice that \emph{dynblocks} defined by \name{} differ from usual beamer's blocks because no title is given.
The package has the following requirements:
\begin{itemize}
@@ -83,6 +83,8 @@ The package has the following requirements:
\item \textsf{xparse}.
\end{itemize}
+I would like to thank Enrico Gregorio for having pointed out an issue after the release of Ti\textit{k}Z 3.0.0 and \textsf{xparse} version 2014/08/25.
+
\section{Usage}
To load the package use as usual: \cs{usepackage}\mbarg{options}\mcmd{dynblocks}.
@@ -101,7 +103,7 @@ thanks to the command \cs{opaqueblock}\sarg{overlay spec}\mbarg{width}\marg{text
\item multiple numbers separated by commas and delimited by braces: \texttt{<\{1,2,3\}>};
\item a single number followed by a dash: \texttt{<1->}.
\end{itemize}
-Moreover, it is also possible to make it \emph{invisible} forcing colors to become \texttt{gray} by means of \cs{invblock}\sarg{overlay spec}. For example, the following code, generates the two frames shown in figures \ref{fig:basic1} and \ref{fig:basic2}.
+Moreover, it is also possible to make it \emph{invisible}, that is to force colors to become \texttt{gray} by means of \cs{invblock}\sarg{overlay spec}. For example, the following code, generates the two frames shown in figures \ref{fig:basic1} and \ref{fig:basic2}.
\medskip
\begin{lstlisting}[frame=lines]
\documentclass{beamer}
@@ -149,7 +151,7 @@ Moreover, it is also possible to make it \emph{invisible} forcing colors to beco
\caption{The basic example}
\end{figure}
-In this example, it is possible to notice that the second \cs{opaqueblock} has not \texttt{width} specified; the default value is \cs{textwidth}, but if the block is placed inside a \emph{column} environment it inherits the \texttt{width} given there. To set different values of \texttt{width}, it is necessary to specify the optional argument as did for the first \cs{opaqueblock} of the example.
+In this example, it is possible to notice that the second \cs{opaqueblock} has no specified \texttt{width}; the default value is \cs{textwidth}, but if the block is placed inside a \emph{column} environment it automatically inherits the \texttt{width} given there. To set different values of \texttt{width}, it is necessary to specify the optional argument as did for the first \cs{opaqueblock} of the example.
The presence of an \cs{invblock} makes the first \cs{opaqueblock} invisible; this command needs to be placed immediately after an \cs{opaqueblock} because of two facts:
\begin{itemize}
@@ -157,10 +159,10 @@ The presence of an \cs{invblock} makes the first \cs{opaqueblock} invisible; thi
\item it automatically shows the text of the previous \cs{opaqueblock}.
\end{itemize}
-Finally, both \cs{opaqueblock} and \cs{invblock} needs to be placed inside a \texttt{dynblock} environment.
+Finally, both \cs{opaqueblock} and \cs{invblock} need to be placed inside a \texttt{dynblock} environment.
\subsection{Change text alignment}
-Thanks to the command \cs{setalignment}\marg{text spec} the text alignment changes according to the \meta{text spec} (for all possibilities please refer to the pgfmanual section 16.4.3 - version October 25, 2010).
+Thanks to the command \cs{setalignment}\marg{text spec} the text alignment changes according to the \meta{text spec} (for all possibilities please refer to the pgfmanual section 17.4.3 - version December 20, 2013).
Suppose, for instance, to modify the previous example in order to display the second block with center aligned text. The only change to do is:
\medskip
@@ -180,7 +182,7 @@ and this will lead to figure \ref{fig:align}.
\label{fig:align}%
\end{figure}
-Notice that alignments can be local or global: if there is a definition in the preamble, perfectly admissible, all \emph{dynblocks} will be set according to this definition. Whereas the definition is set inside a group, the \emph{columns} environment or simply the \emph{dynblock} environment, it affects just local \emph{dynblocks}. It is even possible set a global definition and then change things locally.
+Notice that the alignments can be local or global: if there is a definition in the preamble (global), all the \emph{dynblocks} will be set according to this definition. When the definition is set inside a group (a \emph{columns} environment or even simpler, the \emph{dynblock} environment), it affects only locally the \emph{dynblocks}. It is even possible set a global definition and then make local changes.
\subsection{Text opacity and word alert}
By default:
@@ -195,7 +197,7 @@ To change these values two commands have been introduced:
\end{itemize}
where \meta{opacity spec} is a value in the interval $[0 \, , \, 1]$. Also these commands can be set locally or in a global fashion in the preamble.
-Due to the opacity the usual \cs{alert} command is not more useful with \cs{invblock}s. The package provides a method to alert a word even in this case; the command to be used is \cs{dynalert}\sarg{overlay spec}\marg{text}; notice that through the proper usage of \meta{overlay spec}, \cs{dynalert} must not fall inside a \cs{opaqueblock}. This is a limitation, but the purpose for which it has been developed is different.
+Due to the opacity, the usual \cs{alert} command is not more useful with \cs{invblock}s. The package provides a method to alert a word even in this case. The command to be used is \cs{dynalert}\sarg{overlay spec}\marg{text}. Note that with the proper usage of \meta{overlay spec}, \cs{dynalert} must not fall inside a \cs{opaqueblock}. This is a limitation because the purpose for which it has been developed is different.
Assume, for example, to modify the reference example such that the opacity of \cs{invblock} will be set to $0.1$; furthermore, for the first block, the word ``\emph{itemize}'' will be alerted with \cs{alert}, while ``\emph{dynamic block}'' with \cs{dynalert} and for the second block (that does not have the correspondent \cs{invblock}) it is shown what happens with a wrong usage of \cs{dynalert}. The code is:
\medskip
@@ -585,7 +587,7 @@ with the final output shown in figure \ref{fig:estl}.
\label{fig:estl}%
\end{figure}
-The decision of adopting the \emph{structure} as reference is due to the fact that this parameter assume an high relevance when customizing a theme. In the following example, it is shown a color customization of the Szeged theme and a particular effect that can be realized thanks to multiple \emph{dynblocks} inside the same \texttt{dynblock} environment:
+The decision of adopting \emph{structure} as reference is due to the fact that this parameter is one of the most relevant while customizing a Beamer theme. In the following example, it is shown a color customization of the Szeged theme and a particular effect that can be realized thanks to multiple \emph{dynblocks} inside the same \texttt{dynblock} environment:
\begin{lstlisting}[frame=lines]
\documentclass{beamer}
\usepackage[getthemecolors,roundedcorners,shadow]{dynblocks}
@@ -630,8 +632,7 @@ The two frames obtained as outcome are shown in figures \ref{fig:szeg1} and \ref
\caption{Example of a customized theme}
\end{figure}
-
-Notice that the \texttt{getthemecolors} option has some drawbacks when used with particular Beamer color themes like:
+Note that the \texttt{getthemecolors} option has some drawbacks when it is used with particular Beamer color themes like:
\begin{itemize}
\item albatross;
\item beetle.
diff --git a/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty b/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty
index 361f1eee573..fbe3d929b64 100644
--- a/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty
+++ b/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty
@@ -1,5 +1,5 @@
% * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-% Copyright 2012 Claudio Fiandrino
+% Copyright 2012-2014 Claudio Fiandrino
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
@@ -14,7 +14,7 @@
% The Current Maintainer of this work is Claudio Fiandrino.
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{dynblocks}[2012/27/09 v0.2a A simple way to create dynamic blocks.]
+\ProvidesPackage{dynblocks}[2014/18/09 v0.2b A simple way to create dynamic blocks.]
\RequirePackage{tikz}
\RequirePackage{etoolbox}
\RequirePackage{xparse}
@@ -157,9 +157,9 @@
\setlength{\intdimension}{\z@}
\addtolength{\intdimension}{#2}
\ifbool{shadowed}{% true
-\node[visib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup};
+\node[visib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup};
}{% false
-\node[visib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup};
+\node[visib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup};
}
\savetext{mytext}{#3}
}
@@ -168,9 +168,9 @@
\setlength{\intdimension}{\z@}
\addtolength{\intdimension}{#2}
\ifbool{shadowed}{% true
-\node[fancyvisib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup};
+\node[fancyvisib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup};
}{% false
-\node[fancyvisib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup};
+\node[fancyvisib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup};
}
\savetext{mytext}{#3}
}
@@ -179,9 +179,9 @@
\setlength{\intdimension}{\z@}
\addtolength{\intdimension}{#2}
\ifbool{shadowed}{% true
-\node[vshadevisib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup};
+\node[vshadevisib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup};
}{% false
-\node[vshadevisib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup};
+\node[vshadevisib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup};
}
\savetext{mytext}{#3}
}
@@ -190,21 +190,21 @@
\setlength{\intdimension}{\z@}
\addtolength{\intdimension}{#2}
\ifbool{shadowed}{% true
-\node[oshadevisib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup};
+\node[oshadevisib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup};
}{% false
-\node[oshadevisib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup};
+\node[oshadevisib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup};
}
\savetext{mytext}{#3}
}
\NewDocumentCommand{\invblock}{r<>}{%
\ifbool{shadowed}{% true
-\node[invisib=\intdimension,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\printthistext{\thethistext}};
+\node[invisib=\intdimension,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\printthistext{\thethistext}};
}{% false
-\node[invisib=\intdimension,dynvisible on=<#1>] (X) {\printthistext{\thethistext}};
+\node[invisib=\intdimension,dynvisible on=<{#1}>] (X) {\printthistext{\thethistext}};
}
}
-\NewDocumentCommand{\dynalert}{r<> m}{\alt<#1>{\pgfsetfillopacity{1}\myalert{#2}\pgfsetfillopacity{\@invopacity}}{#2}}
+\NewDocumentCommand{\dynalert}{r<> m}{\alt<{#1}>{\pgfsetfillopacity{1}\myalert{#2}\pgfsetfillopacity{\@invopacity}}{#2}}
\endinput