cardgame -- Typeset custom playing cards for printing
===================================================

The `cardgame` package allows you to define `cards`, which
have various attributes like image, text, and a bunch of
layout features. You can then include those cards as
images or, more importantly, generate a document containing
all of the cards you defined laid out optimally for printing
and cutting. You can optionally create card lists for
your game's manual, and you can create multiple copies
of cards and automatically print the correct number
of back sides.

Installation
------------

The package is supplied in `.dtx` format and as a pre-extracted
`.zip` file, `cardgame.zip`. The latter is most convenient
for most users: simply unzip this in your local `texmf`
directory. If you want to unpack the `.dtx` yourself, running
`tex cardgame.dtx` will extract the package whereas `latex
cardgame.dtx` or `pdflatex cardgame.dtx` will extract it
and also typeset the documentation.

The package requires LaTeX3 support as provided in the
`l3kernel` and `l3packages` bundles. Both of these are available
on [CTAN](http://www.ctan.org/) as ready-to-install `.zip`
files. Suitable versions are available in MiKTeX 2.9 and TeX
Live 2012 (updating the relevant packages online may be
necessary). LaTeX3, and so `cardgame`, requires the e-TeX
extensions: these are available on all modern TeX systems.

Typesetting the documentation requires a number of packages in
addition to those needed to use the package. To compile the
documentation without error, you will need the following packages:
- `listings`
- `float`


