summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-03-01 00:53:37 +0000
committerKarl Berry <karl@freefriends.org>2016-03-01 00:53:37 +0000
commit384f9a0c9aed29686dd44edf6a48b6b17739297e (patch)
treef6733d56e05ae705bc53370f682126714b5777f3 /Master/texmf-dist/doc/latex/tcolorbox
parent6a2bf934fc548f066363cd953b7aaa6e5c38293a (diff)
tcolorbox
git-svn-id: svn://tug.org/texlive/trunk@39894 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES31
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin361333 -> 448255 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex43
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex19
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex105
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex293
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty23
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex389
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex79
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin6369898 -> 6581403 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex10
13 files changed, 936 insertions, 62 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 7e680d82456..ca5fba5bc7d 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
+++ b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
@@ -1,7 +1,7 @@
-%% The LaTeX package tcolorbox - version 3.80 (2015/11/27)
+%% The LaTeX package tcolorbox - version 3.90 (2016/02/29)
%%
%% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2006-2015 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
@@ -848,3 +848,30 @@ version 3.80 (2015/11/27)
- library 'xparse':
* new macro: '\tcbsidebyside'
* new options: 'sidebyside adapt', 'sidebyside switch'
+
+version 3.90 (2016/02/29)
+- bug fix: 'height fill' after headings (nobreak) produced an error
+- implementation for 'before' and 'before skip' changed to avoid spacing
+ problems when there is a page break before breakable/unbreakable boxes
+- the 'height fill' option can be applied also for boxed inside a tcbraster
+- new options:
+ 'add to natural height', 'space to', 'use height from group' (new default)
+- new macros:
+ '\tcbheightspace', '\tcbtextwidth', '\tcbtextheight'
+- library 'skins':
+ * 'halign title' works with 'boxed title' now
+ * 'boxed title style' changed to be stackable
+ * better support for titles at the bottom of the box
+ * new skin: 'tile'
+ * new options:
+ 'blankest', 'tile', 'no boxed title style', 'boxed title size',
+ 'attach boxed title to bottom', 'attach boxed title to bottom*',
+ 'attach boxed title to top', 'attach boxed title to top*',
+ 'flip title'
+- library 'raster':
+ * new environment:
+ 'tcboxedraster'
+ * new options:
+ 'raster multicolumn', 'raster multirow'
+- library 'documentation':
+ removal of some unwanted blanks
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index e4e999d65cb..55be40956e3 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/README
+++ b/Master/texmf-dist/doc/latex/tcolorbox/README
@@ -1,7 +1,7 @@
-%% The LaTeX package tcolorbox - version 3.80 (2015/11/27)
+%% The LaTeX package tcolorbox - version 3.90 (2016/02/29)
%%
%% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2006-2015 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index d559c7d3c56..57d5ba6e149 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
index f5c4a4e7175..ef72f3a4197 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
@@ -1,8 +1,8 @@
-%% The LaTeX package tcolorbox - version 3.80 (2015/11/27)
+%% The LaTeX package tcolorbox - version 3.90 (2016/02/29)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2006-2015 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
@@ -190,5 +190,44 @@ We have given Theorem \ref{theorem:summation} on page \pageref{theorem:summation
\lipsum[1-4]
\end{tcolorbox}
+%----------------------------------------------------------
+\clearpage
+\section{Rasters of Boxes}
+
+\begin{tcolorbox}[tile,size=fbox,boxsep=2mm,boxrule=0pt,
+ colback=blue!20!black,colbacktitle=yellow!50!black,
+ title=A Raster of Boxes,center title,
+ height fill]
+ \begin{tcbitemize}[raster columns=3,raster rows=4,raster equal skip=2mm,
+ raster height=\tcbtextheight,
+ title={Box~\thetcbrasternum},fonttitle=\bfseries,
+ enhanced,colframe=blue!50,colback=blue!5]
+ \tcbitem A
+ \tcbitem[flip title={interior hidden}] B
+ \tcbitem[colbacktitle=blue!40!black] C
+ \tcbitem[colbacktitle=blue!40!black,flip title] D
+ \tcbitem[beamer] E
+ \tcbitem[tile,colbacktitle=red!40!black] F
+ \tcbitem[tile,colbacktitle=red!40!black,flip title={sharp corners}] G
+ \tcbitem[blankest]
+ \begin{tcbitemize}[raster columns=2,raster rows=2,raster height=\tcbtextheight,
+ tile,halign=center,valign=center,fontupper=\bfseries\Huge,before upper=\strut,
+ colback=green!20]
+ \tcbitem a
+ \tcbitem b
+ \tcbitem c
+ \tcbitem d
+ \end{tcbitemize}
+ \tcbitem[widget] I
+ \tcbitem[frame style image=goldshade,opacityback=0.5,colback=white] J
+ \tcbitem[frame style image=blueshade,opacityback=0.5,colback=white,
+ center title,flip title={frame hidden,opacityback=0.25,colback=black}] K
+ \tcbitem[octogon arc,arc is angular,halign=center,valign=center,
+ detach title,watermark text={\tcbtitletext}] L
+ \end{tcbitemize}
+\end{tcolorbox}
+
+
+
\end{document}
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 e0d477e1e01..f3d8976d047 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -106,7 +106,7 @@ parameters. The differences are:
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.}.
+ 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.
@@ -118,6 +118,12 @@ parameters. The differences are:
The |perpage| option of the |footmisc| package is deliberately deactivated
inside a breakable box since all footnotes are placed at the end
of the box (possibly far away from the reference point).
+\item\tcbdocmarginnote{\tcbdocnew{2016-02-15}}
+ Making a box \refKey{/tcb/breakable} which actually is not broken creates
+ a box which acts \emph{almost} like an unbreakable box. Visual differences
+ are kept as indiscernible as possible, but can appear with certain
+ \refKey{/tcb/before} and \refKey{/tcb/after} settings, especially, if there
+ is an automatic page break before the box.
\end{itemize}
@@ -518,12 +524,10 @@ and \refKey{/tcb/enlarge bottom at break by}.
% \usetikzlibrary{decorations.pathmorphing}
% \tcbuselibrary{skins}
\newtcolorbox{mybox}[1][]{
- enhanced,frame hidden,
- colframe=yellow,
- sharp corners,
+ tile,
colback=green!7,coltitle=blue!50!black,colbacktitle=blue!5,
center title,
- boxrule=0pt,toprule=1.25mm,bottomrule=1.25mm,
+ toprule=1.25mm,bottomrule=1.25mm,
extras unbroken and first={
borderline north={0.25mm}{0.5mm}{blue,decoration={zigzag,amplitude=0.5mm},decorate}},
extras unbroken and last={
@@ -681,6 +685,11 @@ the \emph{break sequence} parts are displayed.
\tcbbreakskininto{bicolormiddle}{bicolormiddle}{bicolormiddle}{bicolormiddle}{bicolor}
\tcbbreakskininto{bicolorlast}{bicolormiddle}{bicolormiddle}{bicolorlast}{bicolor}
\clearpage
+\tcbbreakskininto{tile}{tilefirst}{tilemiddle}{tilelast}{tile,colbacktitle=Navy}
+\tcbbreakskininto{tilefirst}{tilefirst}{tilemiddle}{tilemiddle}{tile,colbacktitle=Navy}
+\tcbbreakskininto{tilemiddle}{tilemiddle}{tilemiddle}{tilemiddle}{tile,colbacktitle=Navy}
+\tcbbreakskininto{tilelast}{tilemiddle}{tilemiddle}{tilelast}{tile,colbacktitle=Navy}
+\clearpage
\tcbbreakskininto{beamer}{beamerfirst}{beamermiddle}{beamerlast}{beamer}
\tcbbreakskininto{beamerfirst}{beamerfirst}{beamermiddle}{beamermiddle}{beamer}
\tcbbreakskininto{beamermiddle}{beamermiddle}{beamermiddle}{beamermiddle}{beamer}
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 57a74eb85f2..09318e42bb5 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -1430,7 +1430,7 @@ This is a \textbf{tcolorbox}.
\begin{docTcbKey}{sharpish corners}{}{style, no value}
Shortcut for setting \refKey{/tcb/arc} and \refKey{/tcb/outer arc}
- to |0pt|. With this setting, rounded corners will appear als quasi-sharp,
+ to |0pt|. With this setting, rounded corners will appear as quasi-sharp,
but e.\,g.\ the shadow will be somewhat rounder than the shadow
of really sharp corners.
\begin{marker}
@@ -1683,6 +1683,8 @@ This is a \textbf{tcolorbox} where the text area has a height of 2cm.
\begin{docTcbKey}[][doc new=2014-11-07]{add to height}{=\meta{length}}{style, no default}
Adds \meta{length} to the current height of the colored box.
\refKey{/tcb/height} has to be set before this key is used!
+ If this option is used several times, then the \refKey{/tcb/height} is
+ also increased several times.
\begin{dispExample}
\tcbset{height=1cm,
valign=center,width=(\linewidth-2mm)/2,
@@ -1698,7 +1700,28 @@ This is a \textbf{tcolorbox} where the text area has a height of 2cm.
\end{docTcbKey}
-\begin{docTcbKey}[][doc new and updated={2014-09-22}{2014-12-15}]{height fill}{\colOpt{=true\textbar false\textbar maximum}}{default |true|, initially |false|}
+\begin{docTcbKey}[][doc new=2016-02-16]{add to natural height}{=\meta{length}}{style, no default}
+ The application of this option generates a box with natural height plus
+ the given \meta{length}. If this option is used several times, then the
+ last setting of \meta{length} wins. The resulting box is not considered
+ a fixed height box and the implementation is quite different to
+ \refKey{/tcb/add to height}.
+\begin{dispExample}
+\tcbset{valign=center,width=(\linewidth-2mm)/2,
+ before=,after=\hfill,colframe=blue!75!black,colback=white}
+
+\begin{tcolorbox}
+ This box has natural height.
+\end{tcolorbox}
+\begin{tcolorbox}[add to natural height=1cm]
+ This box has natural height plus 1 cm.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}[][doc new and updated={2014-09-22}{2016-02-17}]{height fill}{\colOpt{=true\textbar false\textbar maximum}}{default |true|, initially |false|}
If set to \docValue*{true}, the height of the |tcolorbox| is set to the rest of the
available vertical space of the current page.
If set to \docValue{maximum}, the page is compressed as much as possible.
@@ -1712,6 +1735,9 @@ 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}.
+This option can and should not be used for boxes in boxes, but it can be
+used for boxes inside a \refEnv{tcbraster}.
+
\begin{dispListing}
% \usepackage{lipsum}
% \tcbuselibrary{breakable}
@@ -1792,6 +1818,47 @@ colframe=blue!75!black,colback=white,height=3cm}
+\begin{docTcbKey}[][doc new=2015-02-15]{space to}{=\meta{macro}}{no default, initially unset}
+ If the height of a |tcolorbox| is not the natural height, the space
+ difference between the forced and the natural size is saved into the
+ given local \meta{macro}. This \meta{macro} can and should be used inside
+ the box content to add content which is vertically sized to match \meta{macro}.
+ \begin{marker}
+ \begin{itemize}
+ \item The actual length saved into \meta{macro} is adapted dynamically
+ during several compilations -- at least two, but maybe more.
+ \item Due to the adaption algorithm, objects can be sized with
+ \meta{macro} plus any offset length.
+ \item Never ever use \meta{macro} multiplied with a factor. The only
+ exception to this rule is that the space can be split into parts which
+ sum to \meta{macro}.
+ \item Never use this in combination with \refKey{/tcb/fit}.
+ \end{itemize}
+ \end{marker}
+\begin{dispExample}
+\begin{tcolorbox}[colframe=blue!75!black,colback=white,height=3cm,
+ space to=\myspace]
+ This is my box of height 3cm. The space is filled with a picture:\\[2mm]
+ \includegraphics[width=\linewidth,height=\myspace]{goldshade.png}\\[1mm]
+ This is some other text.
+\end{tcolorbox}
+\end{dispExample}
+
+\begin{dispExample}
+\begin{tcolorbox}[colframe=blue!75!black,colback=white,height=3cm,
+ space to=\myspace]
+ \includegraphics[width=\linewidth,
+ height=0.33\dimexpr\myspace]{blueshade.png}\\[1mm]
+ This is my box of height 3cm.\\[2mm]
+ \includegraphics[width=\linewidth,
+ height=0.67\dimexpr\myspace]{goldshade.png}
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+
\begin{docTcbKey}{split}{=\meta{fraction}}{no default}
If the height of a |tcolorbox| is not the natural height, the
\meta{fraction} with a value between 0 and 1 determines the positioning
@@ -1898,11 +1965,13 @@ with a listing.
\end{dispExample}
\end{docTcbKey}
-
-\begin{docTcbKey}[][doc new=2015-11-27]{use height from group}{=\meta{id}}{style, no default}
+\clearpage
+\begin{docTcbKey}[][doc new and updated={2015-11-27}{2016-02-22}]{use height from group}{\colOpt{=\meta{id}}}{style, default current group}
Sets the current box to a fixed \refKey{/tcb/height} which is copied from
an equal height group with the given \meta{id}. If this height is not
- available during the current compilation, no fixed height setting is used.\par
+ available during the current compilation, no fixed height setting is used.
+ If \meta{id} is omitted, the current equal height group is used which has
+ to be set before by \refKey{/tcb/equal height group}.\par
Note that the natural height of the current box is not considered for
computation of the group height. The main application for
\refKey{/tcb/use height from group} is that the height can be adapted
@@ -1914,9 +1983,25 @@ with a listing.
Height from group 'C' of the previous example, but reduced by 2cm.
\end{tcolorbox}%
\end{dispExample}
+
+\begin{dispExample}
+% \tcbuselibrary{raster}
+Every line is inside an equal height group:
+\begin{tcbraster}[raster equal height=rows,
+ title=Box \thetcbrasternum,
+ enhanced,size=small,colframe=red!50!black,colback=red!10!white]
+ \begin{tcolorbox}First line\\second line\\
+ The height of this box rules.\end{tcolorbox}
+ \begin{tcolorbox}[use height from group]Test\end{tcolorbox}
+ \begin{tcolorbox}[use height from group]
+ First line\\second line\end{tcolorbox}
+ \begin{tcolorbox}The height of this box rules.\end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
\end{docTcbKey}
-\enlargethispage*{1cm}
+
+
\begin{docCommand}[doc new=2015-11-27]{tcbheightfromgroup}{\marg{macro}\marg{id}}
Saves the height from an equal height group with the given \meta{id}
to a \meta{macro}. If this height is not available during the current compilation,
@@ -2510,19 +2595,19 @@ This behavior is controlled by the keys |before| and |after|.
\begin{docTcbKey}{parskip}{}{style, no value}
Sets the keys |before| and |after| to values which are
recommended, if the package |parskip| \emph{is} used and there is no better
- idea for |before| and |after|.
+ idea for |before| and |after|. This is similar to:
\begin{dispListing}
\tcbset{parskip/.style={before={\par\pagebreak[0]\parindent=0pt},
after={\par}}}
\end{dispListing}
\end{docTcbKey}
-\begin{docTcbKey}[][doc updated=2015-03-16]{noparskip}{}{style, no value}
+\begin{docTcbKey}[][doc updated=2016-02-14]{noparskip}{}{style, no value}
Sets the keys |before| and |after| to values which are
recommended, if the package |parskip| is \emph{not} used and there is no better
- idea for |before| and |after|.
+ idea for |before| and |after|. This is similar to:
\begin{dispListing}
-\tcbset{noparskip/.style={before={\par\smallskip\pagebreak[0]\parindent=0pt},
+\tcbset{noparskip/.style={before={\par\pagebreak[0]\smallskip\parindent=0pt},
after={\par\smallskip}}}
\end{dispListing}
\end{docTcbKey}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex
index 6545a51ef7d..925cb4f1691 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex
@@ -15,7 +15,7 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk
\subsection{Macros}
-\begin{docCommand}[doc new and updated={2014-11-14}{2014-11-24}]{tcbincludegraphics}{\oarg{options}\marg{file name}}
+\begin{docCommand}[doc new and updated={2014-11-14}{2016-02-19}]{tcbincludegraphics}{\oarg{options}\marg{file name}}
In principle, this macro includes an image file denoted by \meta{file name}
using the standard |\includegraphics| and puts it into a \refEnv{tcolorbox}.
The \meta{options} are |tcolorbox| keys to set up the colored box.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
index 8e54c49b658..009552f1a3b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
@@ -176,6 +176,48 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}.
\clearpage
+\begin{docEnvironment}[doc new=2016-02-19]{tcboxedraster}{\oarg{raster options}\marg{box options}}
+ This is a convenience environment which combines a \refEnv{tcolorbox} with
+ an embedded \refEnv{tcbraster}. The \meta{box options} are given to the
+ outer \refEnv{tcolorbox}, while the \meta{raster options} are given to the
+ embedded \refEnv{tcbraster}.
+ This environment is especially useful for rasters inside rasters.
+
+\begin{dispExample}
+\begin{tcboxedraster}[raster columns=3, raster equal height,
+ size=small,colframe=red!50!black,colback=red!10!white,colbacktitle=red!50!white,
+ title={Box \# \thetcbrasternum}]
+ {colback=yellow!10,fonttitle=\bfseries,title=Boxed Raster}
+ \begin{tcolorbox}First box\end{tcolorbox}
+ \begin{tcolorbox}Second box\end{tcolorbox}
+ \begin{tcolorbox}This is a box\\with a second line\end{tcolorbox}
+ \begin{tcolorbox}Another box\end{tcolorbox}
+ \begin{tcolorbox}A box again\end{tcolorbox}
+\end{tcboxedraster}
+\end{dispExample}
+
+\begin{dispExample}
+% \tcbuselibrary{skins}
+\begin{tcbraster}[raster columns=2, raster equal height,
+ raster every box/.style={size=small,colframe=red!50!black,colback=red!10!white,
+ valign=center,halign=center}]
+ \begin{tcolorbox}One\end{tcolorbox}
+ \begin{tcolorbox}Two\end{tcolorbox}
+ \begin{tcboxedraster}{blankest}
+ \begin{tcolorbox}Three\end{tcolorbox}
+ \begin{tcolorbox}Four\end{tcolorbox}
+ \begin{tcolorbox}Five\end{tcolorbox}
+ \begin{tcolorbox}Six\end{tcolorbox}
+ \end{tcboxedraster}
+ \begin{tcolorbox}Seven\end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+
+\end{docEnvironment}
+
+
+\clearpage
\subsection{Option Keys of the Library}\label{subsec:raster_options}
\begin{docTcbKey}[][doc new=2014-11-10]{raster columns}{=\meta{number}}{no default, initially |2|}
@@ -574,4 +616,255 @@ This style is used for the box with number |n|.
\end{docTcbKey}
+\clearpage
+\subsection{Combining Columns or Rows}\label{subsec:raster_multicolrow}
+
+\begin{docTcbKey}[][doc new=2016-02-19]{raster multicolumn}{=\meta{number}}{no default, initially unset}
+ This option has to be set inside the option list of a \refEnv{tcolorbox}
+ inside a \refEnv{tcbraster} or inside \refCom{tcbitem} inside \refEnv{tcbitemize}.
+ It merges the given \meta{number} of boxes into one single box
+ on the same line. The resulting box gets the \docAuxCommand{thetcbrasternum}
+ of the first box.
+ If there are not enough boxes available on the current line, this option
+ is ignored and a warning is given.
+
+\begin{dispExample}
+\begin{tcbitemize}[raster equal height=rows,raster columns=3,
+ title=\thetcbrasternum,colframe=red!50!black,colback=red!10!white]
+\tcbitem[colframe=blue!50!black,colback=blue!10!white,raster multicolumn=1]
+ multicolumn=1
+\tcbitem
+\tcbitem
+\tcbitem[colframe=blue!50!black,colback=blue!10!white,raster multicolumn=2]
+ multicolumn=2
+\tcbitem
+\tcbitem[colframe=blue!50!black,colback=blue!10!white,raster multicolumn=3]
+ multicolumn=3
+\tcbitem
+\tcbitem[colframe=blue!50!black,colback=blue!10!white,raster multicolumn=2]
+ multicolumn=2
+\end{tcbitemize}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}[][doc new=2016-02-19]{raster multirow}{=\meta{number}}{no default, initially unset}
+ This option has to be set inside the option list of a \refEnv{tcolorbox}
+ inside a \refEnv{tcbraster} or inside \refCom{tcbitem} inside \refEnv{tcbitemize}.
+ This option not really merges boxes, but simply sizes the current box to fit
+ the space of \meta{number} rows.
+
+ \begin{marker}
+ \refKey{/tcb/raster multirow} needs \refKey{/tcb/raster height} to be set.
+ How to achieve a similar result for boxes without fixed \refKey{/tcb/raster height}
+ is shown afterwards.
+ \end{marker}
+
+\begin{dispExample}
+\begin{tcbitemize}[raster rows=3,raster columns=3,raster height=6cm,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+\tcbitem
+\tcbitem
+\tcbitem
+\tcbitem[colframe=blue!50!black,colback=blue!10!white,raster multirow=2]
+ multirow=2
+\tcbitem[raster multicolumn=2,raster multirow=2,blankest]
+ \begin{tcbitemize}[raster rows=2,raster columns=2,raster height=\tcbtextheight]
+ \tcbitem
+ \tcbitem
+ \tcbitem
+ \tcbitem
+ \end{tcbitemize}
+\end{tcbitemize}
+\end{dispExample}
+
+
+\clearpage
+For rasters without fixed \refKey{/tcb/raster height}, \refKey{/tcb/raster multirow}
+cannot be used. Note that \refCom{tcbtextheight} also cannot be used like
+in the previous example.
+
+But, with combination of \refKey{/tcb/raster equal height} and
+\refKey{/tcb/space to}, a similar effect can be created:
+
+\begin{dispExample}
+\begin{tcbitemize}[raster columns=3,raster equal height=rows,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+\tcbitem
+\tcbitem
+\tcbitem
+\tcbitem[colframe=blue!50!black,colback=blue!10!white]
+ \lipsum[2]
+\tcbitem[raster multicolumn=2,blankest,space to=\myspace]
+ \begin{tcbitemize}[raster columns=2]
+ \tcbitem This is a box of the inner raster.
+ \tcbitem
+ \tcbitem[height=\myspace]
+ \tcbitem[height=\myspace]
+ \end{tcbitemize}
+\end{tcbitemize}
+\end{dispExample}
+
+\end{docTcbKey}
+
+
+
+\clearpage
+\subsection{Rasters inside Rasters}\label{subsec:raster_insideraster}
+
+A \emph{raster} inside a \emph{raster} cannot be used directly, because
+a \emph{raster} can only contain a \emph{tcolorbox} or something
+derived from a \emph{tcolorbox}. So, a \emph{raster} can be put inside
+a \emph{tcolorbox} inside a \emph{raster}.
+
+Some examples for such constructions can be found at \refEnv{tcboxedraster},
+\refKey{/tcb/raster multicolumn},
+\refKey{/tcb/raster multirow}.
+
+
+\subsubsection{Raster Setup}
+The intermediating \refEnv{tcolorbox} can be made invisible by using
+\refKey{/tcb/blankest}.
+
+\begin{dispExample}
+\begin{tcbraster}[raster equal height=rows,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+ \begin{tcolorbox}[blankest]
+ \begin{tcbraster}[raster columns=1]
+ \begin{tcolorbox}One\end{tcolorbox}
+ \begin{tcolorbox}Two\end{tcolorbox}
+ \end{tcbraster}
+ \end{tcolorbox}
+ \begin{tcolorbox}raster+tcolorbox+raster\end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+\enlargethispage*{1cm}
+\begin{dispExample}
+\begin{tcbraster}[raster equal height=rows,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+ \begin{tcboxedraster}[raster columns=1]{blankest}
+ \begin{tcolorbox}One\end{tcolorbox}
+ \begin{tcolorbox}Two\end{tcolorbox}
+ \end{tcboxedraster}
+ \begin{tcolorbox}raster+tcboxedraster\end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+
+\begin{dispExample}
+\begin{tcbitemize}[raster equal height=rows,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+ \tcbitem[blankest]
+ \begin{tcbitemize}[raster columns=1]
+ \tcbitem One
+ \tcbitem Two
+ \end{tcbitemize}
+ \tcbitem tcbitemize+tcbitem+tcbitemize
+\end{tcbitemize}
+\end{dispExample}
+
+
+\subsubsection{Placing Spaces}
+If the heights of boxes inside staggered rasters should be matched, the
+space has to be distributed accordingly.
+
+\begin{itemize}
+\item For fixed height boxes/rasters using \refKey{/tcb/raster height},
+ the height of boxes is available by \refCom{tcbtextheight}. This can be
+ used to size deeper layered boxes/rasters.
+\item For boxes/rasters layed out using \refKey{/tcb/raster equal height},
+ space can be distributed by \refKey{/tcb/space to}.
+ It can take several compilations until all spaces are distributed correctly.
+\end{itemize}
+
+
+\begin{dispExample}
+\begin{tcbitemize}[raster rows=2,raster height=6cm,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+ \tcbitem[blankest]
+ \begin{tcbitemize}[raster columns=1,raster rows=2,raster height=\tcbtextheight]
+ \tcbitem One
+ \tcbitem Two
+ \end{tcbitemize}
+ \tcbitem This is a fixed height box.
+ \tcbitem Three
+ \tcbitem Four
+\end{tcbitemize}
+\end{dispExample}
+
+
+\begin{dispExample}
+\begin{tcbitemize}[raster columns=4,raster rows=4,raster height=0.8\linewidth,
+ raster every box/.style={size=small,beamer,
+ colframe=blue!75!yellow,colback=red!75!yellow!20,
+ center title,title=Box}]
+ \tcbitem One
+ \tcbitem Two
+ \tcbitem Three
+ \tcbitem Four
+ \tcbitem[raster multirow=2,blankest]
+ \begin{tcbitemize}[raster columns=1,raster rows=2,raster height=\tcbtextheight]
+ \tcbitem Twelve
+ \tcbitem Eleven
+ \end{tcbitemize}
+ \tcbitem[raster multirow=2,raster multicolumn=2,
+ colframe=red!75!yellow,colback=blue!75!yellow!20]
+ This is an example with fixed height boxes.
+ \tcbitem[raster multirow=2,blankest]
+ \begin{tcbitemize}[raster columns=1,raster rows=2,raster height=\tcbtextheight]
+ \tcbitem Five
+ \tcbitem Six
+ \end{tcbitemize}
+ \tcbitem Ten
+ \tcbitem Nine
+ \tcbitem Eight
+ \tcbitem Seven
+\end{tcbitemize}
+\end{dispExample}
+
+
+\begin{dispExample}
+\begin{tcbitemize}[raster equal height=rows,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+ \tcbitem[blankest,space to=\myspace]
+ \begin{tcbitemize}[raster columns=1]
+ \tcbitem One
+ \tcbitem[add to natural height=\myspace]
+ This box will adapt its height.
+ \end{tcbitemize}
+ \tcbitem This is a flexible height box.
+ \tcbitem \lipsum[4]
+ \tcbitem[blankest,space to=\myspace]
+ \begin{tcbitemize}[raster columns=1]
+ \tcbitem One
+ \tcbitem[add to natural height=\myspace]
+ This box will adapt its height.
+ \end{tcbitemize}
+\end{tcbitemize}
+\end{dispExample}
+
+
+
+\begin{dispExample}
+\begin{tcbitemize}[raster equal height=rows,
+ raster every box/.style={colframe=red!50!black,colback=red!10!white}]
+ \tcbitem[blankest,space to=\myspace]
+ \begin{tcbitemize}[raster columns=1]
+ \tcbitem One
+ \tcbitem[add to natural height=\myspace]
+ This box will adapt its height.
+ \tcbitem \lipsum[4]
+ \end{tcbitemize}
+ \tcbitem[blankest,space to=\myspace]
+ \begin{tcbitemize}[raster columns=1]
+ \tcbitem[blankest]\includegraphics[width=\linewidth]{goldshade.png}
+ \tcbitem[add to natural height=\myspace]
+ This box will adapt its height.
+ \end{tcbitemize}
+\end{tcbitemize}
+\end{dispExample}
+
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
index 5238fe00356..560b9b45b3e 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
@@ -1,5 +1,8 @@
% !TeX root = tcolorbox.tex
% include file (style) of tcolorbox.tex (manual of the LaTeX package tcolorbox)
+\renewcommand*\l@subsection{\@dottedtocline{2}{1.5em}{2.7em}}
+\renewcommand*\l@subsubsection{\@dottedtocline{3}{4.2em}{3.2em}}
+
\RequirePackage[T1]{fontenc}
\RequirePackage[latin1]{inputenc}
\RequirePackage[english]{babel}
@@ -36,21 +39,16 @@
\RequirePackage{amsmath}
\RequirePackage{lipsum}
\RequirePackage{empheq}
-
-%\RequirePackage[cache]{minted}% minted 2.0
+\RequirePackage[extendedchars,encoding,filenameencoding=utf-8]{grffile}
\providecommand{\tcbpkgprefix}{}
\RequirePackage{\tcbpkgprefix tcolorbox}
\tcbuselibrary{most,documentation}
-\makeatletter
\tcbifexternal{}{%
\tcbuselibrary{minted}%
\tcbset{listing engine=listings,initialize@reset={listing engine=listings}}%
}
-\makeatother
-
-\RequirePackage[extendedchars,encoding,filenameencoding=utf-8]{grffile}
\tcbset{skin=enhanced,
doc head={colback=yellow!10!white,interior style=fill},
@@ -79,9 +77,9 @@
\newrobustcmd{\tcbIndexPrintSkinC}[1]{\tcb@Index@Print@C{#1}{\kvtcb@col@key}}
\def\tcb@index@Skin#1{\iftcb@doc@toindex\index{#1\idx@actual\tcbIndexPrintSkinCA{#1}}\index{Skins\idx@level#1\idx@actual\tcbIndexPrintSkinC{#1}}\fi}%
-\newenvironment{docSkin}[1]{\begin{tcb@manual@entry}%
- \begin{tcb@doc@head}{colback=magenta!5!white,interior style=fill}%
- \hypertarget{skin:#1}{\tcb@Print@Key{/tcb/skin=}\tcb@Print@Val{#1}\tcb@index@Skin{#1}\protected@edef\@currentlabel{#1}\label{skin:#1}\hfill(skin)}%
+\newenvironment{docSkin}[2][]{\begin{tcb@manual@entry}%
+ \begin{tcb@doc@head}{colback=magenta!5!white,interior style=fill,#1}%
+ \hypertarget{skin:#2}{\tcb@Print@Key{/tcb/skin=}\tcb@Print@Val{#2}\tcb@index@Skin{#2}\protected@edef\@currentlabel{#2}\label{skin:#2}\hfill(skin)}%
\end{tcb@doc@head}}%
{\end{tcb@manual@entry}}
\def\refSkin{\tcb@ref@doc{skin}}
@@ -126,7 +124,7 @@
tcblower,tcbox,tcboxfit,tcbset,tcbuselibrary,tcolorbox,tcbverbatimwrite,tcbsetforeverylayer,tcbsubtitle,
tcolorboxenvironment,tcblistof,tcbstartrecording,tcbrecord,tcbstoprecording,tcbinputrecords,
tcbpatcharcangular,tcbpatcharcround,tcbifoddpage,thetcolorboxnumber,thetcolorboxpage,
- tcbheightfromgroup,
+ tcbheightfromgroup,tcbheightspace,tcbtextwidth,tcbtextheight,
% listings
endtcblisting,newtcblisting,newtcbinputlisting,
tcblisting,tcbinputlisting,tcbuselistingtext,tcbuselistinglisting,tcbusetemplisting,
@@ -172,11 +170,7 @@
classoffset=0% restore default
}
-
\definecolor{Green_Dark}{rgb}{0.078431,0.407843,0.176471}
-\definecolor{Blue_Dark}{rgb}{0.078431,0.188235,0.615686}
-
-
\definecolor{Blue_Dark}{rgb}{0.090196,0.211765,0.364706}
\definecolor{Blue_Bright}{rgb}{0.858824,0.898039,0.945098}
@@ -210,7 +204,6 @@
\newtcbexternalizetcolorbox{exdispExample*}{dispExample*}{environment with percent=false,minipage}{beforeafter example}
-
\newcommand{\inputpreamblelisting}[1]{%
\tcbinputlisting{title=Definition in the preamble:,
base example,coltitle=black,fonttitle=\itshape,titlerule=0pt,
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 dbac5e0cbe9..a7277ee892e 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -422,12 +422,13 @@ This is the lower part.
\clearpage
\subsection{Boxed Title Option Keys}\label{subsec:skinboxedtitle}
+\subsubsection{Boxed Title Placement}
The following options place the title text into an own \refCom{tcbox}.
This boxed title can be customized independently from the main box using
\refKey{/tcb/boxed title style}.
The placement can be influenced by \meta{boxtitle options}.
-\begin{docTcbKey}{attach boxed title to top left}{\colOpt{=\meta{boxtitle options}}}{style, default empty}
+\begin{docTcbKey}{attach boxed title to top left}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
The title is boxed with a \refCom{tcbox} and attached to
the top left corner of the main box.
\begin{exdispExample*}{attach_boxed_title_to_top_left}{sbs,lefthand ratio=0.66}
@@ -438,7 +439,7 @@ the top left corner of the main box.
\end{exdispExample*}
\end{docTcbKey}
-\begin{docTcbKey}{attach boxed title to top center}{\colOpt{=\meta{boxtitle options}}}{style, default empty}
+\begin{docTcbKey}{attach boxed title to top center}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
The title is boxed with a \refCom{tcbox} and attached to
the top of the main box.
\begin{exdispExample*}{attach_boxed_title_to_top_center}{sbs,lefthand ratio=0.66}
@@ -449,7 +450,7 @@ the top of the main box.
\end{exdispExample*}
\end{docTcbKey}
-\begin{docTcbKey}{attach boxed title to top right}{\colOpt{=\meta{boxtitle options}}}{style, default empty}
+\begin{docTcbKey}{attach boxed title to top right}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
The title is boxed with a \refCom{tcbox} and attached to
the top right corner of the main box.
\begin{exdispExample*}{attach_boxed_title_to_top_right}{sbs,lefthand ratio=0.66}
@@ -460,7 +461,7 @@ the top right corner of the main box.
\end{exdispExample*}
\end{docTcbKey}
-\begin{docTcbKey}{attach boxed title to bottom left}{\colOpt{=\meta{boxtitle options}}}{style, default empty}
+\begin{docTcbKey}{attach boxed title to bottom left}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
The title is boxed with a \refCom{tcbox} and attached to
the bottom left corner of the main box.
\begin{exdispExample*}{attach_boxed_title_to_bottom_left}{sbs,lefthand ratio=0.66}
@@ -471,7 +472,7 @@ the bottom left corner of the main box.
\end{exdispExample*}
\end{docTcbKey}
-\begin{docTcbKey}{attach boxed title to bottom center}{\colOpt{=\meta{boxtitle options}}}{style, default empty}
+\begin{docTcbKey}{attach boxed title to bottom center}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
The title is boxed with a \refCom{tcbox} and attached to
the bottom of the main box.
\begin{exdispExample*}{attach_boxed_title_to_bottom_center}{sbs,lefthand ratio=0.66}
@@ -482,7 +483,7 @@ the bottom of the main box.
\end{exdispExample*}
\end{docTcbKey}
-\begin{docTcbKey}{attach boxed title to bottom right}{\colOpt{=\meta{boxtitle options}}}{style, default empty}
+\begin{docTcbKey}{attach boxed title to bottom right}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
The title is boxed with a \refCom{tcbox} and attached to
the bottom right corner of the main box.
\begin{exdispExample*}{attach_boxed_title_to_bottom_right}{sbs,lefthand ratio=0.66}
@@ -493,8 +494,78 @@ the bottom right corner of the main box.
\end{exdispExample*}
\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}[][doc new=2016-02-26]{attach boxed title to top}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
+ This is a convenient style to mimic a standard title.
+ It uses \refKey{/tcb/attach boxed title to top center},
+ \refKey{/tcb/minipage boxed title}, and sizes the boxed title to match
+ the base box.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tcolorbox}[enhanced,title=My title,
+ attach boxed title to top,
+ boxed title style={colframe=red}]
+ This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2016-02-26]{attach boxed title to top*}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
+ In contrast to \refKey{/tcb/attach boxed title to top}, this style
+ uses smaller left and right rules to avoid previewer glitches.
+ Typically, one would not use different colors for the frame as in the
+ example below.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tcolorbox}[enhanced,title=My title,
+ attach boxed title to top*,
+ boxed title style={colframe=red}]
+ This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2016-02-26]{attach boxed title to bottom}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
+ This is a convenient style to produce a standard-like title at the bottom
+ of the box.
+ It uses \refKey{/tcb/attach boxed title to bottom center},
+ \refKey{/tcb/minipage boxed title}, and sizes the boxed title to match
+ the base box.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tcolorbox}[enhanced,title=My title,
+ attach boxed title to bottom,
+ boxed title style={colframe=red}]
+ This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2016-02-26]{attach boxed title to bottom*}{\colOpt{=\marg{boxtitle options}}}{style, default empty}
+ In contrast to \refKey{/tcb/attach boxed title to top}, this style
+ uses smaller left and right rules to avoid previewer glitches.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tcolorbox}[enhanced,title=My title,
+ attach boxed title to bottom*]
+ This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2016-02-26]{flip title}{\colOpt{=\marg{options}}}{style, default empty}
+ This style combines \refKey{/tcb/attach boxed title to bottom*}
+ with \refKey{/tcb/boxed title style}. The \meta{options} are given to
+ \refKey{/tcb/boxed title style}.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tcolorbox}[tile,flip title={sharp corners},
+ title=My title,colback=red!10,
+ colbacktitle=red!75!black]
+ This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
\clearpage
+\subsubsection{Options for the Boxed Title Placement}
The \meta{boxtitle options} of the keys described above are shift values.
The dimensions of the boxed title are stored into two macros
\docAuxCommand{tcboxedtitleheight} and
@@ -568,6 +639,7 @@ are \emph{not} automatically computed.
\clearpage
+\subsubsection{Options for the Boxed Title Box}
\begin{marker}
The boxed title options are implemented as an underlay, see \Vref{subsec:skinunderlay}.
Therefore, a boxed title is not drawn, if a skin does not support underlays
@@ -591,14 +663,47 @@ are \emph{not} automatically computed.
-\begin{docTcbKey}{boxed title style}{=\meta{options}}{style, initially empty}
+\begin{docTcbKey}[][doc new=2016-02-26]{boxed title size}{=\meta{size}}{no default, initially |title|}
+ This setting defines the basic size for the title box. Further settings
+ can be applied using \refKey{/tcb/boxed title style}.
+ Feasible values for \meta{size} are:
+ \begin{itemize}
+ \item\docValue{title}: Sets the size according to \refKey{/tcb/size}|=|\docValue{title}.
+ \item\docValue{standard}: No size setting. Typically, this is identical to
+ \refKey{/tcb/size}|=|\docValue{normal}.
+ \item\docValue{copy}: The size values for a title of the base box are copied
+ for the title box.
+ \end{itemize}
+
+\begin{dispExample}
+% \tcbuselibrary{raster}
+\begin{tcbraster}[raster columns=3,enhanced,boxrule=0.4pt,
+ title=My title,attach boxed title to top center]
+ \begin{tcolorbox}[boxed title size=title]
+ This is a \textbf{tcolorbox}.
+ \end{tcolorbox}
+ \begin{tcolorbox}[boxed title size=standard]
+ This is a \textbf{tcolorbox}.
+ \end{tcolorbox}
+ \begin{tcolorbox}[boxed title size=copy]
+ This is a \textbf{tcolorbox}.
+ \end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}[][doc updated=2016-02-26]{boxed title style}{=\meta{options}}{style, initially empty}
By default, a boxed title is dimensioned with \refKey{/tcb/size}|=|\docValue*{title}
-and inherits \refKey{/tcb/colframe} of the main box.
+and inherits the \refKey{/tcb/skin} and \refKey{/tcb/colframe} of the main box.
Also, the \refKey{/tcb/colback} is inherited from the main \refKey{/tcb/colbacktitle}.
Font and color of the title text are set as usual.
-All other \meta{options} are set by the |boxed title style| key.
+All other \meta{options} are set by the \refKey{/tcb/boxed title style} key.
Since a boxed title is set by \refCom{tcbox}, all |tcolorbox| options are
-applicable here.
+applicable here. If \refKey{/tcb/boxed title style} is used several times,
+the \meta{options} are is appended.
\begin{exdispExample*}{boxed_title_style_1}{sbs,lefthand ratio=0.66}
\begin{tcolorbox}[enhanced,title=My title,
@@ -619,8 +724,7 @@ applicable here.
fonttitle=\bfseries,coltitle=red!50!black,
attach boxed title to top left=
{xshift=3.2mm,yshift=-0.50mm},
- boxed title style={enhanced,
- skin=enhancedfirst jigsaw,
+ boxed title style={skin=enhancedfirst jigsaw,
size=small,arc=1mm,bottom=-1mm,
interior style={fill=none,
top color=red!30!white,
@@ -634,7 +738,7 @@ applicable here.
colframe=blue!50!black,colback=blue!10!white,colbacktitle=blue!5!yellow!10!white,
fonttitle=\bfseries,coltitle=black,attach boxed title to top center=
{yshift=-0.25mm-\tcboxedtitleheight/2,yshifttext=2mm-\tcboxedtitleheight/2},
- boxed title style={enhanced,boxrule=0.5mm,
+ boxed title style={boxrule=0.5mm,
frame code={ \path[tcb fill frame] ([xshift=-4mm]frame.west)
-- (frame.north west) -- (frame.north east) -- ([xshift=4mm]frame.east)
-- (frame.south east) -- (frame.south west) -- cycle; },
@@ -679,7 +783,7 @@ applicable here.
fonttitle=\bfseries,varwidth boxed title=0.7\linewidth,
colbacktitle=green!45!white,coltitle=green!10!black,colframe=green!50!black,
interior style={top color=yellow!10!white,bottom color=green!10!white},
- boxed title style={enhanced,boxrule=0.75mm,colframe=white,
+ boxed title style={boxrule=0.75mm,colframe=white,
borderline={0.1mm}{0mm}{green!50!black},
borderline={0.1mm}{0.75mm}{green!50!black},
interior style={top color=green!10!white,bottom color=green!10!white,
@@ -695,12 +799,8 @@ applicable here.
\begin{exdispExample}{boxed_title_style_6}
\newtcolorbox{flipbox}[2][]{
- enhanced,sharp corners=south,
- attach boxed title to bottom center={yshift=0.5mm},
- minipage boxed title*,
- boxed title style={enhanced,size=normal,top=0pt,bottom=0pt,
- interior hidden,sharp corners=north},
- title={#2},#1}
+ enhanced,colframe=blue!50!black,colback=yellow!5,fonttitle=\bfseries,
+ flip title={interior hidden},title={#2},#1}
\begin{flipbox}{My title}
\lipsum[2]
@@ -734,6 +834,46 @@ applicable here.
\lipsum[2]
\end{mybox}
\end{exdispExample}
+
+
+\begin{exdispExample}{boxed_title_style_8}
+% \usepackage{varwidth}
+\newtcolorbox{mybox}[2][]{enhanced,
+ before skip=2mm,after skip=2mm,
+ colback=black!5,colframe=black!50,boxrule=0.2mm,
+ attach boxed title to top left={xshift=1cm,yshift*=1mm-\tcboxedtitleheight},
+ varwidth boxed title*=-3cm,
+ boxed title style={frame code={
+ \path[fill=tcbcol@back!30!black]
+ ([yshift=-1mm,xshift=-1mm]frame.north west)
+ arc[start angle=0,end angle=180,radius=1mm]
+ ([yshift=-1mm,xshift=1mm]frame.north east)
+ arc[start angle=180,end angle=0,radius=1mm];
+ \path[left color=tcbcol@back!60!black,right color=tcbcol@back!60!black,
+ middle color=tcbcol@back!80!black]
+ ([xshift=-2mm]frame.north west) -- ([xshift=2mm]frame.north east)
+ [rounded corners=1mm]-- ([xshift=1mm,yshift=-1mm]frame.north east)
+ -- (frame.south east) -- (frame.south west)
+ -- ([xshift=-1mm,yshift=-1mm]frame.north west)
+ [sharp corners]-- cycle;
+ },interior engine=empty,
+ },
+ fonttitle=\bfseries,
+ title={#2},#1}
+
+\begin{mybox}[colbacktitle=green]{My title}
+\lipsum[2]
+\end{mybox}
+\begin{mybox}[colbacktitle=red]{My title}
+\lipsum[3]
+\end{mybox}
+\end{exdispExample}
+\end{docTcbKey}
+
+
+
+\begin{docTcbKey}[][doc new=2016-02-26]{no boxed title style}{}{style, initially set}
+ Removes all options which were set by \refKey{/tcb/boxed title style}.
\end{docTcbKey}
@@ -3521,6 +3661,189 @@ Nevertheless, this skin can be applied independently.
\clearpage
+\subsection{Skin Family 'tile'}
+\begin{docSkin}[doc new=2016-02-25]{tile}
+ This skin is a variant of skin \refSkin{bicolor}. Especially, the
+ optional lower part of the box is colored by \refKey{/tcb/colbacklower}.
+ The main difference to \refSkin{bicolor} is that \refSkin{tile} has no
+ frame.
+\begin{tcolorbox}[skintable=tile]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |empty|\\
+ \refKey{/tcb/interior titled engine}: \> \emph{special}\\
+ \refKey{/tcb/interior engine}: \> \emph{special}\\
+ \refKey{/tcb/segmentation engine}: \> \emph{special}\\
+ \refKey{/tcb/title engine}: \> |path|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{docTcbKey}[][doc new=2016-02-25]{tile}{}{style, no value}
+ This is an abbreviation for setting |skin=tile|.
+ \begin{marker}It also changes the geometry and some style options.\end{marker}
+\end{docTcbKey}
+
+
+\begin{dispExample}
+\begin{tcbraster}[tile,raster equal height,raster columns=4,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm]
+ \begin{tcolorbox}
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}[doc new=2016-02-25]{tilefirst}
+This is a flavor of \refSkin{tile} which is used as a \emph{first} part
+in a break sequence for \refSkin{tile}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=tilefirst]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |empty|\\
+ \refKey{/tcb/interior titled engine}: \> \emph{special}\\
+ \refKey{/tcb/interior engine}: \> \emph{special}\\
+ \refKey{/tcb/segmentation engine}: \> \emph{special}\\
+ \refKey{/tcb/title engine}: \> |pathfirst|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{dispExample}
+\begin{tcbraster}[skin=tilefirst,raster equal height,raster columns=4,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm,boxrule=0pt]
+ \begin{tcolorbox}
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}[doc new=2016-02-25]{tilemiddle}
+This is a flavor of \refSkin{tile} which is used as a \emph{middle} part
+in a break sequence for \refSkin{tile}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=tilemiddle]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |empty|\\
+ \refKey{/tcb/interior titled engine}: \> \emph{special}\\
+ \refKey{/tcb/interior engine}: \> \emph{special}\\
+ \refKey{/tcb/segmentation engine}: \> \emph{special}\\
+ \refKey{/tcb/title engine}: \> |pathmiddle|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\begin{tcbraster}[skin=tilemiddle,raster equal height,raster columns=4,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm,boxrule=0pt]
+ \begin{tcolorbox}
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}[doc new=2016-02-25]{tilelast}
+This is a flavor of \refSkin{tile} which is used as a \emph{last} part
+in a break sequence for \refSkin{tile}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=tilelast]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |empty|\\
+ \refKey{/tcb/interior titled engine}: \> \emph{special}\\
+ \refKey{/tcb/interior engine}: \> \emph{special}\\
+ \refKey{/tcb/segmentation engine}: \> \emph{special}\\
+ \refKey{/tcb/title engine}: \> |pathlast|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\begin{tcbraster}[skin=tilelast,raster equal height,raster columns=4,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm,boxrule=0pt]
+ \begin{tcolorbox}
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \end{tcolorbox}
+ \begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+ \end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+
+
+
+\clearpage
\subsection{Skin Family 'beamer'}
\begin{docSkin}{beamer}
@@ -4009,6 +4332,32 @@ A & B & C\\\hline
\clearpage
+\begin{docTcbKey}{blankest}{}{style, initially unset}
+ This style extends \refKey{/tcb/blanker}.
+ All engines are set to empty and all margins are set to |0pt|.
+ In contrast to \refKey{/tcb/blanker}, also title, shadow, underlay,
+ overlay, finish and borderline are removed.
+
+\begin{dispExample}
+% \tcbuselibrary{raster}
+\begin{tcbraster}[raster columns=3,raster equal height,
+ title=Box \thetcbrasternum,
+ enhanced,size=small,colframe=red!50!black,colback=red!10!white,
+ coltitle=yellow!85!black,
+ drop fuzzy shadow,watermark text={Box \thetcbrasternum},
+ borderline={.25mm}{-0.5mm}{green!40!black},
+ finish={\begin{tcbclipframe}\draw[blue,opacity=0.1,line width=1cm]
+ (frame.south west) -- (frame.north east);\end{tcbclipframe}},
+ ]
+ \begin{tcolorbox}\lipsum[4]\end{tcolorbox}
+ \begin{tcolorbox}[blanker]\lipsum[4]\end{tcolorbox}
+ \begin{tcolorbox}[blankest]\lipsum[4]\end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
\begin{docSkin}{emptyfirst}
This is a flavor of \refSkin{empty} which is used as a \emph{first} part
in a break sequence for \refSkin{empty}.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex
index b846a87231e..783306b6d79 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex
@@ -649,3 +649,82 @@ Lower part
\end{dispExample}
\egroup
+
+\clearpage
+\subsection{Useful Properties}\label{subsec:tech_properties}
+
+The following macros describe certain \textit{properties} which may be
+used for the drawing scheme, see \Fullref{subsec:tcolorboxdrawing}.
+Sometimes, they are even available inside the box content. All of them are
+considered to be \textit{read-only} and should never be redefined by the user.
+
+\begin{docCommand}[doc new=2016-02-16]{tcbheightspace}{}
+ If the height of a |tcolorbox| is not the natural height, the space
+ difference between the forced and the natural size is hold by
+ \refCom{tcbheightspace}.
+ This macro is not usable inside the box content, but for skins or
+ inside \refKey{/tcb/underlay}, \refKey{/tcb/overlay}, etc.
+
+ If such a space information is needed inside the box content, see
+ \refKey{/tcb/space to} instead.
+\begin{dispExample}
+% \tcbuselibrary{skins}
+\newtcolorbox{testbox}[2][]{enhanced,size=fbox,
+ colframe=blue!75!black,colback=white,height=#2,
+ underlay={\node[above,inner sep=3pt] at (interior.south){%
+ \includegraphics[width=\tcbtextwidth,height=\tcbheightspace-3pt]{goldshade.png}};
+ },
+ #1}
+\begin{testbox}{3cm}
+ This is my box. The space is filled with a picture.
+\end{testbox}
+\begin{testbox}{2cm}
+ This is my box. The space is filled with a picture.
+\end{testbox}
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}[doc new=2016-02-16]{tcbtextwidth}{}
+ This property describes the box content width.
+ \begin{itemize}
+ \item If there also is a lower part, it describes the width of the upper part.
+ \item For \refKey{/tcb/sidebyside} boxes, it describes the combined text
+ width plus segmentation.
+ \item This property can be used inside the box content text with exception
+ of \refKey{/tcb/fit} boxes.
+ \item \refCom{tcbtextwidth} can be used for all box types for skins or
+ inside \refKey{/tcb/underlay}, \refKey{/tcb/overlay}, etc.
+ \end{itemize}
+\begin{dispExample}
+\begin{tcolorbox}[colframe=blue!75!black]
+ Inside a box: \tcbtextwidth\ (=\the\linewidth).
+\end{tcolorbox}
+\end{dispExample}
+\end{docCommand}
+
+\pagebreak
+\begin{docCommand}[doc new=2016-02-16]{tcbtextheight}{}
+ This property describes the designated box content height. If the
+ box is larger than the natural height, the actual content will be smaller
+ than \refCom{tcbtextheight}.
+ \begin{itemize}
+ \item For boxes with a fixed \refKey{/tcb/height}, this property can
+ be used inside the box content text. For other boxes, it denotes |0pt|
+ inside the box content.
+ \item \refCom{tcbtextheight} can be used for all box types for skins or
+ inside \refKey{/tcb/underlay}, \refKey{/tcb/overlay}, etc.
+ \end{itemize}
+
+\begin{dispExample}
+% \tcbuselibrary{skins}
+\begin{tcolorbox}[enhanced,colframe=blue!75!black,
+ underlay={\node[left,red] at (frame.east) {Here: \tcbtextheight};}]
+ Inside a box with natural height: \tcbtextheight.
+\end{tcolorbox}
+\begin{tcolorbox}[enhanced,colframe=blue!75!black,height=1cm,
+ underlay={\node[left,red] at (frame.east) {Here: \tcbtextheight};}]
+ Inside a box with fixed height: \tcbtextheight.
+\end{tcolorbox}
+\end{dispExample}
+\end{docCommand}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index cc4559e9c78..b0c98874c31 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
index 44e1db33256..74d604ca65d 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
@@ -1,9 +1,9 @@
% \LaTeX-Main\
-%% The LaTeX package tcolorbox - version 3.80 (2015/11/27)
+%% The LaTeX package tcolorbox - version 3.90 (2016/02/29)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2006-2015 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
@@ -35,8 +35,8 @@
\setlength{\bibitemsep}{\smallskipamount}
\addbibresource{tcolorbox.doc.bib}
-\def\version{3.80}%
-\def\datum{2015/11/27}%
+\def\version{3.90}%
+\def\datum{2016/02/29}%
\makeindex
\hypersetup{
@@ -49,7 +49,7 @@
\usepackage{pgfplots}
%\tcbset{draftmode}
-%\includeonly{tcolorbox.doc.sidebyside}
+%\includeonly{tcolorbox.doc.skins}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}