[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: DITA Subcommittee Agenda -- 3 April 2006
Hello All, Agenda for Monday 3 April 2006 11:00 am - 12:00 am Eastern Standard Team (-5 GMT) DITA Technical Committtee teleconference USA Toll Free Number: 866-566-4838 USA Toll Number: +1-210-280-1707 PASSCODE: 185771 Gershon Joseph will chair today's meeting. I am at the CMS conference in San Francisco. Roll Call Approve Minutes from 27 March 2006 (enclosed for those who are not TC members) http://www.oasis-open.org/apps/org/workgroup/dita-translation/download.p hp/17431/SCmeeting060327.txt Action Items: Discussion of the dir attribute proposal (Gershon Joseph, Kevin Farwell, Richard Ischida) Use cases for the xml:lang attribute (submitted by JoAnn Hackos) New Business The goal is to close on these proposals based on the discussion this week and submit the detailed explanations to the DITA TC for the 1.1 specification. These are links to the current submissions. They are also attached to this agenda for non-members. http://www.oasis-open.org/apps/org/workgroup/dita-translation/email/arch ives/200603/msg00051.html http://www.oasis-open.org/apps/org/workgroup/dita-translation/email/arch ives/200603/msg00051.html http://www.oasis-open.org/apps/org/workgroup/dita-translation/email/arch ives/200603/msg00052.html Below are the links to last week's proposals. I hope everyone already has this information from last week's agenda. Continued discussion of dir during the week. 1) Re: Proposal for the xml:lang attribute specification -- presentation by Gershon http://www.oasis-open.org/apps/org/workgroup/dita-translation/email/arch ives/200603/msg00042.html 2) Re: Proposal for the dir attribute specification -- presentation by Gershon http://www.oasis-open.org/apps/org/workgroup/dita-translation/email/arch ives/200603/msg00043.html JoAnn JoAnn T. Hackos, PhD President Comtech Services, Inc. 710 Kipling Street, Suite 400 Denver, CO 80215 303-232-7586 joann.hackos@comtech-serv.com http://www.comtech-serv.com <http://www.comtech-serv.com/> Skype joannhackos JoAnn JoAnn T. Hackos, PhD President Comtech Services, Inc. 710 Kipling Street, Suite 400 Denver, CO 80215 303-232-7586 joann.hackos@comtech-serv.com http://www.comtech-serv.com <http://www.comtech-serv.com/> Skype joannhackos
MEETING MINUTES -- 27 March 2006 -- DITA TRANSLATION SUBCOMMITTEE (Minutes taken by Gershon Joseph <gershon@tech-tav.com>) Date: Monday, 27 March 2006 Time: 08:00 - 09:00 PST DITA Translation Subcommittee resources: - SC Web site: http://www.oasis-open.org/apps/org/workgroup/dita-translation/index.php - Mailing list: dita-translation@lists.oasis-open.org - Non-OASIS members please email Gershon or Don and we'll post on your behalf Roll Call - Present: Chris Wong, Kevin, Robert, Don, Gershon, JoAnn, Yves, Andrzej - Regrets: Felix Review/approve minutes from previous meeting (20 March 2006) - http://lists.oasis-open.org/archives/dita-translation/200603/msg00041.html - Don moves to accept the minutes as read, Robert accepts, no objections, approved by acclamation. Announcement: Many thanks to Andrzej Zydron for his presentation of the workflow for DITA + xml:tm New Business 1) Proposal for the xml:lang attribute specification -- presentation by Gershon http://www.oasis-open.org/archives/dita-translation/200603/msg00042.html - JoAnn read new additions to proposal (sections "Recommended Usage" and "Note to Vendors/Implementers") - Chris -- Should xml:lang attribute be used as sparingly as possible? -- Worries about xml:lang being used on root element. - Andrzej -- I fully support the proposal that calls for maximum use of xml:lang. - Chris -- <dita> has no content, so what's the purpose of setting xml:lang on it (as the root element)? - Robert -- No attributes on <dita>, only on <topic> and peers - Andrzej -- <topic> etc. have xml:lang attribute. - DISCUSSION -- We're talking about the root topic element. -- If xml:lang is on document element, then the highest level topic element inherits xml:lang. Likewise, <topicref> should inherit from <map> (if no parent overrides xml:lang) or from nearest parent that overrides the xml:lang setting of the root element. -- In case of contradiction between xml:lang setting on <topicref> and xml:lang on <topic>, the <topicref> setting does not apply to the <topic>. In other words, the map does not override any xml:lang on the <topic>. -- Discussion whether xml:lang on map should apply to the topics... -- Discussion of translation workflow... -- Need map file for each target language. -- Proposal must clarify the following: - xml:lang on <map> is applied to the map. - xml:lang on <map> does not affect topics. - if different xml:lang values exist on map and topic, topic setting overrides. - add use cases --ACTION-- JoAnn to write up use case --ACTION-- Nancy to write up use case --ACTION-- Everyone to circulate xml:lang use cases on the email list. Gershon to amend proposal to include maps and clarify which elements in DITA are in effect the root elements for xml:lang settings. 2) Proposal for the dir attribute specification -- presentation by Gershon http://www.oasis-open.org/archives/dita-translation/200603/msg00043.html - JoAnn -- summarizes proposal - Kevin -- I still owe Gershon a couple of paragraphs on output. --ACTION-- Kevin to submit output sections this week. - Any other DITA 1.1 best practices we want to provide? - Don -- We must submit xml:lang and dir best practices next week. - Workflow proposal (led by Andrzej) - Rodolfo -- It's not necessary to use xml:tm or XLIFF, though both do have advantages. - DISCUSSION... - Don -- it's a recommendation, not mandatory -- our recommended workflows should show with xml:tm and without. - DISCUSSION... - Everyone to look at the 2 proposal received and we'll discuss next week. - Everyone to look at the new DITA Web site (http://dita.xml.org/) and see if it's the way to provide best practice information/recommendations. - Don -- We need recommended scenarios for enterprise as well as small workgroups - JoAnn -- We should have 2: one with CMS and one without CMS. - We should also have the following: - a simple model with open source only. - CMS model without xml:tm. - CMS with xml:tm model. - enterprise vs small/medium documentation team (5-20 or 50 members) - Patrick may be able to provide small business use case. Next week: - discuss and approve final xml:lang and dir proposals with amendments as above - discuss progress on workflow proposals --Meeting adjourned--
--- Begin Message ---
- From: "JoAnn Hackos" <joann.hackos@comtech-serv.com>
- To: <dita-translation@lists.oasis-open.org>,<cwong@idiominc.com>,<Kevin_Farwell@lionbridge.com>,<nancyph@us.ibm.com>,<robander@us.ibm.com>,<mambrose@sdl.com>,"Andrzej Zydron" <azydron@xml-intl.com>,<bhertz@sdl.com>,"Bryan Schnabel" <bryan.s.schnabel@tek.com>,<dpooley@sdl.com>,<dond@us.ibm.com>,<dschell@us.ibm.com>,<fsasaki@w3.org>,<rfletcher@sdl.com>,<gershon@tech-tav.com>,"Howard.Schwartz" <Howard.Schwartz@trados.com>,"Jennifer Linton" <jennifer.linton@comtech-serv.com>,"JoAnn Hackos" <joann.hackos@comtech-serv.com>,<patrickk@scriptware.nl>,<Peter.Reynolds@lionbridge.com>,<ishida@w3.org>,<rodolfo@heartsome.net>,"Sandi Castle" <sandi@siberlogic.com>,<Sukumar.Munshi@lionbridge.com>,<tony.jewtushenko@productinnovator.com>,<ysavourel@translate.com>
- Date: Fri, 31 Mar 2006 10:44:47 -0600
--- End Message ---
Use case for xml:langTechnical manuals frequently contain entire topics that are in languages different from the primary source languages of most of the topics. A manual in English, for example, may contain warnings that are in multiple languages, or have multiple topics of warnings each in individual languages. A manual may also contain regulatory notices as individual topics in different languages.Therefore, a map might reference topics that are written and labelled (xml:lang) in more than one language. In this case, it may be useful to encode xml:lang at the map level to ensure that the correct language version of the topic is selected."I'm not entirely sure that the map encoding woudl be the best way to handle this scenario. I await your expert advice."JoAnn
JoAnn T. Hackos, PhD
President
Comtech Services, Inc.
710 Kipling Street, Suite 400
Denver, CO 80215
303-232-7586
joann.hackos@comtech-serv.com
http://www.comtech-serv.com
Skype joannhackos
--- Begin Message ---Title: [dita-translation] RE: Proposal - dir attribute
- From: "Gershon L Joseph" <gershon@tech-tav.com>
- To: <dita-translation@lists.oasis-open.org>,<mambrose@sdl.com>,<pcarey@lexmark.com>,<rfletcher@sdl.com>,<bhertz@sdl.com>,"Richard Ishida" <ishida@w3.org>,<tony.jewtushenko@productinnovator.com>,"Lieske, Christian" <christian.lieske@sap.com>,"Jennifer Linton" <jennifer.linton@comtech-serv.com>,"Munshi, Sukumar" <Sukumar.Munshi@lionbridge.com>,"Charles Pau" <charles_pau@us.ibm.com>,<dpooley@sdl.com>,"Reynolds, Peter" <Peter.Reynolds@lionbridge.com>,"Felix Sasaki" <fsasaki@w3.org>,"Yves Savourel" <ysavourel@translate.com>,"Dave A Schell" <dschell@us.ibm.com>,"Bryan Schnabel" <bryan.s.schnabel@tek.com>
- Date: Fri, 31 Mar 2006 03:55:33 -0600
Hi Richard,
Thanks for this feedback. Essentially you're saying directionality is
independent of the language. I was trying to reduce the work of
authors/translators by inferring an initial direction from the xml:lang
attribute. If we remove the initial directionality defaulting based on
language, we have two choices:* Assume a direction of LTR unless otherwise specified, regardless of the
xml:lang. This means that on an Arabic or Hebrew document, the author will
have to explicitly set dir on the root element of every document. Users
generally expect setting the language gives them the correct directionality
for the language. Perhaps tools could handle this automatically for the
user.* Require the user to set dir on the root element, and have it optional
everywhere else.I think we should adopt the same approach as we did for xml:lang, in that
the attribute is optional, but best practice recommends using it on the root
element of each document.Treating directionality independently from language definitely simplifies
the algorithm, and probably makes it easier for users to understand too.Does everyone agree that we should separate directionality from language?
Any other comments?
Best Regards,
Gershon-----Original Message-----
From: Richard Ishida [mailto:ishida@w3.org]
Sent: Monday, March 27, 2006 2:45 PM
To: gershon@tech-tav.com; dita-translation@lists.oasis-open.org;
mambrose@sdl.com; pcarey@lexmark.com; rfletcher@sdl.com; bhertz@sdl.com;
tony.jewtushenko@productinnovator.com; 'Lieske, Christian'; 'Jennifer
Linton'; 'Munshi, Sukumar'; 'Charles Pau'; dpooley@sdl.com; 'Reynolds,
Peter'; 'Felix Sasaki'; 'Yves Savourel'; 'Dave A Schell'; 'Bryan Schnabel'
Cc: 'Richard Ishida'
Subject: RE: Proposal - dir attributeHello Gershon,
[Please forward this email to lists I am unable to reach.]
I have the following comments on the proposal:
[1]
===
"1. xml:lang attribute on the document element or, if not specified, default
language assumed by the processor. Directionality is determined by the
Unicode bidirectional algorithm for this language."2. xml:lang attribute on any element that overrides the inherited
language. Again, directionality is determined by the Unicode bidirectional
algorithm for the specified language."xml:lang should be used to declare language only, and not directionality,
because:(a) It does *not* give information about directionality. Direction cannot
be inferred from that information. For example, Azerbaijani is written LTR
in Azerbaijan (Latin script) but RTL in Iran (Arabic script) - yet it is
still xml:lang="az" in both cases. The same applies for non-standard
orthographies (for example an IPA transcription of Hebrew in W3C's Speech
Synthesis Markup Language should be labelled xml:lang="he", but *not*
dir="rtl").(b) dir could be used inline within the same paragraph with values of ltr in
one place and rtl in another. xml:lang is not designed for this type of use,
and so dir is needed anyway - why complicate matters by having two ways to
designate directionality, one of which is incapable of actually doing most
of the job? Better reduce confusion and scope for error by having simple,
clear semantics to the attributes.(c) The Unicode bidi algorithm works on the basis of the Unicode character
semantics as modified by directional embedding directives (ie. dir), not the
language expressed in xml:lang, so 'the Unicode bidirectional algorithm for
this language' doesn't make sense.(d) In a document that is generally in English you may have a small table
that contains only Hebrew or Arabic text. Although it would make sense to
use xml:lang on the table markup, so that you don't have to repeat it, you
would probably *not* want the table columns to flow from right to left (as
would usually be the case when using dir="rtl" on the table), since this is
an English document. If xml:lang was associated with direction, you would
probably have no control over that. Same goes for list items.(e) Note that, once you have established the general directionality of the
document, you *don't* have to specify dir for every instance of RTL text.
If I wanted to display the following HTML text that in memory reads"
<p>He said 'arabic arabic arabic arabic' to me.</p> in any of the
major desktop browsers today, no dir is needed for the bidi algorithm to
correctly render the text as
<p>He said 'cibara cibara cibara cibara' to me.</p> Although
xml:lang might be useful to identify the extent of the arabic language, that
declaration has nothing to do with the correct ordering of characters.
[2]
===
"Text direction cannot be sufficiently specified by the xml:lang attribute
alone"So really I'm saying
"Text direction cannot be sufficiently specified by the xml:lang attribute
at all."
[3]
===
Not sure whether it's worth clarifying this particularly in the text
(particularly since you point to my article, where it is explained), but...Note that it is not solely to deal with punctuation characters that dir is
needed. In fact, in some cases the Unicode RLM and LRM characters are a
better choice (note that RLM and LRM are *not* referring to the Unicode
characters that mirror the effect of dir!).dir is most often needed to ensure the correct order of directional runs, as
in the quote 'W3C ,werbeh werbeh' in an overall LTR context, where the bidi
algorithm would have put the W3C over to the right.
[4]
===
"This attribute, when set to "ltr" or "rtl", overrides the default Unicode
bidirectional algorithm on neutral characters (such as spaces and
punctuation)."It doesn't actually override the algorithm - only the rlo and lro do that,
and as mentioned above, it's use is not limited to neutral characters. You
could say, instead, "This attribute, when set to "ltr" or "rtl", is intended
to resolve cases of ambiguous directionality in bidirectional text."
[5]
===
"This attribute is usually used in conjunction with the xml:lang attribute,
to override the default Unicode bidirectional algorithm that applies to the
specified language."Again, I would remove this.
[6]
===
"then if the document element specifies the xml:lang attribute, the Unicode
Bidirectional Algorithm must be applied to the specified language"The bidi algorithm should be applied and work independently of whether or
not a language has been declared, since it operates on the basis of the
characters in the text. Again, this and other references to use of xml:lang
for direction are inappropriate.
[7]
===
"Directionality is inferred from the xml:lang value. Every language has an
associated directionality (left-to-right or right-to-left, also termed LTR
or RTL). For example, for English this default direction is LTR and for
Hebrew it's RTL."Again, I strongly disagree with this. I think this should say something
like:"The default direction of a document is LTR. This can be overridden by use
of the dir attribute set to "rtl"."Note also that it is currently not defined what should happen if the
language of a document is not defined by the author, which is another reason
to use the wording I suggest.
Hope that helps,
Richard.
============
Richard Ishida
Internationalization Lead
W3C (World Wide Web Consortium)
--- End Message ---
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]