diff options
Diffstat (limited to 'Master/texmf-dist/doc')
19 files changed, 276 insertions, 149 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index d48ba782dc8..fd31f14db6e 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 4.32 (2020/09/17) +%% The LaTeX package tcolorbox - version 4.40 (2020/09/25) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2020 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> @@ -1164,3 +1164,20 @@ version 4.32 (2020/09/17) - library 'xparse': * new options (#111): 'IfNoValueT', 'IfNoValueF', 'IfValueT', 'IfValueF', 'IfBooleanT', 'IfBooleanF' + +version 4.40 (2020/09/25) +- bug fix (#114): 'IfBooleanT', 'IfBooleanF' +- bug fix (#117): 'widget' set 'toprule at break' and needed the breakable library +- (bug) fix: style 'marker' set 'breakable' and needed the breakable library +- (#113) 'capture=hbox' applies '\@parboxrestore' now to allow e.g. hbox style + listings inside indented environments like itemize +- (#2) support 'hbox' for 'minted' listings +- (#115) New default vertical space options + 'before skip balanced', 'after skip balanced', 'beforeafter skip balanced' + NOTE: These options replace the current default options + 'parskip', 'noparskip', 'autoparskip' + WARNING: Old documents may need adapted manual page breaks where used. + Otherwise: Use \tcbsetforeverylayer{autoparskip} + to restore the old behavior! +- 'before skip' and 'before skip balanced' do not insert glue now, if + the tcolorbox is the first element in a minipage (or sourrounding tcolorbox) diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index f421faa8ebe..67c4e5df05f 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 4.32 (2020/09/17) +%% The LaTeX package tcolorbox - version 4.40 (2020/09/25) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2020 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf Binary files differindex 2f8c59debeb..6cdb9974d89 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex index 74eb419478e..9db17546efe 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 4.32 (2020/09/17) +%% The LaTeX package tcolorbox - version 4.40 (2020/09/25) %% tcolorbox-example-poster.tex: a poster example for tcolorbox %% %% ------------------------------------------------------------------------------------------- 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 b623da16766..c5eb25044cf 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 3a626698726..8a119c74483 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 4.32 (2020/09/17) +%% The LaTeX package tcolorbox - version 4.40 (2020/09/25) %% tcolorbox-example.tex: an example for tcolorbox %% %% ------------------------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf Binary files differindex 837d8ba475d..6cec00a3aff 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex index a84d7045907..ab9b50b3698 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex @@ -1,5 +1,5 @@ % \LaTeX-Main\ -%% The LaTeX package tcolorbox - version 4.32 (2020/09/17) +%% The LaTeX package tcolorbox - version 4.40 (2020/09/25) %% tcolorbox-tutorial-poster.tex: a tutorial for poster creation with tcolorbox %% %% ------------------------------------------------------------------------------------------- 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 c714bfd4450..b8d678d8d2d 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex @@ -128,7 +128,7 @@ parameters. The differences are: \refKey{/tcb/before} and \refKey{/tcb/after} settings, especially, if there is an automatic page break before the box. \item\tcbdocmarginnote{\tcbdocnew{2016-05-25}} - Lua\TeX\ version 0.95 changes the behaviour of the basic |\vsplit| (a bug?!) + Lua\TeX\ version 0.95 changes the behavior of the basic |\vsplit| (a bug?!) resulting in badly broken boxes. Thanks to Jeremy Engel, the \mylib{breakable} library contains a patch for this which also loads the the |ifluatex| package. 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 ba853c46e38..d885f482793 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -240,8 +240,6 @@ and an optional \emph{lower part}. These parts are separated by This is a \textbf{tcolorbox} (but invisible). \end{tcolorbox} -\bigskip - \begin{tcolorbox}[upperbox=invisible,colback=white] This is a \textbf{tcolorbox} (but invisible). \tcblower @@ -426,6 +424,8 @@ Now, the saved part is used: \end{tcolorbox} \end{exdispExample} +\enlargethispage*{1cm} + The |savedelimiter| is used implicitely with \refCom{newtcolorbox} which allows a more convenient usage: \begin{exdispExample}{savedelimiter2} @@ -2805,52 +2805,34 @@ are drawn by the codes given with \subsection{Embedding into the Surroundings}\label{subsec:surroundings} Typically, but not necessarily, a |tcolorbox| is put inside a separate paragraph and has some vertical space before and after it. -This behavior is controlled by the keys |before| and |after|. +This behavior is controlled by the keys \refKey{/tcb/before} and \refKey{/tcb/after}. + +\begin{marker} +Before version 4.40, the default setting for \refKey{/tcb/before} +and \refKey{/tcb/after} was given by \refKey{/tcb/autoparskip}. +Starting with version 4.40, the default setting is given by +\refKey{/tcb/before skip balanced} and \refKey{/tcb/after skip balanced}.\par +Note that old documents may need adaptions of page breaks.\par +Alternatively, the old default setting can be restored by using +\begin{dispListing} +\tcbsetforeverylayer{autoparskip} +\end{dispListing} +inside the document preamble. +\end{marker} -\begin{docTcbKey}{before}{=\meta{code}}{no default, initially see \refKey{/tcb/autoparskip}} + +\begin{docTcbKey}{before}{=\meta{code}}{no default, initially see \refKey{/tcb/before skip balanced}} Sets the \meta{code} which is executed before the colored box. It is not used for floating boxes. Also, it is not used, if the box follows a heading immediately and \refKey{/tcb/ignore nobreak} is set to \docValue{false}. \end{docTcbKey} -\begin{docTcbKey}{after}{=\meta{code}}{no default, initially see \refKey{/tcb/autoparskip}} +\begin{docTcbKey}{after}{=\meta{code}}{no default, initially see \refKey{/tcb/after skip balanced}} Sets the \meta{code} which is executed after the colored box. It is not used for floating boxes. \end{docTcbKey} -\begin{docTcbKey}[][doc updated=2017-02-01]{parskip}{}{style, no value} - Sets the keys |before| and |after| to values which are - recommended, if the package |parskip| \emph{is} used and there is no better - idea for |before| and |after|. This is similar to: -\begin{dispListing} -\tcbset{parskip/.style={before={\par\pagebreak[0]\parindent=0pt}, - after={\par}}} -\end{dispListing} -\end{docTcbKey} - -\begin{docTcbKey}[][doc updated=2017-02-01]{noparskip}{}{style, no value} - Sets the keys |before| and |after| to values which are - recommended, if the package |parskip| is \emph{not} used and there is no better - idea for |before| and |after|. This is similar to: -\begin{dispListing} -\tcbset{noparskip/.style={before={\par\pagebreak[0]\smallskip\parindent=0pt}, - after={\par\smallskip}}} -\end{dispListing} -\end{docTcbKey} - -\begin{docTcbKey}{autoparskip}{}{style, no value, initially set} - Tries to detect the usage of the package |parskip| and sets - the keys |before| and |after| accordingly. Actually, the following is done: - \begin{itemize} - \item If the length of |\parskip| is greater than |0pt| at the beginning of the document, - \refKey{/tcb/parskip} is executed. Here, the usage of package |parskip| is \emph{assumed}. - \item Otherwise, if the length of |\parskip| is not greater than |0pt| at the beginning of the document, - \refKey{/tcb/noparskip} is executed. Here, the absence of package |parskip| is \emph{assumed}. - \end{itemize} - |autoparskip| is the default for the package |tcolorbox|, if |before| or |after| - are not changed otherwise. -\end{docTcbKey} \begin{docTcbKey}{nobeforeafter}{}{style, no value} Abbreviation for clearing the keys |before| and |after|. The colored box @@ -2865,7 +2847,6 @@ This behavior is controlled by the keys |before| and |after|. \end{exdispExample} \end{docTcbKey} -\enlargethispage*{1cm} \begin{docTcbKey}{force nobeforeafter}{}{style, no value} Forces the setting of \refKey{/tcb/nobeforeafter} even if \refKey{/tcb/before} and \refKey{/tcb/after} are set to other values @@ -2876,78 +2857,80 @@ This behavior is controlled by the keys |before| and |after|. \clearpage -\begin{docTcbKey}{baseline}{=\meta{length}}{no default, initially |0pt|} - Used to set the |\pgfsetbaseline| value of the resulting |tcolorbox|. -\begin{exdispExample}{baseline} -\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} -Some text\dotfill -\begin{tcolorbox}[baseline=3mm] -One line. -\end{tcolorbox} -\begin{tcolorbox}[baseline=3mm] -First line.\\Second line. +\begin{docTcbKey}[][doc new={2020-09-25}]{before skip balanced}{=\meta{glue}}{no default, initially |0.5\textbackslash baselineskip plus 2pt|} + Inserts some vertical space before the colored box. This style sets \refKey{/tcb/before}.\par + If the depth of the + preceeding \TeX\ box is between |0pt| and |0.3\baselineskip|, + the distance between the \emph{baseline} of the preceeding \TeX\ box and the tcolorbox + ist set to \meta{glue}$+$|0.3\baselineskip|.\par + If the depth is larger, the distance of the preceeding \TeX\ box and the tcolorbox + ist set to \meta{glue}.\par + Alternatively, see \refKey{/tcb/before skip} which ignores the \emph{baseline}. + +\begin{exdispExample*}{before_skip_balanced}{sbs,lefthand ratio=0.6} +Some text. +\begin{tcolorbox}[before skip balanced=1cm, + colframe=red!50!white] + This is a \textbf{tcolorbox}. \end{tcolorbox} -\end{exdispExample} +\end{exdispExample*} \end{docTcbKey} +\begin{docTcbKey}[][doc new={2020-09-25}]{after skip balanced}{=\meta{glue}}{no default, initially |0.5\textbackslash baselineskip plus 2pt|} + Inserts some vertical space of the given \meta{glue} after the colored box. + This style sets \refKey{/tcb/after}. + Additionally, |\prevdepth| is set to |0.3\baselineskip|. The following + \TeX\ box may enlarge the space by further glue to adjust its \emph{baseline}. + Alternatively, see \refKey{/tcb/after skip} which ignores the \emph{baseline}. -\begin{docTcbKey}[][doc new=2014-10-10]{box align}{=\meta{alignment}}{style, no default, initially |bottom|} - Used to set the \refKey{/tcb/baseline} value of the resulting |tcolorbox|. - Feasible values for \meta{alignment} are: - \begin{itemize} - \item\docValue{bottom}: alignment with the box bottom, - \item\docValue{top}: alignment with the box top, - \item\docValue{center}: alignment with the box center, - \item\docValue{base}: alignment with the box content base. This option - is not applicable for a \refEnv{tcolorbox} but for a \refCom{tcbox} only. - It is an alias for \refKey{/tcb/tcbox raise base}. - \end{itemize} - -\begin{exdispExample}{box_align_1} -\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} -Some text\dotfill -\begin{tcolorbox}[box align=bottom] -One line. -\end{tcolorbox} -\begin{tcolorbox}[box align=bottom] -First line.\\Second line. -\end{tcolorbox} -\end{exdispExample} - -\begin{exdispExample}{box_align_2} -\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} -Some text\dotfill -\begin{tcolorbox}[box align=top] -One line. -\end{tcolorbox} -\begin{tcolorbox}[box align=top] -First line.\\Second line. +\begin{exdispExample*}{after_skip_balanced}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[after skip balanced=1cm, + colframe=red!50!white] + This is a \textbf{tcolorbox}. \end{tcolorbox} -\end{exdispExample} +Some text. +\end{exdispExample*} +\end{docTcbKey} -\begin{exdispExample}{box_align_3} -\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} -Some text\dotfill -\begin{tcolorbox}[box align=center] -One line. -\end{tcolorbox} -\begin{tcolorbox}[box align=center] -First line.\\Second line. -\end{tcolorbox} -\end{exdispExample} -\begin{exdispExample}{box_align_4} -\tcbset{colframe=red!50!white,nobeforeafter} -Some text\dotfill -\tcbox[nobeforeafter,box align=base]{One line} -\tcbox[nobeforeafter,box align=base,size=fbox]{Another line} -\end{exdispExample} +\begin{docTcbKey}[][doc new={2020-09-25}]{beforeafter skip balanced}{=\meta{glue}}{no default, initially |0.5\textbackslash baselineskip plus 2pt|} + Inserts some vertical space of the given \meta{glue} before \emph{and} after the colored box. + This style sets \refKey{/tcb/before skip balanced} and \refKey{/tcb/after skip balanced}. +\begin{exdispExample*}{beforeafter_skip_balanced}{sbs,lefthand ratio=0.6} +\newtcolorbox{doubleline}[1][]{ + beforeafter skip balanced=0pt, + height=1.8\baselineskip, + enlarge top by=.1\baselineskip, + enlarge bottom by=.1\baselineskip, + colframe=blue!20,colback=blue!5, + size=small,valign upper=center,#1 } + +\noindent\begin{tikzpicture} +\path[use as bounding box] (0,0) + rectangle (0.1,0.1); +\foreach \y in {0,1,...,9} { + \draw[very thin,red] + (-0.2,-\y*\baselineskip) -- + (\linewidth+0.2cm,-\y*\baselineskip); } +\end{tikzpicture} +line 1\par +\begin{doubleline} Abc \end{doubleline} +\begin{doubleline} Def \end{doubleline} +line 2g\par +\begin{doubleline} Ghi \end{doubleline} +line 3\par +line 4 g +\end{exdispExample*} \end{docTcbKey} -\begin{docTcbKey}[][doc new and updated={2014-10-10}{2015-03-16}]{before skip}{=\meta{glue}}{style, no default} +\clearpage + +\begin{docTcbKey}[][doc new and updated={2020-09-25}{2015-03-16}]{before skip}{=\meta{glue}}{style, no default} Inserts some vertical space of the given \meta{glue} before the colored box. This style sets \refKey{/tcb/before}. + In contrast to \refKey{/tcb/before skip balanced}, this \meta{glue} is + relative to the lower edge of the preceeding box and not to the baseline. \begin{exdispExample*}{before_skip}{sbs,lefthand ratio=0.6} Some text. \begin{tcolorbox}[before skip=1cm, @@ -2957,9 +2940,11 @@ Some text. \end{exdispExample*} \end{docTcbKey} -\begin{docTcbKey}[][doc new and updated={2014-10-10}{2017-02-01}]{after skip}{=\meta{glue}}{style, no default} +\begin{docTcbKey}[][doc new and updated={2020-09-25}{2017-02-01}]{after skip}{=\meta{glue}}{style, no default} Inserts some vertical space of the given \meta{glue} after the colored box. This style sets \refKey{/tcb/after}. + In contrast to \refKey{/tcb/after skip balanced}, this \meta{glue} is + relative to the upper edge of the following box and not to the baseline. \begin{exdispExample*}{after_skip}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[after skip=1cm, colframe=red!50!white] @@ -2971,19 +2956,23 @@ Some text. \begin{docTcbKey}[][doc new=2014-10-10]{beforeafter skip}{=\meta{glue}}{style, no default} Inserts some vertical space of the given \meta{glue} before \emph{and} after the colored box. - This style sets \refKey{/tcb/before} and \refKey{/tcb/after}. + This style sets \refKey{/tcb/before skip} and \refKey{/tcb/after skip}. \begin{exdispExample*}{beforeafter_skip}{sbs,lefthand ratio=0.6} \tcbset{beforeafter skip=0pt, colframe=red!50!white} + +text before \begin{tcolorbox} This is a \textbf{tcolorbox}. \end{tcolorbox} \begin{tcolorbox} Second box. \end{tcolorbox} +text after \end{exdispExample*} \end{docTcbKey} + \clearpage \begin{docTcbKey}[][doc new=2014-11-07]{left skip}{=\meta{length}}{style, no default, initially |0mm|} @@ -3028,6 +3017,122 @@ Some text. \end{docTcbKey} +\clearpage + +\begin{docTcbKey}[][doc updated=2017-02-01]{parskip}{}{style, no value} + This options is considered to be superseded by + \refKey{/tcb/before skip balanced} and \refKey{/tcb/after skip balanced} + (see note on page~\pageref{subsec:surroundings}).\par + Sets the keys |before| and |after| to values which are + recommended, if the package |parskip| \emph{is} used and there is no better + idea for |before| and |after|. This is similar to: +\begin{dispListing} +\tcbset{parskip/.style={before={\par\pagebreak[0]\parindent=0pt}, + after={\par}}} +\end{dispListing} +\end{docTcbKey} + +\begin{docTcbKey}[][doc updated=2017-02-01]{noparskip}{}{style, no value} + This options is considered to be superseded by + \refKey{/tcb/before skip balanced} and \refKey{/tcb/after skip balanced} + (see note on page~\pageref{subsec:surroundings}).\par + Sets the keys |before| and |after| to values which are + recommended, if the package |parskip| is \emph{not} used and there is no better + idea for |before| and |after|. This is similar to: +\begin{dispListing} +\tcbset{noparskip/.style={before={\par\pagebreak[0]\smallskip\parindent=0pt}, + after={\par\smallskip}}} +\end{dispListing} +\end{docTcbKey} + +\begin{docTcbKey}{autoparskip}{}{style, no value} + This options is considered to be superseded by + \refKey{/tcb/before skip balanced} and \refKey{/tcb/after skip balanced} + (see note on page~\pageref{subsec:surroundings}).\par + Tries to detect the usage of the package |parskip| and sets + the keys |before| and |after| accordingly. Actually, the following is done: + \begin{itemize} + \item If the length of |\parskip| is greater than |0pt| at the beginning of the document, + \refKey{/tcb/parskip} is executed. Here, the usage of package |parskip| is \emph{assumed}. + \item Otherwise, if the length of |\parskip| is not greater than |0pt| at the beginning of the document, + \refKey{/tcb/noparskip} is executed. Here, the absence of package |parskip| is \emph{assumed}. + \end{itemize} +\end{docTcbKey} + + +\clearpage + +\begin{docTcbKey}{baseline}{=\meta{length}}{no default, initially |0pt|} + Used to set the |\pgfsetbaseline| value of the resulting |tcolorbox|. +\begin{exdispExample}{baseline} +\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} +Some text\dotfill +\begin{tcolorbox}[baseline=3mm] +One line. +\end{tcolorbox} +\begin{tcolorbox}[baseline=3mm] +First line.\\Second line. +\end{tcolorbox} +\end{exdispExample} +\end{docTcbKey} + + +\begin{docTcbKey}[][doc new=2014-10-10]{box align}{=\meta{alignment}}{style, no default, initially |bottom|} + Used to set the \refKey{/tcb/baseline} value of the resulting |tcolorbox|. + Feasible values for \meta{alignment} are: + \begin{itemize} + \item\docValue{bottom}: alignment with the box bottom, + \item\docValue{top}: alignment with the box top, + \item\docValue{center}: alignment with the box center, + \item\docValue{base}: alignment with the box content base. This option + is not applicable for a \refEnv{tcolorbox} but for a \refCom{tcbox} only. + It is an alias for \refKey{/tcb/tcbox raise base}. + \end{itemize} + +\begin{exdispExample}{box_align_1} +\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} +Some text\dotfill +\begin{tcolorbox}[box align=bottom] +One line. +\end{tcolorbox} +\begin{tcolorbox}[box align=bottom] +First line.\\Second line. +\end{tcolorbox} +\end{exdispExample} + +\begin{exdispExample}{box_align_2} +\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} +Some text\dotfill +\begin{tcolorbox}[box align=top] +One line. +\end{tcolorbox} +\begin{tcolorbox}[box align=top] +First line.\\Second line. +\end{tcolorbox} +\end{exdispExample} + +\begin{exdispExample}{box_align_3} +\tcbset{colframe=red!50!white,width=4cm,nobeforeafter} +Some text\dotfill +\begin{tcolorbox}[box align=center] +One line. +\end{tcolorbox} +\begin{tcolorbox}[box align=center] +First line.\\Second line. +\end{tcolorbox} +\end{exdispExample} + +\begin{exdispExample}{box_align_4} +\tcbset{colframe=red!50!white,nobeforeafter} +Some text\dotfill +\tcbox[nobeforeafter,box align=base]{One line} +\tcbox[nobeforeafter,box align=base,size=fbox]{Another line} +\end{exdispExample} +\end{docTcbKey} + + + + \begin{docTcbKey}[][doc new=2014-12-11]{ignore nobreak}{\colOpt{=true\textbar false}}{default |true|, initially |false|} After a heading, \LaTeX\ tries to avoid a break by setting a |nobreak| boolean value. Starting from version |3.33|, the \refKey{/tcb/before} respectively \refKey{/tcb/before skip} @@ -3048,7 +3153,6 @@ enforce the \refKey{/tcb/before} setting. the box follows a heading. \end{docTcbKey} -\enlargethispage*{1cm} \begin{docTcbKey}[][doc new=2017-02-23]{parfillskip restore}{\colOpt{=true\textbar false}}{default |true|, initially |true|} If this option is set to be |true|, the minimum value of |\parfillskip| is 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 9c2cfe8f6d8..3f301b0033c 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex @@ -1279,6 +1279,8 @@ instead. Also see \refKey{/tcb/docexample}. \end{deprecated} \end{docTcbKey} +\enlargethispage*{1cm} + \begin{docTcbKey}{after example}{=\meta{macros}}{no default, initially empty} \smallskip\begin{deprecated} Sets the \meta{macros} which are executed after \refEnv{dispExample} and \refEnv{dispListing} @@ -1363,6 +1365,7 @@ instead. Also see \refKey{/tcb/docexample}. \refKey{/tcb/index level}. \end{docTcbKey} +\enlargethispage*{1cm} \begin{docTcbKey}{index german settings}{}{style, no value} Sets the |makeindex| values recommended for German language texts. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex index c91bc1bb19e..7b207b6255c 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex @@ -45,6 +45,7 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk \end{dispExample*} \end{docTikzKey} +\enlargethispage*{1cm} \begin{docTikzKey}{fill plain picture}{=\meta{graphical code}}{no default, initially unset} Fills the current path with the given \meta{graphical code}. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty index 32e77fc9f0b..e9379a6fdd4 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty @@ -138,7 +138,7 @@ \newtcolorbox{marker}[1][]{enhanced, - before skip=2mm,after skip=3mm, + before skip balanced=2mm,after skip balanced=3mm, boxrule=0.4pt,left=5mm,right=2mm,top=1mm,bottom=1mm, colback=yellow!50, colframe=yellow!20!black, @@ -244,8 +244,8 @@ docexample/.style={docexample original},% }, beforeafter example/.style={ - before skip=4pt plus 2pt minus 1pt, - after skip=8pt plus 4pt minus 2pt + before skip balanced=4pt plus 2pt minus 1pt, + after skip balanced=5pt plus 2pt minus 1pt }, base example/.style={bicolor, beforeafter example,arc is angular,fonttitle=\bfseries, @@ -272,7 +272,9 @@ base example,coltitle=black,fonttitle=\itshape,titlerule=0pt, colbacktitle=Navy!15!ExampleBack, top=0mm, - before=\par\smallskip,% + %before=\par\smallskip,% + before skip balanced=4pt plus 2pt minus 1pt, + after skip balanced=5pt plus 2pt minus 1pt, listing style=mydocumentation, listing only,listing file={\jobname_preamble_#1.tex}}% } 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 646d4229aea..32b395673d1 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex @@ -472,6 +472,8 @@ the bottom left corner of the main box. \end{exdispExample*} \end{docTcbKey} +\enlargethispage*{1cm} + \begin{docTcbKey}{attach boxed title to bottom center}{\colOpt{=\marg{boxtitle options}}}{style, default empty} The title is boxed with a \refCom{tcbox} and attached to the bottom of the main box. @@ -1168,7 +1170,8 @@ This example uses a public domain picture from\\ \end{dispExample} \end{docTcbKey} -\enlargethispage{5mm} +\enlargethispage*{1cm} + \begin{docTcbKey}{watermark zoom}{=\meta{fraction}}{no default, initially |0.75|} Sets the zoom value for a watermark. The zoom respects the aspect ratio. The value $1.0$ means to fill the whole box until the watermark touches the frame. @@ -3688,7 +3691,7 @@ Nevertheless, this skin can be applied independently. as seen in the third line.}} git commit git commit -a -git commit -am `changes to my example' +git commit -am 'changes to my example' \end{tcblisting} \end{dispExample} @@ -3847,9 +3850,10 @@ Nevertheless, this skin can be applied independently. \end{tcolorbox} \end{docSkin} -\begin{docTcbKey}[][doc new=2016-02-25]{tile}{}{style, no value} - This is an abbreviation for setting |skin=tile|. - \begin{marker}It also changes the geometry and some style options.\end{marker} +\begin{docTcbKey}[][doc new=2016-02-25]{tile}{}{style, initially\\ + |skin=tile,boxrule=0pt,sharp corners,title filled,fonttitle=\textbackslash bfseries| +} + This key applies |skin=tile| and in addition changes the geometry and some style options. \end{docTcbKey} @@ -4016,11 +4020,7 @@ Nevertheless, this skin can be applied independently. \begin{docSkin}{beamer} This skin resembles boxes known from the |beamer| class and therefore is called \enquote{beamer}. It uses the normal colors from the core package but shades - them a little bit. To use this skin, the |tikz| library |shadings| - has to be included in the preamble by: -\begin{dispListing} -\usetikzlibrary{shadings} -\end{dispListing} + them a little bit. \begin{tcolorbox}[skintable=beamer] \begin{tabbing} \refKey{/tcb/interior titled engine}: \=\kill @@ -4036,9 +4036,11 @@ Nevertheless, this skin can be applied independently. -\begin{docTcbKey}{beamer}{}{style, no value} - This is an abbreviation for setting |skin=beamer|. - \begin{marker}It also changes the geometry and some style options.\end{marker} +\begin{docTcbKey}{beamer}{}{style, initially\\ + |skin=beamer,boxrule=0mm,titlerule=1mm,toptitle=0.5mm,|\\ + |arc=2mm,fonttitle=\textbackslash bfseries,drop fuzzy shadow| +} + This key applies |skin=beamer| and in addition changes the geometry and some style options. \end{docTcbKey} @@ -4230,14 +4232,10 @@ Nevertheless, this skin can be applied independently. \subsection{Skin Family \enquote{widget}} \begin{docSkin}{widget} This skin uses the normal colors from the core package but shades - them a little bit. To use this skin, the |tikz| library |shadings| - has to be included in the preamble by: -\begin{dispListing} -\usetikzlibrary{shadings} -\end{dispListing} -The appearance of the skin can be controlled by \refKey{/tcb/frame style}, -\refKey{/tcb/interior style}, and \refKey{/tcb/segmentation style}, -if needed. + them a little bit. + The appearance of the skin can be controlled by \refKey{/tcb/frame style}, + \refKey{/tcb/interior style}, and \refKey{/tcb/segmentation style}, + if needed. \begin{tcolorbox}[skintable=widget] \begin{tabbing} \refKey{/tcb/interior titled engine}: \=\kill @@ -4252,12 +4250,14 @@ if needed. \end{docSkin} -\begin{docTcbKey}{widget}{}{style, no value} - This is an abbreviation for setting |skin=widget|. - \begin{marker}It also changes the geometry and some style options.\end{marker} +\begin{docTcbKey}[][doc updated={2020-09-23}]{widget}{}{style, initially\\ + |skin=widget,arc=0.5mm,fonttitle=\bfseries,titlerule=0mm| +} + This key applies |skin=widget| and in addition changes the geometry and some style options. \end{docTcbKey} + \begin{dispExample} \begin{tcbraster}[widget,raster equal height,raster columns=4, colback=LightGreen,colframe=DarkGreen, @@ -4289,7 +4289,7 @@ This is my content. \end{tcolorbox} \end{dispExample} - +\clearpage \begin{docSkin}{widgetfirst} This is a flavor of \refSkin{widget} which is used as a \emph{first} part diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex index 2d637f4678a..21e8153de40 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex @@ -30,7 +30,7 @@ option from the core package has to be set. \begin{tcolorbox}[adjusted title=My title] This is my content. \end{tcolorbox} -\begin{tcolorbox}[skin=beamer,beamer,adjusted title=My title] +\begin{tcolorbox}[beamer,adjusted title=My title] This is my content. \end{tcolorbox} \end{dispExample} 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 672ff20421d..2d316a3379e 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex @@ -593,7 +593,7 @@ created by hand or using \refCom{tcbmaketheorem} or using its successor of the lower part. \end{docTcbKey} -\enlargethispage*{1cm} +\enlargethispage*{2cm} \begin{docTcbKey}[][doc updated=2014-10-30]{ams equation*}{}{style, no value} Adds an |amsmath| |equation*| environment to the start and end of the upper \emph{and} lower part. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex index bad6fd6a60e..752b5b35ad0 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex @@ -124,7 +124,7 @@ This is a tcolorbox. } } Wraps the |\IfBoolean(TF)| command(s) of |xparse| for option setting. - If the \meta{argument} is |\BooleanTue|, the \meta{true options} are set. + If the \meta{argument} is |\BooleanTrue|, the \meta{true options} are set. If the \meta{argument} is |\BooleanFalse|, the \meta{false options} are set. \begin{dispExample} @@ -163,7 +163,7 @@ This is a tcolorbox. \DeclareTColorBox[use counter from=pabox]{mybox}{ O{red} m d"" !O{} } {enhanced,colframe=#1!75!black,colback=#1!5!white, fonttitle=\bfseries,title={\thetcbcounter~#2}, - IfValueTF={#3}{watermark text={#3}}{},#4} + IfValueT={#3}{watermark text={#3}},#4} \begin{mybox}{My title} This is a tcolorbox. @@ -271,8 +271,8 @@ This is a tcolorbox. \DeclareTCBox[use counter from=pabox]{\mybox}{ s m s } { nobeforeafter,colback=red!5!white,colframe=red!75!black, title={#2 (Box \thetcbcounter)},fonttitle=\bfseries, - IfBooleanTF={#1}{enhanced,drop shadow}{}, - IfBooleanTF={#3}{colbacktitle=red!50!white}{} } + IfBooleanT={#1}{enhanced,drop shadow}, + IfBooleanT={#3}{colbacktitle=red!50!white} } \mybox{Bird}{This is my first box.} \hfill @@ -339,7 +339,7 @@ typeset the verbatim content. % \usepackage{listings} or \tcbuselibrary{listings} \DeclareTotalTCBox{\commandbox}{ s v } {verbatim,colupper=white,colback=black!75!white,colframe=black} -{\IfBooleanTF{#1}{\textcolor{red}{\ttfamily\bfseries > }}{}% +{\IfBooleanT{#1}{\textcolor{red}{\ttfamily\bfseries > }}% \lstinline[language=command.com,keywordstyle=\color{blue!35!white}\bfseries]^#2^} \commandbox*{cd "My Documents"} changes to directory \commandbox{My Documents}. @@ -459,7 +459,7 @@ With date of 2018-05-12, the |xparse| \cite{latexproject:xparse} package changed the argument collection process. Now, spaces are ignored which leads to a serious change for listing environments ending with an optional argument like \verb+O{}+. -The former behaviour of respecting spaces can be preserved by adding a \flqq\verb+!+\frqq. +The former behavior of respecting spaces can be preserved by adding a \flqq\verb+!+\frqq. Note that the following code uses \verb+!O{}+ now. \begin{itemize} \item For older |xparse| versions, the following code is correct when using \verb+O{}+. @@ -570,7 +570,7 @@ The following commands need the \mylib{fitting} library to be included. {colback=red!5!white, colframe=red!75!black, width=#2,height=#2/3*2, - IfValueTF={#3}{height=#3}{}, + IfValueT={#3}{height=#3}, #1} \mybox[colback=yellow]{5cm}% diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf Binary files differindex ef1068931f8..015a9bd9266 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 2b2a2d9102a..0aebc2ca474 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 4.32 (2020/09/17) +%% The LaTeX package tcolorbox - version 4.40 (2020/09/25) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -43,8 +43,8 @@ \setlength{\bibitemsep}{\smallskipamount} \addbibresource{tcolorbox.doc.bib} -\def\version{4.32}% -\def\datum{2020/09/17}% +\def\version{4.40}% +\def\datum{2020/09/25}% \makeindex \hypersetup{ @@ -62,7 +62,7 @@ %\geometry{showframe} %\tcbset{draftmode} \tcbset{/tcb/external/-}% for final run -%\includeonly{tcolorbox.doc.breakable} +%\includeonly{tcolorbox.doc.intro,tcolorbox.doc.quickref,tcolorbox.doc.coremacros} %\hypersetup{colorlinks=false} |