OASIS Open Document Format for Office Applications (OpenDocument) TC

Proposal for foot- and endnote configuration

  • 1.  Proposal for foot- and endnote configuration

    Posted 10-17-2003 13:26
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    office message

    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


    Subject: Proposal for foot- and endnote configuration


    Dear TC members,
    
    as agreed in the last con call, here is a proposal how to merge
    foot- and endote configurations.
    
    In the current specification, the <text:endnotes-configuration>
    element is a subset of the <text:footnotes-configuration>
    element. Compared to the footnotes element, the following is missing in 
    the endnotes element:
    
    - There is no attribute "text:footnotes-position" that specifies
       whether notes should be collected at the end of the document or
       at the end of each page. Endnotes are always collected at the end
       of the document.
    - There is no attribute "text:start-numbering-at" that specifies
       whether note numbers should start with one at the beginning of
       each document, chapter or page. Endnotes always get unique numbers
       in the whole document.
    - There are no child elements
       <text:footnote-continuation-notice-forward> and
       <text:footnote-continuation-notice-backward>. These elements specify
       texts that are used if a single footnote has to be distributed over
       more than one page. The forward text is appended to the footnote text
       that is displayed on the first page, the backward text is prepended to
       the rest of the footnote at the second page.
    
    So what I propose is
    - to remove the <text:endnotes-configuration> element,
    - to rename <text:footnotes-configuration> to <text:notes-configuration>
       element, and to remove "foot" from all its attribute and child element
       names,
    - to add a "text:type" attribute to the <text:endnotes-configuration>
       element that takes the value "footnote" and "endnote".
    - to add for both note types information to the specification document
       - regarding the attributes/elements that are supported by the note
         type
       - regarding the implied default values of the attributes for the note
         type
    
    An Relax-NG schema that corresponds to the OpenOffice.org DTD as well as
    a proposal for the new schema is attached.
    
    Best regards
    
    Michael
    
    ----------------------------------------------
       <!-- OpenOffice.org schema -->
    
       <!-- footnote configuration -->
       <define name="text.footnotes-configuration">
         <element name="text:footnotes-configuration">
           <ref name="text.notes-configuration-attlist"/>
           <ref name="text.footnotes-configuration-attlist"/>
           <optional>
             <element name="text:footnote-continuation-notice-forward">
               <text/>
             </element>
             <element name="text:footnote-continuation-notice-backward">
               <text/>
             </element>
           </optional>
         </element>
       </define>
    
       <!-- endnote configuration -->
       <define name="text.endnotes-configuration">
         <element name="text:endnotes-configuration">
           <ref name="text.notes-configuration-attlist"/>
           <empty/>
         </element>
       </define>
    
       <!-- attributes common to foot and endnotes -->
       <define name="text.notes-configuration-attlist" combine="interleave">
         <optional>
           <attribute name="style:num-prefix">
             <ref name="string"/>
           </attribute>
           <attribute name="style:num-suffix">
             <ref name="string"/>
           </attribute>
           <attribute name="style:num-format">
             <ref name="string"/>
           </attribute>
           <attribute name="style:num-letter-sync">
             <ref name="string"/>
           </attribute>
           <attribute name="text:citation-body-style-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:citation-style-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:default-style-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:master-page-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:start-value">
             <ref name="integer"/>
           </attribute>
         </optional>
       </define>
    
       <!-- extra attributes for footnote configuration only -->
       <define name="text.footnotes-configuration-attlist" combine="interleave">
         <optional>
           <attribute name="text:footnotes-position" a:defaultValue="page">
             <choice>
               <value>document</value>
               <value>page</value>
             </choice>
           </attribute>
           <attribute name="text:start-numbering-at" a:defaultValue="document">
             <choice>
               <value>document</value>
               <value>chapter</value>
               <value>page</value>
             </choice>
           </attribute>
         </optional>
       </define>
    
    ----------------------------------------------
       <!-- proposed new schema -->
    
       <!-- notes configuration -->
       <define name="text.notes-configuration">
         <element name="text:notes-configuration">
           <ref name="text.notes-configuration-attlist"/>
           <optional>
             <element name="text:note-continuation-notice-forward">
               <text/>
             </element>
             <element name="text:note-continuation-notice-backward">
               <text/>
             </element>
           </optional>
         </element>
       </define>
    
       <!-- attributes common to foot and endnotes -->
       <define name="text.notes-configuration-attlist" combine="interleave">
         <optional>
    	  <attribute name="text:type">
             <choice>
               <value>footnote</value>
               <value>endnote</value>
             </choice>
           </attribute>
           <attribute name="style:num-prefix">
             <ref name="string"/>
           </attribute>
           <attribute name="style:num-suffix">
             <ref name="string"/>
           </attribute>
           <attribute name="style:num-format">
             <ref name="string"/>
           </attribute>
           <attribute name="style:num-letter-sync">
             <ref name="string"/>
           </attribute>
           <attribute name="text:citation-body-style-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:citation-style-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:default-style-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:master-page-name">
             <ref name="styleName"/>
           </attribute>
           <attribute name="text:start-value">
             <ref name="integer"/>
           </attribute>
           <attribute name="text:notes-position" a:defaultValue="page">
             <choice>
               <value>document</value>
               <value>page</value>
             </choice>
           </attribute>
           <attribute name="text:start-numbering-at" a:defaultValue="document">
             <choice>
               <value>document</value>
               <value>chapter</value>
               <value>page</value>
             </choice>
           </attribute>
         </optional>
       </define>
    
    


    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]