<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<META name="GENERATOR" content="hevea 1.10">
<META name="Author" content="Luc Maranget">
<LINK rel="stylesheet" type="text/css" href="manual.css">
<TITLE>Displayed Paragraphs</TITLE>
</HEAD>
<BODY >
<A HREF="manual027.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual022.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<A HREF="manual029.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
<HR>
<H2 CLASS="section"><A NAME="htoc77">B.6</A>  Displayed Paragraphs</H2><UL>
<LI><A HREF="manual028.html#toc60">Quotation and Verse</A>
</LI><LI><A HREF="manual028.html#toc61">List-Making environments</A>
</LI><LI><A HREF="manual028.html#toc62">The <TT>list</TT> and <TT>trivlist</TT>
environments</A>
</LI><LI><A HREF="manual028.html#toc63">Verbatim</A>
</LI></UL>
<P>
Displayed-paragraph environments translate to block-level
elements.</P><P>In addition to the environments described in this section,
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A implements the <CODE>center</CODE>, <CODE>flushleft</CODE> and
<CODE>flushright</CODE> environments.
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A also implements the corespondant T<sub>E</sub>X style declaration
<CODE>\centering</CODE> <CODE>\raggedright</CODE> and <CODE>\raggedleft</CODE>,
but these declarations may not work as expected, when they do not
appear directly inside a displayed-paragraph environment or inside an array
element.</P><H3 CLASS="subsection"><A NAME="toc60"></A><A NAME="htoc78">B.6.1</A>  Quotation and Verse</H3><P>
The <CODE>quote</CODE> and <CODE>quotation</CODE> environments are the same thing: they
translate to <CODE>BLOCKQUOTE</CODE> elements.
The <CODE>verse</CODE> environment is not supported.</P><H3 CLASS="subsection"><A NAME="toc61"></A><A NAME="htoc79">B.6.2</A>  List-Making environments</H3><P>
The <CODE>itemize</CODE>, <CODE>enumerate</CODE> and <CODE>description</CODE>
environments translate to the <CODE>UL</CODE>, <CODE>OL</CODE>, and
<CODE>DL</CODE> elements and this is the whole story.</P><P>As a consequence, no control is allowed on the appearances of these
environments. More precisely optional arguments to <CODE>\item</CODE> do not
function properly inside <CODE>itemize</CODE> and <CODE>enumerate</CODE>. Moreover, item
labels inside <CODE>itemize</CODE> or numbering style inside <CODE>enumerate</CODE>
are browser dependent.</P><P>However, customized lists can be produced by using the
the <TT>list</TT> environment (see next section).</P><H3 CLASS="subsection"><A NAME="toc62"></A><A NAME="htoc80">B.6.3</A>  The <TT>list</TT> and <TT>trivlist</TT>
environments</H3><P>
The <CODE>list</CODE> environment translates to the
<CODE>DL</CODE> element.
Arguments to <CODE>\begin{list}</CODE> are handled as follows:</P><DIV CLASS="flushleft">
  <CODE>\begin{list}{</CODE><I>default_label</I><CODE>}{</CODE><I>decls</I><CODE>}</CODE>
</DIV><P>The first argument <I>default_label</I> is the label generated by an
<CODE>\item</CODE> command with no argument.
The second argument, <I>decls</I> is a sequence of declarations.
In practice, the following declarations are relevant:
</P><DL CLASS="list"><DT CLASS="dt-list">
<TT>\usecounter{</TT><I>counter</I><TT>}</TT></DT><DD CLASS="dd-list">
The counter <I>counter</I> is incremented by <CODE>\refstepcounter</CODE>
by every <CODE>\item</CODE> command with no argument, before it does
anything else.
</DD><DT CLASS="dt-list"><TT>\renewcommand{\makelabel}[1]{</TT>…<TT>}</TT></DT><DD CLASS="dd-list">
The command <CODE>\item</CODE> executes
<CODE>\makelabel{</CODE><I>label</I><CODE>}</CODE>, where <I>label</I> is the item
label, to print its label.
Thus, users can change label formatting by redefining
<CODE>\makelabel</CODE>.
The default definition of <CODE>\makelabel</CODE> simply echoes <I>label</I>.
</DD></DL><P>As an example, a list with an user-defined counter can be defined as
follows:
</P><PRE CLASS="verbatim">\newcounter{coucou}
\begin{list}{\thecoucou}{%
\usecounter{coucou}%
\renewcommand{\makelabel}[1]{\textbf{#1}.}}
...
\end{list}
</PRE><P>This yields:
</P><DL CLASS="list"><DT CLASS="dt-list">
<B>1</B>.</DT><DD CLASS="dd-list">First item.
</DD><DT CLASS="dt-list"><B>2</B>.</DT><DD CLASS="dd-list">Second item.
</DD></DL><P>The <CODE>trivlist</CODE> environment is also supported. It is equivalent to
the <CODE>description</CODE> environment.</P><H3 CLASS="subsection"><A NAME="toc63"></A><A NAME="htoc81">B.6.4</A>  Verbatim</H3><P>The <CODE>verbatim</CODE> and <CODE>verbatim*</CODE> environments translate to
the <CODE>PRE</CODE> element.
Inside <CODE>verbatim*</CODE>, spaces are replaced by underscores (“<CODE>_</CODE>”).</P><P>Similarly, <CODE>\verb</CODE> and <CODE>\verb*</CODE> translate to the <CODE>CODE</CODE>
text element.</P><P>The <CODE>alltt</CODE> environment is supported.</P><HR>
<A HREF="manual027.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual022.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<A HREF="manual029.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
