DocBook: The Definitive Guide
PrevVersion 1.0.3.Next

BlockQuote

Name

BlockQuote -- A quotation set off from the main text

Synopsis

Content Model

BlockQuote ::=
(Title?,Attribution?,
 (CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList|
  SimpleList|VariableList|Caution|Important|Note|Tip|Warning|
  LiteralLayout|ProgramListing|ProgramListingCO|Screen|ScreenCO|
  ScreenShot|Synopsis|CmdSynopsis|FuncSynopsis|FormalPara|Para|
  SimPara|Address|BlockQuote|Graphic|GraphicCO|MediaObject|
  MediaObjectCO|InformalEquation|InformalExample|InformalFigure|
  InformalTable|Equation|Example|Figure|Table|MsgSet|Procedure|
  Sidebar|QandASet|Anchor|BridgeHead|Comment|Highlights|Abstract|
  AuthorBlurb|Epigraph|IndexTerm)+)

Attributes

Common attributes

Tag Minimization

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

Parameter Entities

%admon.mix;%bookcomponent.content;%component.mix;
%divcomponent.mix;%example.mix;%figure.mix;
%footnote.mix;%glossdef.mix;%indexdivcomponent.mix;
%informal.class;%legalnotice.mix;%para.mix;
%qandaset.mix;%refcomponent.mix;%sidebar.mix;
%textobject.mix;

Description

Block quotations are set off from the main text, as opposed to occurring inline.

Processing expectations

Formatted as a displayed block.

(4.0) Future Changes

Epigraph will not be allowed in BlockQuote in DocBook V4.0.

Parents

These elements contain BlockQuote: Answer, Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caption, Caution, Chapter, Colophon, Dedication, Example, Figure, Footnote, Glossary, GlossDef, GlossDiv, Important, Index, IndexDiv, InformalExample, InformalFigure, LegalNotice, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, Section, SetIndex, Sidebar, SimpleSect, Step, TextObject, Tip, Warning.

Children

The following elements occur in BlockQuote: Abstract, Address, Anchor, Attribution, AuthorBlurb, BlockQuote, BridgeHead, CalloutList, Caution, CmdSynopsis, Comment, Epigraph, Equation, Example, Figure, FormalPara, FuncSynopsis, GlossList, Graphic, GraphicCO, Highlights, Important, IndexTerm, InformalEquation, InformalExample, InformalFigure, InformalTable, ItemizedList, LiteralLayout, MediaObject, MediaObjectCO, MsgSet, Note, OrderedList, Para, Procedure, ProgramListing, ProgramListingCO, QandASet, Screen, ScreenCO, ScreenShot, SegmentedList, Sidebar, SimPara, SimpleList, Synopsis, Table, Tip, Title, VariableList, Warning.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

In some contexts, the following elements are excluded: Caution, Equation, Example, Figure, Important, IndexTerm, InformalTable, Note, Table, Tip, Warning.

See Also

Abstract, Attribution, Epigraph, Highlights, Sidebar

Examples

<!DOCTYPE blockquote PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<blockquote><attribution>Richard Dawkins</attribution>
<para>
The universe that we observe has precisely the properties we should 
expect if there is, at bottom, no design, no purpose, no evil and
no good, nothing but pitiless indifference.
</para>
</blockquote>
 

The universe that we observe has precisely the properties we should expect if there is, at bottom, no design, no purpose, no evil and no good, nothing but pitiless indifference.

 
--Richard Dawkins 

For additional examples, see also Attribution, LiteralLayout.

PrevHomeNext
BiblioSetUpBook

Copyright © 1999 O'Reilly & Associates, Inc. All rights reserved.