Version 3.05

doc/latex/tcolorbox/README

@@ -0,0 +1,74 @@
+%% The LaTeX package tcolorbox - version 3.05 (2014/05/28)
+%%
+%% -------------------------------------------------------------------------------------------
+%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% -------------------------------------------------------------------------------------------
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%%   http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `author-maintained'.
+%%
+%% This work consists of all files listed in README
+%%
+
+tcolorbox provides an environment for colored and framed text boxes with a
+heading line. Optionally, such a box can be split in an upper and a lower
+part. The package tcolorbox can be used for the setting of LaTeX examples where
+one part of the box displays the source code and the other part shows the
+output. Another common use case is the setting of theorems. The package supports
+saving and reuse of source code and text parts.
+
+Contents of the package
+=======================
+  'README'                    this file
+  'CHANGES'                   log of changes (history)
+  'tcolorbox.sty'             LaTeX package file (style file)
+  'tcbbreakable.code.tex'     LaTeX package file (library of tcolorbox)
+  'tcbdocumenation.code.tex'  LaTeX package file (library of tcolorbox)
+  'tcbfitting.code.tex'       LaTeX package file (library of tcolorbox)
+  'tcbhooks.code.tex'         LaTeX package file (library of tcolorbox)
+  'tcblistings.code.tex'      LaTeX package file (library of tcolorbox)
+  'tcblistingscore.code.tex'  LaTeX package file (library of tcolorbox)
+  'tcblistingsutf8.code.tex'  LaTeX package file (library of tcolorbox)
+  'tcbminted.code.tex'        LaTeX package file (library of tcolorbox)
+  'tcbskins.code.tex'         LaTeX package file (library of tcolorbox)
+  'tcbskinsjigsaw.code.tex'   LaTeX package file (library of tcolorbox)
+  'tcbtheorems.code.tex'      LaTeX package file (library of tcolorbox)
+  'tcbxparse.code.tex'        LaTeX package file (library of tcolorbox)
+  'tcolorbox.pdf'             Documentation for tcolorbox
+  'tcolorbox.tex'             Source code of the documentation (main file)
+  '*.doc.*'                   Source code of the documentation (include files)
+  'tcolorbox-example.tex'     Example file for package usage
+  '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
+============
+Copy the contents of the 'tcolorbox.tds.zip' from CTAN to your local TeX file tree.
+
+Alternatively, put the files to their respective locations within the TeX installation:
+  'tcolorbox.sty'             ->  /tex/latex/tcolorbox
+  'tcbbreakable.code.tex'     ->  /tex/latex/tcolorbox
+  'tcbdocumenation.code.tex'  ->  /tex/latex/tcolorbox
+  'tcbfitting.code.tex'       ->  /tex/latex/tcolorbox
+  'tcbhooks.code.tex'         ->  /tex/latex/tcolorbox
+  'tcblistings.code.tex'      ->  /tex/latex/tcolorbox
+  'tcblistingscore.code.tex'  ->  /tex/latex/tcolorbox
+  'tcblistingsutf8.code.tex'  ->  /tex/latex/tcolorbox
+  'tcbminted.code.tex'        ->  /tex/latex/tcolorbox
+  'tcbtheorems.code.tex'      ->  /tex/latex/tcolorbox
+  'tcbskins.code.tex'         ->  /tex/latex/tcolorbox
+  'tcbskinsjigsaw.code.tex'   ->  /tex/latex/tcolorbox
+  'tcbxparse.code.tex'        ->  /tex/latex/tcolorbox
+  all other files             ->  /doc/latex/tcolorbox

doc/latex/tcolorbox/tcolorbox-example.tex

@@ -0,0 +1,191 @@
+%% The LaTeX package tcolorbox - version 3.05 (2014/05/28)
+%% tcolorbox-example.tex: an example for tcolorbox
+%%
+%% -------------------------------------------------------------------------------------------
+%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% -------------------------------------------------------------------------------------------
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%%   http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `author-maintained'.
+%%
+%% This work consists of all files listed in README
+%%
+\documentclass{article}
+\usepackage{tikz,lipsum,lmodern}
+\usepackage[most]{tcolorbox}
+
+\begin{document}
+
+%----------------------------------------------------------
+\section{Colored boxes}
+
+\begin{tcolorbox}[colback=red!5!white,colframe=red!75!black]
+  My box.
+\end{tcolorbox}
+
+\begin{tcolorbox}[colback=blue!5!white,colframe=blue!75!black,title=My title]
+  My box with my title.
+\end{tcolorbox}
+
+\begin{tcolorbox}[colback=green!5!white,colframe=green!75!black]
+  Upper part of my box.
+  \tcblower
+  Lower part of my box.
+\end{tcolorbox}
+
+\begin{tcolorbox}[colback=yellow!5!white,colframe=yellow!50!black,
+  colbacktitle=yellow!75!black,title=My title]
+  I can do this also with a title.
+  \tcblower
+  Lower part of my box.
+\end{tcolorbox}
+
+\begin{tcolorbox}[colback=yellow!10!white,colframe=red!75!black,lowerbox=invisible,
+  savelowerto=\jobname_ex.tex]
+  Now, we play hide and seek. Where is the lower part?
+  \tcblower
+  I'm invisible until you find me.
+\end{tcolorbox}
+
+\begin{tcolorbox}[colback=yellow!10!white,colframe=red!75!black,title=Here I am]
+  \input{\jobname_ex.tex}
+\end{tcolorbox}
+
+
+\begin{tcolorbox}[colback=blue!50!white,colframe=blue!25!black,coltext=yellow,
+    fontupper=\Large\bfseries,arc=6mm,boxrule=2mm,boxsep=5mm]
+  Funny settings.
+\end{tcolorbox}
+
+
+\begin{tcolorbox}[enhanced,frame style image=blueshade.png,
+  opacityback=0.75,opacitybacktitle=0.25,
+  colback=blue!5!white,colframe=blue!75!black,
+  title=My title]
+  This box is filled with an external image.\par
+  Title and interior are made partly transparent to show the image.
+\end{tcolorbox}
+
+
+\begin{tcolorbox}[enhanced,attach boxed title to top center={yshift=-3mm,yshifttext=-1mm},
+  colback=blue!5!white,colframe=blue!75!black,colbacktitle=red!80!black,
+  title=My title,fonttitle=\bfseries,
+  boxed title style={size=small,colframe=red!50!black} ]
+  This box uses a \textit{boxed title}. The box of the title can
+  be formatted independently from the main box.
+\end{tcolorbox}
+
+
+\clearpage
+%----------------------------------------------------------
+\section{\LaTeX-Examples}
+
+\begin{tcblisting}{colback=red!5!white,colframe=red!75!black}
+This is a \LaTeX\ example:
+\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}
+
+
+%----------------------------------------------------------
+\section{Theorems}
+
+\newtcbtheorem[auto counter,number within=section]{theo}%
+  {Theorem}{fonttitle=\bfseries\upshape, fontupper=\slshape,
+     arc=0mm, colback=blue!5!white,colframe=blue!75!black}{theorem}
+
+\begin{theo}{Summation of Numbers}{summation}
+  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}.
+
+\newtcbtheorem[use counter from=theo]{antheo}%
+  {Theorem}{theorem style=change,oversize,enlarge top by=1mm,enlarge bottom by=1mm,
+    enhanced jigsaw,interior hidden,fuzzy halo=1mm with green,
+     fonttitle=\bfseries\upshape,fontupper=\slshape,
+     colframe=green!75!black,coltitle=green!50!blue!75!black}{antheorem}
+
+\begin{antheo}{Summation of Numbers}{summation}
+  For all natural number $n$ it holds:
+  \begin{equation}
+  \tcbhighmath{\sum\limits_{i=1}^n i = \frac{n(n+1)}{2}.}
+  \end{equation}
+\end{antheo}
+
+%----------------------------------------------------------
+\section{Watermarks}
+
+\begin{tcolorbox}[enhanced,watermark graphics=Basilica_5.png,
+  watermark opacity=0.3,watermark zoom=0.9,
+  colback=green!5!white,colframe=green!75!black,
+  fonttitle=\bfseries, title=Box with a watermark picture]
+  Here, you see my nice box with a picture as a watermark.
+  This picture is automatically resized to fit the dimensions
+  of my box. Instead of a picure, some text could be used or
+  arbitrary graphical code. See the documentation for more options.
+\end{tcolorbox}
+
+%----------------------------------------------------------
+\section{Boxes in boxes}
+\begin{tcolorbox}[colback=yellow!10!white,colframe=yellow!50!black,
+  every box/.style={fonttitle=\bfseries},title=Box]
+  \begin{tcolorbox}[enhanced,colback=red!10!white,colframe=red!50!black,
+    colbacktitle=red!85!black,
+    title=Box inside box,drop fuzzy shadow]
+    \begin{tcolorbox}[beamer,colframe=blue!50!black,title=Box inside box inside box]
+      And now for something completely different: Boxes!\par\medskip
+      \newtcbox{\mybox}{nobeforeafter,tcbox raise base,colframe=green!50!black,colback=green!10!white,arc=0pt}
+      \mybox{This} \mybox{is} \mybox{another} \mybox{box.}
+    \end{tcolorbox}
+  \end{tcolorbox}
+\end{tcolorbox}
+
+
+
+%----------------------------------------------------------
+\section{Breakable Boxes}
+\begin{tcolorbox}[enhanced jigsaw,breakable,pad at break=1mm,
+  colback=blue!5!white,colframe=blue!75!black,title=Breakable box,
+  watermark color=white,watermark text=\Roman{tcbbreakpart}]
+  \lipsum[1-12]
+\end{tcolorbox}
+
+%----------------------------------------------------------
+\clearpage
+\section{Fit Boxes}
+
+\begin{tcolorbox}[enhanced,fit to height=10cm,
+  colback=green!25!black!10!white,colframe=green!75!black,title=Fit box (10cm),
+  drop fuzzy shadow,watermark color=white,watermark text=Fit]
+  \lipsum[1-4]
+\end{tcolorbox}
+
+\begin{tcolorbox}[enhanced,fit to height=5cm,
+  colback=green!25!black!10!white,colframe=green!75!black,title=Fit box (5cm),
+  drop fuzzy shadow,watermark color=white,watermark text=Fit]
+  \lipsum[1-4]
+\end{tcolorbox}
+
+\end{document}
+

doc/latex/tcolorbox/tcolorbox.doc.abstract.tex

@@ -0,0 +1,86 @@
+% !TeX root = tcolorbox.tex
+% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox)
+\begin{tcboutputlisting}
+% \usepackage{incgraph}
+\begin{inctext}
+\begin{tikzpicture}
+\definecolorseries{boxcol}{rgb}{last}{red}{blue}
+\resetcolorseries[24]{boxcol}
+\coordinate (A) at (0,0); \coordinate (B) at (21,29.7);
+\path[use as bounding box,top color=Goldenrod!25!white,bottom color=Navy!25!white]
+  (A) rectangle coordinate (C) (B);
+\foreach \w in {-15,-30,...,-360}
+{\node[below right,rotate around={\w:(C)}] at ([xshift=1cm]C) {%
+  \begin{tcolorbox}[width=8cm,title=tcolorbox \version,
+    fontupper=\scriptsize,fonttitle=\small\bfseries,
+    colback=boxcol!25!white,colbacktitle=boxcol!!+!50!black,colframe=boxcol,
+    enhanced jigsaw,opacityback=0.5,opacitybacktitle=0.75]
+    \lipsum[2]
+  \end{tcolorbox}};
+}
+\node[font=\Huge\bfseries] at ([yshift=12cm]C) {|tcolorbox|};
+\node[font=\large\bfseries] at ([yshift=-12cm]C)
+  {Manual for version \version\ (\datum)};
+\end{tikzpicture}
+\end{inctext}
+\end{tcboutputlisting}
+\tcbuselistingtext
+\tcbinputlisting{title=Cover code,
+  base example,coltitle=black,fonttitle=\itshape,titlerule=0pt,
+  colbacktitle=Navy!15!ExampleBack,top=0mm,before=\par\smallskip,%
+  listing style=mydocumentation,listing only}
+
+\bigskip
+
+\begin{marker}
+If you have trouble printing this document, the reason is quite likely the
+cover page. Printing the pages starting with page 2 or page 3 should work.
+\end{marker}
+
+\clearpage
+\begin{center}
+\begin{tcolorbox}[enhanced,hbox,tikznode,left=8mm,right=8mm,boxrule=0.4pt,
+  colback=white,colframe=black!50!yellow,
+  %drop fuzzy midday shadow=black!50!yellow,
+  drop lifted shadow=black!50!yellow,
+  before=\par\vspace*{5mm},after=\par\bigskip]
+{\bfseries\LARGE The \texttt{tcolorbox} package}\\[3mm]
+{\large Manual for version \version\ (\datum)}
+\end{tcolorbox}
+{\large Thomas F.~Sturm%
+  \footnote{Prof.~Dr.~Dr.~Thomas F.~Sturm, Institut f\"{u}r Mathematik und Informatik,
+    Universit\"{a}t der Bundeswehr M\"{u}nchen, D-85577 Neubiberg, Germany;
+     email: \href{mailto:thomas.sturm@unibw.de}{thomas.sturm@unibw.de}} }
+\end{center}
+\bigskip
+\begin{absquote}
+  \begin{center}\bfseries Abstract\end{center}
+  |tcolorbox| provides an environment for colored and framed text boxes with a
+  heading line. Optionally, such a box can be split in an upper and a lower
+  part. The package |tcolorbox| can be used for the setting of \LaTeX\ examples where
+  one part of the box displays the source code and the other part shows the
+  output. Another common use case is the setting of theorems. The package supports
+  saving and reuse of source code and text parts.
+\end{absquote}
+
+\begin{tcolorbox}[breakable,enhanced jigsaw,title={Contents},fonttitle=\bfseries\Large,
+  colback=yellow!10!white,colframe=red!50!black,before=\par\bigskip\noindent,
+  interior style={fill overzoom image=goldshade.png,fill image opacity=0.25},
+  colbacktitle=red!50!yellow!75!black,
+  watermark color=yellow!75!red!25!white,pad at break=3mm,
+  watermark text={\bfseries\Large Contents},
+  attach boxed title to top center={yshift=-0.25mm-\tcboxedtitleheight/2,yshifttext=2mm-\tcboxedtitleheight/2},
+  boxed title style={enhanced,boxrule=0.5mm,
+    frame code={ \path[tcb fill frame] ([xshift=-4mm]frame.west) -- (frame.north west)
+    -- (frame.north east) -- ([xshift=4mm]frame.east)
+    -- (frame.south east) -- (frame.south west) -- cycle; },
+    interior code={ \path[tcb fill interior] ([xshift=-2mm]interior.west)
+    -- (interior.north west) -- (interior.north east)
+    -- ([xshift=2mm]interior.east) -- (interior.south east) -- (interior.south west)
+    -- cycle;}  },
+  %enlargepage=2\baselineskip,
+  drop fuzzy shadow]
+\makeatletter
+\@starttoc{toc}
+\makeatother
+\end{tcolorbox}