Synopsis

Content Model

Attributes

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.

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>