doc/docbook-xml/soextblx.dtd

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