W3C home > Mailing lists > Public > www-html-editor@w3.org > July to September 2002

XHTML 1 schema annotations

From: Damien Guillaume <Damien.Guillaume@obspm.fr>
Date: Thu, 05 Sep 2002 20:10:50 +0900 (JST)
Message-Id: <20020905.201050.126571849.mimasa@w3.org>
To: www-html-editor@w3.org

I'm writing an XML editor, in which element annotations are displayed. 
However, it can only display element-related annotations when there is 
an explicit (i.e. xml) relation between the element definition and the 
annotation.
Also, I think it would be conceptually better (by adding a meaning to 
the relationship element-annotation) to write for instance:

   <xs:element name="hr">
     <xs:annotation>
       <xs:documentation>
       horizontal rule
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

instead of:

   <xs:annotation>
     <xs:documentation>
     =================== Horizontal 
Rule ==================================
     </xs:documentation>
   </xs:annotation>

   <xs:element name="hr">
     <xs:complexType>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

or to write:

   <xs:element name="dl">
     <xs:annotation>
       <xs:documentation>
       definition list
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
       <xs:choice maxOccurs="unbounded">
         <xs:element ref="dt"/>
         <xs:element ref="dd"/>
       </xs:choice>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

   <xs:element name="dt">
     <xs:annotation>
       <xs:documentation>
       definition term
       </xs:documentation>
     </xs:annotation>
     <xs:complexType mixed="true">
       <xs:complexContent>
         <xs:extension base="Inline">
           <xs:attributeGroup ref="attrs"/>
         </xs:extension>
       </xs:complexContent>
     </xs:complexType>
   </xs:element>

instead of:

   <xs:annotation>
     <xs:documentation>
     definition lists - dt for term, dd for its definition
     </xs:documentation>
   </xs:annotation>

   <xs:element name="dl">
     <xs:complexType>
       <xs:choice maxOccurs="unbounded">
         <xs:element ref="dt"/>
         <xs:element ref="dd"/>
       </xs:choice>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

   <xs:element name="dt">
     <xs:complexType mixed="true">
       <xs:complexContent>
         <xs:extension base="Inline">
           <xs:attributeGroup ref="attrs"/>
         </xs:extension>
       </xs:complexContent>
     </xs:complexType>
   </xs:element>

As a side note, I've been waiting for an XML schema for XHTML for a long 
time, so I'm glad it's finally there :-)

Damien
Received on Thursday, 5 September 2002 07:10:53 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 27 March 2012 18:17:42 GMT