From 386b0766bf3d980ab3b41391fb0ee0171982bd39 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 25 Jun 2014 15:10:50 +0000 Subject: tcolorbox (28may14) git-svn-id: svn://tug.org/texlive/trunk@34406 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 11 ++- Master/texmf-dist/doc/latex/tcolorbox/README | 2 +- .../doc/latex/tcolorbox/tcolorbox-example.pdf | Bin 361334 -> 361329 bytes .../doc/latex/tcolorbox/tcolorbox-example.tex | 2 +- .../doc/latex/tcolorbox/tcolorbox.doc.abstract.tex | 4 +- .../latex/tcolorbox/tcolorbox.doc.breakable.tex | 32 ++++++-- .../doc/latex/tcolorbox/tcolorbox.doc.skins.tex | 85 ++++++++++++++++++++- .../texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | Bin 4298125 -> 4326972 bytes .../texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 12 +-- 9 files changed, 130 insertions(+), 18 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index 1f12bd7f91a..520bd9032f7 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES +++ b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.04 (2014/05/18) +%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm @@ -536,3 +536,12 @@ version 3.04 (2014/05/18) * new keys 'underlay boxed title', 'no underlay boxed title', 'underlay boxed title pre' * documentation example updated +version 3.05 (2014/05/28) +- compatibility fix for the upcoming version 2.0 of the package minted +- inner boxes are enforced to be unbreakable now +- library 'breakable': + new key 'enforce breakable' (for breaking inner boxed deliberately) +- library 'skins': + * new options: + 'lifted shadow', 'drop small lifted shadow', 'drop lifted shadow', 'drop large lifted shadow' + diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index 52531fedecd..0eb00c4bbde 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/README +++ b/Master/texmf-dist/doc/latex/tcolorbox/README @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.04 (2014/05/18) +%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf index 380293fe52d..77df64b9536 100644 Binary files a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf and b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf differ diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex index a1e29da8a7f..18a1561d335 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.04 (2014/05/18) +%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) %% tcolorbox-example.tex: an example for tcolorbox %% %% ------------------------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex index b1ca770328c..b447e3530fb 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex @@ -40,7 +40,9 @@ cover page. Printing the pages starting with page 2 or page 3 should work. \clearpage \begin{center} \begin{tcolorbox}[enhanced,hbox,tikznode,left=8mm,right=8mm,boxrule=0.4pt, - colback=white,colframe=black!50!yellow,drop fuzzy midday shadow=black!50!yellow, + colback=white,colframe=black!50!yellow, + %drop fuzzy midday shadow=black!50!yellow, + drop lifted shadow=black!50!yellow, before=\par\vspace*{5mm},after=\par\bigskip] {\bfseries\LARGE The \texttt{tcolorbox} package}\\[3mm] {\large Manual for version \version\ (\datum)} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex index 1fca8ae8497..ba0467b34c1 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex @@ -87,12 +87,17 @@ parameters. The differences are: restricted capacity. Therefore, you cannot place hundreds of pages inside a |tcolorbox|. \item You can nest an unbreakable |tcolorbox| inside another |tcolorbox|, - even inside a breakable one. But you should not nest a breakable box - inside a breakable box since this will give a mess. Inside a breakable box, - the further breaking is disabled by default. If you really want to or - have to use the keys \refKey{/tcb/breakable} or \refKey{/tcb/unbreakable} - inside the content of an outer |tcolorbox|, you have to guard this with a - \TeX\ group. + even inside a breakable one. + But you cannot not nest a breakable box inside a breakable box. + The \refKey{/tcb/breakable} key for a nested box is ignored + automatically\footnote{Until |tcolorbox| 3.04, the \refKey{/tcb/breakable} key + was not ignored for nested boxes.}, i.\,e.\ inner + boxes are always unbreakable.\par + After all, in the unlikely case you really want to have the nested box to be breakable, + use \refKey{/tcb/enforce breakable} for the nested + box\footnote{ \refKey{/tcb/enforce breakable} acts like \refKey{/tcb/breakable} until |tcolorbox| 3.04.}. + \textbf{But, a breakable box inside a breakable box will usually give a mess.} + \item If your text content contains some text color changing commands, your color will not survive the break to the next box. \end{itemize} @@ -100,7 +105,7 @@ parameters. The differences are: \clearpage \subsection{Main Option Keys} -\begin{docTcbKey}{breakable}{}{no value} +\begin{docTcbKey}{breakable}{\colOpt{=true\textbar false}}{default |true|, initially |false|} Allows the |tcolorbox| to be breakable. If the box is larger than the available space at the current page, the box is automatically broken and continued to the next next page. All sorts of |tcolorbox| can be made @@ -127,6 +132,17 @@ parameters. The differences are: \end{docTcbKey} +\begin{docTcbKey}{enforce breakable}{}{no value} + A |tcolorbox| inside a |tcolorbox| is automatically set to be unbreakable. + Using \refKey{/tcb/breakable} on such an inner box has no effect. + If one \emph{really} wants the inner box to be breakable, use \refKey{/tcb/enforce breakable}. + \textbf{This will usually give a mess of shattered boxes. You are advised to not use this option.}\\ + Note that \refKey{/tcb/enforce breakable} has the functionality + that \refKey{/tcb/breakable} had until package version 3.04 + and exists for backward compatibility. +\end{docTcbKey} + + \begin{docTcbKey}{title after break}{=\meta{text}}{no default, initially empty} The \refKey{/tcb/title} is used only for the \emph{first} part of a \emph{break sequence}. Use |title after break| to create a heading line @@ -149,7 +165,7 @@ parameters. The differences are: the lower box part are placed before a break happens. \end{docTcbKey} - +\clearpage \begin{docTcbKey}{enlargepage}{=\meta{length}\colOpt{/\meta{length}\ldots/\meta{length}}}{no default, initially |0pt|} Inserts a |\enlargethispage|\marg{length} to the pages of the break sequence, i.\,e.\ allows one to enlarge (or shrink) partial boxes. The first \meta{length} is applied diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex index ac7c378897b..c7830b43597 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex @@ -1399,7 +1399,7 @@ This is a tcolorbox. \clearpage \begin{docTcbKey}{fuzzy shadow}{=\marg{xshift}\marg{yshift}\marg{offset}\marg{step}\marg{options}}{no default} Adds a new fuzzy shadow to the stack of shadows. Actually, this option - adds seversal shadows which appear like a shadow with a fuzzy border. + adds several shadows which appear like a shadow with a fuzzy border. This fuzzy shadow is follows the outline of the |tcolorbox| but is shifted by \meta{xshift} and \meta{yshift}. The \meta{offset} value is a distance value from the frame outline. A positive \meta{offset} value shrinks the shadow @@ -1754,6 +1754,89 @@ equivalent to the preceding examples. \end{docTcbKey}% +\clearpage +\begin{docTcbKey}{lifted shadow}{=\marg{xshift}\marg{yshift}\marg{bend}\marg{step}\marg{options}}{no default} + Adds a new lifted shadow to the stack of shadows. Actually, this option + adds several shadows which appear like a shadow with a fuzzy border. + This lifted shadow is follows the outline of the |tcolorbox| but is shifted by + \meta{xshift} and \meta{yshift} on the lower left corner and by + $-$\meta{xshift} and \meta{yshift} on the lower right corner. + Additionally, there is a \meta{bend} in the middle. + The \marg{step} value describes a shrink + offset used for the combination of the partial shadows. + The shadow is filled along a \tikzname\ path with the given \tikzname\ \meta{options} but + any |opacity| value will be ignored. +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\tcbset{enhanced,colback=red!5!white, + boxrule=0.1pt, + colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[title=My own shadow, + lifted shadow={1mm}{-2mm}{3mm}{0.1mm}% + {black!50!white}] +This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + +\begin{docTcbKey}{drop lifted shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|} + Adds a new lifted shadow with standard dimensions to the stack of shadows. + Optionally, the \meta{color} for the shadow can be changed. +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\tcbset{enhanced,colback=red!5!white, + boxrule=0.4pt,arc=0pt,outer arc=0pt, + colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[drop lifted shadow] +This is a tcolorbox. +\end{tcolorbox}\par\bigskip +\begin{tcolorbox}[title=Another shadow, + drop lifted shadow=blue] +This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + +\begin{docTcbKey}{drop small lifted shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|} + Adds a new small lifted shadow with standard dimensions to the stack of shadows. + Optionally, the \meta{color} for the shadow can be changed. +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\tcbset{enhanced,colback=red!5!white, + boxrule=0.4pt,arc=0pt,outer arc=0pt, + colframe=red!75!black,fonttitle=\bfseries} + +\tcbox[drop small lifted shadow,size=fbox] + {This is a tcolorbox.} +\par\bigskip +\begin{tcolorbox}[title=Another shadow, + drop small lifted shadow=black] +This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + +\clearpage +\begin{docTcbKey}{drop large lifted shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|} + Adds a new large lifted shadow with standard dimensions to the stack of shadows. + Optionally, the \meta{color} for the shadow can be changed. +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\tcbset{enhanced,colback=red!5!white, + colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[drop large lifted shadow] +This is a tcolorbox. +\end{tcolorbox}\par\bigskip +\begin{tcolorbox}[title=Another shadow, + drop large lifted shadow=blue] +This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + + \clearpage \subsection{\tikzname\ Picture Option Keys}\label{subsec:tikzpicture} The following general options are applicable for skins which diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf index cc559935619..298363bc1a5 100644 Binary files a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf and b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf differ diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex index 2f63cd63b0c..dfb3185c97b 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex @@ -1,5 +1,5 @@ % \LaTeX-Main\ -%% The LaTeX package tcolorbox - version 3.04 (2014/05/18) +%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -61,6 +61,8 @@ \usepackage{lipsum} \usepackage{empheq} +%\usepackage[cache]{minted}% minted 2.0 + \usepackage{changepage} \strictpagecheck @@ -100,8 +102,8 @@ \newtcolorbox{marker}[1][]{marker,#1} -\def\version{3.04}% -\def\datum{2014/05/18}% +\def\version{3.05}% +\def\datum{2014/05/28}% \makeindex \hypersetup{ @@ -165,7 +167,7 @@ \tcbset{documentation listing style=mydocumentation,% sbs/.style={sidebyside,before lower app={\tcbset{sidebyside=false}}},% innerbox/.style={reset,documentation listing style=mydocumentation, - docexample/.style={docexample original}%,listing engine=minted,documentation minted style=perldoc, + docexample/.style={docexample original},%listing engine=minted,documentation minted style=manni,documentation minted options={tabsize=2,fontsize=\footnotesize}, }, base example/.style={bicolor, colframe=Navy!50!ExampleFrame,colback=Navy!5!ExampleBack,fontlower=\footnotesize, @@ -302,7 +304,7 @@ %\tcbset{draftmode} -%\includeonly{tcolorbox.doc.skins} +%\includeonly{tcolorbox.doc.abstract} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -- cgit v1.2.3