OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook] Advice needed on annotating page breaks...


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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]