summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-12-18 22:04:25 +0000
committerKarl Berry <karl@freefriends.org>2013-12-18 22:04:25 +0000
commit7edd1b30f6d91c3f4961d8ceca5a9af64668db1b (patch)
tree3c631b8d49caab36f4b589405ec4766a0f46aa5a /Master/texmf-dist/doc
parent00be60da8df9f90d4ad3914ed813951c0639b409 (diff)
tcolorbox (17dec13)
git-svn-id: svn://tug.org/texlive/trunk@32442 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES39
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin280197 -> 280299 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex31
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex15
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex276
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex8
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex24
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex25
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex62
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex747
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex48
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin2956266 -> 3212601 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex33
15 files changed, 1200 insertions, 116 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 4372ef626bc..41f94695da2 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
+++ b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 2.51 (2013/09/16)
+%% The LaTeX package tcolorbox - version 2.60 (2013/12/17)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2013 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -326,6 +326,7 @@ version 2.51 (2013/09/16)
* new options: 'extend freelance', 'extend freelancefirst',
'extend freelancemiddle', 'extend freelancelast',
'drop midday shadow', 'drop fuzzy midday shadow'
+ * new environment 'tcbinvclipframe'
- library 'listings':
* new macros '\renewtcblisting', '\renewtcbinputlisting'
- library 'theorems':
@@ -334,3 +335,39 @@ version 2.51 (2013/09/16)
* new macro '\renewtcboxfit'
- library 'documentation':
* new option 'documentation listing options'
+
+version 2.60 (2013/12/17)
+- new 'jigsaw' variants for the skins 'standard' and 'enhanced' for
+ advanced transparency and similar effects.
+- new package core skin 'standard jigsaw'
+- 'tabularx' and 'tabularx*' reset the arrayrulecolor to black after the table now.
+- option 'colbacktitle' moved from library 'skins' to package core
+- new options:
+ 'title filled', 'opacityupper', 'opacitylower', 'opacitytitle', 'opacityframe',
+ 'opacityback', 'opacitybacktitle', 'opacityfill', 'opacitytext','hyphenationfix',
+ 'standard jigsaw', 'enlarge by', 'grow to left by', 'grow to right by'
+- library 'skins':
+ * new skin: 'enhanced jigsaw', 'enhancedfirst jigsaw', 'enhancedmidle jigsaw',
+ 'enhancedlast jigsaw'
+ * marker style now based on 'enhancedmiddle jigsaw'
+ * new options:
+ 'enhanced jigsaw', 'tikz', 'tikz reset', 'show bounding box',
+ 'at begin tikz', 'at begin tikz reset', 'at end tikz', 'at end tikz reset',
+ 'rotate', 'scale', 'remember', 'remember as',
+ 'drop shadow southeast', 'drop shadow south', 'drop shadow southwest', 'drop shadow west',
+ 'drop shadow northwest', 'drop shadow north', 'drop shadow northeast', 'drop shadow east',
+ 'drop fuzzy shadow southeast', 'drop fuzzy shadow south', 'drop fuzzy shadow southwest',
+ 'drop fuzzy shadow west', 'drop fuzzy shadow northwest', 'drop fuzzy shadow north',
+ 'drop fuzzy shadow northeast','drop fuzzy shadow east',
+- library 'listings':
+ new options 'text above listing' and 'listing above text'
+- library 'theorems':
+ \newtcbtheorem creates an additional starred theorem environment
+- library 'fitting':
+ fit algorithm warning switched off by default.
+ new options:
+ 'fit warning'
+- library 'documentation': more values for 'index format'
+- documentation extended
+- major internal implementation changes and optimizations
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index fae874a221d..301c83b5e51 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/README
+++ b/Master/texmf-dist/doc/latex/tcolorbox/README
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 2.51 (2013/09/16)
+%% The LaTeX package tcolorbox - version 2.60 (2013/12/17)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2013 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -38,6 +38,7 @@ Contents of the package
'tcblistingsutf8.code.tex' LaTeX package file (library of tcolorbox)
'tcbminted.code.tex' LaTeX package file (library of tcolorbox)
'tcbskins.code.tex' LaTeX package file (library of tcolorbox)
+ 'tcbskinsjigsaw.code.tex' LaTeX package file (library of tcolorbox)
'tcbtheorems.code.tex' LaTeX package file (library of tcolorbox)
'tcolorbox.pdf' Documentation for tcolorbox
'tcolorbox.tex' Source code of the documentation (main file)
@@ -63,4 +64,5 @@ Alternatively, put the files to their respective locations within the TeX instal
'tcbminted.code.tex' -> /tex/latex/tcolorbox
'tcbtheorems.code.tex' -> /tex/latex/tcolorbox
'tcbskins.code.tex' -> /tex/latex/tcolorbox
+ 'tcbskinsjigsaw.code.tex' -> /tex/latex/tcolorbox
all other files -> /doc/latex/tcolorbox
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index 1bd05a70ad8..c7939ef7c3f 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 f589bda59a7..5d2693d784e 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 2.51 (2013/09/16)
+%% The LaTeX package tcolorbox - version 2.60 (2013/12/17)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
@@ -134,7 +134,7 @@ We have given Theorem \ref{theorem:summation} on page \pageref{theorem:summation
%----------------------------------------------------------
\section{Breakable Boxes}
-\begin{tcolorbox}[enhanced,breakable,
+\begin{tcolorbox}[enhanced jigsaw,breakable,pad at break=1mm,
colback=blue!5!white,colframe=blue!75!black,title=Breakable box,
watermark color=white,watermark text=\Roman{tcbbreakpart}]
\lipsum[1-12]
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
index 525f7642983..e53fa8671f7 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
@@ -1,5 +1,36 @@
% !TeX root = tcolorbox.tex
% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox)
+\begin{tcboutputlisting}
+\begin{inctext}[a4paper]
+\begin{tikzpicture}%
+\definecolorseries{boxcol}{rgb}{last}{red}{blue}%
+\resetcolorseries[24]{boxcol}%
+\coordinate (A) at (0,0); \coordinate (B) at (21,29.7);
+\path[use as bounding box,top color=Goldenrod!25!white,bottom color=Navy!25!white]
+ (A) rectangle coordinate (C) (B);
+\foreach \w in {-15,-30,...,-360}
+{\node[below right,rotate around={\w:(C)}] at ([xshift=1cm]C) {%
+ \begin{tcolorbox}[width=8cm,title=tcolorbox \version,
+ fontupper=\scriptsize,fonttitle=\small\bfseries,
+ colback=boxcol!25!white,colbacktitle=boxcol!!+!50!black,colframe=boxcol,
+ enhanced jigsaw,opacityback=0.5,opacitybacktitle=0.75]
+ \lipsum[2]
+ \end{tcolorbox}};%
+}
+\node[font=\Huge\bfseries] at ([yshift=12cm]C) {|tcolorbox|};
+\node[font=\large\bfseries] at ([yshift=-12cm]C)
+ {Manual for version \version\ (\datum)};
+\end{tikzpicture}
+\end{inctext}
+\end{tcboutputlisting}
+\tcbuselistingtext
+\tcbinputlisting{title=Cover code,
+ base example,coltitle=black,fonttitle=\itshape,titlerule=0pt,
+ colbacktitle=Navy!15!ExampleBack,top=0mm,before=\par\smallskip,%
+ listing style=mydocumentation,listing only}
+
+\hspace{0pt}
+\clearpage
\begin{center}
\vspace*{5mm}
\begin{tcolorbox}[enhanced,
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 05defec37aa..8e181efeab8 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -273,30 +273,37 @@ the \emph{break sequence} parts are displayed.
\def\tcbbreakskininto#1#2#3#4#5{%
\begin{center}\begin{tikzpicture}
-\tcbset{width=5cm,colframe=Navy,colback=AliceBlue,fonttitle=\bfseries,
+\tcbset{width=7cm,colframe=Navy,colback=AliceBlue,fonttitle=\bfseries,
watermark color=AliceBlue!85!Navy,#5
}
\node[above] (unbroken) at (0,0) {\begin{tcolorbox}[title=Unbroken Box,skin=#1,watermark text=unbroken,height=3.8cm]
\texttt{skin=#1}
\end{tcolorbox}};
-\node[above] (first) at (8,2.4) {\begin{tcolorbox}[title=Broken Boxes,skin=#2,watermark text=first,height=1.4cm]
+\node[above] (first) at (8.7,2.4) {\begin{tcolorbox}[title=Broken Boxes,skin=#2,watermark text=first,height=1.4cm]
\texttt{skin=#2}
\end{tcolorbox}};
-\node[above] (middle) at (8,1.2) {\begin{tcolorbox}[skin=#3,watermark text=middle,height=1cm]
+\node[above] (middle) at (8.7,1.2) {\begin{tcolorbox}[skin=#3,watermark text=middle,height=1cm]
\texttt{skin=#3}
\end{tcolorbox}};
-\node[above] (last) at (8,0) {\begin{tcolorbox}[skin=#4,watermark text=last,height=1cm]
+\node[above] (last) at (8.7,0) {\begin{tcolorbox}[skin=#4,watermark text=last,height=1cm]
\texttt{skin=#4}
\end{tcolorbox}};
\path[draw=FireBrick,line width=2pt,->] (unbroken) edge (first.west) edge (middle.west) edge (last.west);
\end{tikzpicture}\end{center}}
\tcbbreakskininto{standard}{standard}{standard}{standard}{watermark text/.style={}}
+\tcbbreakskininto{standard jigsaw}{standard jigsaw}{standard jigsaw}{standard jigsaw}{watermark text/.style={}}
+\clearpage
\tcbbreakskininto{enhanced}{enhancedfirst}{enhancedmiddle}{enhancedlast}{}
\tcbbreakskininto{enhancedfirst}{enhancedfirst}{enhancedmiddle}{enhancedmiddle}{}
\tcbbreakskininto{enhancedmiddle}{enhancedmiddle}{enhancedmiddle}{enhancedmiddle}{}
\tcbbreakskininto{enhancedlast}{enhancedmiddle}{enhancedmiddle}{enhancedlast}{}
\clearpage
+\tcbbreakskininto{enhanced jigsaw}{enhancedfirst jigsaw}{enhancedmiddle jigsaw}{enhancedlast jigsaw}{}
+\tcbbreakskininto{enhancedfirst jigsaw}{enhancedfirst jigsaw}{enhancedmiddle jigsaw}{enhancedmiddle jigsaw}{}
+\tcbbreakskininto{enhancedmiddle jigsaw}{enhancedmiddle jigsaw}{enhancedmiddle jigsaw}{enhancedmiddle jigsaw}{}
+\tcbbreakskininto{enhancedlast jigsaw}{enhancedmiddle jigsaw}{enhancedmiddle jigsaw}{enhancedlast jigsaw}{}
+\clearpage
\tcbbreakskininto{freelance}{freelancefirst}{freelancemiddle}{freelancelast}{}
\tcbbreakskininto{freelancefirst}{freelancefirst}{freelancemiddle}{freelancemiddle}{}
\tcbbreakskininto{freelancemiddle}{freelancemiddle}{freelancemiddle}{freelancemiddle}{}
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 713ed4bc098..8082974f916 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -194,30 +194,62 @@ Now, the saved part is used:
\clearpage
\subsection{Colors and Fonts}
+\begin{docTcbKey}{colframe}{=\meta{color}}{no default, initially \texttt{black!75!white}}
+ Sets the frame \meta{color} of the box.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[colframe=red!50!white]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
\begin{docTcbKey}{colback}{=\meta{color}}{no default, initially \texttt{black!5!white}}
Sets the background \meta{color} of the box.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
-\begin{tcolorbox}[colback=white]
+\begin{tcolorbox}[colback=red!50!white]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{dispExample*}
\end{docTcbKey}
-\begin{docTcbKey}{colframe}{=\meta{color}}{no default, initially \texttt{black!75!white}}
- Sets the frame \meta{color} of the box.
+\begin{docTcbKey}{title filled}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+ Switches the drawing of the title background according to the \meta{boolean value}.
+ This option is set to |true| automatically by \refKey{/tcb/colbacktitle},
+ \refKey{/tcb/opacitybacktitle}, and \refKey{/tcb/title style},
+ and \refKey{/tcb/title code}.
+
\begin{dispExample*}{sbs,lefthand ratio=0.6}
-\begin{tcolorbox}[colframe=red!50!yellow]
+\begin{tcolorbox}[title=My title,title filled]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\begin{tcolorbox}[title=My title,
+ title filled=false]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{dispExample*}
\end{docTcbKey}
+
+\begin{docTcbKey}{colbacktitle}{=\meta{color}}{no default, initially \texttt{black!50!white}}
+ Sets the background \meta{color} of the title area of the box.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[colbacktitle=red!50!white,
+ title=My title,coltitle=black,
+ fonttitle=\bfseries]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+
+\clearpage
+
\begin{docTcbKey}{colupper}{=\meta{color}}{no default, initially \texttt{black}}
Sets the text \meta{color} of the upper part.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
-\begin{tcolorbox}[colupper=yellow,
- colback=blue!50,colframe=blue]
+\begin{tcolorbox}[colupper=red!75!black]
This is a \textbf{tcolorbox}.
\tcblower
This is the lower part.
@@ -229,8 +261,7 @@ This is the lower part.
\begin{docTcbKey}{collower}{=\meta{color}}{no default, initially \texttt{black}}
Sets the text \meta{color} of the lower part.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
-\begin{tcolorbox}[collower=yellow,
- colback=blue!50,colframe=blue]
+\begin{tcolorbox}[collower=red!75!black]
This is a \textbf{tcolorbox}.
\tcblower
This is the lower part.
@@ -243,8 +274,7 @@ This is the lower part.
Sets the text \meta{color} of the box. This is an abbreviation for setting
|colupper| and |collower| to the same value.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
-\begin{tcolorbox}[coltext=yellow,
- colback=blue!50,colframe=blue]
+\begin{tcolorbox}[coltext=red!75!black]
This is a \textbf{tcolorbox}.
\tcblower
This is the lower part.
@@ -256,14 +286,15 @@ This is the lower part.
\begin{docTcbKey}{coltitle}{=\meta{color}}{no default, initially \texttt{white}}
Sets the title text \meta{color} of the box.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
-\begin{tcolorbox}[coltitle=blue!50!black,
- colframe=blue!25,title=Test]
+\begin{tcolorbox}[coltitle=red!75!black,
+ colbacktitle=black!10!white,title=Test]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{dispExample*}
\end{docTcbKey}
\clearpage
+
\begin{docTcbKey}{fontupper}{=\meta{text}}{no default, initially empty}
Sets \meta{text} before the content of the upper part (e.\,g.\ font settings).
\begin{dispExample}
@@ -691,6 +722,117 @@ with help of an overlay.
\tcbusetemp
\end{docTcbKey}
+
+\clearpage
+\subsection{Transparency}
+
+\begin{marker}
+Transparency effects are likely to be used in conjunction with \emph{jigsaw}
+skin variants, see \Vref{subsec:skinjigsaw}.
+\end{marker}
+
+\begin{docTcbKey}{opacityframe}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the frame opacity of the box to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6,segmentation style={pattern=crosshatch dots light steel blue}}
+\begin{tcolorbox}[opacityframe=0.25]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}{opacityback}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the background opacity of the box to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6,segmentation style={pattern=crosshatch dots light steel blue}}
+\begin{tcolorbox}[standard jigsaw,
+ opacityframe=0.5, opacityback=0.5]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{opacitybacktitle}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the title background opacity of the box to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6,segmentation style={pattern=crosshatch dots light steel blue}}
+\begin{tcolorbox}[standard jigsaw,
+ opacityframe=0.5, opacitybacktitle=0.5,
+ title filled, title=This is a title]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{opacityfill}{=\meta{fraction}}{style, no default, initially \texttt{1.0}}
+ Sets the fill opacity for frame, interior and optionally the title background
+ to to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6,segmentation style={pattern=crosshatch dots light steel blue}}
+\begin{tcolorbox}[standard jigsaw,
+ opacityfill=0.7, title=This is a title]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}{opacityupper}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the text opacity of the upper box part to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[enhanced,opacityupper=0.5,
+ interior style={pattern=crosshatch dots light steel blue}]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{opacitylower}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the text opacity of the lower box part to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[enhanced,opacitylower=0.5,
+ interior style={pattern=crosshatch dots light steel blue}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}{opacitytext}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the text opacity of the upper and the lower box part to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[enhanced,opacitytext=0.5,
+ interior style={pattern=crosshatch dots light steel blue}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{opacitytitle}{=\meta{fraction}}{no default, initially \texttt{1.0}}
+ Sets the text opacity of the box title to the given \meta{fraction}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[enhanced,opacitytitle=0.7,
+ fonttitle=\bfseries,title=This is a title,
+ title style={pattern=crosshatch dots light steel blue}]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{dispExample*}{segmentation style={pattern=crosshatch dots light steel blue}}
+\begin{tcolorbox}[enhanced jigsaw,fonttitle=\bfseries,title=This is a title,
+ opacityframe=0.5,opacityback=0.25,opacitybacktitle=0.25,opacitytext=0.8,
+ colback=red!5!white,colframe=red!75!black,colbacktitle=yellow!20!red]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+
+
+
\clearpage
\subsection{Height Control}
In a typical usage scenario, the height of a |tcolorbox| is computed automatically
@@ -1710,6 +1852,12 @@ around it. If the bounding box is shrunk, i.\,e.\ enlarged with negative
values, the |tcolorbox| will overlap to other parts of the page.
For example, the |tcolorbox| could be stretched into the page margin.
+\begin{marker}
+The following examples use \refKey{/tcb/show bounding box} to display the
+actual bounding box. For this, the library \mylib{skins} has to be included and
+\refKey{/tcb/enhanced} has to be set.
+\end{marker}
+
\begin{docTcbKey}{enlarge top by}{=\meta{length}}{no default, initially |0mm|}
Enlarges the bounding box distance to the top of the box by \meta{length}.
\begin{dispExample}
@@ -1718,7 +1866,7 @@ For example, the |tcolorbox| could be stretched into the page margin.
\begin{tcolorbox}[enlarge top by=-5mm]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
-\begin{tcolorbox}[enlarge top by=5mm]
+\begin{tcolorbox}[enlarge top by=5mm,enhanced,show bounding box]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{dispExample}
@@ -1734,7 +1882,7 @@ This is a \textbf{tcolorbox}.
\begin{tcolorbox}[enlarge bottom by=5mm]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
-\begin{tcolorbox}[enlarge bottom by=-5mm]
+\begin{tcolorbox}[enlarge bottom by=-5mm,enhanced,show bounding box]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{dispExample}
@@ -1748,7 +1896,7 @@ This is a \textbf{tcolorbox}.
\begin{dispExample}
\tcbset{colframe=blue!75!black,colback=white}
-\begin{tcolorbox}[enlarge left by=2cm,width=\linewidth-2cm]
+\begin{tcolorbox}[enlarge left by=2cm,width=5cm,enhanced,show bounding box]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\begin{tcolorbox}[enlarge left by=-2cm,width=\linewidth+2cm]
@@ -1762,7 +1910,8 @@ This is a \textbf{tcolorbox}.
\begin{dispExample}
\tcbset{colframe=blue!75!black,colback=white}
-\begin{tcolorbox}[enlarge right by=-2cm,width=\linewidth+2cm]
+\begin{tcolorbox}[enlarge right by=-2cm,width=\linewidth+2cm,
+ enhanced,show bounding box]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\begin{tcolorbox}[enlarge right by=2cm,width=\linewidth-2cm]
@@ -1771,6 +1920,56 @@ This is a \textbf{tcolorbox}.
\end{dispExample}
\end{docTcbKey}
+\begin{docTcbKey}{enlarge by}{=\meta{length}}{no default, initially |0mm|}
+ Enlarges the bounding box distance to all sides of the box by \meta{length}.
+\begin{dispExample}
+\tcbset{colframe=blue!75!black,colback=white,width=5cm,nobeforeafter}
+
+\begin{tcolorbox}
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\begin{tcolorbox}[enlarge by=5mm,enhanced,show bounding box]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}{grow to left by}{=\meta{length}}{no default, initially |0mm|}
+ Enlarges the current box size by \meta{length} and
+ enlarges (shrinks) the bounding box distance to the left side of the box by
+ $-$\meta{length}.
+\begin{dispExample}
+\tcbset{colframe=blue!75!black,colback=white}
+
+\begin{tcolorbox}[width=5cm,grow to left by=2cm,enhanced,show bounding box]
+This is a \textbf{tcolorbox} with a width of 7cm.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{docTcbKey}{grow to right by}{=\meta{length}}{no default, initially |0mm|}
+ Enlarges the current box size by \meta{length} and
+ enlarges (shrinks) the bounding box distance to the right side of the box by
+ $-$\meta{length}.
+\begin{dispExample}
+\tcbset{colframe=blue!75!black,colback=white}
+
+\begin{tcolorbox}[grow to right by=2cm,enhanced,show bounding box]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+
+\bigskip
+
+\begin{tcolorbox}[grow to right by=2cm,grow to left by=1cm,
+ enhanced,show bounding box]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+
+\end{dispExample}
+\end{docTcbKey}
+
+
\clearpage
\begin{docTcbKey}{toggle enlargement}{=\meta{toggle preset}}{default |evenpage|, initially |none|}
According to the \meta{toggle preset}, the left and the right enlargements of
@@ -1787,9 +1986,9 @@ This is a \textbf{tcolorbox}.
\begin{dispExample}
% \usepackage{changepage} for 'check odd page'
\tcbset{colframe=blue!75!black,colback=white,
-enlarge left by=-20mm,enlarge right by=5mm,width=\linewidth+15mm}
+ grow to left by=20mm,grow to right by=-5mm}
-\begin{tcolorbox}[toggle enlargement=none]
+\begin{tcolorbox}[toggle enlargement=none,enhanced,show bounding box]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\begin{tcolorbox}[toggle enlargement=forced]
@@ -1798,15 +1997,15 @@ This is a \textbf{tcolorbox}.
\begin{tcolorbox}[toggle enlargement=evenpage,check odd page]
This page is an \ifthenelse{\isodd{\thepage}}{odd}{even} page.
Therefore, the left and right enlargements
- \ifthenelse{\isodd{\thepage}}{are not}{are} toggled (with some luck).
+ \ifthenelse{\isodd{\thepage}}{are not}{are} toggled.
\end{tcolorbox}
\end{dispExample}
\begin{dispListing}
-\begin{tcolorbox}[colframe=red!60!black,colback=red!15!white,
+% \usepackage{changepage} for 'check odd page'
+\begin{tcolorbox}[colframe=red!60!black,colback=red!15!white,check odd page,
fonttitle=\bfseries,title=Floating box from \texttt{toggle enlargement},
- width=\textwidth+20mm,enlarge right by=-20mm,
- toggle enlargement=evenpage,float=t]
+ width=\textwidth,grow to right by=2cm,toggle enlargement=evenpage,float=t]
This page is an \ifthenelse{\isodd{\thepage}}{odd}{even} page.
Therefore, the left and right enlargements
\ifthenelse{\isodd{\thepage}}{are not}{are} toggled (with some luck; otherwise
@@ -2142,6 +2341,37 @@ This is a tcolorbox.
\end{dispListing}
{\tcbusetemp}
+
+\clearpage
+\begin{docTcbKey}{hyphenationfix}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+ Long words at the begin of paragraphs in very narrow boxes
+ will not be hyphenated using |pdflatex|. This problem is circumvented by
+ applying the |hyphenationfix| option.
+
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{colframe=blue!75!black,
+ fontupper=\normalsize,
+ colback=blue!5!white,width=4cm}
+
+\begin{tcolorbox}
+Rechnungsadjunktentochter.\par
+Statthaltereikonzipist.
+\end{tcolorbox}
+
+\begin{tcolorbox}[hyphenationfix]
+Rechnungsadjunktentochter.\par
+Statthaltereikonzipist.
+\end{tcolorbox}
+\end{dispExample*}
+
+\smallskip
+\begin{marker}
+|parbox=false| and |hyphenationfix| should not be used together. They are
+targeting different box types and they do not blend very well.
+\end{marker}
+\end{docTcbKey}
+
+
\subsection{Files}
\begin{docTcbKey}{tempfile}{=\meta{file name}}{no default, initially \cs{jobname.tcbtemp}}
Sets \meta{file name} as name for the temporary file which is used inside
@@ -2171,7 +2401,7 @@ Test\dotfill
the base of the environmental line; see example above.
\end{docTcbKey}
-
+\enlargethispage*{10mm}
\subsection{Skins}
There are additional option keys which change the appearance of a |tcolorbox|.
If only the core package is used, there is only one \emph{skin} and these
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
index 4beccce5aac..749cc9ec244 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
@@ -373,13 +373,17 @@ This is my \colOpt{text}.
Determines the basic \meta{format} of the generated index.
Feasible values are:
\begin{itemize}
- \item |pgf|: The index is formatted like in the |pgf| documentation.
- \item |doc|: The index assumed to be formatted by |doc|/|ltxdoc|. A usage of |makeindex|
+ \item |pgfsection|: The index is formatted like in the |pgf| documentation (as a section).
+ \item |pgfchapter|: The index is formatted like in the |pgf| documentation (as a chapter).
+ \item |pgf|: Alias for |pgfsection|.
+ \item |doc|: The index is assumed to be formatted by |doc|/|ltxdoc|. A usage of |makeindex|
with |-s gind.ist| is assumed. The package |hypdoc| has to be loaded
\emph{before} |tcolorbox|.
+ \item |off|: The index is not formatted by |tcolorbox|.
\end{itemize}
\end{docTcbKey}
+\clearpage
\begin{docTcbKey}{index actual}{=\meta{character}}{no default, initially |@|}
Sets the character for 'actual' in automatic indexing.
\end{docTcbKey}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex
index 555c22109c4..4d3a305c7aa 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex
@@ -139,11 +139,9 @@ The \refCom{tcboxfit} macro uses this algorithm by default.
\begin{dispExample}
% \usepackage{lipsum}
% \tcbuselibrary{skins}
-\newtcolorbox{fitting}[2][]{fit,height=#2,boxsep=1pt,valign=center,
- top=0.4\tcbfitdim,bottom=0.4\tcbfitdim,
- left=0.75\tcbfitdim,right=0.75\tcbfitdim,
- enhanced,watermark text={\tcbfitsteps},
- colframe=blue!75!black,colback=white,#1}
+\newtcolorbox{fitting}[2][]{fit,height=#2,boxsep=1pt,valign=center,opacityupper=0.5,
+ top=0.4\tcbfitdim,bottom=0.4\tcbfitdim,left=0.75\tcbfitdim,right=0.75\tcbfitdim,
+ enhanced,watermark text={\tcbfitsteps},colframe=blue!75!black,colback=white,#1}
\begin{fitting}{4cm}
\lipsum[1]
@@ -160,6 +158,7 @@ The \refCom{tcboxfit} macro uses this algorithm by default.
\end{docTcbKey}
+\clearpage
\begin{docTcbKey}{fit to}{=\meta{width} and \meta{height}}{style, initially unset}
Shortcut for using \refKey{/tcb/fit} and setting the \meta{width} and \meta{height} values
separately.
@@ -412,3 +411,18 @@ if necessary.
is determined within a deviation of \meta{dimension}.
\end{docTcbKey}
+
+\begin{docTcbKey}{fit warning}{=\meta{value}}{no default, initially |off|}
+ Typically, the fit control algorithm constructs several auxiliary boxes
+ to determine the optimal one. If not switched off, the construction of
+ the auxiliary boxes may produce many |hbox| warnings. This option key
+ changes the |\hbadness| value.
+ \begin{itemize}
+ \item |off|: Most of |'Underfull \hbox'| and |'Overfull \hbox'| warnings are
+ switched off (including the ones for the finally used box).
+ \item |on|: All warnings for all auxiliary boxes are displayed.
+ \item |final|: Only warnings for the finally used box are displayed.
+ Note that an additional box has to be contructed for theses messages.
+ \end{itemize}
+\end{docTcbKey}
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex
index e8ca304eb37..c1874a4bebe 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex
@@ -143,6 +143,11 @@ The real counter name is \texttt{\tcbcounter}.
\end{newTcbKey}
\clearpage
+\begin{marker}
+The following options \refKey{/tcb/new/crefname} and \refKey{/tcb/new/Crefname}
+need to be set inside the preamble.
+\end{marker}
+
\begin{newTcbKey}{crefname}{=\marg{singular}\marg{plural}}{no default, initially unset}
This option key can be used only in conjunction with the |cleveref| package
\cite{cubitt:2013a} which has to be loaded separately.
@@ -160,6 +165,26 @@ The real counter name is \texttt{\tcbcounter}.
See \refKey{/tcb/label type} and \cite{cubitt:2013a} for more information.
\end{newTcbKey}
+\inputpreamblelisting{I}
+\begin{dispExample}
+% \usepackage{cleveref}
+% \usepackage{varioref}
+\begin{mybluebox}[label={myreference}]{My title}
+This is an example.
+\end{mybluebox}
+
+\Cref{myreference}, \cref{myreference}.\\
+\Cpageref{myreference}, \cpageref{myreference}.\\
+\nameCref{myreference}, \namecref{myreference}.\\
+\labelcref{myreference}, \labelcpageref{myreference}.\\
+With \texttt{varioref}:\\
+\Vref{myreference}, \vref{myreference}.\\
+\Vref*{myreference}, \vref*{myreference}.
+\end{dispExample}
+
+
+
+
\clearpage
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
index cdd632fc08d..1b0036e7f5b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
@@ -189,6 +189,12 @@ This \textbf{text} is written to a standardized file for later usage.
\clearpage
+\begin{marker}
+It is not recommended to create a new sort of |tcblisting| environment with
+one optional argument only. If there is just one argument, it should be made
+mandatory to avoid content scanning problems.
+\end{marker}
+
\begin{docCommand}{newtcblisting}{\oarg{init options}\marg{name}\oarg{number}\oarg{default}\marg{options}}
Creates a new environment \meta{name} based on \refEnv{tcblisting}.
Basically, |\newtcblisting| operates like |\newenvironment|. This means,
@@ -241,6 +247,7 @@ This is my
\end{mybox}
\end{dispExample*}
+\clearpage
\inputpreamblelisting{C}
\begin{dispExample*}{sbs,lefthand ratio=0.5}
@@ -248,11 +255,10 @@ This is my
This is my \LaTeX\ box.
\end{mycbox}
\end{dispExample*}
-
\end{docCommand}
-\enlargethispage*{1cm}
+%\enlargethispage*{1cm}
\begin{docCommand}{renewtcblisting}{\oarg{init options}\marg{name}\oarg{number}\oarg{default}\marg{options}}
Operates like \refCom{newtcblisting}, but based on |\renewenvironment| instead of |\newenvironment|.
An existing environment is redefined.
@@ -456,10 +462,6 @@ be used inside these macros.
\end{docTcbKey}
-
-
-
-
\begin{docTcbKey}{listing and text}{}{no value, initially set}
Typesets the environment content as listing in the upper part and
as compiled text in the lower part.
@@ -470,6 +472,7 @@ This is a \LaTeX\ example.
\end{dispExample}
\end{docTcbKey}
+
\begin{docTcbKey}{text and listing}{}{no value}
Typesets the environment content as compiled text in the upper part and
as listing in the lower part.
@@ -595,6 +598,34 @@ This is a \LaTeX\ example.
\end{docTcbKey}
+\clearpage
+\begin{docTcbKey}{listing above text}{}{no value}
+ Typesets the environment content as listing in a |tcolorbox|
+ and as compiled text outside and below the box.
+ The outside text is treated as \emph{lower} part of the
+ |tcolorbox| and can be formatted with all lower part options.
+ The distance between box and text is controlled by \refKey{/tcb/middle}.
+\begin{dispExample}
+\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
+This is a \LaTeX\ example.
+\end{tcblisting}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{text above listing}{}{no value}
+ Typesets the environment content as listing in a |tcolorbox|
+ and as compiled text outside and above the box.
+ The outside text is treated as \emph{lower} part of the
+ |tcolorbox| and can be formatted with all lower part options.
+ The distance between box and text is controlled by \refKey{/tcb/middle}.
+\begin{dispExample}
+\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,text above listing}
+This is a \LaTeX\ example.
+\end{tcblisting}
+\end{dispExample}
+\end{docTcbKey}
+
\clearpage
\subsection{Creation of \LaTeX\ Tutorials}\label{sec:latextutorial}
@@ -775,9 +806,24 @@ The following series of examples demonstrate the application of
\begin{dispExample}
+\begin{texexptitled}[center lower,text above listing]
+ {How to use options (6):\par The picture may also be put above
+ the listing box.}{options6}
+\begin{tikzpicture}
+\path[fill=yellow!50!white] (0,0) circle (11mm);
+\path[fill=white] (0,0) circle (9mm);
+\foreach \w/\c in {90/red,210/green,330/blue}
+{\path[shading=ball,ball color=\c]
+ (\w:1cm) circle (7mm);}
+\end{tikzpicture}
+\end{texexptitled}
+\end{dispExample}
+
+
+\begin{dispExample}
\begin{texexptitled}[beamer,center lower,text outside listing,lefthand width=3.5cm]
- {How to use options (6):\par Our style is easily transformed into
- a beamerish one.}{options6}
+ {How to use options (7):\par Our style is easily transformed into
+ a beamerish one.}{options7}
\begin{tikzpicture}
\path[fill=yellow!50!white] (0,0) circle (11mm);
\path[fill=white] (0,0) circle (9mm);
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 d6d349092b1..3dbdba3fe1e 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -105,9 +105,13 @@ Every engine for the up to four steps can be set to one of the following types:
\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 |pathjigsaw|: 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 |pathfirstjigsaw|: 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 |pathmiddlejigsaw|: 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 |pathlastjigsaw|: 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}
@@ -126,6 +130,7 @@ Every engine for the up to four steps can be set to one of the following types:
\end{itemize}
\end{docTcbKey}
+\clearpage
\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}.
@@ -346,32 +351,11 @@ This is the lower part.
\end{docTcbKey}
-\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*}{sbs,lefthand ratio=0.66}
-\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}
-
\begin{docTcbKey}{title hidden}{}{style, no value}
This is a shortcut for |title style={draw=none,fill=none}|.
Depending on the skin, this option switches off the drawing of the
- title background. This is the default behavior for \refSkin{standard} and
- \refSkin{enhanced}.
+ title background. See also \refKey{/tcb/title filled} for a similar effect.
\begin{dispExample*}{sbs,lefthand ratio=0.66}
\tcbset{colback=red!5!white,colframe=red!75!black,
fonttitle=\bfseries}
@@ -386,6 +370,7 @@ This is the lower part.
\end{docTcbKey}
+
\clearpage
\subsection{Code Option Keys}\label{subsec:addcodeoptions}
The following code options are applicable for all skins which
@@ -774,6 +759,32 @@ Defines a |Tikz| scope which clips to the frame area path.
\end{docEnvironment}
\clearpage
+\begin{docEnvironment}{tcbinvclipframe}{}
+Defines a |Tikz| scope which clips to the \emph{outside} of the frame area path.
+
+\begin{dispExample}
+\tcbset{enhanced jigsaw,fonttitle=\bfseries,opacityback=0.35,colback=blue!5!white,
+ frame style={left color=red!75!black,right color=red!10!yellow}}
+
+\begin{tikzpicture}% draw two balls
+ \path[use as bounding box] (0,0.8) rectangle +(0.1,0.1);
+ \shadedraw [shading=ball] (0,0) circle (1cm);
+ \shadedraw [ball color=red] (3,-2.2) circle (1cm);
+\end{tikzpicture}
+
+\begin{tcolorbox}[title=A translucent box,
+ overlay={\begin{tcbinvclipframe}
+ \draw[red,line width=1cm] ([xshift=-2mm,yshift=2mm]frame.north west)
+ --([xshift=2mm,yshift=-2mm]frame.south east);
+ \draw[red,line width=1cm] ([xshift=-2mm,yshift=-2mm]frame.south west)
+ --([xshift=2mm,yshift=2mm]frame.north east);
+ \end{tcbinvclipframe}}]
+ \lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+\end{docEnvironment}
+
+\clearpage
\begin{docEnvironment}{tcbclipinterior}{}
Defines a |Tikz| scope which clips to the interior area path.
\begin{dispExample}
@@ -802,7 +813,8 @@ Defines a |Tikz| scope which clips to the title area path.
\begin{docTcbKey}{clip title}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
Sets the title to be clipped to the title area.
\begin{dispExample}
-\tcbset{enhanced,width=5cm,colframe=red!50!white,coltitle=black}
+\tcbset{enhanced,width=5cm,colframe=red!50!white,coltitle=black,
+ colbacktitle=yellow!50!white}
\begin{tcolorbox}[title=\mbox{This is a title which is unbreakable and far too long}]
This is a tcolorbox.
@@ -972,6 +984,30 @@ This is a tcolorbox.
\end{docTcbKey}
+\begin{docTcbKey}{show bounding box}{\colOpt{=\meta{color}}}{default |red|, initially unset}
+ Technically, this option is no borderline option but an overlay option, see
+ \Vref{subsec:overlays}. It is documented here, because it needs a
+ |tikzpicture| environment and it displays the bounding box borderline of
+ a |tcolorbox|. Its intended use is debugging and fine tuning.
+ The optional \meta{color} is the base color for the bounding box
+ borderline.
+\begin{dispExample}
+\tcbset{enhanced,nobeforeafter,width=4cm,fonttitle=\bfseries}
+
+\begin{tcolorbox}[show bounding box,title=Normal]
+This is a tcolorbox.
+\end{tcolorbox}%
+\begin{tcolorbox}[show bounding box=blue,title=Shadow,drop fuzzy shadow]
+This is a tcolorbox.
+\end{tcolorbox}%
+\begin{tcolorbox}[show bounding box=green,title=Enlarged,drop fuzzy shadow,
+ enlarge by=2mm]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
\clearpage
\subsection{Shadow Option Keys}\label{subsec:shadows}
The following shadow options are applicable for most skins which
@@ -982,6 +1018,10 @@ but most other skins, e.\,g.\ \refSkin{enhanced}.
The shadows are stackable, i.\,e.\ several different shadows can be
used on the same |tcolorbox|. They are drawn \emph{before} the box frame is drawn.
+\begin{docTcbKey}{no shadow}{}{no default}
+ Removes all shadows if set before.
+\end{docTcbKey}
+
\begin{docTcbKey}{shadow}{=\marg{xshift}\marg{yshift}\marg{offset}\marg{options}}{no default}
Adds a new shadow to the stack of shadows.
@@ -1101,7 +1141,6 @@ This is a tcolorbox.
\clearpage
-
\begin{docTcbKey}{drop shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
Adds a new shadow with standard dimensions to the stack of shadows.
Optionally, the \meta{color} for the shadow can be changed.
@@ -1120,6 +1159,8 @@ This is a tcolorbox.
\end{docTcbKey}
+
+
\begin{docTcbKey}{drop fuzzy shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
Optionally, the \meta{color} for the shadow can be changed.
@@ -1174,7 +1215,6 @@ This is a tcolorbox.
\end{docTcbKey}
-
\clearpage
\begin{docTcbKey}{halo}{=\meta{size} \texttt{with} \meta{color}}{style, default |0.9mm with yellow|}
Adds a new halo shadow with the given \meta{color}
@@ -1213,20 +1253,395 @@ This is a tcolorbox.
\end{dispExample*}
\begin{dispExample}
-\begin{tcolorbox}[blank,
+\begin{tcolorbox}[blank,enhanced jigsaw,boxsep=2pt,arc=2pt,
fuzzy halo=2mm with red!50!white,
- fuzzy halo=1mm with white,]
+ fuzzy halo=1mm with white]
\lipsum[1]
\end{tcolorbox}
\end{dispExample}
\end{docTcbKey}
+\clearpage
+For all following shadows, the optionally given \meta{color} for the shadow can be changed
+equivalent to the preceding examples.
-\begin{docTcbKey}{no shadow}{}{no default}
- Removes all shadows if set before.
+\begin{docTcbKey}{drop shadow southeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow southeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow south}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop midday shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow south,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow southwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow southwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow west}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow west,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow northwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow northwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow north}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow north,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\clearpage
+\begin{docTcbKey}{drop shadow northeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow northeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow east}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow east,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+
+\begin{docTcbKey}{drop fuzzy shadow southeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop fuzzy shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow southeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow south}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop fuzzy midday shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow south,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow southwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow southwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow west}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow west,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\clearpage
+\begin{docTcbKey}{drop fuzzy shadow northwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow northwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow north}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow north,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow northeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow northeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow east}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow east,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+
+\clearpage
+\subsection{TikZ Picture Option Keys}\label{subsec:tikzpicture}
+The following general options are applicable for skins which
+use |tikzpicture| as \refKey{/tcb/graphical environment}.
+Therefore, the skin \refSkin{standard} does not support these options,
+but most other skins, e.\,g.\ \refSkin{enhanced}.
+
+
+\begin{docTcbKey}{tikz}{=\meta{tikz option list}}{no default, initially empty}
+ Adds the given \meta{tikz option list} to the main |tikzpicture| environment
+ used to draw the color box, see \cite{tantau:2010c}. If this option is
+ applied a second time, the new \meta{tikz option list} is appended to the
+ current option list.
+\begin{dispExample*}{sbs,lefthand ratio=0.66,
+ segmentation style={pattern=crosshatch dots light steel blue}}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=Transparent box,
+ tikz={opacity=0.5,transparency group}]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{tikz reset}{}{initially set}
+ Removes all options given by \refKey{/tcb/tikz}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at begin tikz}{=\meta{tikz code}}{no default, initially empty}
+ The given \meta{tikz code} is executed at the begin of the |tikzpicture| environment
+ after the TikZ option |execute at begin picture| was applied.
+ If this option is applied a second time, the new \meta{tikz code} is appended to the current code.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at begin tikz reset}{}{initially set}
+ Removes all code given by \refKey{/tcb/at begin tikz}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at end tikz}{=\meta{tikz code}}{no default, initially empty}
+ The given \meta{tikz code} is executed at the end of the |tikzpicture| environment
+ before the TikZ option |execute at end picture| was applied.
+ If this option is applied a second time, the new \meta{tikz code} is appended to the current code.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at end tikz reset}{}{initially set}
+ Removes all code given by \refKey{/tcb/at end tikz}.
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{rotate}{=\meta{angle}}{no default, initially unset}
+ Rotates the |tcolorbox| by the given \meta{angle}. Note that this is
+ a TikZ coordinate transformation i.e. not all graphical elements like shadings
+ will really be rotated.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=Rotated box,rotate=30]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}{scale}{=\meta{fraction}}{no default, initially unset}
+ Scales the |tcolorbox| by the given \meta{fraction}. Note that this is
+ a TikZ coordinate transformation i.e. not all graphical elements like line widths
+ will really be scaled.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=Scaled box,scale=0.5]
+This is a tcolorbox.
+\end{tcolorbox}
+\begin{tcolorbox}[title=Scaled box,scale=1.25]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{remember}{}{style, initially unset}
+ Shortcut for |tikz={remember picture}|. This allows to reference nodes
+ in other TikZ pictures.
+\begin{dispExample}
+\begin{tcolorbox}[enhanced,remember,colback=red!5!white,colframe=red!75!black,
+ fonttitle=\bfseries,title=The four corners of a paper,
+ overlay={\draw[red!50!white,line width=1mm,opacity=0.5,shorten >=3mm]
+ (frame.north west) edge[->] (current page.north west)
+ (frame.north east) edge[->] (current page.north east)
+ (frame.south west) edge[->] (current page.south west)
+ (frame.south east) edge[->] (current page.south east);}]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample}
\end{docTcbKey}
+\clearpage
+\begin{docTcbKey}{remember as}{=\meta{name}}{style, no default, initially unset}
+ The |frame| node will be remembered by the given \meta{name} to be referenced
+ in other TikZ pictures.
+\begin{dispExample}
+% \usepackage{lipsum}
+\newtcolorbox{mybox}[1][]{enhanced,colframe=blue!75!black,colback=blue!10!white,
+ fonttitle=\bfseries,#1}
+
+\begin{mybox}[title=First Box,nobeforeafter,width=\linewidth/4,remember as=one]
+This is a test.
+\end{mybox}
+\hfill
+\begin{mybox}[title=Second Box,nobeforeafter,width=\linewidth/4,remember as=two]
+This is a test.
+\end{mybox}
+\hfill
+\begin{mybox}[title=Third Box,nobeforeafter,width=\linewidth/4,remember as=three]
+This is a test.
+\end{mybox}
+
+\lipsum[2]
+
+\begin{mybox}[title=Fourth Box,remember as=four]
+This is a test.
+\end{mybox}
+
+\begin{tikzpicture}[overlay,remember picture,line width=1mm,draw=red!75!black]
+ \draw[->] (one.east) to[bend right] node[above] {A} (two.west);
+ \draw[->] (two.east) to[bend left] node[above] {B} (three.west);
+ \draw[->] (three.east) to[bend left=90] node[right] {C} (four.east);
+ \draw[->] (four.west) to[bend left=90] node[left] {D} (one.west);
+\end{tikzpicture}
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
+\subsection{Jigsaw Skin Variants}\label{subsec:skinjigsaw}
+As described in \Vref{sec:skincorekeys}, a |tcolorbox| is drawn by up to
+four \emph{engines}. Typically, the \emph{frame} engine fills the complete box area
+with color and the other engines fill certain areas with other colors.
+Finally, only the area which you see as \emph{frame} of the box will display
+the frame color. For most applications, this is a good approach.
+
+For certain boxes, a more delicate procedure is needed. E.g., if the box should
+be translucent, an already painted area cannot be made unpainted. Therefore,
+more elaborate frame engines saw holes into the frame where the interior area and
+optionally the title area will be painted.
+The resulting skins are called \emph{jigsaw} skins. For \refSkin{standard}
+and \refSkin{enhanced}, there are variants called \refSkin{standard jigsaw}
+and \refSkin{enhanced jigsaw}.
+
+
+\begin{dispExample}
+\newcommand{\ballexample}{\begin{tikzpicture}
+ \path[use as bounding box] (0,0.8) rectangle +(0.1,0.1);
+ \shadedraw [shading=ball] (0,0) circle (1cm);
+ \shadedraw [ball color=red] (3,-2.2) circle (1cm);
+\end{tikzpicture}}
+
+\tcbset{enhanced,colback=blue!5!white,
+ frame style={left color=red!75!black,right color=red!10!yellow},
+ fonttitle=\bfseries }
+
+\ballexample
+
+\begin{tcolorbox}[title=A normal box]
+ \lipsum[2]
+\end{tcolorbox}
+
+\ballexample
+
+\begin{tcolorbox}[title=A translucent jigsaw box,
+ enhanced jigsaw,opacityback=0.35]
+ \lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample*}{segmentation style={pattern=crosshatch dots light steel blue}}
+\tcbset{enhanced,colback=red!10!white,coltitle=black,
+ frame style={left color=red!75!black,right color=red!10!yellow},
+ fonttitle=\bfseries,interior hidden,title hidden}
+
+\begin{tcolorbox}[title=A normal box with hidden interior and titel]
+ This is a tcolorbox.
+\end{tcolorbox}
+
+\begin{tcolorbox}[enhanced jigsaw,
+ title=A jigsaw box with hidden interior and titel]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+
+
+\begin{dispExample}
+\newtcolorbox{mybox}{skin=enhancedmiddle jigsaw,leftrule=5mm,rightrule=5mm,
+ boxsep=0mm,top=0mm,bottom=0mm,
+ frame style={top color=blue,bottom color=red},interior hidden}
+
+\begin{mybox}
+ \lipsum[2]
+\end{mybox}
+\end{dispExample}
\clearpage
@@ -1235,7 +1650,7 @@ This is a tcolorbox.
fonttitle=\bfseries,before=\par\smallskip,
title=Environment and engines for the skin '\texttt{#1}'}}
-\subsection{Skin 'standard'}\label{subsec:skinstandard}
+\subsection{Skin Family 'standard'}\label{subsec:skinstandard}
\begin{marker}Note that the option keys \refKey{/tcb/frame style},
\refKey{/tcb/interior style},
\refKey{/tcb/segmentation style}, and
@@ -1268,7 +1683,7 @@ This is a tcolorbox.
\begin{dispExample}
\tcbset{standard,equal height group=standard,
colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
- width=(\linewidth-6mm)/4,nobeforeafter,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
%
\begin{tcolorbox}
@@ -1290,6 +1705,53 @@ This is a tcolorbox.
\end{dispExample}
+\clearpage
+
+\begin{docSkin}{standard jigsaw}
+ This is the standard jigsaw skin from the core package. It differs from
+ the skin \refSkin{standard} by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=standard jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |pgfpicture|\\
+ \refKey{/tcb/frame engine}: \> |standardjigsaw|\\
+ \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 jigsaw}{}{style, no value}
+ This is an abbreviation for setting |skin=standard jigsaw|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{standard jigsaw,equal height group=standardjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ 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'}
@@ -1526,8 +1988,188 @@ Nevertheless, this skin can be applied independently.
\end{dispExample}
+
+
+\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
+\begin{docSkin}{enhanced jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhanced}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=enhanced jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathjigsaw|\\
+ \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 jigsaw}{}{style, no value}
+ This is an abbreviation for setting |skin=enhanced jigsaw|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{enhanced jigsaw,equal height group=enhancedjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ 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}{enhancedfirst jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhancedfirst}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=enhancedfirst jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathfirstjigsaw|\\
+ \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 jigsaw,equal height group=enhancedfirstjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ 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 jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhancedmiddle}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=enhancedmiddle jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathmiddlejigsaw|\\
+ \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 jigsaw,equal height group=enhancedmiddlejigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ 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
+ This styles relies on the skin \refSkin{enhancedmiddle jigsaw}. It is
intended to be used as an optical marker like a highlighter pen.
\begin{dispExample}
\begin{tcolorbox}[marker]
@@ -1541,10 +2183,9 @@ Nevertheless, this skin can be applied independently.
\begin{dispListing*}{before upper={This examples demonstrates the creation of several
\emph{text marker} environments based on \refSkin{enhancedmiddle}.\par\medskip}}
\tcbset{textmarker/.style={%
- skin=enhancedmiddle,breakable,parbox=false,
+ skin=enhancedmiddle jigsaw,breakable,parbox=false,
boxrule=0mm,leftrule=5mm,rightrule=5mm,boxsep=0mm,arc=0mm,outer arc=0mm,
- left=3mm,right=3mm,top=1mm,bottom=1mm,enlarge left by=-8mm,enlarge right by=-8mm,
- toptitle=1mm,bottomtitle=1mm,width=\the\dimexpr\linewidth+1.6cm\relax}}
+ left=3mm,right=3mm,top=1mm,bottom=1mm,toptitle=1mm,bottomtitle=1mm,oversize}}
\newtcolorbox{yellow}{textmarker,colback=yellow!5!white,colframe=yellow}
\newtcolorbox{orange}{textmarker,colback=DarkOrange!5!white,
@@ -1552,41 +2193,45 @@ Nevertheless, this skin can be applied independently.
\newtcolorbox{red}{textmarker,colback=red!5!white,colframe=red}
\newtcolorbox{blue}{textmarker,colback=DeepSkyBlue!5!white,colframe=DeepSkyBlue}
\newtcolorbox{green}{textmarker,colback=Chartreuse!5!white,colframe=Chartreuse}
+\newtcolorbox{rainbow}{textmarker,interior hidden,
+ frame style={top color=blue,bottom color=red,middle color=green}}
\begin{yellow}
- \lipsum[1]
+ \lipsum[1-3]
\end{yellow}
\begin{orange}
- \lipsum[2]
+ \lipsum[4]
\end{orange}
\begin{red}
- \lipsum[3]
+ \lipsum[5]
\end{red}
\begin{green}
- \lipsum[4]
+ \lipsum[6]
\end{green}
\begin{blue}
- \lipsum[5]
+ \lipsum[7]
\end{blue}
-\lipsum[6]% following text
+
+\begin{rainbow}
+ \lipsum[8]
+\end{rainbow}
\end{dispListing*}
{\tcbusetemp}
\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{docSkin}{enhancedlast jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhancedlast}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
\begin{tcolorbox}[skintable=enhancedlast]
\begin{tabbing}
\refKey{/tcb/interior titled engine}: \=\kill
\refKey{/tcb/graphical environment}: \> |tikzpicture|\\
- \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/frame engine}: \> |pathlastjigsaw|\\
\refKey{/tcb/interior titled engine}: \> |pathlast|\\
\refKey{/tcb/interior engine}: \> |pathlast|\\
\refKey{/tcb/segmentation engine}: \> |path|\\
@@ -1595,10 +2240,12 @@ Nevertheless, this skin can be applied independently.
\end{tcolorbox}
\end{docSkin}
+
\begin{dispExample}
-\tcbset{skin=enhancedlast,equal height group=enhancedlast,
- colback=LightGreen,colframe=DarkGreen,
- width=(\linewidth-6mm)/4,nobeforeafter,
+\tcbset{skin=enhancedlast jigsaw,equal height group=enhancedlastjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
%
\begin{tcolorbox}
@@ -1620,8 +2267,6 @@ Nevertheless, this skin can be applied independently.
\end{dispExample}
-
-
\clearpage
\subsection{Skin Family 'freelance'}
\begin{marker}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex
index 41657873cde..58542326d1b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex
@@ -11,22 +11,24 @@ This also loads the package |amsmath|.
\subsection{Macros of the Library}
\begin{docCommand}{newtcbtheorem}{\oarg{init options}\marg{name}\marg{display name}\marg{options}\marg{prefix}}
- Creates a new environment \meta{name} based on |tcolorbox| to frame a
+ Creates new environments \meta{name} and \meta{name}|*| based on |tcolorbox| to frame a
(mathematical) theorem. The \meta{display name} is used in the title line
with a number, e.\,g. \mbox{\flqq Theorem 5.1\frqq}.
The \meta{options} are given to the underlying |tcolorbox| to control
the appearance.
%The \meta{counter} is used for automatic numbering.
The \meta{init options} allow to set up automatic numbering,
- see Section \ref{sec:initkeys} from page \pageref{sec:initkeys}.\par
+ see \Vref{sec:initkeys}.\par
The new environment \meta{name} takes one optional and two mandatory
parameters. The optional parameter supplements the options and should be
used only in rare cases.
The first mandatory parameter is the title text for the theorem and
the second mandatory parameter is a \meta{marker}. The theorem is
- automatically labeled with \meta{prefix}|:|\meta{marker}.
-
-\enlargethispage*{20mm}
+ automatically labeled with \meta{prefix}|:|\meta{marker}.\par
+ The new environment \meta{name}|*| takes one optional and one mandatory
+ parameter and represents an unnumbered variant of the environment \meta{name}.
+ This variant is not labeled and not listed in lists of theorems.
+%\enlargethispage*{20mm}
\inputpreamblelisting{F}
\begin{dispExample}
\begin{mytheo}{This is my title}{theoexample}
@@ -49,10 +51,21 @@ This also loads the package |amsmath|.
vanished magically.
\end{mytheo}
\end{dispExample}
+
+\begin{dispExample}
+\begin{mytheo*}{Unnumbered Theorem}
+ This theorem is not numbered.
+\end{mytheo*}
+\end{dispExample}
+
+\begin{dispExample}
+\begin{mytheo*}{}
+ This theorem has no number and no title.
+\end{mytheo*}
+\end{dispExample}
\end{docCommand}
-\clearpage
\begin{docCommand}{renewtcbtheorem}{\oarg{init options}\marg{name}\marg{display name}\marg{options}\marg{prefix}}
Operates like \refCom{newtcbtheorem}, but based on |\renewenvironment| instead of |\newenvironment|.
An existing environment is redefined.
@@ -79,6 +92,7 @@ This also loads the package |amsmath|.
\end{deprecated}
\end{docCommand}
+\clearpage
\begin{docCommand}{tcboxmath}{\oarg{options}\marg{mathematical box content}}
Creates a \refEnv{tcolorbox} which is fitted to the width of the given
\meta{mathematical box content}. This box is intended to be applied as
@@ -96,8 +110,6 @@ This also loads the package |amsmath|.
\end{dispExample}
\end{docCommand}
-\clearpage
-
\begin{docCommand}{tcbhighmath}{\oarg{options}\marg{mathematical box content}}
This is a special case of the \refCom{tcboxmath} macro which uses
the style \refKey{/tcb/highlight math}.
@@ -107,7 +119,8 @@ This also loads the package |amsmath|.
\begin{dispExample}
\tcbset{myformula/.style={colback=yellow!10!white,colframe=red!50!black,
- highlight math style={colback=LightBlue!50!white,colframe=Navy}}}
+ every box/.style={highlight math style={colback=LightBlue!50!white,colframe=Navy}}
+ }}
\begin{align}
\tcbhighmath{\sum\limits_{n=1}^{\infty} \frac{1}{n}} &= \infty.\\
@@ -187,7 +200,22 @@ created by hand or using \refCom{tcbmaketheorem} or using its successor
\begin{docTcbKey}{highlight math style}{=\meta{style definition}}{style, no default}
Changes the definition for \refKey{/tcb/highlight math} to the given
- \meta{style definition}. See \refCom{tcbhighmath} for an example.
+ \meta{style definition}. See \refCom{tcbhighmath} for another example.
+\begin{dispExample}
+% \tcbuselibrary{skins}
+\tcbset{highlight math style={enhanced,%<-- needed for the 'remember' options
+ colframe=red,colback=red!10!white,boxsep=0pt}}
+\begin{align*}
+\tcbhighmath[remember as=fx]{f(x)}
+ &= \int\limits_{1}^{x} \frac{1}{t^2}~dt
+ = \left[ -\frac{1}{t} \right]_{1}^{x}\\
+ &= -\frac{1}{x} + \frac{1}{1}\\
+ &=
+\tcbhighmath[remember,overlay={%
+ \draw[blue,very thick,->] (fx.south) to[bend right] ([yshift=2mm]frame.west);}]
+ {1-\frac{1}{x}.}
+\end{align*}
+\end{dispExample}
\end{docTcbKey}
\begin{docTcbKey}{math upper}{}{style, no value}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index e0070c21875..dd9cba7e3bd 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 9c610590a6d..f02fc310661 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
@@ -1,5 +1,5 @@
% \LaTeX-Main\
-%% The LaTeX package tcolorbox - version 2.51 (2013/09/16)
+%% The LaTeX package tcolorbox - version 2.60 (2013/12/17)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -29,7 +29,7 @@
\usepackage{tikz}
\usepackage{varioref}
\usepackage[pdftex,bookmarks,raiselinks,pageanchor,hyperindex,colorlinks]{hyperref}
-\usepackage{cleveref}
+\usepackage{cleveref,incgraph}
\usepackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm,
marginparsep=5mm,marginparwidth=10mm,
@@ -82,8 +82,8 @@
\newtcolorbox{marker}[1][]{marker,#1}
-\def\version{2.51}%
-\def\datum{2013/09/16}%
+\def\version{2.60}%
+\def\datum{2013/12/17}%
\makeindex
\hypersetup{
@@ -137,16 +137,18 @@
morekeywords={% core
adjusted,adjust,after,arc,auto,autoparskip,align,
before,bottom,boxsep,boxrule,bottomtitle,bottomrule,broken,basedim,
- collower,coltext,coltitle,colback,colframe,colupper,center,code,capture,check,counter,
+ collower,coltext,coltitle,colback,colframe,colupper,center,code,capture,check,counter,crefname,Crefname,
equal,enlarge,enlargement,extrude,every,box,higher,layers,
- fontupper,fontlower,fonttitle,first,floatplacement,float,fit,fontsize,flushleft,flushright,freestyle,format,
+ fontupper,fontlower,fonttitle,first,floatplacement,float,fit,fontsize,flushleft,flushright,freestyle,format,filled,
group,gap,
height,
+ jigsaw,
lowerbox,left,leftrule,lefttitle,leftupper,leftlower,lower,last,lefthand,label,
middle,minimum,maxstep,macros,
notitle,natural,noparskip,nobeforeafter,nofloat,number,
parskip,parbox,phantom,page,
- outer,oversize,overlay,odd,
+ outer,oversize,overlay,odd,opacitytext,opacityfill,
+ opacityupper,opacitylower,opacitytitle,opacityframe,opacityback,opacitybacktitle,
right,rightrule,righttitle,rightupper,rightlower,righthand,ratio,
savelowerto,savedelimiter,space,split,shrink,sidebyside,skip,step,separated,
title,top,toptitle,toprule,titlerule,tabularx,tikz,toggle,tight,tempfile,text,
@@ -154,6 +156,7 @@
valign,
width,within,
% listings
+ above,
comment,
file,
inputencoding,
@@ -197,10 +200,12 @@
opacity,overzoom,
midday,
nodes,
- skin,segmentation,stretch,standard,shadow,
+ rotate,remember,
+ skin,segmentation,stretch,standard,shadow,scale,
titled,
watermark,widget,
zoom,
+ southeast,south,southwest,west,northwest,north,northeast,east,
% breakable
breakable,break,enlargepage,
goal,
@@ -328,7 +333,17 @@
\input{\jobname_preamble_H.tex}
-%\includeonly{tcolorbox.doc.skins}
+\begin{tcbverbatimwrite}{\jobname_preamble_I.tex}
+% \usepackage{cleveref}
+\newtcolorbox[auto counter,number within=section,
+ Crefname={Bluebox}{Blueboxes},crefname={bluebox}{blueboxes}]%
+ {mybluebox}[2][]{colback=blue!5!white,colframe=blue!75!black,fonttitle=\bfseries,
+ title=Bluebox \thetcbcounter: #2,#1}
+\end{tcbverbatimwrite}
+\input{\jobname_preamble_I.tex}
+
+
+%\includeonly{tcolorbox.doc.abstract}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%