Reference. Reference for the DocBook DTD

[Prev] [Next]


BeginPage

Name

BeginPage---Page break in a print version of a work that may be displayed online

Synopsis

Content Model
  EMPTY

Attributes

This element has common and Role attributes.

Name Value(s) Type Default Value
Pagenum CDATA #IMPLIED  

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Description

BeginPage marks a page break in a print version of a work that may be displayed online. It is without content, but has common and PageNum attributes.

The value of PageNum, which is not required, should be the folio (page number) of the page beginning at that point.

Usage

Once you give a PageNum to a BeginPage, subsequent BeginPages should be assumed to indicate that value incremented by one per BeginPage. You can indicate a change or reset in page numbering by providing a PageNum value for a later BeginPage.

BeginPage, like IndexTerm, is handled as an SGML inclusion. To generalize, if you parse a DocBook instance that has as its doctype a structure smaller than Sect1 or RefEntry, your SGML parser will not pick up the inclusion, and you will have to include a modification of the doctype element in the document type declaration, or redefine the element in your customization layer.

Parents

These elements contain BeginPage at all levels by inclusion.Appendix, Article, Book, Chapter, Part, PartIntro, Preface, RefEntry, Reference, Sect1, Set, and SimpleSect

Attributes

Pagenum

PageNum is the number of the page on which a given element begins or occurs in a printed book.

Examples

<CHAPTER><TITLE>BeginPage is a Chapter-Level Inclusion</TITLE>
<PARA>
Use BeginPage to show <BEGINPAGE PAGENUM="7"> your 
help desk personnel where information occurs in the
printed version of the documentation.
Or to show where the page breaks in some important text,
<BLOCKQUOTE>
<PARA>&hellip;An external entity is one where the replacement
text itself does <BEGINPAGE PAGENUM="378"> not appear
in the entity declaration &hellip; .
</PARA></BLOCKQUOTE>
so that the reader can understand its significance better.
</PARA>
</CHAPTER>


[Prev] base.char.class
[Next] BiblioDiv
[Reference Home] [Davenport Group Home]