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


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

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

Subject: Re: [docbook-apps] acronyms, abbreviations, definitions

Hello again,
since no one has replied: should I be asking this question somewhere else?

I have also searched the archives, but have not found any relevant info. 
One thread in Nov.2006 dealt with the usefulness of acronyms 
(personally, I really need these to meet accessibility requirements!), 
but unfortunately did not mention how to include their expansions in 

So thanks for any pointers on how to go about finding a solution to this!

Nathalie Sequeira wrote:
> Hello list!
> 1. I'm  a bit insecure on how to mark up inline acronyms & 
> abbbreviations in docBook.
> Coming from XHTML, I was expecting an attribute that can contain their 
> written-out counterparts, somewhat like
> <abbr title="United Nations">UN</abbr>
> but cannot find a similar mechanism in the docBook 5 online reference.
> Is there any "standard" way of including this essential information?
> Or should we do something like
> <abbreviation>UN<phrase>United Nations</phrase></abbreviation>
> and let XSL transformation deal with the <phrase/> (or is another 
> element semantically more adequate?), either setting it in parentheses 
> inline, creating a linked list of glossary terms at the end of the 
> text (e.g. for PDF output) or transforming into HTML attributes in 
> HTML output?
> 2. Is there an element that is suited for inline definitions (I 
> haven't found any obvious choice and am quite lost on how to get this 
> done...)?
> Thanks for any thoughts on this!
> Nathalie Sequeira
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

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