DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

V5.0acknowledgements

acknowledgements — Acknowledgements of a book or other component.

Synopsis

acknowledgements ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • label
  • status

Additional Constraints

  • If this element is the root element, it must have a version attribute.

Description

The acknowledgements section of a book or other component provides the author(s) with a place to identify individuals, organizations, and other sources of support and to acknowledge their contributions to the work.

Processing expectations

Formatted as a displayed block. In books, it usually introduces a forced page break and often starts on the next recto page. In smaller components, such as articles, it may simply appear as another section.

Attributes

Common attributes and common linking attributes.

label

Specifies an identifying string for presentation purposes

status

Identifies the editorial or publication status of the element on which it occurs

Parents

These elements contain acknowledgements: article, book, part.

Children

The following elements occur in acknowledgements: address, anchor, bibliolist, blockquote, bridgehead, calloutlist, dialogue, drama, epigraph, equation, example, figure, formalpara, glosslist, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.info), info (db.titleforbidden.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandaset, remark, revhistory, sidebar, simpara, simplelist, subtitle, table, task, title, titleabbrev, variablelist.

Examples

<book xmlns='http://docbook.org/ns/docbook'>
<title>An Example Book</title>
<info>
  <author><personname>
    <firstname>Norman</firstname><surname>Walsh</surname>
  </personname></author>
</info>

<acknowledgements>
<para>Many thanks to the hundreds of contributors to the
example project. In particular, I'd like to thank the following
individuals, without whose contributions, this work would
not be half as useful:</para>
<itemizedlist>
<listitem>
<para><personname><firstname>A</firstname>
<surname>Nonymous</surname></personname>, for …
</para>
</listitem>
<!-- ... -->
</itemizedlist>
</acknowledgements>

<chapter><title>A Chapter</title>
<para>The body of the book…</para>
</chapter>
</book>