Frequently Asked Question List for TeX
Lamport’s book lists various
parameters for the layout of list (things like \topsep
,
\itemsep
and \parsep
), but fails to mention that they’re set
automatically within the standard (LaTeX-defined) lists. This
happens because each list
executes a command \@list<depth>
(the depth
appearing as a lower-case roman numeral); what’s more, the top-level
\@listi
is usually reset when the font size is changed. As a
result, it’s rather tricky for
the user to control list spacing. Of course, the real answer is to use
a document class designed with more modest list spacing, but we all
know such things are hard to come by. The memoir
class doesn’t
provide more compact lists, but offers the user control over the list
spacing using \firmlist
and \tightlist
(and *
-ed
versions of them); see section 8.6 of the memoir manual.
There are packages that provide some control of list spacing, but they
seldom address the separation from surrounding text (defined by
\topsep
). The expdlist
package, among its many controls
of the appearance of description
lists, offers a
compaction parameter (see the documentation); the mdwlist
package offers a \makecompactlist
command for users’ own list
definitions, and uses it to define compact lists
itemize*
, enumerate*
and
description*
. In fact, you can write lists such as
these commands define pretty straightforwardly — for example:
\newenvironment{itemize*}%
{\begin{itemize}%
\setlength{\itemsep}{0pt}%
\setlength{\parskip}{0pt}}%
{\end{itemize}}
The paralist
package provides several approaches to list
compaction:
asparaenum
environment formats each item as if
it were a paragraph introduced by the enumeration label (which saves
space if the item texts are long);compactenum
environment is the same sort of
compact list as is provided in expdlist
and
mdwlist
; andinparaenum
environment produces a list “in the paragraph”,
i.e., with no line break between items, which is a
great space-saver if the list item texts are short.The package will manipulate its enumerate
environment
labels just like the enumerate
package
does.
Paralist
also provides itemize
equivalents
(asparaitem
, etc.), and description
equivalents (asparadesc
, etc.).
The multenum
package offers a more regular form of
paralist
’s inparaenum
; you define a notional
grid on which list entries are to appear, and list items will always
appear at positions on that grid. The effect is somewhat like that of
the “tab” keys on traditional typewriters; the package was designed
for example sheets, or lists of answers in the appendices of a book.
The expdlist
, mdwlist
and paralist
packages all offer other facilities for list configuration: you should
probably not try the “do-it-yourself” approaches outlined below if
you need one of the packages for some other list configuration
purpose.
For ultimate flexibility (including manipulation of \topsep
), the
enumitem
package permits adjustment of list parameters using
a “key=‹value›” format.
For example, one might write
\usepackage{enumitem}
...
\begin{enumerate}[topsep=0pt, partopsep=0pt]
\item ...
\item ...
\end{enumerate}
to suppress all spacing above and below your list, or
\usepackage{enumitem}
...
\begin{enumerate}[itemsep=2pt,parsep=2pt]
\item ...
\item ...
\end{enumerate}
to set spacing between items and between paragraphs within items.
Enumitem
also permits manipulation of the label format in a
more “basic” (and therefore more flexible) manner than the
enumerate
package does.
The ultimate in compaction (of every sort) is offered by the
savetrees
package; compaction of lists is included. The
package’s prime purpose is to save space at every touch and turn:
don’t use it if you’re under any design constraint whatever!
FAQ ID: Q-complist
Tags: lists