cover
cover — Additional content for the cover of a publication.
Synopsis
- One or more of:
bridgehead
dialogue
drama
poetry
remark
revhistory
- Graphic elements
- Informal elements
- List elements
- Paragraph elements
- Publishing elements
- Technical elements
- Verbatim elements
Attributes
Description
The cover
element contains additional material
to be printed on the cover of a publication. Multiple
cover
elements may be used to hold material for the
inside and outside front and back covers, the spine, dust jackets,
etc.
Because there is likely to be great variation in the number of
covers, and the means by which the cover
elements are
processed, DocBook does not attempt to define semantics for their order
or relationship to one another.
The title, authors, and other bibliographic metadata that appears
in the info
element should not be repeated inside the
cover
. The intent is merely that
cover
can contain any additional material
required.
Processing expectations
Formatted as a displayed block. Sometimes suppressed.
Parents
These elements contain cover
: biblioentry
, bibliomixed
, bibliomset
, biblioset
, info
(db.info), info
(db.titleforbidden.info), info
(db.titleonly.info), info
(db.titleonlyreq.info), info
(db.titlereq.info).
Children
The following elements occur in cover: address
, anchor
, bibliolist
, blockquote
, bridgehead
, calloutlist
, dialogue
, drama
, epigraph
, formalpara
, glosslist
, informalequation
, informalexample
, informalfigure
, informaltable
, itemizedlist
, literallayout
, mediaobject
, orderedlist
, para
, poetry
, procedure
, qandaset
, remark
, revhistory
, sidebar
, simpara
, simplelist
, task
, variablelist
.
Examples
The following example shows a cover
tag as it might
have appeared in the source for the first edition of this book.
<book xmlns='http://docbook.org/ns/docbook'>
<info>
<title>DocBook</title>
<subtitle>The Definitive Guide</subtitle>
<biblioid class="isbn">978-0-596-8050-2-9</biblioid>
<authorgroup>
<author>
<personname>
<firstname>Norman</firstname>
<surname>Walsh</surname>
</personname>
</author>
</authorgroup>
<publisher>
<publishername>O'Reilly Media, Inc.</publishername>
<address><city>Beijing</city></address>
<address><city>Cambridge</city></address>
<address><city>Farnham</city></address>
<address><city>Köln</city></address>
<address><city>Paris</city></address>
<address><city>Sebastopol</city></address>
<address><city>Taipei</city></address>
<address><city>Tokyo</city></address>
</publisher>
<copyright>
<year>2010</year>
<holder>Norman Walsh, All rights reserved.</holder>
</copyright>
<releaseinfo>Published by O'Reilly Media, Inc.,
101 Morris Street, Sebastopol, CA 95472.</releaseinfo>
<editor>
<personname>
<firstname>Richard L.</firstname>
<surname>Hamilton</surname>
</personname>
</editor>
<revhistory>
<revision>
<date>March 2010</date>
<revremark>Second Edition.</revremark>
</revision>
<revision>
<date>October 1999</date>
<revremark>First Edition.</revremark>
</revision>
</revhistory>
<legalnotice>
<para>Nutshell Handbook, the Nutshell Handbook logo, and the…</para>
<para>Many of the designations used by manufacturers…</para>
<para>While every precaution has been taken in the preparation…</para>
</legalnotice>
<cover>
<para role="tagline">The Official Documentation for DocBook</para>
<mediaobject>
<imageobject>
<imagedata fileref="graphics/duck-cover.png">
<info>
<othercredit>
<orgname>O'Reilly Media</orgname>
</othercredit>
<othercredit>
<orgname>Dover Archives</orgname>
</othercredit>
</info>
</imagedata>
</imageobject>
</mediaobject>
</cover>
<cover>
<mediaobject>
<imageobject>
<imagedata fileref="graphics/duck-backcover.png"/>
</imageobject>
</mediaobject>
<para>DocBook is a system for writing structured documents using…</para>
<para><citetitle>DocBook: The Definitive Guide</citetitle> is the…</para>
<itemizedlist>
<listitem>
<para>A brief introduction to …</para>
</listitem>
<listitem>
<para>A guide to creating documents with the DocBook schema…</para>
</listitem>
<listitem>
<para>…</para>
</listitem>
</itemizedlist>
<para>In an era of collaborative creation of technology, …</para>
<formalpara>
<title>Norman Walsh</title>
<para>is a …</para>
</formalpara>
</cover>
</info>
<preface>
<title>Preface</title>
<para>DocBook provides a system …</para>
</preface>
<!-- … -->
</book>
In this example, we assume that the first cover
element
contains additional material for the front cover and the second
cover
element contains additional material for the back cover.