[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [dita-translation] Changes to documentation of xml:lang and translateattributes
Hi Gershon/others,
I agree we should keep it as a reference. We would have a hard time keeping
the list correct, as new values are added or modified - a DITA application
would have to wait for a new update to DITA before it could support a new
language. Also, I'd agree that a list of 100+ values would not be any
better for the user than a blank field.
In my experience, authors and translators never need to know more than one
or two values. The author can set the source language, or rely on the
editor or processing application to provide a default. Translators only
need to know the value for the language they are translating to.
Translation applications could aid in that as well.
I would expect that each application should choose which locales to
support. The DITA toolkit supports 47 language-region combinations; others
could choose to support only 10, or they could support over 100. It would
be up to that application to warn about any unsupported values. The toolkit
does that today if you try to generate text with an invalid value (if no
generated text is needed, then theoretically every language available in
Unicode will work).
Robert D Anderson
Authoring Tools Development
Chief Architect, DITA Open Toolkit
(507) 253-8787, T/L 553-8787
"Gershon L
Joseph"
<gershon@tech-tav To
.com> "'Farwell, Kevin'"
<Kevin.Farwell@lionbridge.com>,
03/08/2006 02:14 "'Felix Sasaki'" <fsasaki@w3.org>,
PM Robert D
Anderson/Rochester/IBM@IBMUS
cc
Please respond to <bhertz@sdl.com>, "'Bryan
gershon Schnabel'"
<bryan.s.schnabel@tek.com>, Charles
Pau/Cambridge/IBM@Lotus, "'Lieske,
Christian'"
<christian.lieske@sap.com>, Dave A
Schell/Raleigh/IBM@IBMUS,
<dita-translation@lists.oasis-open.
org>, <dpooley@sdl.com>, "'Richard
Ishida'" <ishida@w3.org>,
"'Jennifer Linton'"
<jennifer.linton@comtech-serv.com>,
<mambrose@sdl.com>,
<patrickk@scriptware.nl>,
<pcarey@lexmark.com>, "'Reynolds,
Peter'"
<Peter.Reynolds@lionbridge.com>,
<rfletcher@sdl.com>, "'Munshi,
Sukumar'"
<Sukumar.Munshi@lionbridge.com>,
<tony.jewtushenko@productinnovator.
com>, "'Yves Savourel'"
<ysavourel@translate.com>
Subject
RE: [dita-translation] Changes to
documentation of xml:lang and
translate attributes
If we hard-code it in the DTD, we'll have a hard time keeping the set of
allowable values up-to-date. Also, I've yet to find an accurate fully
up-to-date list of values on the Web that's not draft or incomplete. I
think
it should be up to the implementation to ensure the value entered is valid,
or to offer the user a list of options customized to the user's needs. I
suspect offering a list of about 100 values will confuse the user almost as
much as leaving them to research it themselves.
I don't mind adding a link in the spec documentation to an accurate list
that's always going to be kept updated. I have not found such a list (I'm
sure it exists, but I could find anything valuable via Google).
What do others think?
Best Regards,
Gershon
-----Original Message-----
From: Farwell, Kevin [mailto:Kevin.Farwell@lionbridge.com]
Sent: Wednesday, March 08, 2006 6:58 PM
To: gershon@tech-tav.com; Felix Sasaki; Robert D Anderson
Cc: bhertz@sdl.com; Bryan Schnabel; Charles Pau; Lieske, Christian; Dave A
Schell; dita-translation@lists.oasis-open.org; [email protected]; Richard
Ishida; Jennifer Linton; mambrose@sdl.com; [email protected];
pcarey@lexmark.com; Reynolds, Peter; [email protected]; Munshi, Sukumar;
tony.jewtushenko@productinnovator.com; Yves Savourel
Subject: RE: [dita-translation] Changes to documentation of xml:lang and
translate attributes
Hi,
I have a question about the values of the xml:lang attribute. With phrases
like "The allowed xml:lang values..." from the DITA reference and "This
attribute must be set to a language identifier, as defined..."
from the email below, I don't understand why the values aren't set in the
DTD and the users aren't given a list to pick from instead of a set of
rules
to follow. As an NMTOKEN, the value of the xml:lang attribute can be
anything the user desires as still be valid. If something must be enforced,
why leave it to users to enforce it? Why doesn't the content model enforce
it?
Confusion surrounding the locale codes is fairly easy to understand. The
textual description runs country-language, but the symbol runs
language-country. If a user is trying to remember the symbol for UK
English,
gb-en is as likely as en-gb, and even if they remember the country comes
first, why wouldn't UK English be en-uk? Latvian is lv-lv, so why isn't
Japanese ja-ja or jp-jp? If what's "allowed" "must" be in the attribute
value, why leave it to chance or leave it up to users doing research
(which,
in my opinion, are the same thing)?
Kevin
-----Original Message-----
From: Gershon L Joseph [mailto:gershon@tech-tav.com]
Sent: Wednesday, March 08, 2006 8:38 AM
To: 'Felix Sasaki'; 'Robert D Anderson'
Cc: bhertz@sdl.com; 'Bryan Schnabel'; 'Charles Pau'; 'Lieske, Christian';
'Dave A Schell'; dita-translation@lists.oasis-open.org;
dpooley@sdl.com; 'Richard Ishida'; 'Jennifer Linton'; [email protected];
patrickk@scriptware.nl; [email protected]; Reynolds, Peter;
rfletcher@sdl.com; Munshi, Sukumar; [email protected];
'Yves Savourel'
Subject: RE: [dita-translation] Changes to documentation of xml:lang and
translate attributes
Thank you all for your input. I'm replying to all comments in a single
email
to make it easier to follow this thread and where we're going...
Here are new proposals for the two attributes based on all the feedback
I've
received to-date, as well as our discussions during Monday's SC meeting.
My previous proposal kept the original descriptions in the current spec as
much as possible, and I'm glad I received the reactions I did (e.g.
English being the default language -- I felt uneasy about that one too).
I took the default values from the spec, which I now see confused everyone;
I've changed them to reflect their usage.
PROPOSAL FOR translate ATTRIBUTE:
Name: translate
Description: Indicates whether the content of the element should be
translated or not. The translate attribute setting applies to the element
on
which it is set, and is inherited by all child elements that do not specify
the translate attribute. The translate attribute does not indicate whether
attribute values of the element and its children should be translated;
attribute values should never be translated. If this attribute is not
specified on the document element, then processors must assume
translate="yes".
Data Type: yes | no
Default Value: Not set
Required: #IMPLIED
PROPOSAL FOR xml:lang ATTRIBUTE:
Name: xml:lang
Description: Specifies the language and locale of the element content.
The intent declared with xml:lang is considered to apply to all attributes
and content of the element where it is specified, unless overridden with an
instance of xml:lang on another element within that content. When no
xml:lang value is supplied, the processor should assume a default value.
This attribute must be set to a language identifier, as defined by IETF RFC
3066 (http://www.ietf.org/rfc/rfc3066.txt) or successor.
Data Type: NMTOKEN
Default Value: Not set
Required: #IMPLIED
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]