summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-09 16:31:58 +0000
committerKarl Berry <karl@freefriends.org>2013-04-09 16:31:58 +0000
commitd6730e96b1acc94ef3a26f9079e57099be823dff (patch)
tree2bc872d6369d464c590c9a071de5274beca219c7 /Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
parent92897266fb13289d7ef1da636a65bd9c444864f3 (diff)
tcolorbox (9apr13)
git-svn-id: svn://tug.org/texlive/trunk@29788 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex1718
1 files changed, 1718 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
new file mode 100644
index 00000000000..6b331cc9413
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -0,0 +1,1718 @@
+% !TeX root = tcolorbox.tex
+% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox)
+\clearpage
+\section{Library 'skins'}\label{sec:skins}
+The library is loaded by a package option or inside the preamble by:
+\begin{dispListing}
+\tcbuselibrary{skins}
+\end{dispListing}
+This also loads the package |tikz| \cite{tantau:2010c}. Typically but not necessarily,
+the following skins use |tikz| instead of |pgf|.
+
+\subsection{Technical Overview and Core Package Option Keys}\label{sec:skincorekeys}
+From a technical point of view, a \emph{skin} is a style definition for the
+appearance of a |tcolorbox|. The core package provides some additional
+option keys for skins but only a single skin called \refSkin{standard}.
+The 'skins' library adds several more skins. To change a skin, only one
+option from the core package has to be set.
+
+\begin{docTcbKey}{skin}{=\meta{name}}{style, no default, initially \texttt{standard}}
+ Sets the current skin to \meta{name}. This is a style definition which sets all the following
+ keys, i.\,e.\ for many use cases there is nothing more to do.
+\begin{dispExample}
+\tcbset{colback=Salmon!50!white,colframe=FireBrick!75!black,
+ width=(\linewidth-8mm)/2,before=,after=\hfill,equal height group=ske}
+
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}
+\begin{tcolorbox}[skin=beamer,beamer,adjusted title=My title]
+ This is my content.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{marker}
+ On first read, you may skip the rest of this subsection and proceed to
+ Subsection \ref{subsec:addstyleoptions} on page \pageref{subsec:addstyleoptions}.
+ All following keys in this subsection are automatically set by the selected skin
+ and you may never have to temper with them.
+ Nevertheless, they can be used after a skin was selected to modify
+ this skin.
+\end{marker}
+
+
+\begin{docTcbKey}{skin first}{=\meta{name}}{style, no default, initially \texttt{standard}}
+ If the box is set to be \refKey{/tcb/breakable} and \emph{is} broken actually,
+ then the skin for the \emph{first} part of the break sequence
+ is set to \meta{name}, see Subsection \ref{subsec:breaksequence} on page \pageref{subsec:breaksequence}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{skin middle}{=\meta{name}}{style, no default, initially \texttt{standard}}
+ If the box is set to be \refKey{/tcb/breakable} and \emph{is} broken actually,
+ then the skin for the \emph{middle} parts (if any) of the break sequence
+ is set to \meta{name}, see Subsection \ref{subsec:breaksequence} on page \pageref{subsec:breaksequence}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{skin last}{=\meta{name}}{style, no default, initially \texttt{standard}}
+ If the box is set to be \refKey{/tcb/breakable} and \emph{is} broken actually,
+ then the skin for the \emph{last} part of the break sequence
+ is set to \meta{name}, see Subsection \ref{subsec:breaksequence} on page \pageref{subsec:breaksequence}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+\end{docTcbKey}
+
+
+
+
+\begin{docTcbKey}{graphical environment}{=\meta{name}}{no default, initially \texttt{pgfpicture}}
+ Sets the graphical environment for the |tcolorbox| to \meta{name}.
+ Feasible values are |pgfpicture| and |tikzpicture| or environments which
+ inherit from one of these two. This key is set by a \refKey{/tcb/skin} and
+ may seldom be used directly.
+\end{docTcbKey}
+
+The skin of a |tcolorbox| is drawn by up to four \emph{engines}.
+Afterwards, the text content is drawn which is not part of a skin.
+The four steps are:
+\begin{enumerate}
+\item The \emph{frame} of the box.
+\item The \emph{interior} of the box. The interior of a box with title is
+ drawn differently from a box without title.
+\item The \emph{segmentation} (line) of the box, if there is a lower part.
+\item The \emph{title area} of the box, if there is a title.
+\end{enumerate}
+
+Every engine for the up to four steps can be set to one of the following types:
+\begin{enumerate}
+\item |standard|: the original code from the core package.
+\item |path|: a |tikz| path which can be controlled by options.
+\item |pathfirst|: a |tikz| path which can be controlled by options.
+\item |pathmiddle|: a |tikz| path which can be controlled by options.
+\item |pathlast|: a |tikz| path which can be controlled by options.
+\item |freelance|: arbitrary user code.
+\end{enumerate}
+%\clearpage
+
+\begin{docTcbKey}{frame engine}{=\meta{name}}{no default, initially \texttt{standard}}
+ Sets the \emph{frame} drawing engine for a box to \meta{name}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+ Feasible values for \meta{name} are:
+ \begin{itemize}
+ \item |standard|: the original code from the core package,
+ \item |path|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathfirst|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathmiddle|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathlast|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |freelance|: arbitrary user code which is given by \refKey{/tcb/frame code}.
+ \end{itemize}
+\end{docTcbKey}
+
+\begin{docTcbKey}{interior titled engine}{=\meta{name}}{no default, initially \texttt{standard}}
+ Sets the \emph{interior} drawing engine for a titled box to \meta{name}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+ Feasible values for \meta{name} are:
+ \begin{itemize}
+ \item |standard|: the original code from the core package,
+ \item |path|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |pathfirst|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |pathmiddle|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |pathlast|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |freelance|: arbitrary user code which is given by \refKey{/tcb/interior titled code}.
+ \end{itemize}
+\end{docTcbKey}
+
+\begin{docTcbKey}{interior engine}{=\meta{name}}{no default, initially \texttt{standard}}
+ Sets the \emph{interior} drawing engine for an untitled box to \meta{name}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+ Feasible values for \meta{name} are:
+ \begin{itemize}
+ \item |standard|: the original code from the core package,
+ \item |path|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |pathfirst|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |pathmiddle|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |pathlast|: a |tikz| path which is controlled by \refKey{/tcb/interior style},
+ \item |freelance|: arbitrary user code which is given by \refKey{/tcb/interior code}.
+ \end{itemize}
+\end{docTcbKey}
+
+\begin{docTcbKey}{segmentation engine}{=\meta{name}}{no default, initially \texttt{standard}}
+ Sets the \emph{segmentation} (line) drawing engine for a box to \meta{name}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+ Feasible values for \meta{name} are:
+ \begin{itemize}
+ \item |standard|: the original code from the core package,
+ \item |path|: a |tikz| path which is controlled by \refKey{/tcb/segmentation style},
+ \item |freelance|: arbitrary user code which is given by \refKey{/tcb/segmentation code}.
+ \end{itemize}
+\end{docTcbKey}
+
+\begin{docTcbKey}{title engine}{=\meta{name}}{no default, initially \texttt{standard}}
+ Sets the \emph{title area} drawing engine for a titled box to \meta{name}.
+ Typically, this key is set by a \refKey{/tcb/skin}.
+ Feasible values for \meta{name} are:
+ \begin{itemize}
+ \item |standard|: the original code from the core package,
+ \item |path|: a |tikz| path which is controlled by \refKey{/tcb/title style},
+ \item |pathfirst|: a |tikz| path which is controlled by \refKey{/tcb/title style},
+ \item |pathmiddle|: a |tikz| path which is controlled by \refKey{/tcb/title style},
+ \item |pathlast|: a |tikz| path which is controlled by \refKey{/tcb/title style},
+ \item |freelance|: arbitrary user code which is given by \refKey{/tcb/title code}.
+ \end{itemize}
+\end{docTcbKey}
+
+\begin{docTcbKey}{geometry nodes}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+ If set to |true|, up to four |tikz| nodes are defined for a |tcolorbox|
+ which are named |frame|, |interior|, |segmentation|, and |title|. These nodes
+ describe the boundaries of the equally named parts of a |tcolorbox|.
+ They are used by all engines of type |path| and they may be used by engines
+ of type |freelance|. Typically, this key is set by a \refKey{/tcb/skin}.
+\begin{dispExample}
+\tcbset{colback=Salmon!50!white,colframe=FireBrick!75!black,
+ width=(\linewidth-8mm)/2,before=,after=\hfill,equal height group=geon}
+
+\begin{tcolorbox}[adjusted title=The title]
+ The upper part.\tcblower The lower part.
+\end{tcolorbox}
+\begin{tcolorbox}[adjusted title=The title,skin=freelance,
+ frame code={\path[draw=red,fill=red!25]
+ (frame.south west) rectangle (frame.north east);},
+ interior titled code={\path[draw=blue,fill=blue!25]
+ (interior.south west) rectangle (interior.north east);},
+ segmentation code={\path[draw=green,fill=green!25]
+ (segmentation.south west) rectangle (segmentation.north east);},
+ title code={\path[draw=black,fill=brown!75!black]
+ (title.south west) rectangle (title.north east);}]
+ The upper part.\tcblower The lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\subsection{Style Option Keys}\label{subsec:addstyleoptions}
+The following style options are applicable for all skins which
+use engines of type |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
+Especially, the skin \refSkin{enhanced} supports \emph{all} of them
+and \refSkin{standard} \emph{none}.
+
+\begin{docTcbKey}{frame style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default}
+ The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command
+ for drawing the \emph{frame} of the box.\\
+ This option is available if the \refKey{/tcb/frame engine} is set to
+ |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
+ It is \emph{not} available for |standard| and it \emph{may} be
+ applicable for |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ frame style={left color=red!75!black,right color=blue!75!black}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{interior style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default}
+ The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command
+ for drawing the \emph{interior} of the box. They are used for the titled
+ and for the untitled version as well.\\
+ This option is available if the \refKey{/tcb/interior titled engine}
+ or \refKey{/tcb/interior engine} is set to
+ |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
+ It is \emph{not} available for |standard| and it \emph{may} be
+ applicable for |freelance|.
+\begin{dispExample}
+\tcbset{colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ interior style={left color=red!20!white,right color=yellow!50!white}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}{segmentation style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default}
+ The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command
+ for drawing the \emph{segmentation} line of the box.\\
+ This option is available if the \refKey{/tcb/segmentation engine}
+ is set to |path|.
+ It is \emph{not} available for |standard| and it \emph{may} be
+ applicable for |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ segmentation style={double=white,draw=blue,double distance=1pt,solid}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{title style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default}
+ The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command
+ for drawing the \emph{title area} of the box.\\
+ This option is available if the \refKey{/tcb/title engine} is set to
+ |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
+ It is \emph{not} available for |standard| and it \emph{may} be
+ applicable for |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,coltitle=blue!50!black,
+ fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ title style={left color=blue!15!yellow,right color=red!85!black}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{colbacktitle}{=\meta{color}}{style, no default, initially unset}
+ Abbreviation for setting \refKey{/tcb/title style} to |fill=|\meta{color}.
+ This fills the background of the title area with the given \meta{color}.\\
+ This option is available if the \refKey{/tcb/title engine} is set to
+ |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
+ It is \emph{not} available for |standard| and it \emph{may} be
+ applicable for |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,coltitle=blue!50!black,
+ fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,colbacktitle=yellow!50!white]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+\clearpage
+\subsection{Code Option Keys}\label{subsec:addcodeoptions}
+The following code options are applicable for all skins which
+use engines of type |freelance|.
+Especially, the skin \refSkin{freelance} supports \emph{all} of them,
+\refSkin{standard} and \refSkin{enhanced} \emph{none} of them.
+
+
+\begin{docTcbKey}{frame code}{\colOpt{=\meta{graphical code}}}{code, default from |standard|}
+ The given \meta{graphical code} is used for drawing the \emph{frame} of the box.\\
+ This option is available only if the \refKey{/tcb/frame engine} is set to |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black}
+
+\begin{tcolorbox}[freelance,frame code={
+ \foreach \n in {north east,north west,south east,south west}
+ {\path [fill=red!75!black] (interior.\n) circle (3mm); }; }]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{docTcbKey}{interior titled code}{\colOpt{=\meta{graphical code}}}{code, default from |standard|}
+ The given \meta{graphical code} is used
+ for drawing the \emph{interior} of the box, if the box comes with a title.\\
+ This option is available only if the \refKey{/tcb/interior titled engine} is set to |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[freelance,title=My title,interior titled code={
+ \path[draw=red!5!white,line width=5mm,line cap=round]
+ ([xshift=3mm,yshift=-3mm]interior.north west)
+ --([xshift=-3mm,yshift=3mm]interior.south east)
+ ([xshift=3mm,yshift=3mm]interior.south west)
+ --([xshift=-3mm,yshift=-3mm]interior.north east);}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{interior code}{\colOpt{=\meta{graphical code}}}{code, default from |standard|}
+ The given \meta{graphical code} is used
+ for drawing the \emph{interior} of the box, if the box is without a title.\\
+ This option is available only if the \refKey{/tcb/interior engine} is set to |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black}
+
+\begin{tcolorbox}[freelance,interior code={
+ \path[draw=red!5!white,line width=5mm,line cap=round]
+ ([xshift=3mm,yshift=-3mm]interior.north west)
+ --([xshift=-3mm,yshift=3mm]interior.south east)
+ ([xshift=3mm,yshift=3mm]interior.south west)
+ --([xshift=-3mm,yshift=-3mm]interior.north east);}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{docTcbKey}{segmentation code}{\colOpt{=\meta{graphical code}}}{code, default from |standard|}
+ The given \meta{graphical code} is used for drawing the
+ \emph{segmentation} area of the box.\\
+ This option is available only if the \refKey{/tcb/segmentation engine} is set to |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[freelance,title=My title,segmentation code={
+ \path[top color=red!5!white,bottom color=red!5!white,middle color=blue]
+ (segmentation.south west) rectangle (segmentation.north east);}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{title code}{\colOpt{=\meta{graphical code}}}{code, default from |standard|}
+ The given \meta{graphical code} is used for drawing the
+ \emph{title} area of the box.\\
+ This option is available only if the \refKey{/tcb/title engine} is set to |freelance|.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ coltitle=black}
+
+\begin{tcolorbox}[freelance,title=My title,title code={
+ \path[draw=yellow,solid,decorate,line width=2mm,
+ decoration={coil,aspect=0,segment length=10.1mm}]
+ ([xshift=1mm]title.west) -- ([xshift=-1mm]title.east);}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\subsection{Watermark Option Keys}\label{subsec:watermarks}
+The following watermark options are applicable for all skins which
+use |tikzpicture| as \refKey{/tcb/graphical environment}.
+Therefore, the skin \refSkin{standard} does not support these watermarks,
+but all other skins, e.\,g.\ \refSkin{enhanced}.
+
+\begin{marker}
+The watermark options rely on the more general overlay options described in
+Section \ref{subsec:overlays} from page \pageref{subsec:overlays}.
+Therefore, \emph{watermarks} and \emph{overlays} cannot be used mixed.
+But a mixture is possible with the 'hooks' library, see Section \ref{sec:hooks}.
+\end{marker}
+
+
+\begin{docTcbKey}{watermark text}{=\meta{text}}{no default, initially unset}
+ Writes some \meta{text} in the center of the interior region of a |tcolorbox|.
+ This \meta{text} is written \emph{after} the
+ frame and interior are drawn and \emph{before} the text content is drawn.
+ It is zoomed or stretched according the values of
+ \refKey{/tcb/watermark zoom} or \refKey{/tcb/watermark stretch}.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,watermark text=My Watermark]
+\lipsum[1]
+\tcblower
+\lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\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|
+ as described for \refKey{/tcb/watermark text}.
+ But this is done only for boxes named \meta{part} of a break sequence, see
+ \refKey{/tcb/breakable}.\\
+ Feasible values for \meta{part} are:
+ \begin{itemize}
+ \item |broken|: all broken box parts,
+ \item |unbroken|: unbroken boxes only,
+ \item |first|: first parts of a break sequence,
+ \item |middle|: middle parts of a break sequence,
+ \item |last|: last parts of a break sequence,
+ \item |unbroken and first|: unbroken boxes and first parts of a break sequence,
+ \item |middle and last|: middle and last parts of a break sequence.
+ \end{itemize}
+\end{docTcbKey}
+
+
+\clearpage
+
+
+\begin{docTcbKey}{watermark graphics}{=\meta{file name}}{no default, initially unset}
+ Draws an external picture referenced by \meta{file name}
+ in the center of the interior region of a |tcolorbox|.
+ The picture is drawn \emph{after} the
+ frame and interior are drawn and \emph{before} the text content is drawn.
+ It is zoomed or stretched according the values of
+ \refKey{/tcb/watermark zoom} or \refKey{/tcb/watermark stretch}.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,watermark graphics=Basilica_5.png,
+ watermark opacity=0.15]
+\lipsum[1-2]
+\tcblower
+This example uses a public domain picture from\\
+\url{http://commons.wikimedia.org/wiki/File:Basilica_5.png}
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{watermark graphics on}{=\meta{part} is \meta{file name}}{no default, initially unset}
+ This option draws a picture referenced by \meta{file name} in the center of the interior region of a |tcolorbox|
+ as described for \refKey{/tcb/watermark graphics}.
+ But this is done only for boxes named \meta{part} of a break sequence, see
+ \refKey{/tcb/breakable}.\\
+ Feasible values for \meta{part} are:
+ \begin{itemize}
+ \item |broken|: all broken box parts,
+ \item |unbroken|: unbroken boxes only,
+ \item |first|: first parts of a break sequence,
+ \item |middle|: middle parts of a break sequence,
+ \item |last|: last parts of a break sequence,
+ \item |unbroken and first|: unbroken boxes and first parts of a break sequence,
+ \item |middle and last|: middle and last parts of a break sequence.
+ \end{itemize}
+\end{docTcbKey}
+
+
+
+\clearpage
+\begin{docTcbKey}{watermark tikz}{=\meta{graphical code}}{no default, initially unset}
+ Draws the given |tikz| \meta{graphical code}
+ in the center of the interior region of a |tcolorbox|.
+ The code is executed \emph{after} the
+ frame and interior are drawn and \emph{before} the text content is drawn.
+ The result is zoomed or stretched according the values of
+ \refKey{/tcb/watermark zoom} or \refKey{/tcb/watermark stretch}.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ watermark tikz={\draw[line width=2mm] (interior) circle (1cm)
+ node{\fontfamily{ptm}\fontseries{b}\fontsize{20mm}{20mm}\selectfont ?};}]
+\lipsum[1]
+\tcblower
+\lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+\begin{docTcbKey}{watermark tikz on}{=\meta{part} is \meta{graphical code}}{no default, initially unset}
+ This option draws the given |tikz| \meta{graphical code} in the center of the interior region of a |tcolorbox|
+ as described for \refKey{/tcb/watermark tikz}.
+ But this is done only for boxes named \meta{part} of a break sequence, see
+ \refKey{/tcb/breakable}.\\
+ Feasible values for \meta{part} are:
+ \begin{itemize}
+ \item |broken|: all broken box parts,
+ \item |unbroken|: unbroken boxes only,
+ \item |first|: first parts of a break sequence,
+ \item |middle|: middle parts of a break sequence,
+ \item |last|: last parts of a break sequence,
+ \item |unbroken and first|: unbroken boxes and first parts of a break sequence,
+ \item |middle and last|: middle and last parts of a break sequence.
+ \end{itemize}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{no watermark}{}{style, no default, initially set}
+ Removes the watermark if set before. This is an alias for
+ \refKey{/tcb/no overlay}.
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{watermark opacity}{=\meta{fraction}}{no default, initially |1.00|}
+ Sets the opacity value $\in[0,1]$ for a watermark.
+\begin{dispExample}
+\tcbset{enhanced,colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ watermark text=Watermark,nobeforeafter,width=(\linewidth-2mm)/2}
+
+\begin{tcolorbox}[title=Opacity 1.00,watermark opacity=1.00]
+\lipsum[2]
+\end{tcolorbox}\hfill%
+\begin{tcolorbox}[title=Opacity 0.50,watermark opacity=0.50]
+\lipsum[2]
+\end{tcolorbox}%
+\end{dispExample}
+\end{docTcbKey}
+
+\enlargethispage{5mm}
+\begin{docTcbKey}{watermark zoom}{=\meta{fraction}}{no default, initially |0.75|}
+ Sets the zoom value for a watermark. The zoom respects the aspect ratio.
+ The value $1.0$ means to fill the whole box.
+\begin{dispExample}
+\tcbset{enhanced,colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ watermark text=Watermark,nobeforeafter,width=(\linewidth-2mm)/2}
+
+\begin{tcolorbox}[title=Zoom 1.00,watermark zoom=1.00]
+\lipsum[2]
+\end{tcolorbox}\hfill%
+\begin{tcolorbox}[title=Zoom 0.50,watermark zoom=0.50]
+\lipsum[2]
+\end{tcolorbox}%
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
+
+\begin{docTcbKey}{watermark stretch}{=\meta{fraction}}{no default, initially unset}
+ Sets the stretch value for a watermark. The stretch value is applied to width
+ and height in relation to the box dimensions. It does not respect the aspect ratio.
+ The value $1.0$ means to fill the whole box.
+\begin{dispExample}
+\tcbset{enhanced,colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ watermark graphics=Basilica_5.png,watermark opacity=0.15,
+ nobeforeafter,width=(\linewidth-2mm)/2}
+
+\begin{tcolorbox}[title=Stretch 1.00,watermark stretch=1.00]
+\lipsum[2]
+\end{tcolorbox}\hfill%
+\begin{tcolorbox}[title=Stretch 0.50,watermark stretch=0.50]
+\lipsum[2]
+\end{tcolorbox}%
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{docTcbKey}{watermark color}{=\meta{color}}{no default, initially mixed background and frame color}
+ Sets the color for the watermark.
+\begin{dispExample}
+\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,watermark text=My Watermark,
+ watermark color=yellow!50!red]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+\clearpage
+\tcbset{skintable/.style={colframe=red!50!yellow!50!black,
+ colback=red!50!yellow!5!white,coltitle=red!50!yellow!3!white,
+ fonttitle=\bfseries,before=\par\smallskip,
+ title=Environment and engines for the skin '\texttt{#1}'}}
+
+\subsection{Skin 'standard'}\label{subsec:skinstandard}
+\begin{marker}Note that the option keys \refKey{/tcb/frame style},
+ \refKey{/tcb/interior style},
+ \refKey{/tcb/segmentation style}, and
+ \refKey{/tcb/title style} are not be applicable to the standard skin.
+ Also, watermarks (see Subsection \ref{subsec:watermarks})
+ are not usable with the standard skin.
+\end{marker}
+
+\begin{docSkin}{standard}
+ This is the standard skin from the core package. All drawing engines
+ are set to type |standard|. The drawing is based on |pgf| commands and
+ does not need the |tikz| package.
+\begin{tcolorbox}[skintable=standard]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |pgfpicture|\\
+ \refKey{/tcb/frame engine}: \> |standard|\\
+ \refKey{/tcb/interior titled engine}: \> |standard|\\
+ \refKey{/tcb/interior engine}: \> |standard|\\
+ \refKey{/tcb/segmentation engine}: \> |standard|\\
+ \refKey{/tcb/title engine}: \> |standard|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{docTcbKey}{standard}{}{style, no value}
+ This is an abbreviation for setting |skin=standard|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{standard,equal height group=standard,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\subsection{Skin family 'enhanced'}
+\begin{marker}
+If you like the standard appearance of a |tcolorbox| but you want to
+have some 'enhanced' features, the |enhanced| skin is what you are looking for.
+\end{marker}
+
+\begin{docSkin}{enhanced}
+ This skin translates the drawing commands of the core package into |tikz|
+ path commands. Therefore, it allows all |tikz| high level options for
+ these paths and has more flexibility compared to the \refSkin{standard} skin.
+ You pay for this with some prolonged compilation time.
+ The |tikz| path options can
+ be given with the option keys
+ \refKey{/tcb/frame style},
+ \refKey{/tcb/interior style},
+ \refKey{/tcb/segmentation style}, and
+ \refKey{/tcb/title style}.
+\begin{tcolorbox}[skintable=enhanced]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |path|\\
+ \refKey{/tcb/interior titled engine}: \> |path|\\
+ \refKey{/tcb/interior engine}: \> |path|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |path|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{docTcbKey}{enhanced}{}{style, no value}
+ This is an abbreviation for setting |skin=enhanced|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{enhanced,equal height group=enhanced,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+\begin{dispExample}
+% \usetikzlibrary{shadings} % preamble
+\tcbset{skin=enhanced,fonttitle=\bfseries,
+ frame style={upper left=blue,upper right=red,lower left=yellow,lower right=green},
+ interior style={white,opacity=0.5},
+ segmentation style={black,solid,opacity=0.2,line width=1pt}}
+
+\begin{tcolorbox}[title=Nice box in rainbow colors]
+ With the 'enhanced' skin, it is quite easy to produce fancy looking effects.
+ \tcblower
+ Note that this is still a \texttt{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample}
+% \usetikzlibrary{shadows} % preamble
+% \usetikzlibrary{decorations.pathmorphing} % preamble
+\tcbset{skin=enhanced,fonttitle=\bfseries,boxrule=1mm,
+ frame style={draw=FireBrick,fill=Salmon,drop shadow},
+ interior style={draw=FireBrick,top color=Salmon!10,bottom color=Salmon!20},
+ segmentation style={draw=FireBrick,solid,decorate,
+ decoration={coil,aspect=0,segment length=10.1mm}}}
+
+\begin{tcblisting}{title=A listing box with shadow and some specials}
+Of course, skins can be used for listings also.
+\begin{equation}
+ \int\limits_1^2 \frac{1}{x}~dx = \ln(2).
+\end{equation}
+\end{tcblisting}
+\end{dispExample}
+
+\clearpage
+
+
+\begin{docCommand}{tcbline}{}
+ Sometimes, a line is only a line. With \refCom{tcblower} you separate
+ the box content into two functional units. |\tcbline| draws only a line
+ which looks like the segmentation line between upper and lower part.
+ Furthermore, you can use |\tcbline| more than just once.
+ |\tcbline| always uses the |path| drawing engine. Therefore,
+ the \refKey{/tcb/segmentation style} can be applied.
+
+\begin{dispExample}
+\tcbset{enhanced,colframe=blue!50!black,colback=white}
+
+\begin{tcolorbox}[colupper=red!50!black,collower=green!50!black]
+\lipsum[1]
+\tcbline
+\lipsum[2]
+\tcblower
+\lipsum[3]
+\tcbline
+\lipsum[4]
+\end{tcolorbox}
+\end{dispExample}
+\end{docCommand}
+
+
+\clearpage
+\begin{docSkin}{enhancedfirst}
+This is a flavor of \refSkin{enhanced} which is used as a \emph{first} part
+in a break sequence for \refSkin{enhanced}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=enhancedfirst]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior titled engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior engine}: \> |pathfirst|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |pathfirst|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{skin=enhancedfirst,equal height group=enhancedfirst,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+\clearpage
+\begin{docSkin}{enhancedmiddle}
+This is a flavor of \refSkin{enhanced} which is used as a \emph{middle} part
+in a break sequence for \refSkin{enhanced}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=enhancedmiddle]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior titled engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior engine}: \> |pathmiddle|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |pathmiddle|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{skin=enhancedmiddle,equal height group=enhancedmiddle,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{docTcbKey}{marker}{}{style, no value}
+ This styles relies on the skin \refSkin{enhancedmiddle}. It is
+ intended to be used as an optical marker like a highlighter pen.
+\begin{dispExample}
+\begin{marker}
+\lipsum[2]
+\end{marker}
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+
+\clearpage
+\begin{docSkin}{enhancedlast}
+This is a flavor of \refSkin{enhanced} which is used as a \emph{last} part
+in a break sequence for \refSkin{enhanced}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=enhancedlast]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/interior titled engine}: \> |pathlast|\\
+ \refKey{/tcb/interior engine}: \> |pathlast|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |pathlast|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{dispExample}
+\tcbset{skin=enhancedlast,equal height group=enhancedlast,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+
+\clearpage
+\subsection{Skin 'freelance'}
+\begin{docSkin}{freelance}
+ This skin gives full freedom for the appearance of the |tcolorbox|.
+ All drawing engines are set to type |freelance|; they use the |tikz| package
+ and compute the \refKey{/tcb/geometry nodes}.
+ This skin is useful for boxes which should differ much from the normal
+ appearance. Note that this difference has to be programmed by the user.
+ The drawing code can be given
+ with the following option keys. As default value, the code from the |standard|
+ skin is set.
+\begin{tcolorbox}[skintable=freelance]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |freelance|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |freelance|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{docTcbKey}{freelance}{}{style, no value}
+ This is an abbreviation for setting |skin=freelance|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{freelance,equal height group=freelance,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+\clearpage
+\begin{dispExample}
+ \tcbset{skin=freelance,boxrule=2mm,enlarge top by=2mm,enlarge bottom by=2mm,
+ enlarge left by=3mm,enlarge right by=3mm,width=\linewidth-6mm,
+ frame code={\path[top color=FireBrick,bottom color=FireBrick,middle color=FireBrick!50,
+ draw=FireBrick!75!black,double=Gold,rounded corners=1mm]
+ (frame.south west) -- ([xshift=-3mm]frame.west) -- (frame.north west)
+ -- ([yshift=2mm]frame.north) -- (frame.north east) -- ([xshift=3mm]frame.east)
+ -- (frame.south east) -- ([yshift=-2mm]frame.south) -- cycle;},
+ interior titled code={\path[outer color=Gold,inner color=white,draw=Gold,
+ double=FireBrick!75!black,rounded corners=5mm]
+ (interior.south west) rectangle (interior.north east);},
+ segmentation code={\path[draw=FireBrick,opacity=0.25] ([xshift=2cm]segmentation.west)
+ -- (segmentation.north) -- ([xshift=-2cm]segmentation.east)
+ -- (segmentation.south) -- cycle;}}
+
+\begin{tcolorbox}[title=My title]
+ This is the upper part.
+ \tcblower
+ This is the lower part.
+\end{tcolorbox}
+\end{dispExample}
+
+\clearpage
+\subsection{Skin family 'bicolor'}
+\begin{docSkin}{bicolor}
+ This skin is quite similar to the \refSkin{standard} and \refSkin{enhanced} skin.
+ But instead of a segmentation line, the optional lower part of the box is filled with a
+ different color or drawn with a different style.
+\begin{tcolorbox}[skintable=bicolor]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |path|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |path|
+ \end{tabbing}
+\end{tcolorbox}
+ \begin{itemize}
+ \item The most basic usage of this skin is to set the background color of
+ the lower part by \refKey{/tcb/colbacklower} and all other options like for
+ the \refSkin{standard} skin.
+\begin{dispExample}
+\begin{tcolorbox}[skin=bicolor,title=The title,
+ colframe=FireBrick!75!black,colback=Salmon!50!white,colbacklower=Salmon]
+ The upper part.
+ \tcblower
+ The lower part.
+\end{tcolorbox}
+\end{dispExample}
+ \item The more advanced usage of this skin is to apply the \refKey{/tcb/frame style}
+ and the \refKey{/tcb/interior style} like for
+ the \refSkin{enhanced} skin. Also, the \refKey{/tcb/segmentation style} can be
+ used, but it is applied to the whole lower part.
+\begin{dispExample}
+\begin{tcolorbox}[skin=bicolor,title=The title,
+ frame style={top color=FireBrick,
+ bottom color=FireBrick!15!white,draw=black},
+ interior style={left color=Salmon,right color=Salmon!50!white},
+ segmentation style={right color=Salmon,left color=Salmon!50!white}]
+ The upper part.
+ \tcblower
+ The lower part.
+\end{tcolorbox}
+\end{dispExample}
+ \end{itemize}
+\end{docSkin}
+
+\begin{docTcbKey}{bicolor}{}{style, no value}
+ This is an abbreviation for setting |skin=bicolor|.
+\end{docTcbKey}
+
+
+\begin{dispExample}
+\tcbset{bicolor,equal height group=bicolor,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+\begin{docTcbKey}{colbacklower}{=\meta{color}}{no default, initially \texttt{black!15!white}}
+ Sets the background \meta{color} of the lower part. It depends on the skin,
+ if this value is used.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{gitexample/.style={listing and comment,comment={#1},
+ skin=bicolor,boxrule=1mm,fonttitle=\bfseries,coltitle=black,
+ frame style={draw=black,left color=Gold,right color=Goldenrod!50!Gold},
+ colback=black,colbacklower=Goldenrod!75!Gold,
+ colupper=white,collower=black,
+ listing options={language={bash},aboveskip=0pt,belowskip=0pt,nolol,
+ basicstyle=\ttfamily\bfseries,extendedchars=true}}}
+
+\begin{tcblisting}{title={Snapshot of the staging area},
+ gitexample={The option '-a' automatically stages all tracked and modified
+ files before the commit.\par
+ This can be combined with the message option '-m'
+ as seen in the third line.}}
+git commit
+git commit -a
+git commit -am 'changes to my example'
+\end{tcblisting}
+\end{dispExample}
+
+
+\clearpage
+
+
+\begin{docSkin}{bicolorfirst}
+This is a flavor of \refSkin{bicolor} which is used as a \emph{first} part
+in a break sequence for \refSkin{bicolor}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=bicolorfirst]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |pathfirst|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{dispExample}
+\tcbset{skin=bicolorfirst,equal height group=bicolorfirst,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{bicolormiddle}
+This is a flavor of \refSkin{bicolor} which is used as a \emph{middle} part
+in a break sequence for \refSkin{bicolor}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=bicolormiddle]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |pathmiddle|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{skin=bicolormiddle,equal height group=bicolormiddle,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{bicolorlast}
+This is a flavor of \refSkin{bicolor} which is used as a \emph{last} part
+in a break sequence for \refSkin{bicolor}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=bicolorlast]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |pathlast|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{skin=bicolorlast,equal height group=bicolorlast,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+\clearpage
+\subsection{Skin family 'beamer'}
+
+\begin{docSkin}{beamer}
+ This skin resembles boxes known from the |beamer| class and therefore is
+ called 'beamer'. It uses the normal colors from the core package but shades
+ them a little bit. To use this skin, the |tikz| libraries |shadings|
+ and |shadows| have to be included in the preamble by:
+\begin{dispListing}
+\usetikzlibrary{shadings,shadows}
+\end{dispListing}
+The appearance of the skin can be controlled by \refKey{/tcb/frame style}
+and \refKey{/tcb/interior style}, if needed. Here, the \emph{segmentation}
+cannot be controlled by a style.
+\begin{tcolorbox}[skintable=beamer]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |path|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |path|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+
+\begin{docTcbKey}{beamer}{}{style, no value}
+ This is an abbreviation for setting |skin=beamer|.
+ \begin{marker}It also changes the geometry and some style options.\end{marker}
+\end{docTcbKey}
+
+
+
+\begin{dispExample}
+\tcbset{beamer,equal height group=beamer,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+\begin{dispExample}
+\begin{tcolorbox}[beamer,colback=Salmon!50!white,colframe=FireBrick!75!black,
+ adjusted title=A colored box with the 'beamer' skin]
+This box looks like a box provided by the \texttt{beamer} class.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+
+\begin{docSkin}{beamerfirst}
+This is a flavor of \refSkin{beamer} which is used as a \emph{first} part
+in a break sequence for \refSkin{beamer}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=beamerfirst]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |pathfirst|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{beamer,skin=beamerfirst,equal height group=beamerfirst,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+
+\begin{docSkin}{beamermiddle}
+This is a flavor of \refSkin{beamer} which is used as a \emph{middle} part
+in a break sequence for \refSkin{beamer}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=beamermiddle]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |pathmiddle|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{beamer,skin=beamermiddle,equal height group=beamermiddle,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{beamerlast}
+This is a flavor of \refSkin{beamer} which is used as a \emph{last} part
+in a break sequence for \refSkin{beamer}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=beamerlast]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |pathlast|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{dispExample}
+\tcbset{beamer,skin=beamerlast,equal height group=beamerlast,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+\clearpage
+\subsection{Skin family 'widget'}
+\begin{docSkin}{widget}
+ This skin uses the normal colors from the core package but shades
+ them a little bit. To use this skin, the |tikz| library |shadings|
+ has to be included in the preamble by:
+\begin{dispListing}
+\usetikzlibrary{shadings}
+\end{dispListing}
+The appearance of the skin can be controlled by \refKey{/tcb/frame style},
+\refKey{/tcb/interior style}, and \refKey{/tcb/segmentation style},
+if needed.
+\begin{tcolorbox}[skintable=widget]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |path|\\
+ \refKey{/tcb/interior titled engine}: \> |path|\\
+ \refKey{/tcb/interior engine}: \> |path|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |freelance|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{docTcbKey}{widget}{}{style, no value}
+ This is an abbreviation for setting |skin=widget|.
+ \begin{marker}It also changes the geometry and some style options.\end{marker}
+\end{docTcbKey}
+
+
+\begin{dispExample}
+\tcbset{widget,equal height group=widget,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample}
+\begin{tcolorbox}[widget,colback=Salmon!50!white,colframe=FireBrick!75!black,
+ adjusted title=A colored box with the 'widget' skin]
+This is my content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+
+\begin{docSkin}{widgetfirst}
+This is a flavor of \refSkin{widget} which is used as a \emph{first} part
+in a break sequence for \refSkin{widget}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=widgetfirst]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior titled engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior engine}: \> |pathfirst|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |freelance|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{widget,skin=widgetfirst,equal height group=widgetfirst,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+\clearpage
+
+\begin{docSkin}{widgetmiddle}
+This is a flavor of \refSkin{widget} which is used as a \emph{middle} part
+in a break sequence for \refSkin{widget}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=widgetmiddle]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior titled engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior engine}: \> |pathmiddle|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |freelance|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{dispExample}
+\tcbset{widget,skin=widgetmiddle,equal height group=widgetmiddle,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{widgetlast}
+This is a flavor of \refSkin{widget} which is used as a \emph{last} part
+in a break sequence for \refSkin{widget}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=widgetlast]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/interior titled engine}: \> |pathlast|\\
+ \refKey{/tcb/interior engine}: \> |pathlast|\\
+ \refKey{/tcb/segmentation engine}: \> |freelance|\\
+ \refKey{/tcb/title engine}: \> |freelance|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{widget,skin=widgetlast,equal height group=widgetlast,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+
+\subsection{Skin 'draft'}\label{subsec:draft}
+
+\begin{docSkin}{draft}
+ This skin is intended to be used while drafting new geometric settings
+ for a |tcolorbox|.
+\begin{tcolorbox}[skintable=draft]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |freelance|\\
+ \refKey{/tcb/interior titled engine}: \> |freelance|\\
+ \refKey{/tcb/interior engine}: \> |freelance|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |path|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{docTcbKey}{draft}{}{style, no value}
+ This is an abbreviation for setting |skin=draft|.
+\end{docTcbKey}
+
+
+\begin{dispExample}
+\tcbset{draft,equal height group=draft,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample}
+\vspace*{3mm}
+\begin{tcolorbox}[draft,title=A colored box with the 'draft' skin]
+\lipsum[1-3]
+\tcblower
+\lipsum[4-6]
+\end{tcolorbox}
+\end{dispExample}
+
+