Per defecte una caixa amb tcolorbox es crea com un entorn:
\begin{tcolorbox}
Contingut de la caixa de text
\end{tcolorbox}
A cada caixa se la pot configurar especialment amb la configuració dels paràmetres corresponents.Però potser és més interessant és definir un nou tipus de caixa de text en el preàmbul del document amb el comandament \newtcolorbox i, al cos del document, cridar-la simplement com si fos un entorn.
Així al preàmbul podem definir una caixa nova:
\newtcolorbox[auto counter,%comptador automàtic
number within=section,% %numera per seccions: secció.número de caixa
]%
{caixablava}[2][]%nom de la caixa de text
{colback=blue!5!white,%color de fons
colframe=blue!75!black,%color del marc
fonttitle=\bfseries,%tipus de lletra del títol
breakable,%es pot trencar entre pàgines
pad at break*=0mm,
title=Caixa Blava \thetcbcounter: #2,#1}%títol de la caixa: text fix, comptador i text variable
Quan al contingut del document volem que aparegui alguna d'aquestes caixes simplement escriurem aquest codi:
\begin{caixablava}[label=cb:referencia1]{Primera caixa}
Contingut de la caixa
\end{caixablava}
Observi's que cada caixa pot tenir una etiqueta (label) que en el nostre cas hem identificat amb el prefix cb. S'ha fet així perquè amb l'ajut del paquet \prettyref després es pot referenciar la caixa per aquesta etiqueta (vegeu l'article Millores en les referències creuades amb prettyref).
Es poden definir diferents tipus de caixa per un document. Per exemple: una caixa d'Exemple, d'Atenció. d'ampliació... que només cal definir un cop, al preàmbul, i cridar-la després al contingut del document en el moment en què sigui menester. Si els posem una etiqueta a cada cqaixa després és fàcil referencial-les i adreçar al lector a la caixa i la pàgina on es troba.
Al document font adjunt caixadetext.tex es pot estudiar el codi i veure com definir diferents tipus de caixa. I es pot veure el resultat, i les referències creuades, al document PDF caixadetext.pdf adjunt.
