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] Marking up marginalia notes...

Michael(tm) Smith wrote:

> [...]
> That sounds like what TEI is intended for. Is there a reason you
> decided to use DocBook instead of TEI?

   These documents are mostly census reports and tabulations and
   contain large numbers of complex tables, charts, maps, tables
   of contents in a rigid heirarchy of sections, parts, divisions,
   publications etc.  So far there's relatively little "free"
   text other than some opening paragraphs in each volume.

   DocBook seemed to be a better semantic match for this kind of
   document, although I'm happy to be persuaded otherwise.

>> Some of these publications have paragraphs with notes printed
>> next to them in the margin in much smaller type.
> [...]
> The annotation element and annotations attribute:
>   http://www.docbook.org/tdg5/en/html/annotation.html
>   http://www.docbook.org/tdg5/en/html/ref-elements.html#db.cmn.annotations
> You can associate an annotation with a particular element either
> by putting an "annotations" attribute on the element, with its value
> set to the xml:id value of the annotation; or you can do it by
> putting an "annotates" attribute on the annotation, with its value
> set to the xml:id of the element it annotates.

    That's very useful -- thanks!



Stuart Hungerford
ANUSF Data Intensive Projects

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