Yves, Sabine, Max,
The i18n Working Group recently reverted the Character Model WD to XML. We
made some changes to the DTD and XSL to meet our needs: including creating
XHTML output in UTF-8. Its not perfect, but I thought it would be good to
share this.
A list of changes to DTD and XSL is given below. There are also additional
files to support editing in XMetal 2.1.
FILES
---------
You can find the following files at
http://www.w3.org/International/Group/charmod-edit/
xmlspec-CM.css (for XMetal rendering)
xmlspec-CM.ctm
xmlspec-CM.dtd
xmlspec-CM.mcr
xmlspec-CM.rlx
xmlspec-CM.xsl
xmlspec-CM_structure.css
Overview.xml
Overview.html
DOCUMENTATION
-------------------------
The enclosed documents below provide some documentation. (One is a copy of
the XML Spec documentation I have doctored slightly and applied new styling
too (just add graphics). I found the new layout makes it much easier to
look things up in hardcopy form.)
CHANGES
-------------
To XSL:
19 Dec 2001: (richard.ishida@gbr.xerox.com)
- additional.css: added css declarations to this document, rather
than using a separate file (to get around the pubrules requirement that the
W3C stylesheet is the last one called)
- ipr-notice: changed ipr-notice link to ipr-notice-20000612 in all
(3) locations
14 Dec 2001: (richard.ishida@gbr.xerox.com)
- olist, ulist: because a list may be a child of req and not just p,
changed the validity.hacks transforms
- abstract, status: corrected duplicate assignment of id
- created anchor element for list items if an id was assigned in the
xml
- created anchor element for notes and examples if an id was
assigned in the xml
12 Dec 2001: (richard.ishida@gbr.xerox.com)
- output: changed to output as xhtml
- general: for every <a> with name=, added id= with same attr value
- general: lowercased all element and attribute names in output
- ednote: made appear using <span class="editor-note">
- example: if first child is p and no head, heading 'EXAMPLE: '
appears *inline* at beginning of first p
otherwise 'EXAMPLE:' appears in its own block
heading 'EXAMPLE: ' wrapped with <span class="example-head">
- note: if first child is p, heading 'NOTE: ' appears *inline* at
beginning of first p
otherwise 'NOTE:' appears in its own block
heading 'NOTE: ' wrapped with <span class="note-head">
NB: CharMod commonly uses notes for informative text
- graphic: added code to deal with height and width attributes
- item: added name= and id= attributes to allow linking to list
items
added <span class="req"> to highlight if part of a
requirement
- kw: changed <b> to <span class="keyword"> to allow more
flexibility in presentation
- olist, ulist: used $validity.hacks to close off <span class="req">
and start again if a requirement includes a list
- del, ins: added code to deal with these new elements (expectation
that all ins and del markup will be removed prior to publication)
- quote: surrounded with <span class="quote"> to allow for
alternative styling (CharMod italicises the text)
- html and head elements:
- changed document declaration for xhtml
- added xml:lang to html tag
- added charset declaration, set to utf-8
- made the default stylesheet link relative
- removed internal css (added to local css file mentioned
below)
- linked to local css file (that currently overwrites
everything in the default for CharMod)
- added link to javascript file and constructs to allow for
hiding/showing redlining (this will be removed prior to publication)
- term: replaced <b> with <span class="term"> to allow for
flexibility in rendering
- added new templates to deal with the following new elements:
- req
- qterm
- qchar
- rfc2119
- uname
- abbr
- acronym
- figure (includes its own caption handling at the moment)
- image
To DTD:
12 Dec 2001
- %illus.class: added image and figure
- %termdef.class: added abbr and acronym
- %local.emph.class: added del and ins
- %tech.class: added qterm, qchar, rfc2119, and uname
- p: added req
- graphic: added attributes height and width - CharMod doesn't use
the alt attribute - this is replaced by an alt element that is part of image
- td, th: changed rowspan and colspan from NMTOKEN '1' to #IMPLIED
- added the following new elements:
- ins
- del
- req plus req-type, req-text
- rfc2119
- qterm
- qchar
- abbr
- acronym
- uname
- figure plus image plus alt
Richard.
X______________________
Richard Ishida
Globalisation Consultant,
International Document & User Interface Design
Xerox GKLS
tel: +44 1707 353395 (Voicemail always available)
http://www.xerox-emea.com/globaldesign/
> -----Original Message-----
> From: Eve L. Maler [mailto:eve.maler@sun.com]
> Sent: 02 January 2002 15:35
> To: spec-prod@w3.org
> Subject: Re: who manages xmlspec?
>
>
> Hello Max,
>
> I'm nominally the maintainer of the DTD, but have not been
> able to devote
> time to it for quite a while. Norm has made some corrections
> when they've
> been absolutely necessary, but that's about it. (Norm maintains the
> stylesheets fairly actively.)
>
> A colleague of mine, Sabine Ocker, has agreed to be the point
> person for
> changes to the XMLspec DTD to help ensure that they're done
> in a consistent
> manner. She's been following this list for a couple of
> months now. She's
> ready to start taking an active role in fielding DTD requests
> and making
> changes; there are quite a few requests for enhancement that
> have been
> piling up.
>
> Your id/name request is related to the stylesheets, right?
> I'll assume
> that Norm will follow up on that one.
>
> Eve
>
> At 02:03 PM 1/2/02 +0100, Max Froumentin wrote:
>
> >The last round of publications has shown that the xmlspec DTD and
> >stylesheets are somewhat out of date with respect to new publication
> >rules, and that it would help future drafts if they were updated. To
> >name a couple of issues: id and name attributes on headers
> and link to
> >errata are missing in the current CVS. I've sent a patch for the
> >former but it hasn't been checked in or refused. So I'm wondering if
> >Norm or Eve still maintain it or whether it is left to
> contributors to
> >commit new stuff (in which case I will update it).
> >
> >Max.
>
> --
> Eve Maler +1 781 442 3190
> Sun Microsystems XML Technology Center eve.maler @ sun.com
>