DocBook 5.1: The Definitive Guide  (Version 1.5.3 for DocBook 5.1)

V5.0cover

cover — Additional content for the cover of a publication.

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), merge.

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.