docs/ref/soextblx.dtd

   1 <!--
   2 ===========================================================================
   3     OASIS XML Exchange Table Model Declaration Module
   4 ===========================================================================
   5 :Date: 1999-03-15
   6 -->
   7
   8 <!-- This set of declarations defines the XML version of the Exchange
   9      Table Model as of the date shown in the Formal Public Identifier
  10      (FPI) for this entity.
  11
  12      This set of declarations may be referred to using a public external
  13      entity declaration and reference as shown in the following three
  14      lines:
  15
  16      <!ENTITY % calstblx
  17        PUBLIC "-//OASIS//DTD XML Exchange Table Model 19990315//EN">
  18        %calstblx;
  19
  20      If various parameter entities used within this set of declarations
  21      are to be given non-default values, the appropriate declarations
  22      should be given before calling in this package (i.e., before the
  23      "%calstblx;" reference).
  24 -->
  25
  26 <!-- The motivation for this XML version of the Exchange Table Model
  27      is simply to create an XML version of the SGML Exchange Table
  28      Model. By design, no effort has been made to "improve" the model.
  29
  30      This XML version incorporates the logical bare minimum changes
  31      necessary to make the Exchange Table Model a valid XML DTD.
  32 -->
  33
  34 <!-- The XML version of the Exchange Table Model differs from
  35      the SGML version in the following ways:
  36
  37      The following parameter entities have been removed:
  38
  39        - tbl.table.excep, tbl.hdft.excep, tbl.row.excep, tbl.entry.excep
  40          There are no exceptions in XML. The following normative statement
  41          is made in lieu of exceptions: the exchange table model explicitly
  42          forbids a table from occurring within another table. If the
  43          content model of an entry includes a table element, then this
  44          cannot be enforced by the DTD, but it is a deviation from the
  45          exchange table model to include a table within a table.
  46
  47        - tbl.hdft.name, tbl.hdft.mdl, tbl.hdft.excep, tbl.hdft.att
  48          The motivation for these elements was to change the table
  49          header/footer elements. Since XML does not allow element declarations
  50          to contain name groups, and the exchange table model does not
  51          allow a table to contain footers, the continued presence of these
  52          attributes seems unnecessary.
  53
  54      The following parameter entity has been added:
  55
  56        - tbl.thead.att
  57          This entity parameterizes the attributes on thead. It replaces
  58          the tbl.hdft.att parameter entity.
  59
  60      Other miscellaneous changes:
  61
  62        - Tag ommission indicators have been removed
  63        - Comments have been removed from declarations
  64        - NUMBER attributes have been changed to NMTOKEN
  65        - NUTOKEN attributes have been to changed to NMTOKEN
  66        - Removed the grouping characters around the content model
  67          parameter entry for the 'entry' element. This is necessary
  68          so that an entry can contain #PCDATA and be defined as an
  69          optional, repeatable OR group beginning with #PCDATA.
  70 -->
  71
  72 <!-- This entity includes a set of element and attribute declarations
  73      that partially defines the Exchange table model.  However, the model
  74      is not well-defined without the accompanying natural language
  75      description of the semantics (meanings) of these various elements,
  76      attributes, and attribute values.  The semantic writeup, also available
  77      from SGML Open, should be used in conjunction with this entity.
  78 -->
  79
  80 <!-- In order to use the Exchange table model, various parameter entity
  81      declarations are required.  A brief description is as follows:
  82
  83      ENTITY NAME      WHERE USED              WHAT IT IS
  84
  85      %yesorno         In ATTLIST of:          An attribute declared value
  86                       almost all elements     for a "boolean" attribute
  87
  88      %paracon         In content model of:    The "text" (logical content)
  89                       <entry>                 of the model group for <entry>
  90
  91      %titles          In content model of:    The "title" part of the model
  92                       table element           group for the table element
  93
  94      %tbl.table.name  In declaration of:      The name of the "table"
  95                       table element           element
  96
  97      %tbl.table-titles.mdl In content model of: The model group for the title
  98                       table elements          part of the content model for
  99                                               table element
 100
 101      %tbl.table.mdl   In content model of:    The model group for the content
 102                       table elements          model for table element,
 103                                               often (and by default) defined
 104                                               in terms of %tbl.table-titles.mdl
 105                                               and tgroup
 106
 107      %tbl.table.att   In ATTLIST of:          Additional attributes on the
 108                       table element           table element
 109
 110      %bodyatt         In ATTLIST of:          Additional attributes on the
 111                       table element           table element (for backward
 112                                               compatibility with the SGML
 113                                               model)
 114
 115      %tbl.tgroup.mdl  In content model of:    The model group for the content
 116                       <tgroup>                model for <tgroup>
 117
 118      %tbl.tgroup.att  In ATTLIST of:          Additional attributes on the
 119 4                      <tgroup>                <tgroup> element
 120
 121      %tbl.thead.att   In ATTLIST of:          Additional attributes on the
 122                       <thead>                 <thead> element
 123
 124      %tbl.tbody.att   In ATTLIST of:          Additional attributes on the
 125                       <tbody>                 <tbody> element
 126
 127      %tbl.colspec.att In ATTLIST of:          Additional attributes on the
 128                       <colspec>               <colspec> element
 129
 130      %tbl.row.mdl     In content model of:    The model group for the content
 131                       <row>                   model for <row>
 132
 133      %tbl.row.att     In ATTLIST of:          Additional attributes on the
 134                       <row>                   <row> element
 135
 136      %tbl.entry.mdl   In content model of:    The model group for the content
 137                       <entry>                 model for <entry>
 138
 139      %tbl.entry.att   In ATTLIST of:          Additional attributes on the
 140                       <entry>                 <entry> element
 141
 142      This set of declarations will use the default definitions shown below
 143      for any of these parameter entities that are not declared before this
 144      set of declarations is referenced.
 145 -->
 146
 147 <!-- These definitions are not directly related to the table model, but are
 148      used in the default CALS table model and may be defined elsewhere (and
 149      prior to the inclusion of this table module) in the referencing DTD. -->
 150
 151 <!ENTITY % yesorno 'NMTOKEN'> <!-- no if zero(s), yes if any other value -->
 152 <!ENTITY % titles  'title?'>
 153 <!ENTITY % paracon '#PCDATA'> <!-- default for use in entry content -->
 154
 155 <!--
 156 The parameter entities as defined below change and simplify the CALS table
 157 model as published (as part of the Example DTD) in MIL-HDBK-28001.  The
 158 resulting simplified DTD has support from the SGML Open vendors and is
 159 therefore more interoperable among different systems.
 160
 161 These following declarations provide the Exchange default definitions
 162 for these entities.  However, these entities can be redefined (by giving
 163 the appropriate parameter entity declaration(s) prior to the reference
 164 to this Table Model declaration set entity) to fit the needs of the
 165 current application.
 166
 167 Note, however, that changes may have significant effect on the ability to
 168 interchange table information.  These changes may manifest themselves
 169 in useability, presentation, and possible structure information degradation.
 170 -->
 171
 172 <!ENTITY % tbl.table.name       "table">
 173 <!ENTITY % tbl.table-titles.mdl "%titles;,">
 174 <!ENTITY % tbl.table-main.mdl   "tgroup+">
 175 <!ENTITY % tbl.table.mdl        "%tbl.table-titles.mdl; %tbl.table-main.mdl;">
 176 <!ENTITY % tbl.table.att        "
 177     pgwide      %yesorno;       #IMPLIED ">
 178 <!ENTITY % bodyatt              "">
 179 <!ENTITY % tbl.tgroup.mdl       "colspec*,thead?,tbody">
 180 <!ENTITY % tbl.tgroup.att       "">
 181 <!ENTITY % tbl.thead.att        "">
 182 <!ENTITY % tbl.tbody.att        "">
 183 <!ENTITY % tbl.colspec.att      "">
 184 <!ENTITY % tbl.row.mdl          "entry+">
 185 <!ENTITY % tbl.row.att          "">
 186 <!ENTITY % tbl.entry.mdl        "(%paracon;)*">
 187 <!ENTITY % tbl.entry.att        "">
 188
 189 <!-- =====  Element and attribute declarations follow. =====  -->
 190
 191 <!--
 192      Default declarations previously defined in this entity and
 193      referenced below include:
 194      ENTITY % tbl.table.name       "table"
 195      ENTITY % tbl.table-titles.mdl "%titles;,"
 196      ENTITY % tbl.table.mdl        "%tbl.table-titles; tgroup+"
 197      ENTITY % tbl.table.att        "
 198                         pgwide          %yesorno;       #IMPLIED "
 199 -->
 200
 201 <!ELEMENT %tbl.table.name; (%tbl.table.mdl;)>
 202
 203 <!ATTLIST %tbl.table.name;
 204         frame           (top|bottom|topbot|all|sides|none)      #IMPLIED
 205         colsep          %yesorno;                               #IMPLIED
 206         rowsep          %yesorno;                               #IMPLIED
 207         %tbl.table.att;
 208         %bodyatt;
 209 >
 210
 211 <!--
 212      Default declarations previously defined in this entity and
 213      referenced below include:
 214      ENTITY % tbl.tgroup.mdl    "colspec*,thead?,tbody"
 215      ENTITY % tbl.tgroup.att    ""
 216 -->
 217
 218 <!ELEMENT tgroup (%tbl.tgroup.mdl;) >
 219
 220 <!ATTLIST tgroup
 221         cols            NMTOKEN                                 #REQUIRED
 222         colsep          %yesorno;                               #IMPLIED
 223         rowsep          %yesorno;                               #IMPLIED
 224         align           (left|right|center|justify|char)        #IMPLIED
 225         %tbl.tgroup.att;
 226 >
 227
 228 <!--
 229      Default declarations previously defined in this entity and
 230      referenced below include:
 231      ENTITY % tbl.colspec.att   ""
 232 -->
 233
 234 <!ELEMENT colspec EMPTY >
 235
 236 <!ATTLIST colspec
 237         colnum          NMTOKEN                                 #IMPLIED
 238         colname         NMTOKEN                                 #IMPLIED
 239         colwidth        CDATA                                   #IMPLIED
 240         colsep          %yesorno;                               #IMPLIED
 241         rowsep          %yesorno;                               #IMPLIED
 242         align           (left|right|center|justify|char)        #IMPLIED
 243         char            CDATA                                   #IMPLIED
 244         charoff         NMTOKEN                                 #IMPLIED
 245         %tbl.colspec.att;
 246 >
 247
 248 <!--
 249      Default declarations previously defined in this entity and
 250      referenced below include:
 251      ENTITY % tbl.thead.att      ""
 252 -->
 253
 254 <!ELEMENT thead (row+)>
 255
 256 <!ATTLIST thead
 257         valign          (top|middle|bottom)                     #IMPLIED
 258         %tbl.thead.att;
 259 >
 260
 261 <!--
 262      Default declarations previously defined in this entity and
 263      referenced below include:
 264      ENTITY % tbl.tbody.att     ""
 265 -->
 266
 267 <!ELEMENT tbody (row+)>
 268
 269 <!ATTLIST tbody
 270         valign          (top|middle|bottom)                     #IMPLIED
 271         %tbl.tbody.att;
 272 >
 273
 274 <!--
 275      Default declarations previously defined in this entity and
 276      referenced below include:
 277      ENTITY % tbl.row.mdl       "entry+"
 278      ENTITY % tbl.row.att       ""
 279 -->
 280
 281 <!ELEMENT row (%tbl.row.mdl;)>
 282
 283 <!ATTLIST row
 284         rowsep          %yesorno;                               #IMPLIED
 285         valign          (top|middle|bottom)                     #IMPLIED
 286         %tbl.row.att;
 287 >
 288
 289
 290 <!--
 291      Default declarations previously defined in this entity and
 292      referenced below include:
 293      ENTITY % paracon           "#PCDATA"
 294      ENTITY % tbl.entry.mdl     "(%paracon;)*"
 295      ENTITY % tbl.entry.att     ""
 296 -->
 297
 298 <!ELEMENT entry %tbl.entry.mdl;>
 299
 300 <!ATTLIST entry
 301         colname         NMTOKEN                                 #IMPLIED
 302         namest          NMTOKEN                                 #IMPLIED
 303         nameend         NMTOKEN                                 #IMPLIED
 304         morerows        NMTOKEN                                 #IMPLIED
 305         colsep          %yesorno;                               #IMPLIED
 306         rowsep          %yesorno;                               #IMPLIED
 307         align           (left|right|center|justify|char)        #IMPLIED
 308         char            CDATA                                   #IMPLIED
 309         charoff         NMTOKEN                                 #IMPLIED
 310         valign          (top|middle|bottom)                     #IMPLIED
 311         %tbl.entry.att;
 312 >