18 Library magazine

LIB

1
The main purpose of this library is to store a tcolorbox Example Article
into an array of box registers for later usage.
This is an example for an arti-
If the tcolorbox is not breakable, there is not much add- cle which starts right here and is
on compared to usual TEX/LATEX box storage and usage continued to the following pages.
The body text for the article is
(and you do not really need this library for that use case).
written inside a single tcolorbox.
For a breakable tcolorbox, this library allows to capture This box is split into parts us-
all partial boxes into a sequence of registers. The partial ing the tools from this section,
boxes can be used anywhere in arbitrary order. — continued on page 391 —

The name of this library indicates magazine in the sense of storage, but also in the sense of a
journal where an article often is continued on page x. An example for this kind of application is
given throughout this section starting on the right hand side. The creation of this library was
motivated by Ulrike Fischer and Steven B. Segletes.
The library is loaded by a package option or inside the preamble by:

\tcbuselibrary{magazine}

This also loads the library breakable , see Section 17 on page 362.
LIB

The box register operations of this library are global. TEX grouping will not clear the
! registers when leaving the current group. Also be aware that extensive use of large box
arrays may eat up TEX’s available memory and registers.

18.1 Creation and Resetting of Box Arrays

N 2015-07-13 \newboxarray{hnamei}
This creates a new box array called hnamei. There already is a box array available with
name default which can be used directly. Note that the creation is a global operation.

\newboxarray{myarray}

N 2015-07-13 \boxarrayreset[hnamei]
Resets the size counter of a box array hnamei to zero. If hnamei is not provided, default is
used as name. Use this or /tcb/reset box arrayÕ P. 388 before you apply /tcb/store to
box arrayÕ P. 389 . Otherwise, all boxes would be appended to the already existing boxes.
This command does not clear box registers.

\boxarrayreset % resets 'default'

\boxarrayreset{myarray} % resets 'myarray'

N 2015-07-13 /tcb/reset box array=hnamei (default default, initially unset)

Resets the size counter of a box array hnamei to zero. Use this or \boxarrayresetÕ P. 388
(which does the same) before you apply /tcb/store to box arrayÕ P. 389 .

\tcbset{
reset box array, % resets 'default'
reset box array=myarray, % resets 'myarray'
}

387