DocBook: The Definitive Guide

docbook: the definitive guide
By Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide


Highlights -- A summary of the main points of the discussed component


Content Model

Highlights ::= ((CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList|   SimpleList|VariableList|Caution|Important|Note|Tip|Warning|   FormalPara|Para|SimPara|IndexTerm)+)


Common attributes

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities



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.


These elements contain Highlights: Answer, Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Chapter, Glossary, GlossDiv, Index, ListItem, MsgExplan, MsgText, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, Section, SetIndex, Sidebar, SimpleSect, Step.


The following elements occur in Highlights: CalloutList, Caution, FormalPara, GlossList, Important, IndexTerm, ItemizedList, Note, OrderedList, Para, SegmentedList, SimPara, SimpleList, Tip, VariableList, Warning.

In some contexts, the following elements are excluded: Caution, Important, IndexTerm, Note, Tip, Warning.

See Also

Abstract, BlockQuote, Epigraph, Sidebar


<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <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>


Back to: DocBook: The Definitive Guide

O'Reilly Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies

© 1999, O'Reilly & Associates, Inc.

DocBook. The Definitive Guide
DocBook 5: The Definitive Guide
ISBN: 0596805020
EAN: 2147483647
Year: 1999
Pages: 412
Authors: Walsh Norman, Richard L. Hamilton

Similar book on Amazon
DocBook XSL: The Complete Guide (4th Edition)
DocBook XSL: The Complete Guide (4th Edition)
XSLT, 2nd Edition
XSLT, 2nd Edition
XSLT Cookbook: Solutions and Examples for XML and XSLT Developers, 2nd Edition
XSLT Cookbook: Solutions and Examples for XML and XSLT Developers, 2nd Edition
XML: Visual QuickStart Guide (2nd Edition)
XML: Visual QuickStart Guide (2nd Edition) © 2008-2017.
If you may any questions please contact us: