diff options
author | Karl Berry <karl@freefriends.org> | 2017-04-25 22:30:39 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-04-25 22:30:39 +0000 |
commit | 9741d3a7175522e2552f723f0b90859d92af3991 (patch) | |
tree | 50bed5383f6af14bea61dac0551e780ffafdd63f /Master/texmf-dist/doc/latex | |
parent | 680e000f5a53e51965eb20aab3f3db3a020bac69 (diff) |
tcolorbox (25apr17)
git-svn-id: svn://tug.org/texlive/trunk@44046 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 14 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/README | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf | bin | 457620 -> 457620 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex | 15 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex | 33 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex | 64 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex | 22 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | bin | 6208618 -> 6318038 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 8 |
11 files changed, 148 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index 5ed38de8de0..47bcee9733d 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.02 (2017/02/24) +%% The LaTeX package tcolorbox - version 4.03 (2017/04/25) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2017 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> @@ -982,4 +982,14 @@ version 4.02 (2017/02/24) - bug fix: '/tcb/external/!' and '/tcb/external/-' were not usable inside \tcbset - documentation optimizations - +version 4.03 (2017/04/25) +- Implementation of 'raster equal height' changed to be more robust e.g. for loops +- Implementation of several fill options like 'fill stretch image' changed + to be more efficient and to be independent from TikZ node positioning options. +- Bug fix: 'fill plain image' and 'fill plain picture' ignored 'fill image opacity'. +- new macro: '\tcbsegmentstate' +- library 'breakable': + * new option: 'segmentation at break' +- library 'documentation': + * new options: 'documentation minted language', 'keywords bold' +- Creation of leaflets documented diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index 4907cd8e363..0906411d94f 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.02 (2017/02/24) +%% The LaTeX package tcolorbox - version 4.03 (2017/04/25) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2017 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.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf Binary files differindex e67688abc10..b547040c107 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 089344ebedb..9102e9f65ed 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.02 (2017/02/24) +%% The LaTeX package tcolorbox - version 4.03 (2017/04/25) %% tcolorbox-example.tex: an example for 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 3c285d7c411..0f510f40aca 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex @@ -425,6 +425,21 @@ and \refKey{/tcb/enlarge bottom at break by}. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2017-03-20]{segmentation at break}{\colOpt{=true\textbar false}}{default |true|, initially |true|} + If a breakable box contains an \emph{upper part} and a \emph{lower part} and + the break happens at the \emph{segmentation} between both parts, then + \begin{itemize} + \item the segmenation line (or similar) is drawn as first element of the + partial box containing the \emph{lower part}, if \refKey{/tcb/segmentation at break} + is set to be |true|. + \item the segmenation line (or similar) is not drawn at all, if + \refKey{/tcb/segmentation at break} is set to be |false|. + This may be preferable for skins like \refSkin{bicolor}, \refSkin{tile}, + or \refSkin{beamer}. + \end{itemize} +\end{docTcbKey} + + \clearpage \subsection{Extra Options for Partial Boxes}\label{subsec:extras} 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 1f1495eedef..44e806d8f07 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex @@ -512,6 +512,14 @@ with another note. Used for \refKey{/tcb/listing engine}|=listings| only. \end{docTcbKey} +\begin{docTcbKey}{documentation minted options}{=\meta{minted style}}{no default,\\\hspace*{\fill} initially |tabsize=2,fontsize=\textbackslash small|} + Sets the options from the package |minted| \cite{poore:2015a} + which are used during typesetting of the listing, if used. + Note that this is not identical to the key + \refKey{/tcb/minted options} which is used for 'normal' listings.\\ + Used for \refKey{/tcb/listing engine}|=minted| only. +\end{docTcbKey} + \begin{docTcbKey}{documentation minted style}{=\meta{key list}}{no default, initially unset} Sets a \meta{style} known to |Pygments| \cite{pygments:2013} for the package |minted| \cite{poore:2015a}, if used. @@ -520,14 +528,15 @@ with another note. Used for \refKey{/tcb/listing engine}|=minted| only. \end{docTcbKey} -\begin{docTcbKey}{documentation minted options}{=\meta{minted style}}{no default,\\\hspace*{\fill} initially |tabsize=2,fontsize=\textbackslash small|} - Sets the options from the package |minted| \cite{poore:2015a} - which are used during typesetting of the listing, if used. +\begin{docTcbKey}[][doc new=2017-04-24]{documentation minted language}{=\meta{programming language}}{no default, initially |latex|} + Sets a \meta{programming language} known to |Pygments| \cite{pygments:2013} + for the package |minted| \cite{poore:2015a}, if used. Note that this is not identical to the key - \refKey{/tcb/minted options} which is used for 'normal' listings.\\ + \refKey{/tcb/minted language} which is used for 'normal' listings.\\ Used for \refKey{/tcb/listing engine}|=minted| only. \end{docTcbKey} + \begin{marker} The following two keys are deprecated and without function (v3.50 and above). Use \refKey{/tcb/before} and \refKey{/tcb/after} with appropriate values @@ -549,6 +558,22 @@ instead. Also see \refKey{/tcb/docexample}. \end{docTcbKey} \clearpage +\begin{docTcbKey}[][doc new=2017-04-25]{keywords bold}{\colOpt{=true\textbar false}}{default |true|, initially |true|} + Keyword used in \refEnv{docEnvironment}, \refEnv{docCommand}, etc. are printed + boldface (or not). Since the typewriter font is used, the effect may be + invisible with Computer Modern fonts or similar which do not + have a bold variant. Note that references to keywords are not printed boldface at all. +\begin{dispExample*}{sidebyside} +\LARGE +\docAuxCommand{fooaux}, \refCom{tcbset} + +\tcbset{keywords bold=false} +\docAuxCommand{fooaux}, \refCom{tcbset} +\end{dispExample*} +\end{docTcbKey} + + + \begin{docTcbKey}[][doc new=2015-01-09]{index command}{=\meta{macro}}{no default, initially \cs{index}} Replaces the internally used \cs{index} macro by the given \meta{macro}. The \meta{macro} has to take one mandatory argument like \cs{index}. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex index a7ad64842fd..433214c07fa 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex @@ -432,6 +432,68 @@ Box width: \the\wd\mybox \end{exdispExample} \end{docCommand} - +\clearpage +\subsection{Leaflet Example} +The following full application example can be used to create leaflets. +Obviously, the code can be adapted and customized in many ways. + +\begin{tcblisting}{ + enhanced jigsaw,lower separated=false,breakable, + listing style=mydocumentation,base example, + listing and comment, + pdf comment,freeze pdf, + comment style={raster columns=1}, + compilable listing, + run pdflatex} +\documentclass[a4paper,landscape]{article} +\usepackage[noheadfoot,margin=0pt]{geometry} +\usepackage[skins,raster,magazine]{tcolorbox} +\usepackage{lipsum} + +\newenvironment{leaflet}[1][]{% + \begin{tcolorbox}[nobeforeafter,empty,colback=white, + sharp corners,size=minimal,left=10mm,right=10mm,top=10mm,bottom=10mm, + width=\textwidth/3, + breakable, + break at=\textheight, + height fixed for=all, + reset box array, + store to box array,#1]} + {\end{tcolorbox}% + \begin{tcbitemize}[raster columns=3,raster equal skip=0pt,blankest] + \tcbitem\consumeboxarray{5} + \tcbitem\consumeboxarray{6} + \tcbitem\consumeboxarray{1} + \tcbitem\consumeboxarray{2} + \tcbitem\consumeboxarray{3} + \tcbitem\consumeboxarray{4} + \end{tcbitemize}% + } + +\pagestyle{empty} +\begin{document} + +\begin{leaflet}[underlay={\node[above=5mm,font=\footnotesize] + at (frame.south) {- \arabic{tcbbreakpart} -};}] + \includegraphics[width=\linewidth]{Basilica_5.png} + \begin{center} + \bfseries\LARGE Example + \end{center} + + \section{Introduction} + \lipsum[1] + + \section{Main Part A} + \lipsum[2-8] + + \section{Main Part B} + \lipsum[9-15] + + \section{Conclusion} + \lipsum[16-18] +\end{leaflet} + +\end{document} +\end{tcblisting} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex index 578552815ee..33a89411cf0 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex @@ -455,7 +455,7 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}. \clearpage -\begin{docTcbKey}[][doc new=2014-11-10]{raster equal height}{=\meta{type}}{default \docValue{all}, initially \docValue{none}} +\begin{docTcbKey}[][doc new and updated={2014-11-10}{2017-02-28}]{raster equal height}{=\meta{type}}{default \docValue{all}, initially \docValue{none}} Puts the enclosed boxes into a common \refKey{/tcb/equal height group}. The \meta{id} of the equal height group is chosen automatically, but it may be set manually by \refKey{/tcb/raster equal height group}. 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 783306b6d79..772ef03aaa8 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex @@ -728,3 +728,25 @@ considered to be \textit{read-only} and should never be redefined by the user. \end{tcolorbox} \end{dispExample} \end{docCommand} + + +\begin{docCommand}[doc new=2017-04-25]{tcbsegmentstate}{} + This macro contains |0|, |1|, or |2|. Itis set for every unbroken box and every broken partial box + with the following meaning: + \begin{itemize} + \item\docValue{0}: The current (partial) box contains only an upper part. + \item\docValue{1}: The current (partial) box contains an upper and a lower part. + The segmentation node can be used for positioning. + \item\docValue{2}: The current (partial) box contains only a lower part. + This can only be true for parts of breakable boxes. + \end{itemize} + Skins like \refSkin{bicolor} use this property to paint the (partial) boxes. +\begin{dispExample} +% \tcbuselibrary{skins,raster} +\begin{tcbraster}[raster equal height,enhanced, + watermark text=\tcbsegmentstate] + \begin{tcolorbox}Upper part\end{tcolorbox} + \begin{tcolorbox}Upper part\tcblower Lower part\end{tcolorbox} +\end{tcbraster} +\end{dispExample} +\end{docCommand} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf Binary files differindex b62fddf32c1..938878c0e39 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 979a4852cee..0dfd55de447 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.02 (2017/02/24) +%% The LaTeX package tcolorbox - version 4.03 (2017/04/25) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -43,8 +43,8 @@ \setlength{\bibitemsep}{\smallskipamount} \addbibresource{tcolorbox.doc.bib} -\def\version{4.02}% -\def\datum{2017/02/24}% +\def\version{4.03}% +\def\datum{2017/04/25}% \makeindex \hypersetup{ @@ -58,7 +58,7 @@ %\tcbset{draftmode} \tcbset{/tcb/external/-}% for final run -%\includeonly{tcolorbox.doc.external} +%\includeonly{tcolorbox.doc.magazine} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |