From d618f80f8f62c896392904e75aefd221af6fa9e6 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 22 Sep 2014 22:17:46 +0000 Subject: tcolorbox (22sep14) git-svn-id: svn://tug.org/texlive/trunk@35232 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 28 +++++- Master/texmf-dist/doc/latex/tcolorbox/README | 2 +- .../doc/latex/tcolorbox/tcolorbox-example.pdf | Bin 361348 -> 361353 bytes .../doc/latex/tcolorbox/tcolorbox-example.tex | 2 +- .../doc/latex/tcolorbox/tcolorbox.doc.abstract.tex | 4 +- .../latex/tcolorbox/tcolorbox.doc.breakable.tex | 1 + .../latex/tcolorbox/tcolorbox.doc.coreoptions.tex | 69 +++++++++++++- .../tcolorbox/tcolorbox.doc.documentation.tex | 106 ++++++++++++++++++--- .../doc/latex/tcolorbox/tcolorbox.doc.filling.tex | 38 +++++++- .../doc/latex/tcolorbox/tcolorbox.doc.hooks.tex | 14 +++ .../latex/tcolorbox/tcolorbox.doc.initoptions.tex | 50 +++++++++- .../doc/latex/tcolorbox/tcolorbox.doc.skins.tex | 15 +++ .../doc/latex/tcolorbox/tcolorbox.doc.theorems.tex | 2 +- .../texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | Bin 4415072 -> 4488553 bytes .../texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 19 ++-- 15 files changed, 315 insertions(+), 35 deletions(-) (limited to 'Master/texmf-dist/doc/latex/tcolorbox') diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index 6acd6031241..192b17cc6d2 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.12 (2014/07/29) +%% The LaTeX package tcolorbox - version 3.20 (2014/09/22) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm @@ -566,7 +566,7 @@ version 3.10 (2014/07/23) for all types of boxes, skins, borders, and shadows: * new options: 'sharpish corners', 'sharp corners', and 'rounded corners' - library 'skins': - * new options: '\tcbline*' + * new macros: '\tcbline*' * bug fix: skin families 'bicolor' and 'beamer' did not respect 'colbacktitle' - pictures 'blueshade.png', 'crinklepaper.png', 'goldshade.png', 'pink_marble.png' moved to package folder @@ -583,3 +583,27 @@ version 3.12 (2014/07/29) - library 'breakable': * new option: 'vfill before first' +version 3.20 (2014/09/22) +- bug fix: titles set with 'detach' or 'boxed title' options were not considered + for lists of tcolorboxes. +- bug fix: 'extrude left by', 'extrude right by' worked only for '\tcbox' but not for 'tcolorbox' +- bug fix: 'pad before break*' and 'pad at break*' were always setting to 0pt +- new options: 'every float', 'list text', 'overlay first and middle', + 'height fill' +- new initialization options: + 'use counter*', 'blend into' +- library 'skins': + * new macros: '\tcbsettowidthofnode', '\tcbsetmacrotowidthofnode', + '\tcbsettoheightofnode', '\tcbsetmacrotoheightofnode' + * new options: 'underlay first and middle', 'finish first and middle' +- library 'hooks': + * new options: 'underlay first and middle pre', + 'overlay first and middle app', 'overlay first and middle pre', + 'finish first and middle pre' +- library 'documentation': + * new macros: '\tcbdocmarginnote', '\tcbdocnew', '\tcbdocupdated' + * The 'docKey' and 'docKey*' environments take tcolorbox options now + * new options: + 'doclang/new', 'doclang/updated', + 'doc marginnote', 'doc updated', 'doc new', 'doc new and updated' + diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index aa3167bb975..06bb2a4f501 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.12 (2014/07/29) +%% The LaTeX package tcolorbox - version 3.20 (2014/09/22) %% %% ------------------------------------------------------------------------------------------- %% 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 3f6068330cd..0902b99e687 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 1a3fc077aca..082cc44e086 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.12 (2014/07/29) +%% The LaTeX package tcolorbox - version 3.20 (2014/09/22) %% 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 b447e3530fb..d355b85d922 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex @@ -67,7 +67,8 @@ cover page. Printing the pages starting with page 2 or page 3 should work. colback=yellow!10!white,colframe=red!50!black,before=\par\bigskip\noindent, interior style={fill overzoom image=goldshade.png,fill image opacity=0.25}, colbacktitle=red!50!yellow!75!black, - watermark color=yellow!75!red!25!white,pad at break=3mm, + enlargepage flexible=\baselineskip,pad at break*=3mm, + watermark color=yellow!75!red!25!white, watermark text={\bfseries\Large Contents}, attach boxed title to top center={yshift=-0.25mm-\tcboxedtitleheight/2,yshifttext=2mm-\tcboxedtitleheight/2}, boxed title style={enhanced,boxrule=0.5mm, @@ -78,7 +79,6 @@ cover page. Printing the pages starting with page 2 or page 3 should work. -- (interior.north west) -- (interior.north east) -- ([xshift=2mm]interior.east) -- (interior.south east) -- (interior.south west) -- cycle;} }, - %enlargepage=2\baselineskip, drop fuzzy shadow] \makeatletter \@starttoc{toc} 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 91dbc9a5c76..894db46d014 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex @@ -370,6 +370,7 @@ and \refKey{/tcb/enlarge bottom at break by}. \begin{marker} If the box keeps unbroken, this option is not applied. See \refKey{/tcb/height} for setting a fixed height for unbroken boxes. + See \refKey{/tcb/height fill} for giving unbroken boxes maximum height. \end{marker} \end{docTcbKey} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex index 03569b2014d..3c350f3b655 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -1122,9 +1122,32 @@ This is a tcolorbox. This is a tcolorbox. This is a tcolorbox. \end{dispExample} \end{docTcbKey} +\clearpage +\begin{docTcbKey}[][doc new=2014-09-22]{height fill}{\colOpt{=true\textbar false}}{default |true|, initially |false|} +If set to |true|, the height of the |tcolorbox| is set to the rest of the +available vertical space of the current page. Note that the |tcolorbox| +is always set as its own paragraph using this option. +This option overrules \refKey{/tcb/natural height}, \refKey{/tcb/height}, etc. +\begin{marker} +Note that the library \mylib{breakable} has to be loaded to use this key! +\end{marker} +This height control key is only applicable to unbreakable boxes but it +uses code from the library \mylib{breakable}. +The counterpart for breakable boxes is \refKey{/tcb/height fixed for}. +\begin{dispListing} +% \usepackage{lipsum} +% \tcbuselibrary{breakable} +\begin{tcolorbox}[height fill, + colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries, + title=Box which fills the rest of the page] +\lipsum[1] +\end{tcolorbox} +\end{dispListing} +\end{docTcbKey} +{\tcbusetemp} -\clearpage +%\clearpage \begin{docTcbKey}{space}{=\meta{fraction}}{no default, initially 0} If the height of a |tcolorbox| is not the natural height, the space difference between the forced and the natural size is distributed @@ -1794,6 +1817,13 @@ This is the lower part. \refKey{/tcb/overlay} overwrites this key. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{overlay first and middle}{=\meta{graphical code}}{no default, initially unset} + This is an optimized abbreviation for setting + \refKey{/tcb/overlay first} and + \refKey{/tcb/overlay middle} together. + \refKey{/tcb/overlay} overwrites this key. +\end{docTcbKey} + \begin{dispListing*}{breakable,before upper={This example demonstrates the application of break sequence specific overlay options. @@ -1812,7 +1842,6 @@ are drawn by the codes given with %\tcbuselibrary{skins,breakable} %\newcounter{example} \colorlet{colexam}{red!75!black} - \newtcolorbox[use counter=example]{myexample}{% empty,title={Example \thetcbcounter},attach boxed title to top left, boxed title style={empty,size=minimal,toprule=2pt,top=4pt, @@ -1922,6 +1951,24 @@ are drawn by the codes given with \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{every float}{=\meta{code}}{no default, initially empty} + For floating objects, the \refKey{/tcb/before} and \refKey{/tcb/after} + settings are ignored. Instead, the given \meta{code} is inserted before + a floating box. If the box is \refKey{/tcb/breakable}, the given \meta{code} is + inserted before every part of the break sequence. + The most common use case is |every float=\centering|. + +\begin{dispListing} +\tcbox[float=htb,title={Floating box},every float=\centering, + colback=blue!50!black,colframe=blue!50!white,colbacktitle=blue!10!white, + coltitle=black,center title] + {\includegraphics[height=6cm]{lichtspiel.jpg}} +\end{dispListing} +{\tcbset{reset}\tcbusetemp} + +\end{docTcbKey} + + \clearpage \subsection{Side by Side}\label{subsec:sidebyside} \begin{marker} @@ -2363,7 +2410,7 @@ Lorem \tcbox{ipsum} dolor sit amet, consectetuer adipiscing elit. \end{dispExample} \end{docTcbKey} -\begin{docTcbKey}{extrude left by}{=\meta{length}}{style, no default, initially unset} +\begin{docTcbKey}[][doc updated=2014-09-19]{extrude left by}{=\meta{length}}{style, no default, initially unset} The (upper part of the) colored box is extruded by the given \meta{length} to the left side. The inner width and the bounding box is kept unchanged and the operation is additiv! @@ -2379,7 +2426,7 @@ Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna. \end{dispExample} \end{docTcbKey} -\begin{docTcbKey}{extrude right by}{=\meta{length}}{style, no default, initially unset} +\begin{docTcbKey}[][doc updated=2014-09-19]{extrude right by}{=\meta{length}}{style, no default, initially unset} The (upper part of the) colored box is extruded by the given \meta{length} to the right side. The inner width and the bounding box is kept unchanged and the operation is additiv! @@ -2748,7 +2795,7 @@ Test\dotfill %page \pageref{sec:skincorekeys}. \clearpage -\subsection{Counters, Labels and References} +\subsection{Counters, Labels, and References} \begin{docTcbKey}{phantom}{=\meta{code}}{no default, initially unset} The \meta{code} is put in a box at the upper left corner of the |tcolorbox|. @@ -2826,6 +2873,18 @@ See Section \ref{listing:exercises} from page \pageref{listing:exercises} for a complete example. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{list text}{=\meta{text}}{style, no default} +This is a shortcut for setting \refKey{/tcb/list entry} to\\ +|\protect\numberline{\thetcbcounter}|\meta{text}. +So, the following settings are identical: +\begin{dispListing} +list text={My beautiful Example}, +list entry={\protect\numberline{\thetcbcounter}My beautiful Example} +\end{dispListing} +See Section \ref{listing:exercises} from page \pageref{listing:exercises} +for a complete example. +\end{docTcbKey} + \begin{docTcbKey}{add to list}{=\marg{list}\marg{type}}{no default, initially unset} If the \flqq list of tcolorbox(es)\frqq\ feature described in Subsection \ref{sec:listsof} from page \pageref{sec:listsof} is used, list entries are diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex index b1fe8a9d02d..52fce65f388 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex @@ -14,8 +14,9 @@ The library is loaded by a package option or inside the preamble by: \end{dispListing} This also loads the library \mylib{listings}, see \Vref{sec:listings}, the library \mylib{skins}, see \Vref{sec:skins}, +the library \mylib{xparse}\tcbdocmarginnote{\tcbdocnew{2014-09-19}}, see \Vref{sec:xparse}, and a bunch of packages, namely -|doc|, |pifont|, |marvosym|, |makeidx|, |refcount|, and |hyperref|. +|doc|, |pifont|, |marvosym|, |makeidx|, |marginnote|, |refcount|, and |hyperref|. \begin{marker} The package |makeidx| is loaded only, if \docAuxCommand*{printindex} is @@ -96,8 +97,9 @@ For |minted| \cite{rudolph:2011a} support, load: \end{xdocEnvironment}} -\begin{docEnvironment}[doclang/environment content=key description]{docKey}{\oarg{key path}\marg{name}\marg{parameters}\marg{description}} +\begin{docEnvironment}[doclang/environment content=key description,doc updated=2014-09-19]{docKey}{\oarg{key path}\oarg{options}\marg{name}\marg{parameters}\marg{description}} Documents a key with given \meta{name} and an optional \meta{key path}. + The given \meta{options} are set with \refCom{tcbset}. This key takes mandatory or optional \meta{parameters} as value with a short \meta{description}. It is automatically indexed and can be referenced with @@ -110,7 +112,7 @@ For |minted| \cite{rudolph:2011a} support, load: \end{docEnvironment} -\begin{docEnvironment}[doclang/environment content=key description]{docKey*}{\oarg{key path}\marg{name}\marg{parameters}\marg{description}} +\begin{docEnvironment}[doclang/environment content=key description,doc updated=2014-09-19]{docKey*}{\oarg{key path}\oarg{options}\marg{name}\marg{parameters}\marg{description}} Identical to \refEnv{docKey}, but without index entry. \end{docEnvironment} @@ -402,6 +404,43 @@ This is my \colOpt{text}. \end{dispExample} \end{docCommand} +\clearpage + +\begin{docCommand}[doc new=2014-09-19]{tcbdocmarginnote}{\oarg{options}\marg{text}} + Creates a |tcolorbox| note with the given \meta{text} inside the margin using + the |marginnote| package. The style of the |tcolorbox| is predefined and can be + altered by \refKey{/tcb/doc marginnote} and the given \meta{options}. +\begin{dispExample} +Some text\tcbdocmarginnote{Note A} +which is commented by a note inside the margin. +Alternatively to |\tcbdocmarginnote|, you can always use +|\marginnote| with a |tcolorbox| directly.\par +This is further text% +\tcbdocmarginnote[colframe=blue!50!white,colback=blue!5!white]{Note B} +with another note. +\end{dispExample} +\end{docCommand} + +\begin{docCommand}[doc new=2014-09-19]{tcbdocnew}{\marg{date}} + Auxiliary macro which typesets the \refKey{/tcb/doclang/new} text with + the given \meta{date}. It may be redefined for customization. + \makeatletter\renewcommand*{\tcbdocnew}[1]{\kvtcb@text@new: #1}\makeatother% +\begin{dispExample*}{sidebyside} +\tcbdocnew{1981-10-29}. +% Next one is displayed in the margin: +\tcbdocmarginnote{\tcbdocnew{1978-02-09}} +\end{dispExample*} +\end{docCommand} + +\begin{docCommand}[doc new=2014-09-19]{tcbdocupdated}{\marg{date}} + Auxiliary macro which typesets the \refKey{/tcb/doclang/updated} text with + the given \meta{date}. It may be redefined for customization. + \makeatletter\renewcommand*{\tcbdocupdated}[1]{\kvtcb@text@updated: #1}\makeatother% +\begin{dispExample*}{sidebyside} +\tcbdocupdated{2014-09-19}. +\end{dispExample*} +\end{docCommand} + \clearpage \subsection{Option Keys of the Library} @@ -561,9 +600,6 @@ The English language is predefined. Heading text in the index for colors. \end{langTcbKey} -\begin{langTcbKey}{environment content}{=\meta{text}}{no default, initially |environment content|} - Text used in \refEnv{docEnvironment}. -\end{langTcbKey} \begin{langTcbKey}{environment}{=\meta{text}}{no default, initially |environment|} Text used in the index for environments. @@ -573,6 +609,10 @@ The English language is predefined. Heading text in the index for environments. \end{langTcbKey} +\begin{langTcbKey}{environment content}{=\meta{text}}{no default, initially |environment content|} + Text used in \refEnv{docEnvironment}. +\end{langTcbKey} + \begin{langTcbKey}{key}{=\meta{text}}{no default, initially |key|} Text used in the index for keys. \end{langTcbKey} @@ -581,6 +621,22 @@ The English language is predefined. Heading text used in the index for keys. \end{langTcbKey} +\begin{langTcbKey}{index}{=\meta{text}}{no default, initially |Index|} + Heading text for the index. +\end{langTcbKey} + +\begin{langTcbKey}[][doc new={2014-09-19}]{new}{=\meta{text}}{no default, initially |New|} + Announcement text for new content. +\end{langTcbKey} + +\begin{langTcbKey}{pageshort}{=\meta{text}}{no default, initially |P.|} + Short text for page references. +\end{langTcbKey} + +\begin{langTcbKey}[][doc new={2014-09-19}]{updated}{=\meta{text}}{no default, initially |Updated|} + Announcement text for updated content. +\end{langTcbKey} + \begin{langTcbKey}{value}{=\meta{text}}{no default, initially |value|} Text used in the index for values. \end{langTcbKey} @@ -589,13 +645,7 @@ The English language is predefined. Heading text in the index for values. \end{langTcbKey} -\begin{langTcbKey}{index}{=\meta{text}}{no default, initially |Index|} - Heading text for the index. -\end{langTcbKey} -\begin{langTcbKey}{pageshort}{=\meta{text}}{no default, initially |P.|} - Short text for page references. -\end{langTcbKey} \clearpage \begin{docTcbKey}{doc left}{=\meta{length}}{no default, initially |2em|} @@ -716,6 +766,38 @@ hand side if too long. Linebreaks can be used inside the \meta{text}. instead of \refEnv{docCommand}. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{doc marginnote}{=\meta{options}}{no default, initially empty} + Sets style \meta{options} for the displayed box of the \refCom{tcbdocmarginnote} command. +\begin{dispExample} +\tcbset{doc marginnote={colframe=blue!50!white,colback=blue!5!white}}% +This is some text\tcbdocmarginnote{Note A} +which is commented by a note inside the margin. +\end{dispExample} +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2014-09-19]{doc new}{=\meta{date}}{style, no default} + Adds a a marginnote with a 'New: \meta{data}' message at the beginning of + the upper box part. The intended use is inside the option list of + \refEnv{docCommand}, \refEnv{docEnvironment}, etc. + \makeatletter\renewcommand*{\tcbdocnew}[1]{\kvtcb@text@new: #1}\makeatother% +\begin{dispExample} +\begin{docCommand}[doc new=2000-01-01]{foosomething}{\marg{text}} +Some command for something. +\end{docCommand} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}[][doc new=2014-09-19]{doc updated}{=\meta{date}}{style, no default} + Adds a marginnote with a 'Updated: \meta{data}' message at the beginning of + the upper box part. See \refKey{/tcb/doc new}. +\end{docTcbKey} + + +\begin{docTcbKey}[][doc new=2014-09-19]{doc new and updated}{=\marg{new date}\marg{update date}}{style, no default} + Adds a marginnote with 'New: \meta{new date}' and 'Updated: \meta{update data}' messages at the beginning of + the upper box part. See \refKey{/tcb/doc new}. +\end{docTcbKey} \subsection{Predefined Colors of the Library} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex index ced3f0ffd01..89e159eba81 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex @@ -1,7 +1,7 @@ % !TeX root = tcolorbox.tex % include file of tcolorbox.tex (manual of the LaTeX package tcolorbox) \clearpage -\section{\tikzname\ Image and Picture Fill Extensions}\label{sec:tikzimagefilling} +\section{\tikzname\ Image and Picture Fill Extensions; Auxiliary Macros}\label{sec:tikzimagefilling} The \mylib{skins} library adds some image and picture fill options to the vast option set of \tikzname\ \cite{tantau:2013a}. These options can be used in any |tikzpicture|. For the following options, the \mylib{skins} library has to be loaded @@ -413,3 +413,39 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk \end{tikzpicture} \end{dispExample*} + +\clearpage +\subsection{Extracting Node Dimensions} +The following auxiliary macros are defined by the \mylib{skins} library. +They allow to determine the width and height of an arbitrary \tikzname\ node. +To be more specific, they determine the east-to-west and the north-to-south dimensions +which may be not the maximal dimensions for a non-rectangular node. + +\begin{docCommand}[doc new=2014-09-19]{tcbsettowidthofnode}{\marg{register}\marg{node}} + Sets the east-to-west dimension of the given \meta{node} + to the \TeX\ \meta{register}. +\end{docCommand} + +\begin{docCommand}[doc new=2014-09-19]{tcbsetmacrotowidthofnode}{\marg{macro}\marg{node}} + Defines \meta{macro} as the east-to-west dimension of the given \meta{node}. +\end{docCommand} + +\begin{docCommand}[doc new=2014-09-19]{tcbsettoheightofnode}{\marg{register}\marg{node}} + Sets the north-to-south dimension of the given \meta{node} + to the \TeX\ \meta{register}. +\end{docCommand} + +\begin{docCommand}[doc new=2014-09-19]{tcbsetmacrotoheightofnode}{\marg{macro}\marg{node}} + Defines \meta{macro} as the north-to-south dimension of the given \meta{node}. +\end{docCommand} + +\begin{dispExample} +\begin{tikzpicture} + \node[align=center,draw=red,fill=yellow] (A) {This is my\\example node}; + \tcbsetmacrotowidthofnode\mywidth{A} + \tcbsetmacrotoheightofnode\myheight{A} + \path[draw=blue,fill=blue!25!white] ([xshift=2mm]A.south east) + rectangle node{Copy} +(\mywidth,\myheight); +\end{tikzpicture} +\end{dispExample} + diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex index 88d2ba4385d..8dbd52789e2 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex @@ -275,6 +275,14 @@ Here, we apply a second overlay. Prepends the given \meta{graphical code} to \refKey{/tcb/overlay unbroken and last}. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{overlay first and middle app}{=\meta{graphical code}}{no default} + Appends the given \meta{graphical code} to \refKey{/tcb/overlay first and middle}. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2014-09-19]{overlay first and middle pre}{=\meta{graphical code}}{no default} + Prepends the given \meta{graphical code} to \refKey{/tcb/overlay first and middle}. +\end{docTcbKey} + \clearpage \subsection{Watermarks} @@ -414,6 +422,9 @@ There are no |app| type keys since underlays are stackable by default. Prepends the given \meta{graphical code} to \refKey{/tcb/underlay unbroken and last}. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{underlay first and middle pre}{=\meta{graphical code}}{no default} + Prepends the given \meta{graphical code} to \refKey{/tcb/underlay first and middle}. +\end{docTcbKey} \clearpage @@ -458,6 +469,9 @@ There are no |app| type keys since finishes are stackable by default. Prepends the given \meta{graphical code} to \refKey{/tcb/finish unbroken and last}. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{finish first and middle pre}{=\meta{graphical code}}{no default} + Prepends the given \meta{graphical code} to \refKey{/tcb/finish first and middle}. +\end{docTcbKey} \subsection{Skin Code} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex index c38f60f8d2c..ab92c631692 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex @@ -50,7 +50,7 @@ The real counter name is \texttt{\tcbcounter}. \clearpage \begin{newTcbKey}{use counter from}{=\meta{tcolorbox}}{no default, initially unset} Here, a counter from another \meta{tcolorbox} is reused. -Note that the setting for \refKey{/tcb/new/number format} and +Note that the settings for \refKey{/tcb/new/number format} and \refKey{/tcb/new/number within} are inherited and cannot be changed. The counter value is referenced by \docAuxCommand{thetcbcounter}. @@ -70,7 +70,7 @@ The real counter name is \texttt{\tcbcounter}. \begin{newTcbKey}{use counter}{=\meta{counter}}{no default, initially unset} -Here, an ordinary existing \LaTeX\ counter is used for numbering. +Here, an ordinary existing \LaTeX\ \meta{counter} is used for numbering. With \refKey{/tcb/new/number format} and \refKey{/tcb/new/number within}, the appearance and behavior of the counter can be changed. The counter value is referenced by \docAuxCommand{thetcbcounter}. @@ -91,6 +91,15 @@ The real counter name is \texttt{\tcbcounter}. \end{newTcbKey} +\begin{newTcbKey}[][doc new=2014-09-19]{use counter*}{=\meta{counter}}{no default, initially unset} +An existing \LaTeX\ \meta{counter} is used for numbering. In contrast to +\refKey{/tcb/new/use counter}, the options \refKey{/tcb/new/number format} and +\refKey{/tcb/new/number within} are ignored. Use this for counters which +are already configured outside the |tcolorbox| package, e.\,g.\ the standard +|figure| counter. +\end{newTcbKey} + + \begin{newTcbKey}{no counter}{}{no value, initially set} The created boxes are not numbered. This is the default. The option may be used to overrule a previous option. @@ -182,9 +191,46 @@ With \texttt{varioref}:\\ \Vref*{myreference}, \vref*{myreference}. \end{dispExample} +\clearpage +\begin{newTcbKey}[][doc new=2014-09-19]{blend into}{=\meta{name}}{style, no default, initially unset} +Used to comfortably blend into an existing schema of naming and numbering for +some selected cases. For example, a |tcolorbox| can be used to display +and entitle an image pretending to be a standard |figure| environment. +Here, \refKey{/tcb/title} is used instead of the standard |\caption| +and \refKey{/tcb/list text} can be used instead of the optional parameter +of the standard |\caption|. +Feasible values for \meta{name} are: +\begin{itemize} +\item\docValue{figures}: blend into the standard |figure| environment. +\item\docValue{tables}: blend into the standard |table| environment. +\item\docValue{listings}: blend into the standard |lstlistings| environment + of the package |listings| \cite{heinz:2013a}. + \begin{marker} + Note that |blend into=listings| can only be used in the document content + or, preferably, inside a |\AtBeginDocument| clause! Using it without + |\AtBeginDocument| inside the preamble does not work since the |listings| + packages initializes its counter also inside |\AtBeginDocument|. + \end{marker} +\end{itemize} +\end{newTcbKey} + +\enlargethispage*{5cm} +\begin{dispListing} +\begin{figure}[htb] + \centering\includegraphics[height=4cm]{lichtspiel.jpg} + \caption{A standard figure} +\end{figure} +\newtcolorbox[blend into=figures]{myfigure}[2][]{float=htb,capture=hbox, + title={#2},every float=\centering,#1} + +\begin{myfigure}{A tcolorbox figure} + \includegraphics[height=4cm]{lichtspiel.jpg} +\end{myfigure} +\end{dispListing} +{\tcbusetemp} \clearpage 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 e3eaa60fd02..e2e319848c3 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex @@ -823,6 +823,7 @@ But a mixture is possible with the \mylib{hooks} library, see Section \ref{sec:h \end{dispExample} \end{docTcbKey} +\enlargethispage*{1cm} \begin{docTcbKey}{watermark text on}{=\meta{part} is \meta{text}}{no default, initially unset} This option writes some \meta{text} in the center of the interior region of a |tcolorbox| @@ -838,6 +839,7 @@ But a mixture is possible with the \mylib{hooks} library, see Section \ref{sec:h \item\docValue{last}: last parts of a break sequence, \item\docValue{unbroken and first}: unbroken boxes and first parts of a break sequence, \item\docValue{middle and last}: middle and last parts of a break sequence. + \item\docValue{first and middle}: first and middle parts of a break sequence. \end{itemize} \end{docTcbKey} @@ -2125,6 +2127,12 @@ The differences between underlays and overlays are: \refKey{/tcb/underlay} overwrites this key. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{underlay first and middle}{=\meta{graphical code}}{no default, initially unset} + This is an abbreviation for setting + \refKey{/tcb/underlay first} and + \refKey{/tcb/underlay middle} together. + \refKey{/tcb/underlay} overwrites this key. +\end{docTcbKey} \clearpage @@ -2261,6 +2269,13 @@ Finishes are intended for special effects like highlights or glosses or text ove \end{docTcbKey} +\begin{docTcbKey}[][doc new=2014-09-19]{finish first and middle}{=\meta{graphical code}}{no default, initially unset} + This is an abbreviation for setting + \refKey{/tcb/finish first} and + \refKey{/tcb/finish middle} together. + \refKey{/tcb/finish} overwrites this key. +\end{docTcbKey} + \clearpage \subsection{Jigsaw Skin Variants}\label{subsec:skinjigsaw} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex index e0d98e5e927..0a261de187f 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex @@ -939,7 +939,7 @@ Let's try a more conservative approach: coltitle=red!50!black,fonttitle=\upshape\bfseries,fontupper=\itshape, drop fuzzy shadow=blue!50!black!50!white,boxrule=0.4pt}{theo} -\begin{YetAnotherTheorem}{Mittelwertsatz f\"{u}r $n$ Variable}{mittelwertsatz_n3}% +\begin{YetAnotherTheorem}{Mittelwertsatz f\"{u}r $n$ Variable}{mittelwertsatz_n4}% Es sei $n\in\mathbb{N}$, $D\subseteq\mathbb{R}^n$ eine offene Menge und $f\in C^{1}(D,\mathbb{R})$. Dann gibt es auf jeder Strecke $[x_0,x]\subset D$ einen Punkt $\xi\in[x_0,x]$, so dass gilt diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf index 0260b9a31a6..e491f7bc7d5 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 7a305b322fd..da6e97c717e 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.12 (2014/07/29) +%% The LaTeX package tcolorbox - version 3.20 (2014/09/22) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -32,7 +32,7 @@ \usepackage{varwidth,cleveref,incgraph} \usepackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm, - marginparsep=5mm,marginparwidth=10mm, + marginparsep=3mm,marginparwidth=18mm, headheight=0mm,headsep=0cm, footskip=1.5cm,includeheadfoot]{geometry} \usepackage{fancyhdr} @@ -103,8 +103,11 @@ \newtcolorbox{marker}[1][]{marker,#1} -\def\version{3.12}% -\def\datum{2014/07/29}% +\renewcommand*{\tcbdocnew}[1]{\textcolor{green!50!black}{\sffamily\bfseries N} #1} +\renewcommand*{\tcbdocupdated}[1]{\textcolor{blue!75!black}{\sffamily\bfseries U} #1} + +\def\version{3.20}% +\def\datum{2014/09/22}% \makeindex \hypersetup{ @@ -147,9 +150,10 @@ meta,marg, oarg, refCom,refEnv,refKey, - tcbmakedocSubKey, + tcbmakedocSubKey,tcbdocmarginnote,tcbdocnew,tcbdocupdated, % skins tcbline,tcboxedtitleheight,tcboxedtitlewidth, + tcbsettowidthofnode,tcbsetmacrotowidthofnode,tcbsettoheightofnode,tcbsetmacrotoheightofnode, % xparse DeclareTColorBox,NewTColorBox,RenewTColorBox,ProvideTColorBox, DeclareTotalTColorBox,NewTotalTColorBox,RenewTotalTColorBox,ProvideTotalTColorBox, @@ -250,8 +254,7 @@ listing file={\solfile\thetcbcounter},label={exe:#2}, phantom={\writesol{#2}}, title={Exercise \thetcbcounter\hfill\mdseries Solution on page \pageref{sol:#2}}, - list entry={\protect\numberline{\thetcbcounter}Exercise with solution on - page \pageref{sol:#2}},#1} + list text={Exercise with solution on page \pageref{sol:#2}},#1} \end{tcbverbatimwrite} \input{\jobname_preamble_E.tex} @@ -305,7 +308,7 @@ %\tcbset{draftmode} -%\includeonly{tcolorbox.doc.breakable} +%\includeonly{tcolorbox.doc.abstract} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -- cgit v1.2.3