diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 24 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/README | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf | bin | 147400 -> 148406 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex | 23 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex | 196 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex | 38 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex | 13 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex | 147 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex | 122 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | bin | 1780743 -> 1879312 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 35 |
11 files changed, 526 insertions, 74 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index 52598a4266e..6b21d50de24 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.10 (2013/04/09)
+%% The LaTeX package tcolorbox - version 2.20 (2013/04/17)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2012 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -162,5 +162,27 @@ version 2.10 (2013/04/09) 'title code app', 'title code pre'
- colorization of source code snippets in the documentation
+version 2.20 (2013/04/17)
+- bug fix: problem with breaking boxes after headings
+- new feature: support for boxes with side by side content
+- new keys:
+ 'sidebyside', 'sidebyside align', 'sidebyside gap',
+ 'lefthand width', 'righthand width', 'lefthand ratio', 'righthand ratio'
+- key 'nofloat' documented
+- new keys for the 'listings' library:
+ 'listing side text', 'text side listing'
+ 'listing outside text', 'text outside listing'
+- new keys for the 'skins' library:
+ 'frame hidden', 'interior hidden', 'segmentation hidden', 'title hidden'
+- new environments for the 'documentation' library:
+ 'dispExample*', 'dispListing*'
+- the default style for 'highlight math' is changed to have no title
+- minor change of internal width computation
+- minor internal fixes
+- slight overhaul of the documentation
+
+
+
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index 03bcfc8e4bd..026ac798416 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.10 (2013/04/09) +%% The LaTeX package tcolorbox - version 2.20 (2013/04/17) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2013 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 6c54a56761a..f1a94de86cf 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 f3b99f8ea71..3359233dee9 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.10 (2013/04/09) +%% The LaTeX package tcolorbox - version 2.20 (2013/04/17) %% tcolorbox-example.tex: an example for tcolorbox %% %% ------------------------------------------------------------------------------------------- @@ -70,7 +70,18 @@ \begin{tcblisting}{colback=red!5!white,colframe=red!75!black} This is a \LaTeX\ example: -$\displaystyle\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}$. +\begin{equation} +\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}. +\end{equation} +\end{tcblisting} + + +\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing side text, + title=Side by side,fonttitle=\bfseries} +This is a \LaTeX\ example: +\begin{equation} +\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}. +\end{equation} \end{tcblisting} @@ -84,8 +95,10 @@ $\displaystyle\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}$. arc=0mm, colback=blue!5!white,colframe=blue!75!black}{mytheorem}{theorem} \begin{theo}{Summation of Numbers}{summation} - For all natural number $n$ it holds:\\[2mm] - $\displaystyle\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}$. + For all natural number $n$ it holds: + \begin{equation} + \tcbhighmath{\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}.} + \end{equation} \end{theo} We have given Theorem \ref{theorem:summation} on page \pageref{theorem:summation}. @@ -106,13 +119,11 @@ We have given Theorem \ref{theorem:summation} on page \pageref{theorem:summation %---------------------------------------------------------- \section{Breakable Boxes} - \begin{tcolorbox}[enhanced,breakable, colback=blue!5!white,colframe=blue!75!black,title=Breakable box, watermark color=white,watermark text=\Roman{tcbbreakpart}] \lipsum[1-18] \end{tcolorbox} - \end{document} 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 f78733ea23a..88b534dda7b 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -12,11 +12,11 @@ starting from page \pageref{sec:latextutorial}. \subsection{Title} \begin{docTcbKey}{title}{=\meta{text}}{no default, initially empty} Creates a heading line with \meta{text} as content. -\begin{dispExample} +\begin{dispExample*}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[title=My heading line] This is a \textbf{tcolorbox}. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} \begin{docTcbKey}{notitle}{}{no value, initially set} @@ -127,74 +127,78 @@ Now, the saved part is used: +\clearpage \subsection{Colors and Fonts} \begin{docTcbKey}{colback}{=\meta{color}}{no default, initially \texttt{black!5!white}} Sets the background \meta{color} of the box. -\begin{dispExample} +\begin{dispExample*}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[colback=white] This is a \textbf{tcolorbox}. \end{tcolorbox} -\end{dispExample} +\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{dispExample} +\begin{dispExample*}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[colframe=red!50!yellow] This is a \textbf{tcolorbox}. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} - \begin{docTcbKey}{colupper}{=\meta{color}}{no default, initially \texttt{black}} Sets the text \meta{color} of the upper part. -\begin{dispExample} -\begin{tcolorbox}[colupper=yellow,colback=blue!50,colframe=blue] +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[colupper=yellow, + colback=blue!50,colframe=blue] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} \begin{docTcbKey}{collower}{=\meta{color}}{no default, initially \texttt{black}} Sets the text \meta{color} of the lower part. -\begin{dispExample} -\begin{tcolorbox}[collower=yellow,colback=blue!50,colframe=blue] +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[collower=yellow, + colback=blue!50,colframe=blue] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} \begin{docTcbKey}{coltext}{=\meta{color}}{style, no default, initially \texttt{black}} Sets the text \meta{color} of the box. This is an abbreviation for setting |colupper| and |collower| to the same value. -\begin{dispExample} -\begin{tcolorbox}[coltext=yellow,colback=blue!50,colframe=blue] +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[coltext=yellow, + colback=blue!50,colframe=blue] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} \begin{docTcbKey}{coltitle}{=\meta{color}}{no default, initially \texttt{white}} Sets the title text \meta{color} of the box. -\begin{dispExample} -\begin{tcolorbox}[coltitle=blue!50!black,colframe=blue!25,title=Test] +\begin{dispExample*}{sbs,lefthand ratio=0.6} +\begin{tcolorbox}[coltitle=blue!50!black, + colframe=blue!25,title=Test] This is a \textbf{tcolorbox}. \end{tcolorbox} -\end{dispExample} +\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} @@ -986,14 +990,17 @@ One & Two & Three \\\hline\hline \begin{dispExample} % \usepackage{tikz} % \usetikzlibrary{skins,listings} -\tcbset{tikz lower,listing and text,fonttitle=\bfseries, - bicolor,colback=LightBlue!50!white,colbacklower=white,colframe=black} +\tcbset{tikz lower,listing side text,fonttitle=\bfseries, + bicolor,colback=LightBlue!50!white,colbacklower=white,colframe=black, + righthand width=3cm} \begin{tcblisting}{title=TikZ drawing} -\path[fill=yellow,draw=yellow!75!red] (0,0) circle (1cm); +\path[fill=yellow,draw=yellow!75!red] + (0,0) circle (1cm); \fill[red] (45:5mm) circle (1mm); \fill[red] (135:5mm) circle (1mm); -\draw[line width=1mm,red] (215:5mm) arc (215:325:5mm); +\draw[line width=1mm,red] + (215:5mm) arc (215:325:5mm); \end{tcblisting} \end{dispExample} \end{docTcbKey} @@ -1144,6 +1151,147 @@ This is the lower part. {\tcbusetemp} +\begin{docTcbKey}{nofloat}{}{style, initially set} + Turns the floating behavior off. +\end{docTcbKey} + + +\clearpage +\subsection{Side by Side}\label{subsec:sidebyside} +\begin{marker} + Further side by side options for code examples are + \refKey{/tcb/listing side text}, + \refKey{/tcb/text side listing}, + \refKey{/tcb/listing outside text}, and + \refKey{/tcb/text outside listing}. +\end{marker} + +\begin{docTcbKey}{sidebyside}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|} +Normally, the upper part and the lower part of the box have their positions +as their names suggest. If |sidebyside| is set to |true|, the upper part +is drawn \emph{left-handed} and the lower part is drawn \emph{right-handed}. +Both parts are drawn together with the geometry settings of the upper part but the +space is divided horizontally according to the following options. +Colors, fonts, and box content additions are used individually. +The resulting box is unbreakable. + +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title,sidebyside] +This is the upper (\textit{left-handed}) part. +\tcblower +This is the lower (\textit{right-handed}) part. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{sidebyside align}{=\meta{alignment value}}{no default, initially |center|} + Sets the vertical alignment for the left-handed and right-handed part. + Feasible values are |center|, |top|, and |bottom|. +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,nobeforeafter, + left=2mm,right=2mm,sidebyside,sidebyside gap=6mm,width=(\linewidth-2mm)/3} + +\begin{tcolorbox}[adjusted title=center,sidebyside align=center] +This is a text which is too long for one line. +\tcblower +This is a short text. +\end{tcolorbox}\hfill +\begin{tcolorbox}[adjusted title=top,sidebyside align=top] +This is a text which is too long for one line. +\tcblower +This is a short text. +\end{tcolorbox}\hfill +\begin{tcolorbox}[adjusted title=bottom,sidebyside align=bottom] +This is a text which is too long for one line. +\tcblower +This is a short text. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + +\clearpage +\begin{docTcbKey}{sidebyside gap}{=\meta{length}}{no default, initially |10mm|} +Sets the horizontal distance between the left-handed and right-handed part to +\meta{length}. +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,nobeforeafter, + sidebyside,width=(\linewidth-2mm)/2} + +\begin{tcolorbox}[adjusted title=Wide gap,sidebyside gap=30mm] +This is a text which is too long for one line. +\tcblower +This is a short text. +\end{tcolorbox}\hfill +\begin{tcolorbox}[adjusted title=Narrow gap,sidebyside gap=1mm] +This is a text which is too long for one line. +\tcblower +This is a short text. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{lefthand width}{=\meta{length}}{no default, initially unset} +Sets the width of the left-handed part to the given \meta{length}. +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title,sidebyside,lefthand width=3cm] +This is the upper (\textit{left-handed}) part. +\tcblower +This is the lower (\textit{right-handed}) part. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + +\enlargethispage*{1cm} +\begin{docTcbKey}{righthand width}{=\meta{length}}{no default, initially unset} +Sets the width of the right-handed part to the given \meta{length}. +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title,sidebyside,righthand width=3cm] +This is the upper (\textit{left-handed}) part. +\tcblower +This is the lower (\textit{right-handed}) part. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + +\clearpage +\begin{docTcbKey}{lefthand ratio}{=\meta{fraction}}{no default, initially |0.5|} +Sets the width of the left-handed part to the given \meta{fraction} of +the available space. \meta{fraction} is a value between |0| and |1|. +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title,sidebyside,lefthand ratio=0.25] +This is the upper (\textit{left-handed}) part. +\tcblower +This is the lower (\textit{right-handed}) part. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{righthand ratio}{=\meta{fraction}}{no default, initially |0.5|} +Sets the width of the right-handed part to the given \meta{fraction} of +the available space. \meta{fraction} is a value between |0| and |1|. +\begin{dispExample} +\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title,sidebyside,righthand ratio=0.25] +This is the upper (\textit{left-handed}) part. +\tcblower +This is the lower (\textit{right-handed}) part. +\end{tcolorbox} +\end{dispExample} +\end{docTcbKey} + + \clearpage \subsection{Embedding into the Surroundings}\label{subsec:surroundings} Typically, but not necessarily, a |tcolorbox| is put inside a separate paragraph 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 b6a9405acb0..456556d55d3 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex @@ -137,14 +137,32 @@ This is an optional \oarg{argument}. The appearance is controlled by \refKey{/tcb/documentation listing style} and the style \refKey{/tcb/docexample}. It may be changed by redefining this style. +{ +%\tcbset{before lower app={\tcbset{docexample/.style={docexample original}}}} +%\tcbset{docexample/.style={docexample original}}% \begin{xdispExample} \begin{dispExample} This is a \LaTeX\ example. \end{dispExample} \end{xdispExample} +} \end{docEnvironment}} +{\let\xdispExample\dispExample + \let\endxdispExample\enddispExample +\begin{docEnvironment}{dispExample*}{\marg{options}} + The starred version of \refEnv{dispExample} takes \refEnv{tcolorbox} \meta{options} + as parameter. These \meta{options} are executed after \refKey{/tcb/docexample}. +\begin{xdispExample} +\begin{dispExample*}{sidebyside} +This is a \LaTeX\ example. +\end{dispExample*} +\end{xdispExample} +\end{docEnvironment}} + + +\clearpage \begin{docEnvironment}{dispListing}{} Creates a colored box based on a \refEnv{tcolorbox}. It displays the environment content as source code. @@ -158,7 +176,17 @@ This is a \LaTeX\ example. \end{dispExample} \end{docEnvironment} -\clearpage +\begin{docEnvironment}{dispListing*}{\marg{options}} + The starred version of \refEnv{dispListing} takes \refEnv{tcolorbox} \meta{options} + as parameter. These \meta{options} are executed after \refKey{/tcb/docexample}. +\begin{dispExample} +\begin{dispListing*}{title=My listing} +This is a \LaTeX\ example. +\end{dispListing*} +\end{dispExample} +\end{docEnvironment} + + \begin{docEnvironment}{absquote}{} Used to typeset an abstract as quoted and small text. \begin{dispExample} @@ -169,6 +197,7 @@ heading line. Optionally, such a box can be split in an upper and a lower part. \end{dispExample} \end{docEnvironment} +\clearpage \begin{docCommand}{tcbmakedocSubKey}{\marg{name}\marg{key path}} Creates a new environment \meta{name} based on \refEnv{docKey} for the documentation of keys with the given \meta{key path} as default. @@ -206,7 +235,7 @@ We have created \refKey{/foo/footitle} as an example. \end{dispExample} \end{docCommand} -\clearpage +% \begin{docCommand}{colDef}{\marg{text}} Sets \meta{text} with the definition color, see \refKey{/tcb/color definition}. \begin{dispExample} @@ -222,12 +251,13 @@ This is my \colOpt{text}. \end{docCommand} +\clearpage \subsection{Option Keys of the Library} \begin{docTcbKey}{docexample}{}{style, no value} Sets the style for \refEnv{dispExample} and \refEnv{dispListing} with the colors |ExampleBack| and |ExampleFrame|. - To change the appearance of the examples, this style could be + To change the appearance of the examples, this style can be redefined. \end{docTcbKey} @@ -279,7 +309,6 @@ This is my \colOpt{text}. \refKey{/tcb/index level}. \end{docTcbKey} -\clearpage \begin{docTcbKey}{index german settings}{}{style, no value} Sets the |makeindex| values recommended for German language texts. This is identical to setting the following: @@ -288,6 +317,7 @@ This is my \colOpt{text}. \end{dispListing} \end{docTcbKey} +\clearpage The following keys are provided for language specific settings. The English language is predefined. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex index 88b99c5db49..ed4187f3518 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex @@ -21,6 +21,19 @@ $\varepsilon$-\TeX\ is assumed to be used by everybody (hopefully). The breaking news for version 2.00 is the support for breakable boxes. This new feature allows new applications of the package without affecting the core package too much if you do not need boxes to break automatically. +With version 2.20, the often requested 'side by side' mode for listings has been added. + +\begin{tcolorbox}[enhanced,boxrule=0mm,boxsep=0mm,frame hidden,interior hidden, + left=0mm,right=0mm,top=0mm,bottom=0mm,watermark opacity=0.25,watermark zoom=1.2,before=\par\smallskip, + watermark tikz={% + \path[fill=yellow,draw=yellow!75!red] (0,0) circle (1cm); + \fill[red] (45:5mm) circle (1mm); + \fill[red] (135:5mm) circle (1mm); + \draw[line width=1mm,red] (215:5mm) arc (215:325:5mm);}] +Since the first public release in 2011, I received a lot of feedback from all over the world. +I want to thank all who wrote me for supporting this package by sending bug reports +and ideas for new or better features. +\end{tcolorbox} \subsection{Loading the Package} 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 21fd295e39d..2edcab150f2 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex @@ -56,11 +56,11 @@ and in compiled form. Saves the environment content to a file which is named by the key value of |listing file|. Later, this file can be loaded by |\tcbinputlisting| or |\tcbuselistingtext| or |\tcbuselistinglisting|. -\begin{dispExample} +\begin{dispListing} \begin{tcboutputlisting} This \textbf{text} is written to a standardized file for later usage. \end{tcboutputlisting} -\end{dispExample} +\end{dispListing} \end{docEnvironment} @@ -74,7 +74,7 @@ This \textbf{text} is written to a standardized file for later usage. \end{dispExample} \end{docCommand} - +\clearpage \begin{docCommand}{tcbuselistingtext}{} Loads text from a file named by the key value of |listing file|. \begin{dispExample} @@ -90,7 +90,7 @@ This \textbf{text} is written to a standardized file for later usage. \end{dispExample} \end{docCommand} - +\enlargethispage*{5mm} \begin{docCommand}{tcbusetemplisting}{} Typesets text as listing from a temporary file which was written by \refEnv{tcbwritetemp}. @@ -233,6 +233,59 @@ This is a \LaTeX\ example. \clearpage +\begin{docTcbKey}{listing side text}{}{no value} +Typesets the environment content side by side as listing in the left (upper) +part and as compiled text in the right (lower) part. +\begin{dispExample} +\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing side text} +This is a \LaTeX\ example. +\end{tcblisting} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{text side listing}{}{no value} +Typesets the environment content side by side as compiled text in the left (upper) +part and as listing in the right (lower) part. +\begin{dispExample} +\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,text side listing} +This is a \LaTeX\ example. +\end{tcblisting} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{listing outside text}{}{no value} +Typesets the environment content side by side as listing in a |tcolorbox| +and as compiled text outside the box in the right part of the page. +Nevertheless, the outside text is treated as \emph{lower} part of the +|tcolorbox| and can be formatted with all lower part options. +The space partitioning is done with the side by side options from +Section \ref{subsec:sidebyside}, see page \pageref{subsec:sidebyside}. +\begin{dispExample} +\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing outside text} +This is a \LaTeX\ example. +\end{tcblisting} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}{text outside listing}{}{no value} +Typesets the environment content side by side as listing in a |tcolorbox| +and as compiled text outside the box in the left part of the page. +Nevertheless, the outside text is treated as \emph{lower} part of the +|tcolorbox| and can be formatted with all lower part options. +The space partitioning is done with the side by side options from +Section \ref{subsec:sidebyside}, see page \pageref{subsec:sidebyside}. +\begin{dispExample} +\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,text outside listing} +This is a \LaTeX\ example. +\end{tcblisting} +\end{dispExample} +\end{docTcbKey} + + +\clearpage \subsection{Creation of \LaTeX\ Tutorials}\label{sec:latextutorial} The following source code gives a guideline for the creation of \LaTeX\ tutorials. In the next section, a framework for \LaTeX\ exercises is described. @@ -361,6 +414,92 @@ part of the box can be used uncoupled also. \end{dispExample} +The following series of examples demonstrate the application of +\refEnv{tcolorbox} options for diversification. + +\begin{dispExample} +\begin{texexptitled}{How to use options (1):\par The basic example}{options1} +\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}[center lower,enhanced,segmentation hidden,middle=0mm] + {How to use options (2):\par The text output is centered and the + segmentation line has vanished.}{options2} +\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}[tikz lower,bicolor,colbacklower=white] + {How to use options (3):\par Here, the |tikzpicture| is totally hidden. + The |bicolor| skin highlights the output.}{options3} +\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{texexptitled} +\end{dispExample} + +\begin{dispExample} +\begin{texexptitled}[center lower,listing side text,righthand width=3.5cm, + bicolor,colbacklower=white] + {How to use options (4):\par The |bicolor| skin also works with side + by side mode}{options4} +\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}[center lower,listing outside text,righthand width=3.5cm] + {How to use options (5):\par Putting our picture outside is just + a matter of one word.}{options5} +\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} +\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} + + +\clearpage \subsection{Creation of \LaTeX\ Exercises} In the following, a guideline is given for the creation of \LaTeX\ exercises with solutions. These solutions are saved to disk for application at a place of 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 6b331cc9413..cb0feeb2f21 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex @@ -207,16 +207,35 @@ and \refSkin{standard} \emph{none}. |path|, |pathfirst|, |pathmiddle|, or |pathlast|. It is \emph{not} available for |standard| and it \emph{may} be applicable for |freelance|. -\begin{dispExample} +\begin{dispExample*}{sbs,lefthand ratio=0.66} \tcbset{colback=red!5!white,fonttitle=\bfseries} \begin{tcolorbox}[enhanced,title=My title, - frame style={left color=red!75!black,right color=blue!75!black}] + frame style={left color=red!75!black, + right color=blue!75!black}] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} +\end{docTcbKey} + + +\begin{docTcbKey}{frame hidden}{}{style, no value} + This is a shortcut for |frame style={draw=none,fill=none}|. + Depending on the skin, this option switches off the drawing of the + frame. +\begin{dispExample*}{sbs,lefthand ratio=0.66} +\tcbset{colback=red!5!white,colframe=red!75!black, + fonttitle=\bfseries,coltitle=black} + +\begin{tcolorbox}[enhanced,title=My title, + frame hidden] +This is a \textbf{tcolorbox}. +\tcblower +This is the lower part. +\end{tcolorbox} +\end{dispExample*} \end{docTcbKey} @@ -229,19 +248,40 @@ This is the lower part. |path|, |pathfirst|, |pathmiddle|, or |pathlast|. It is \emph{not} available for |standard| and it \emph{may} be applicable for |freelance|. -\begin{dispExample} +\begin{dispExample*}{sbs,lefthand ratio=0.66} \tcbset{colframe=red!75!black,fonttitle=\bfseries} \begin{tcolorbox}[enhanced,title=My title, - interior style={left color=red!20!white,right color=yellow!50!white}] + interior style={left color=red!20!white, + right color=yellow!50!white}] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} \clearpage + +\begin{docTcbKey}{interior hidden}{}{style, no value} + This is a shortcut for |interior style={draw=none,fill=none}|. + Depending on the skin, this option switches off the drawing of the + interior. +\begin{dispExample*}{sbs,lefthand ratio=0.66} +\tcbset{frame style={top color=red!20!white, + bottom color=red!20!white!75!black}, + fonttitle=\bfseries,coltitle=black} + +\begin{tcolorbox}[enhanced,title=My title, + interior hidden] +This is a \textbf{tcolorbox}. +\tcblower +This is the lower part. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + \begin{docTcbKey}{segmentation style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default} The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command for drawing the \emph{segmentation} line of the box.\\ @@ -249,19 +289,40 @@ This is the lower part. is set to |path|. It is \emph{not} available for |standard| and it \emph{may} be applicable for |freelance|. -\begin{dispExample} -\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries} +\begin{dispExample*}{sbs,lefthand ratio=0.66} +\tcbset{colback=red!5!white,colframe=red!75!black, + fonttitle=\bfseries} \begin{tcolorbox}[enhanced,title=My title, - segmentation style={double=white,draw=blue,double distance=1pt,solid}] + segmentation style={double=white,draw=blue, + double distance=1pt,solid}] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} +\begin{docTcbKey}{segmentation hidden}{}{style, no value} + This is a shortcut for |segmentation style={draw=none,fill=none}|. + Depending on the skin, this option switches off the drawing of the + segmentation line. +\begin{dispExample*}{sbs,lefthand ratio=0.66} +\tcbset{colback=red!5!white,colframe=red!75!black, + fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title, + enhanced,segmentation hidden] +This is a \textbf{tcolorbox}. +\tcblower +This is the lower part. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + +\clearpage \begin{docTcbKey}{title style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default} The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command for drawing the \emph{title area} of the box.\\ @@ -269,21 +330,21 @@ This is the lower part. |path|, |pathfirst|, |pathmiddle|, or |pathlast|. It is \emph{not} available for |standard| and it \emph{may} be applicable for |freelance|. -\begin{dispExample} -\tcbset{colback=red!5!white,colframe=red!75!black,coltitle=blue!50!black, - fonttitle=\bfseries} +\begin{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, - title style={left color=blue!15!yellow,right color=red!85!black}] + title style={left color=blue!15!yellow, + right color=red!85!black}] This is a \textbf{tcolorbox}. \tcblower This is the lower part. \end{tcolorbox} -\end{dispExample} +\end{dispExample*} \end{docTcbKey} -\clearpage \begin{docTcbKey}{colbacktitle}{=\meta{color}}{style, no default, initially unset} Abbreviation for setting \refKey{/tcb/title style} to |fill=|\meta{color}. This fills the background of the title area with the given \meta{color}.\\ @@ -291,19 +352,38 @@ This is the lower part. |path|, |pathfirst|, |pathmiddle|, or |pathlast|. It is \emph{not} available for |standard| and it \emph{may} be applicable for |freelance|. -\begin{dispExample} -\tcbset{colback=red!5!white,colframe=red!75!black,coltitle=blue!50!black, - fonttitle=\bfseries} +\begin{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] +\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{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}. +\begin{dispExample*}{sbs,lefthand ratio=0.66} +\tcbset{colback=red!5!white,colframe=red!75!black, + fonttitle=\bfseries} + +\begin{tcolorbox}[title=My title, + enhanced,title hidden] +This is a \textbf{tcolorbox}. +\tcblower +This is the lower part. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + \clearpage \subsection{Code Option Keys}\label{subsec:addcodeoptions} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf Binary files differindex 0143cbf750b..8ca73d17d90 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 fbd073bd790..b6128360346 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.10 (2013/04/09) +%% The LaTeX package tcolorbox - version 2.20 (2013/04/17) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -82,8 +82,8 @@ pdfkeywords={colored boxes, LaTeX examples, theorems} } -\def\version{2.10}% -\def\datum{2013/04/09}% +\def\version{2.20}% +\def\datum{2013/04/17}% \makeindex \newcounter{texexp} @@ -122,20 +122,20 @@ keywordstyle=\color{Option}\bfseries, % tcolorbox options morekeywords={% core - adjusted,adjust,after,arc,auto,autoparskip, + adjusted,adjust,after,arc,auto,autoparskip,align, before,bottom,boxsep,boxrule,bottomtitle,bottomrule,broken, collower,coltext,coltitle,colback,colframe,colupper,center, equal,enlarge,enlargement,extrude, fontupper,fontlower,fonttitle,first,floatplacement,float, - group, + group,gap, height, - lowerbox,left,leftrule,lefttitle,leftupper,leftlower,lower,last, + lowerbox,left,leftrule,lefttitle,leftupper,leftlower,lower,last,lefthand, middle,minimum, - notitle,natural,noparskip,nobeforeafter, + notitle,natural,noparskip,nobeforeafter,nofloat, parskip,parbox, outer,oversize,overlay, - right,rightrule,righttitle,rightupper,rightlower, - savelowerto,savedelimiter,space,split,shrink, + right,rightrule,righttitle,rightupper,rightlower,righthand,ratio, + savelowerto,savedelimiter,space,split,shrink,sidebyside, title,top,toptitle,toprule,titlerule,tabularx,tikz,toggle,tight,tempfile,text, upper,unbroken, valign, @@ -145,8 +145,8 @@ file, inputencoding, listing, - options, - style, + options,outside, + style,side, utf, % theorems ams,align, @@ -177,6 +177,7 @@ enhanced,engine, frame,freelance, graphical,geometry,graphics, + hidden, interior, opacity, nodes, @@ -195,9 +196,17 @@ classoffset=0% restore default } -\tcbset{documentation listing style=mydocumentation} +\tcbset{documentation listing style=mydocumentation,% + sbs/.style={sidebyside,before lower app={\tcbset{sidebyside=false}}},% + innerbox/.style={standard,frame style={},colback=black!5!white,colframe=black!75!white,coltext=black,coltitle=white,docexample/.style={docexample original}, + frame code,interior code,interior titled code,segmentation code}, + docexample/.style={colframe=Navy!50!ExampleFrame,colback=Navy!5!ExampleBack,fontlower=\footnotesize, + bicolor,colbacklower=ExampleBack!5!white,frame style={drop shadow}, + before upper={\tcbset{innerbox}},before lower={\tcbset{innerbox}}}, + docexample original/.style={colframe=ExampleFrame,colback=ExampleBack,fontlower=\footnotesize,frame style={}}, +} -%\includeonly{tcolorbox.doc.hooks} +%\includeonly{tcolorbox.doc.skins} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{document} |