Stuart,
Before DocBook 5.0, the <beginpage> element was the one
to use. But, <beginpage> didn't make it into 5.0 because
it caused some confusion (I think there were folks who
thought it was intended to define a page break for
downstream processors, which is not the case).
The DocBook 5.0 howto http://docbook.org/docs/howto/ suggests
that you use a processing instruction instead, so your idea of
using a processing instruction sounds to me like the way to go.
Best Regards,
Dick Hamilton
On Tue, 2006-10-24 at 17:00 +1000, Stuart Hungerford wrote:
> Hi,
>
> I need a little bit of advice from the DocBook community
> on the best way to handle this situation:
>
> We're creating DocBook documents that are re-typed
> versions of various old paper published documents. DocBook
> is a good match for the chapters, sections, tables and
> paragraphs etc that make up these source documents.
>
> It's very important to us to record where page breaks
> occur in the source documents and we're currently using
> <annotation> elements for this.
>
> The problem is that the DocBook 5 schema doesn't allow
> <annotation> elements to appear in all the places we
> need (e.g. between sections of a chapter, or before a
> chapter title).
>
> I can see several ways to handle this, but I'm not sure
> which way (if any) is best practice:
>
> - modify the schema to allow <annotation> elements
> anywhere
>
> - find a better element for these page breaks than
> <annotation>
>
> - use an XML processing instruction instead
>
> Any advice much appreciated,
>
> Stu
>
