Advice needed on annotating page breaks...

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

-- 

Stuart Hungerford
ANUSF Data Intensive Projects


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org

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/doc
s/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
rlhamiltonfrii.com

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
> 


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org

Hi,

even if it is close to heresy, but wouldnt TEI (http://www.tei-c.org) be a
better choice of a DTD to preserve the structure of existing
dead-tree
documents? TEI was designed for that purpose and has a
variety of elements to
support problems like yours, e.g. the pb element that
denotes a pagebreak in
the original text.

regards,
Markus

> 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
> >
>
>
>
------------------------------------------------------------
---------
> To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
> For additional commands, e-mail: docbook-helplists.oasis-open.org
>
>


-- 
Markus Hoenicka
markus.hoenickacats.de
(Spam-protected email: replace the quadrupeds with
"mhoenicka")
http://www.mhoenicka.de


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org

Stuart Hungerford wrote:

> 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

It depends on your further processing requirements. But I
would use XML
processing instruction for such purpose.

			Jirka

-- 
------------------------------------------------------------
------
  Jirka Kosek     e-mail: jirkakosek.cz     http://www.kosek.cz
------------------------------------------------------------
------
  Profesionální školení a poradenství v oblasti technologií
XML.
     Podívejte se na náš nově spuštěný web http://DocBook.cz
       Podrobný přehled školení http://xmlguru.cz/skoleni/

------------------------------------------------------------
------
                   Nejbližší termíny školení:
    ** XSLT 23.-26.10.2006 ** XML schémata 13.-15.11.2006 **
     ** DocBook 11.-13.12.2006 ** XSL-FO 11.-12.12.2006 **
------------------------------------------------------------
------
  http://xmlguru.cz    Blog
mostly about XML for English readers
------------------------------------------------------------
------

Markus Hoenicka wrote:

> even if it is close to heresy, but wouldnt TEI (http://www.tei-c.org) be a
> better choice of a DTD to preserve the structure of
existing dead-tree
> documents? TEI was designed for that purpose and has a
variety of elements to
> support problems like yours, e.g. the pb element that
denotes a pagebreak in
> the original text.

    We did look at TEI, however for these documents I
believe DocBook is
    a better semantic match.

    Thanks,

Stu

-- 

Stuart Hungerford
ANUSF Data Intensive Projects


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org