Re: [docbook] Re: DocBook Annotations

From
Jirka Kosek <>
Date
2005-02-16T18:05:17+00:00
ID
Thread
Re: [docbook] Re: DocBook Annotations
Norman Walsh wrote:

> We could instead do this:
> 
> ...
> <info>
> <annotation xml:id="anot.tooltip">
> <title>Tool Tips</title>
> <para>A tool tip is a word or short phrase displayed automatically by
> an application when the user hovers the mouse over some component in the
> user interface.</para></annotation>
> </info>
> ...
> <para>Modern browsers display acronym expansions and link titles as
> “<phrase annotations="anot.tooltip">tool tips</phrase>”.</para>
> 
> This moves the annotation out of line and allows more than one element
> to point to it. (annotations is an IDREFS, though then folks will
> wonder if xlink:href works there...)

And what about allowing annotation almost everywhere (like indexterm) 
with the following semantic:

- if annotation have xml:id then it could be referenced by IDREFS 
attribute from other elements
- if annotation doesn't have xml:id then it belongs to its parent

This will allow users to select style of annotating that they prefer.

Thoughts?

					Jirka

-- 
------------------------------------------------------------------
   Jirka Kosek     e-mail:      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/
------------------------------------------------------------------