diff options
author | Karl Berry <karl@freefriends.org> | 2014-07-23 22:04:50 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-07-23 22:04:50 +0000 |
commit | f3e14f60640da99c60f8a344d2ce48d6cab12b8c (patch) | |
tree | 1ae1ae4fb8f333f8874192c446fc426e8dafb61a /Master/texmf-dist/doc/latex/tcolorbox | |
parent | 858d2c9bc2f38514b4e7e4ab15d64291bd4e2e85 (diff) |
tcolorbox (22jul14)
git-svn-id: svn://tug.org/texlive/trunk@34701 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
14 files changed, 383 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index 520bd9032f7..3df400c361b 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES +++ b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) +%% The LaTeX package tcolorbox - version 3.10 (2014/07/23) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> @@ -545,3 +545,29 @@ version 3.05 (2014/05/28) * new options: 'lifted shadow', 'drop small lifted shadow', 'drop lifted shadow', 'drop large lifted shadow' +version 3.10 (2014/07/23) +- box breaking algorithm revised: + * breakable boxes now always have \noindent + * distance to preceeding text corrected + * interaction with floating objects fixed + * dimensioning of partial boxes improved + * splitting of an empty closing frame can now be avoided (depending on 'pad at break*') + * The upper total height limit for breakable boxes is extended from + about 16384pt to about 65536pt + * experimental code added (breakable=unlimited) for breakable boxes + without height limit besides memory + * splitting boxes inside multicols environments supported (to a certain degree) + * limited orphan control added ('enlargepage flexible') +- library 'breakable': + * new options: + 'break at', 'height fixed for', 'enlargepage flexible', + 'pad before break*', 'pad at break*' +- Corners can be set individually now to be 'rounded' or 'sharp' + for all types of boxes, skins, borders, and shadows: + * new options: 'sharpish corners', 'sharp corners', and 'rounded corners' +- library 'skins': + * new options: '\tcbline*' + * bug fix: skin families 'bicolor' and 'beamer' did not respect 'colbacktitle' +- pictures 'blueshade.png', 'crinklepaper.png', 'goldshade.png', 'pink_marble.png' + moved to package folder + diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index 0eb00c4bbde..f5ce25658ab 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/README +++ b/Master/texmf-dist/doc/latex/tcolorbox/README @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) +%% The LaTeX package tcolorbox - version 3.10 (2014/07/23) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> @@ -41,6 +41,10 @@ Contents of the package 'tcbskinsjigsaw.code.tex' LaTeX package file (library of tcolorbox) 'tcbtheorems.code.tex' LaTeX package file (library of tcolorbox) 'tcbxparse.code.tex' LaTeX package file (library of tcolorbox) + 'blueshade.png' Picture (package) + 'crinklepaper.png' Picture (package) + 'goldshade.png' Picture (package) + 'pink_marble.png' Picture (package) 'tcolorbox.pdf' Documentation for tcolorbox 'tcolorbox.tex' Source code of the documentation (main file) '*.doc.*' Source code of the documentation (include files) @@ -48,10 +52,6 @@ Contents of the package 'tcolorbox-example.pdf' Compiled example 'Basilica_5.png' Example picture 'lichtspiel.jpg' Example picture - 'blueshade.png' Example picture - 'crinklepaper.png' Example picture - 'goldshade.png' Example picture - 'pink_marble.png' Example picture Installation ============ @@ -71,4 +71,8 @@ Alternatively, put the files to their respective locations within the TeX instal 'tcbskins.code.tex' -> /tex/latex/tcolorbox 'tcbskinsjigsaw.code.tex' -> /tex/latex/tcolorbox 'tcbxparse.code.tex' -> /tex/latex/tcolorbox + 'blueshade.png' -> /tex/latex/tcolorbox + 'crinklepaper.png' -> /tex/latex/tcolorbox + 'goldshade.png' -> /tex/latex/tcolorbox + 'pink_marble.png' -> /tex/latex/tcolorbox all other files -> /doc/latex/tcolorbox diff --git a/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png b/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png Binary files differdeleted file mode 100644 index 4b1713e657c..00000000000 --- a/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png b/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png Binary files differdeleted file mode 100644 index c030edf7656..00000000000 --- a/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png b/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png Binary files differdeleted file mode 100644 index 7e082640532..00000000000 --- a/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png b/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png Binary files differdeleted file mode 100644 index d3279dff5cf..00000000000 --- a/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf Binary files differindex 77df64b9536..b89f20d0ce0 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex index 18a1561d335..ec44e30328d 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) +%% The LaTeX package tcolorbox - version 3.10 (2014/07/23) %% tcolorbox-example.tex: an example for tcolorbox %% %% ------------------------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib index 181e662040b..32fa8379ece 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib @@ -177,3 +177,15 @@ } +@manual{mittelbach:2014a, + author = {Frank Mittelbach}, + title = {An environment for multicolumn output}, + url = {http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf}, + Xnote = {}, + day = 21, + month = jun, + year = 2014, + language = {english} +} + + 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 ba0467b34c1..baf13947484 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex @@ -83,9 +83,19 @@ parameters. The differences are: \subsection{Limitations and Known Bugs} \begin{itemize} -\item The box content is a \TeX\ |\vbox| register which has a - restricted capacity. Therefore, you cannot place hundreds of pages - inside a |tcolorbox|. +\item The maximal total height of the upper and of the lower part + of normal breakable |tcolorbox|es is about 65536pt (ca.\,2300cm) + apiece. If such a part gets longer, the output will get buggy + without warning. + For very oversized boxes which are longer than 65536pt, use + the \docValue{unlimited} value for \refKey{/tcb/breakable}. + With the \docValue{unlimited} setting, + the applied algorithm has (virtually) no height limit for boxes, but + very likely the compiler memory will have to be increased for boxes longer + than 300 pages (depending on compiler settings and box content). + But it is recommended to use \docValue{unlimited} for critical large boxes only, + since there \emph{may} be a single interline space deviation (lost glue) around + every 2300cm, e.\,g.\ a \refCom{tcbline*} \emph{may} get lost. \item You can nest an unbreakable |tcolorbox| inside another |tcolorbox|, even inside a breakable one. But you cannot not nest a breakable box inside a breakable box. @@ -105,7 +115,7 @@ parameters. The differences are: \clearpage \subsection{Main Option Keys} -\begin{docTcbKey}{breakable}{\colOpt{=true\textbar false}}{default |true|, initially |false|} +\begin{docTcbKey}{breakable}{\colOpt{=true\textbar false\textbar unlimited}}{default |true|, initially |false|} Allows the |tcolorbox| to be breakable. If the box is larger than the available space at the current page, the box is automatically broken and continued to the next next page. All sorts of |tcolorbox| can be made @@ -113,16 +123,27 @@ parameters. The differences are: If you do not know better, use \refKey{/tcb/enhanced} for breaking a box. The parts of the \emph{break sequence} are numbered by the counter |tcbbreakpart|. - \begin{dispListing} - % \usepackage{lipsum} % preamble - \tcbset{enhanced jigsaw,colback=red!5!white,colframe=red!75!black, - watermark color=yellow!25!white,watermark text=\arabic{tcbbreakpart}, - fonttitle=\bfseries} - - \begin{tcolorbox}[breakable,title=My breakable box] - \lipsum[1-6] - \end{tcolorbox} - \end{dispListing} + \begin{itemize} + \item\docValue{false}: Sets the |tcolorbox| to be unbreakable. + \item\docValue{true}: Breaks the |tcolorbox| from one page to another. + The maximal total height of the upper and of the lower part is + about 65536pt (ca.\,2300cm or ca.\,90 pages) apiece. + \item\docValue{unlimited}: Experimental code for unlimited total height of + breakable boxes. There \emph{may} be a single interline space deviation (lost glue) around + every 2300cm. For boxes longer than 300 pages (or even shorter ones) the + compiler memory will have to be increased. + \end{itemize} + +\begin{dispListing} +% \usepackage{lipsum} % preamble +\tcbset{enhanced jigsaw,colback=red!5!white,colframe=red!75!black, + watermark color=yellow!25!white,watermark text=\arabic{tcbbreakpart}, + fonttitle=\bfseries} + +\begin{tcolorbox}[breakable,title=My breakable box] +\lipsum[1-6] +\end{tcolorbox} +\end{dispListing} \end{docTcbKey} {\tcbusetemp} @@ -166,7 +187,34 @@ parameters. The differences are: \end{docTcbKey} \clearpage -\begin{docTcbKey}{enlargepage}{=\meta{length}\colOpt{/\meta{length}\ldots/\meta{length}}}{no default, initially |0pt|} +\begin{docTcbKey}{break at}{=\meta{length}\colOpt{/\meta{length}/\ldots/\meta{length}}}{no default, initially |0pt|} + Defines break points at the given \meta{length} values. + The first \meta{length} defines the (maximal) height of the first partial box, + the second \meta{length} defines the (maximal) height of the second partial box, + and so on. The last \meta{length} value is applied to all following partial boxes if any. + Setting a length to |0pt| means that the naturally available space is used + for breaking. +\begin{dispExample} +% \usepackage{multicol,lipsum} +\begin{multicols}{3}\footnotesize +Breakable boxes inside a |multicols| environment need special attendance. +They are broken by default at |\textheight|. +The |break at| option can be used to insert better break points by hand. +\par\medskip +\begin{tcolorbox}[enhanced jigsaw,size=small,before=\noindent, + colframe=red,colback=yellow!10!white,before title=\raggedright, + title={Broken box inside a |multicols| environment},fonttitle=\bfseries, + enforce breakable,% use only breakable in the real world! + pad at break=1mm,break at=3cm/6.3cm ] +\lipsum[1] +\end{tcolorbox} +\refKey{/tcb/height fixed for} may also be considered for |multicols| environments. +\end{multicols} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{enlargepage}{=\meta{length}\colOpt{/\meta{length}/\ldots/\meta{length}}}{no default, initially |0pt|} Inserts a |\enlargethispage|\marg{length} to the pages of the break sequence, i.\,e.\ allows one to enlarge (or shrink) partial boxes. The first \meta{length} is applied to the first partial box, the second \meta{length} is applied @@ -186,11 +234,30 @@ parameters. The differences are: \end{marker} \end{docTcbKey} +\clearpage +\begin{docTcbKey}{enlargepage flexible}{=\meta{length}}{no default, initially |0pt|} + This allows an automated page enlargement for up to \meta{length}. + The algorithm can use this to avoid breaking a box, if there is anough room + after enlargement. Also, the \emph{last} partial box of a break sequence + may be enlarged to avoid further breaking.\\ + Note that this potential enlargement is \emph{additive} to settings of + \refKey{/tcb/enlargepage}. + But \refKey{/tcb/enlargepage flexible} overwrites settings of + \refKey{/tcb/pad before break*} or \refKey{/tcb/pad at break*}. +\begin{dispListing} +% The following setting hinders orphan lines for the last partial box +\tcbset{enlargepage flexible=\baselineskip} +\end{dispListing} +\end{docTcbKey} + + \begin{docTcbKey}{shrink break goal}{=\meta{length}}{no default, initially |0pt|} This is an emergency parameter if the break algorithm produces unpleasant - breaks. It shrinks the goal height of the current box part by \meta{length} + breaks. + It shrinks the goal height of the current box part by \meta{length} which may result in smaller boxes. Never use negative values. + \emph{Usually, this option will never be needed at all.} \end{docTcbKey} @@ -213,8 +280,6 @@ parameters. The differences are: \end{docTcbKey} - - \begin{docTcbKey}{topsep at break}{=\meta{length}}{no default, initially \texttt{0mm}} Additional vertical space of \meta{length} which is added at the top of \emph{middle} and \emph{last} parts in a break sequence. In general, @@ -235,6 +300,12 @@ parameters. The differences are: \emph{middle} and \emph{last} parts in a break sequence start with a rule or a title. \end{docTcbKey} +\begin{docTcbKey}{pad before break*}{=\meta{length}}{style, no default} + Sets \refKey{/tcb/pad before break} to \meta{length} and + \refKey{/tcb/enlargepage flexible} to an appropriate value such that + empty closing frames are avoided. +\end{docTcbKey} + \begin{docTcbKey}{pad after break}{=\meta{length}}{style, no default, initially \texttt{3.5mm}} Sets the total amount of vertical space after the break point and before the text content to \meta{length}. This style sets \refKey{/tcb/bottomrule at break} to |0pt| @@ -260,6 +331,18 @@ parameters. The differences are: \end{dispListing} {\tcbusetemp} +\begin{docTcbKey}{pad at break*}{=\meta{length}}{style, no default} + Sets \refKey{/tcb/pad at break} to \meta{length} and + \refKey{/tcb/enlargepage flexible} to an appropriate value such that + empty closing frames are avoided. +\end{docTcbKey} + +\begin{marker} +\refKey{/tcb/pad at break} or \refKey{/tcb/pad at break*} +should be used as very last option in an option list, because +they adapt other settings. +\end{marker} + \begin{marker} Also see \refKey{/tcb/enlarge top at break by} @@ -267,6 +350,109 @@ and \refKey{/tcb/enlarge bottom at break by}. \end{marker} +\begin{docTcbKey}{height fixed for}{=\meta{part}}{no default, initially |none|} + When certain amount of space is available for a partial box of a + break sequence, the partial box typically is smaller than this space + (depending on the box content). For given \meta{part}(s), the height can be + set to all available space. + \begin{itemize} + \item\docValue{none}: Every partial |tcolorbox| is set with its natural height. + \item\docValue{first}: The \emph{first} partial box is set to a height which matches the available space. + \item\docValue{middle}: All \emph{middle} partial boxes are set to a height which matches the available space. + \item\docValue{last}: The \emph{last} partial box is set to a height which matches + the available space. + \item\docValue{first and middle}: The \emph{first} and + all \emph{middle} partial boxes are set to a height which matches the available space. + \item\docValue{middle and last}: All \emph{middle} partial boxes and the \emph{last} partial box + are set to a height which matches the available space. + \item\docValue{all}: All partial boxes are set to a height which matches the available space. + \end{itemize} +\begin{marker} + If the box keeps unbroken, this option is not applied. + See \refKey{/tcb/height} for setting a fixed height for unbroken boxes. +\end{marker} +\end{docTcbKey} + + +\clearpage +\subsection{Breakable boxes and the \texttt{multicol} package}\label{subsec:multicol} +\begin{multicols}{2} +\begin{tcolorbox}[enhanced jigsaw,size=small,breakable,colback=yellow!10!white, + colframe=red!50!white,break at=3cm,height fixed for=all] +Unbreakable |tcolorbox|es can be used without special care inside a +|multicols| environment from the |multicol| package \cite{mittelbach:2014a}. + +Since version 3.10, a breakable |tcolorbox| detects, if it is used inside +a |multicols| environment. But choosing break points for a breakable box +cannot be done by the balancing routine of |multicols|. By default, boxes +will break at |\textheight|. To get pleasant results, use the +\refKey{/tcb/break at} and \refKey{/tcb/height fixed for} options. +\end{tcolorbox} +\end{multicols} + +\enlargethispage{\baselineskip} +\begin{dispListing} +% \usepackage{lipsum,multicol} % preamble +\small +\begin{multicols}{2} + \lipsum[1] + \begin{tcolorbox}[enhanced jigsaw,breakable,size=title, + colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries, + title=My breakable box,pad at break=1mm, break at=7.5cm/0pt ] + \lipsum[2-4] + \end{tcolorbox} + \lipsum[4] +\end{multicols} +\end{dispListing} +{\tcbusetemp} + +\clearpage + +\begin{multicols}{2} +\small +This example is already set inside a |multicols| environment. +This time, a \emph{middle} part has full |\textheight|. +\refKey{/tcb/height fixed for} is used to spread this box part over the full +height toi align with neighboring columns. +\begin{dispListing} +% \usepackage{lipsum,multicol} +\lipsum[1] +\begin{tcolorbox}[enhanced jigsaw,breakable, + size=title, + colback=red!5!white, + colframe=red!75!black, + fonttitle=\bfseries, + title=My breakable box, + pad at break=2mm, + break at=8.2cm/0pt, + height fixed for=middle ] +\lipsum[2-7] +\end{tcolorbox} +\lipsum[8] +\end{dispListing} +{\tcbusetemp} +\end{multicols} + + +The following example has a |\tcolorbox| which fills the |\multicols| +environment completely. Here, \refKey{/tcb/height fixed for} is used +to give all three columns the full height. +Note that the appropriate \refKey{/tcb/break at} value is not computed +automatically but set manually. + +\begin{dispListing} +% \usepackage{lipsum,multicol} % preamble +\small +\begin{multicols}{3} + \begin{tcolorbox}[enhanced jigsaw,breakable,size=small, + colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries, + title=My breakable box,pad at break=2mm,drop fuzzy shadow, + height fixed for=all, break at=11.4cm ] + \lipsum[1-3] + \end{tcolorbox} +\end{multicols} +\end{dispListing} +{\tcbusetemp} \clearpage @@ -338,8 +524,15 @@ the \emph{break sequence} parts are displayed. \tcbbreakskininto{freelancelast}{freelancemiddle}{freelancemiddle}{freelancelast}{} + + \clearpage \subsection{Break by Hand (Faked Break)} + +\begin{marker} +See \Vref{subsec:multicol} for \emph{real} column breaks. +\end{marker} + Since the appearance of broken boxes is done by skins, it is quite easy to 'fake a break'. For this, you actually don't need the \mylib{breakable} library at 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 1c818f96b02..7b27f9d791f 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -824,6 +824,111 @@ with help of an overlay. \tcbusetemp \end{docTcbKey} +\clearpage +\subsection{Corners}\label{subsec:corners} + +The four corners of any |tcolorbox| can be set individually as +\refKey{/tcb/sharp corners} or as \refKey{/tcb/rounded corners}. +These settings are also reflected in the behavior of \refKey{/tcb/borderline} +and \refKey{/tcb/shadow} as one would expect. + +By default, all four corners are \emph{rounded}. So, only the +\refKey{/tcb/sharp corners} option will be necessary for most use cases. +The \refKey{/tcb/rounded corners} option can be used to revert a \refKey{/tcb/sharp corners} +setting. + +\begin{docTcbKey}{sharp corners}{=\meta{position}}{default |all|, initially unset} +The \meta{position} denotes one or more of the four box corners to be set as +\emph{sharp} corners. The not assigned corners will retain their mode. +Feasible values for \meta{position} are: +\begin{itemize} +\foreach \p in {northwest,northeast,southwest,southeast,north,south,east,west,downhill,uphill,all} +{ +\item\tcbox[on line,size=title,arc=2mm,colframe=red!75!black,colback=red!5!white, + enlarge top by=0.5mm,enlarge bottom by=0.5mm,sharp corners=\p]{\docValue{\p}} +} +\end{itemize} +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[colback=red!5!white, + colframe=red!75!black, + sharp corners=northwest ] +This is a \textbf{tcolorbox}. +\end{tcolorbox} +\end{dispExample*} +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[colback=red!5!white, + colframe=red!75!black, + sharp corners ] +This is a \textbf{tcolorbox}. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + +\clearpage +\begin{docTcbKey}{rounded corners}{=\meta{position}}{default |all|, initially |all|} +The \refKey{/tcb/rounded corners} can be used to revert a \refKey{/tcb/sharp corners} +setting. The \meta{position} denotes one or more of the four box corners to be set as +\emph{rounded} corners. The not assigned corners will retain their mode. +Feasible values for \meta{position} are\footnote{The graphical examples assume + that the boxes where set to have sharp corners before.}: +\begin{itemize} +\foreach \p in {northwest,northeast,southwest,southeast,north,south,east,west,downhill,uphill,all} +{ +\item\tcbox[on line,size=title,arc=2mm,colframe=red!75!black,colback=red!5!white, + enlarge top by=0.5mm,enlarge bottom by=0.5mm,sharp corners,rounded corners=\p]{\docValue{\p}} +} +\end{itemize} +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[colback=red!5!white, + colframe=red!75!black,sharp corners, + rounded corners=northwest ] +This is a \textbf{tcolorbox}. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + +\begin{docTcbKey}{sharpish corners}{}{style, no value} + Shortcut for setting \refKey{/tcb/arc} and \refKey{/tcb/outer arc} + to |0pt|. With this setting, rounded corners will appear als quasi-sharp, + but e.\,g.\ the shadow will be somewhat rounder than the shadow + of really sharp corners. + \begin{marker} + Corners are still of type \emph{rounded} with this option, but appear + \emph{sharp}. To switch back to rounded corners, one has to adapt + \refKey{/tcb/arc} and \refKey{/tcb/outer arc}. + \end{marker} +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[colback=red!5!white, + colframe=red!75!black, + sharpish corners ] +This is a \textbf{tcolorbox}. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + +\clearpage + +The following examples will show the differences between +\refKey{/tcb/rounded corners}, \refKey{/tcb/sharpish corners}, and \refKey{/tcb/sharp corners}. +The later two give the same core box, but \refKey{/tcb/borderline} +and \refKey{/tcb/shadow} settings are slightly different. +The following examples use \refKey{/tcb/drop fuzzy shadow}. + +\foreach \n in {rounded corners,sharpish corners,sharp corners}{ +\begin{tcolorbox}[enhanced jigsaw,frame empty,interior empty,fuzzy halo,center upper] +\begin{tcolorbox}[enhanced,drop fuzzy shadow,width=\linewidth-1cm, + colback=red!5!white, colframe=red!75!black, fonttitle=\bfseries, + title=My title,\n, + tikz={spy using outlines={circle, magnification=8, size=2cm, connect spies}}, + overlay={\spy [blue, size=4cm] on (frame.south east) + in node at ([xshift=-2.5cm,yshift=-2.5cm]frame.south east); + \node[right] at ([xshift=2cm,yshift=-1cm]frame.south west) {\textbf{\Large\ttfamily\n}}; + }] +This is a \textbf{tcolorbox}. +\end{tcolorbox} +\end{tcolorbox}} + \clearpage \subsection{Transparency} 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 c7830b43597..e3eaa60fd02 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex @@ -1229,21 +1229,21 @@ This can be used to apply different effects. Note that the \tikzname\ |line width| option should not be used here.\\ The border lines adapt to the rounded corners of the |tcolorbox|. An inside border line will switch to sharp corners if necessary, an outside border line will - always be rounded if not set to |sharp corners|. + always be rounded except for \refKey{/tcb/sharp corners}. \begin{dispExample} \begin{tcolorbox}[enhanced,title=Rounded corners,fonttitle=\bfseries,boxsep=5pt, arc=8pt, borderline={0.5pt}{0pt}{red}, borderline={0.5pt}{5pt}{blue,dotted}, - borderline={0.5pt}{-5pt}{green,dashed} ] + borderline={0.5pt}{-5pt}{green} ] This is a tcolorbox. \end{tcolorbox} \bigskip \begin{tcolorbox}[enhanced,title=Sharp corners,fonttitle=\bfseries,boxsep=5pt, - arc=0pt,outer arc=0pt, + arc=8pt,sharp corners=downhill, borderline={0.5pt}{0pt}{red}, borderline={0.5pt}{5pt}{blue,dotted}, - borderline={0.5pt}{-5pt}{green,dashed,sharp corners} ] + borderline={0.5pt}{-5pt}{green} ] This is a tcolorbox. \end{tcolorbox} \end{dispExample} @@ -1352,7 +1352,8 @@ used on the same |tcolorbox|. They are drawn \emph{before} the box frame is draw The shadow is filled along a \tikzname\ path with the given \tikzname\ \meta{options}.\\ The shadows adapt to the rounded corners of the |tcolorbox|. An shrinked shadow will switch to sharp corners if necessary, an enlarged shadow may become - more rounded depending on several factors. + more rounded depending on several factors. But \refKey{/tcb/sharp corners} + have sharp shadows. \begin{marker} Shadows are not considered for the bounding box computation by default. Large shadows may be overlaped by the following content. But, the @@ -1784,7 +1785,7 @@ This is a tcolorbox. Optionally, the \meta{color} for the shadow can be changed. \begin{dispExample*}{sbs,lefthand ratio=0.6} \tcbset{enhanced,colback=red!5!white, - boxrule=0.4pt,arc=0pt,outer arc=0pt, + boxrule=0.4pt,sharp corners, colframe=red!75!black,fonttitle=\bfseries} \begin{tcolorbox}[drop lifted shadow] @@ -1803,7 +1804,7 @@ This is a tcolorbox. Optionally, the \meta{color} for the shadow can be changed. \begin{dispExample*}{sbs,lefthand ratio=0.6} \tcbset{enhanced,colback=red!5!white, - boxrule=0.4pt,arc=0pt,outer arc=0pt, + boxrule=0.4pt,sharp corners, colframe=red!75!black,fonttitle=\bfseries} \tcbox[drop small lifted shadow,size=fbox] @@ -2652,6 +2653,11 @@ Of course, skins can be used for listings also. \end{dispExample} \end{docCommand} +\begin{docCommand}{tcbline*}{} + Equivalent to \refCom{tcbline}, but in a breakable box, \refCom{tcbline*} + is removed if at a page/box break. Also, it is removed at the end + of a box. +\end{docCommand} \clearpage \begin{docSkin}{enhancedfirst} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf Binary files differindex 298363bc1a5..734b420dbdc 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex index dfb3185c97b..a9863570323 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex @@ -1,5 +1,5 @@ % \LaTeX-Main\ -%% The LaTeX package tcolorbox - version 3.05 (2014/05/28) +%% The LaTeX package tcolorbox - version 3.10 (2014/07/23) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -55,6 +55,7 @@ \usetikzlibrary{shadings,shadows} \usetikzlibrary{decorations.pathmorphing} \usetikzlibrary{patterns} +\usetikzlibrary{spy} \usepackage{array,tabularx} \usepackage{amsmath} @@ -102,8 +103,8 @@ \newtcolorbox{marker}[1][]{marker,#1} -\def\version{3.05}% -\def\datum{2014/05/28}% +\def\version{3.10}% +\def\datum{2014/07/23}% \makeindex \hypersetup{ @@ -304,7 +305,7 @@ %\tcbset{draftmode} -%\includeonly{tcolorbox.doc.abstract} +%\includeonly{tcolorbox.doc.theorems} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |