Re: [docbook] Marking up marginalia notes...

[Stuart Hungerford <stuart.hungerford@anu.edu.au>]

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!

Stu

-- 

Stuart Hungerford
ANUSF Data Intensive Projects