Whole document tree


www.fifi.org
    Documentation
        Manpages
        GNU Info
        Debian document tree
        Whole document tree
    Trigance web page
    Public services
    User info
    Mailing lists
    Secure server
    Multilingual usage
 

Copyright (C) 2000-2012
Philippe Troin
<webmaster@fifi.org>.

Validate HTML
Validate CSS

    

Whole document tree

BeginPage
Guide to the DocBook DTD
PrevNext

BeginPage

Name

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

Content Model

  EMPTY

Attributes

This element has common and Role attributes.

NameValue(s)TypeDefault Value
PagenumCDATA#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, 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>
PrevHomeNext
AuthorInitialsUpBiblioDiv