This is an alpha version of this book.

highlights

Name

highlights — A summary of the main points of the discussed component

Synopsis

Content Model

highlights ::=
((calloutlist|glosslist|itemizedlist|orderedlist|segmentedlist|
  simplelist|variablelist|caution|important|note|tip|warning|
  formalpara|para|simpara|indexterm)+)

Attributes

Common attributes

Parameter Entities

The following parameter entities contain highlights:

Parameter Entities
%bookcomponent.content; %component.mix; %divcomponent.mix;
%genobj.class; %qandaset.mix; %refcomponent.mix;
%revdescription.mix; %sidebar.mix;  

Description

Highlights are generally presented at the beginning of a component and offer some sort of summary of the main points that will be discussed.

Processing expectations

Formatted as a displayed block. Highlights often contain some sort of list.

See Also

abstract, blockquote, epigraph, sidebar.

Examples

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<chapter><title>Example Chapter</title>
<highlights>
<para>
This chapter will teach you
<itemizedlist>
<listitem>
<para>
How to disassemble an automobile.
</para>
</listitem>
<listitem>
<para>
How to properly carry the component pieces.
</para>
</listitem>
<listitem>
<para>
How to reassemble an automobile in a standard telephone booth.
</para>
</listitem>
</itemizedlist>
</para>
</highlights>
<para>&hellip</para>
</chapter>

Copyright © 1999, 2000, 2001 O'Reilly & Associates, Inc.