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

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-translation message

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


Subject: Re: [dita-translation] Acronym proposal


This time with some small corrections to spelling etc.

Best Regards,

AZ

Robert D Anderson wrote:
> As requested in today's meeting, I'm sending along the technical comments
> on this proposal.
> 
> The sample conref syntax needs to include the topic ID when referencing an
> element:
> <acronym conref="acronyms.dita#acronyms/abs"/>
> 
> The <acronym> element itself probably should not be specialized from
> <data>, because the <data> element represents metadata, and by default it
> is not included in the output. A better choice would be <keyword>. However,
> the keyword element today does not have children of its own, so this would
> be dependent on another DITA 1.2 requirement for keywords to nest keywords.
> 
> I would suggest that the proper specialization would be to specialize
> acronym from <keyword>, expanded from <keyword>, and <short> from <data>.
> This would mean that the expanded term is a normal phrase, while the short
> form is metadata that is hidden when processes do not know what to do with
> it. Processes that are prepared for this element will choose the proper one
> for display.
> 
> So, the model would be:
> <acronym>  ==> specialize from keyword
>   <expanded/>  ==> specialize from keyword
>   <short/>  ==> specialize from data
> </acronym>
> 
> Robert D Anderson
> IBM Authoring Tools Development
> Chief Architect, DITA Open Toolkit
> (507) 253-8787, T/L 553-8787
> 
> 
>                                                                            
>              "Rodolfo M. Raya"                                             
>              <rmraya@heartsome                                             
>              .net>                                                      To 
>                                        <dita-translation@lists.oasis-open. 
>              05/07/2007 09:53          org>                                
>              AM                                                         cc 
>                                                                            
>                                                                    Subject 
>                                        [dita-translation] Acronym proposal 
>                                                                            
>                                                                            
>                                                                            
>                                                                            
>                                                                            
>                                                                            
> 
> 
> 
> 
> Hi All,
> 
> Please find attached a revised version of the <acronym> proposal.
> 
> Best regards,
> Rodolfo
> --
> The information in this e-mail is intended strictly for the addressee,
> without prejudices, as a confidential document. Should it reach you,
> not being the addressee, it is not to be made accessible to any other
> unauthorised person or copied, distributed or disclosed to any other
> third party as this would constitute an unlawful act under certain
> circumstances, unless prior approval is given for its transmission. The
> content of this e-mail is solely that of the sender and not necessarily
> that of Heartsome.
> [attachment "acronym.html.zip" deleted by Robert D Anderson/Rochester/IBM]
> 
> 
> 


-- 


email - azydron@xml-intl.com
smail - c/o Mr. A.Zydron
	PO Box 2167
         Gerrards Cross
         Bucks SL9 8XF
	United Kingdom
Mobile +(44) 7966 477 181
FAX    +(44) 1753 480 465
www - http://www.xml-intl.com

This message contains confidential information and is intended only
for the individual named.  If you are not the named addressee you
may not disseminate, distribute or copy this e-mail.  Please
notify the sender immediately by e-mail if you have received this
e-mail by mistake and delete this e-mail from your system.
E-mail transmission cannot be guaranteed to be secure or error-free
as information could be intercepted, corrupted, lost, destroyed,
arrive late or incomplete, or contain viruses.  The sender therefore
does not accept liability for any errors or omissions in the contents
of this message which arise as a result of e-mail transmission.  If
verification is required please request a hard-copy version. Unless
explicitly stated otherwise this message is provided for informational
purposes only and should not be construed as a solicitation or offer.



acronym-proposal.zip



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