W3C home > Mailing lists > Public > www-i18n-comments@w3.org > October 2003

RE: ATeXHI 1.0 or Babel Scribe 1.0

From: Richard Ishida <ishida@w3.org>
Date: Sat, 25 Oct 2003 11:44:04 +0100
To: "'Karl Dubost'" <karl@w3.org>, <www-i18n-comments@w3.org>
Message-ID: <001c01c39ae4$ec884380$6401a8c0@w3c40upc3ma3j2>

Hi Karl,

> the verbiage was repeating the same principles along the 
> document. The 
> document to be read by the outline. I Would encourage the editors to 
> write atomic statement for each feature and to not repeat the same 
> verbiage BUT to point to these atomic statement from 
> different outlines.
> 
> 	It will be like having modules addressing some 
> problems, and profiles 
> collecting a set of modules or features applied to specific 
> problems or 
> readers. It will have the advantage for the editor to be easier to 
> maintain as well and less confusing for the reader in certain 
> circumstances.


If I understand your suggestion correctly, you'll find that we do
exactly that.  The individual techniques are written in a 'repository'
document.  There's one for HTML and one for CSS so far.  Each technique
appears only once in a repository.  In addition there's a separate file
for references.  What you have looked at is a 'view' on the data adapted
for XHTML and HTML content authors.  There is no technique text at all
in the XML source for the view document - just links to techniques in
the repositories. Where a technique is repeated, this is produced by two
or more links to the same technique in the repository. We run XSLT on
the XML to produce the XHTML document you read with technique text and
appropriate references.

This is all described in our Framework doc
http://www.w3.org/TR/i18n-guide-framework/

You can see the repositories and related documentation on the GEO home
page at http://www.w3.org/International/geo/ (look for Miscellaneous
working documents on the left).

RI
Received on Saturday, 25 October 2003 06:44:55 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 27 October 2009 08:32:34 GMT