beginpage

$Revision: 1666 $

$Date: 2002-06-12 07:19:37 -0400 (Wed, 12 Jun 2002) $

beginpage — The location of a page break in a print version of the document

Synopsis

Content Model

beginpage ::=
EMPTY

Attributes

Common attributes

Name

Type

Default

pagenumCDATANone

Description

The BeginPage element marks the location of an actual page break in a print version of the document, as opposed to where a page break might appear in a further rendition of the document. This information may be used, for example, to allow support staff using an online system to coordinate with a user referring to a page number in a printed manual.

Processing expectations

The break identified by BeginPage may be displayed in an online version of the document or used for legacy purposes, but it is not expected to cause a page break when the document is processed by an SGML system.

Parents

These elements contain beginpage: abbrev, accel, acronym, action, appendix, application, article, attribution, bibliodiv, bibliography, bibliomisc, blockquote, callout, caution, chapter, citation, citetitle, classname, classsynopsisinfo, code, command, computeroutput, constant, constraintdef, database, dedication, emphasis, entry, envar, errorcode, errorname, errortext, errortype, example, exceptionname, figure, filename, firstterm, foreignphrase, funcparams, funcsynopsisinfo, function, glossary, glossdef, glossdiv, glosssee, glossseealso, glossterm, guibutton, guiicon, guilabel, guimenu, guimenuitem, guisubmenu, hardware, important, index, indexdiv, informalexample, informalfigure, initializer, interface, interfacename, itemizedlist, keycap, keycode, keysym, label, legalnotice, lineannotation, link, listitem, literal, literallayout, lot, lotentry, manvolnum, markup, medialabel, member, methodname, modifier, mousebutton, msgaud, msgexplan, msglevel, msgorig, msgtext, note, olink, option, optional, orderedlist, package, para, parameter, part, partintro, phrase, preface, procedure, productname, programlisting, prompt, property, quote, refentry, refentrytitle, reference, refpurpose, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, remark, returnvalue, screen, screeninfo, sect1, sect2, sect3, sect4, sect5, section, seg, setindex, sgmltag, sidebar, simpara, simplesect, step, structfield, structname, symbol, synopsis, systemitem, taskprerequisites, taskrelated, tasksummary, td, term, termdef, th, tip, toc, tocback, tocentry, tocfront, token, type, ulink, uri, userinput, variablelist, varname, warning, wordasword.

Attributes

pagenum

PageNum contains the page number of the page in the printed document which begins at the location of the BeginPage element.

Examples

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<chapter id="ch-publish">
<chapterinfo>
<beginpage pagenum="64"/> <!-- first edition -->
</chapterinfo>
<title>Publishing DocBook Documents</title>

<para>Creating and editing &SGML;/&XML; documents is usually only half the
battle. After you've composed your document, you'll want to publish
it. Publishing, for our purposes, means either print or web
publishing. For &SGML; and &XML; documents, this is usually
accomplished with some kind of <glossterm>stylesheet</glossterm>.  In
the (not too distant) future, you may be able to publish an &XML;
document on the Web by simply putting it online with a stylesheet, but
for now you'll probably have to translate your document into &HTML;.
</para>

<!-- ... -->
</chapter>