Displayed Paragraphs
Author: Luc Maranget

## B.6 Displayed Paragraphs

- Quotation and Verse
- List-Making environments
- The list and trivlist environments
- Verbatim

Displayed-paragraph environments translate to block-level elements.

In addition to the environments described in this section, HEVEA implements the `center`, `flushleft` and `flushright` environments. HEVEA also implements the corespondant TEX style declaration `\centering` `\raggedright` and `\raggedleft`, but these declarations may not work as expected, when they do not appear directly inside a displayed-paragraph environment or inside an array element.

### B.6.1 Quotation and Verse

The `quote` and `quotation` environments are similar; they translate to `BLOCKQUOTE` elements with associated classes `quote` and `quotation`, respectively.

The `verse` environment is supported as `BLOCKQUOTE` element with class `verse`.

### B.6.2 List-Making environments

The `itemize`, `enumerate` and `description` environments translate to the `ul`, `ol`, and `DL` elements and this is the whole story.

As a consequence, no control is allowed on the appearances of these environments. More precisely optional arguments to `\item` do not function properly inside `itemize` and `enumerate`. Moreover, item labels inside `itemize` or numbering style inside `enumerate` are browser dependent.

However, customized lists can be produced by using the the list environment (see next section).

### B.6.3 The list and trivlist environments

The `list` environment translates to the `DL` element. Arguments to `\begin{list}` are handled as follows:

`\begin{list}{`default_label`}{`decls`}`

The first argument default_label is the label generated by an `\item` command with no argument. The second argument, decls is a sequence of declarations. In practice, the following declarations are relevant:

\usecounter{counter}
  The counter counter is incremented by `\refstepcounter` by every `\item` command with no argument, before it does anything else.
\renewcommand{\makelabel}[1]{…}
  The command `\item` executes `\makelabel{`label`}`, where label is the item label, to print its label. Thus, users can change label formatting by redefining `\makelabel`. The default definition of `\makelabel` simply echoes label.

As an example, a list with an user-defined counter can be defined as follows:

    \newcounter{coucou}
    \begin{list}{\thecoucou}{%
    \usecounter{coucou}%
    \renewcommand{\makelabel}[1]{\textbf{#1}.}}
    ...
    \end{list}

This yields:

1.
  First item.
2.
  Second item.

The `trivlist` environment is also supported. It is equivalent to the `description` environment.

### B.6.4 Verbatim

The `verbatim` and `verbatim*` environments translate to the `PRE` elements. Inside `verbatim*`, spaces are replaced by visual spaces (“`␣`”). Similarly, `\verb` and `\verb*` translate to `CODE` text elements. The environments are associated with CSS classes of the same names, this is, `verbatim` and `\verb`, respectively.

The `alltt` environment is supported.