| DocBook: The Definitive Guide 2.0.17 (Alpha)

# 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
pagenum | CDATA | None

## 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>

authorinitials |  | bibliocoverage

Copyright © 1999, 2000, 2001, 2002, 2003 O'Reilly & Associates, Inc. All rights reserved.