slides/schema/relaxng/glossary.rng

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3   This file is part of DocBook V5.0
   4
   5   Copyright 1992-2008 HaL Computer Systems, Inc.,
   6   O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software
   7   Corporation, Norman Walsh, Sun Microsystems, Inc., and the
   8   Organization for the Advancement of Structured Information
   9   Standards (OASIS).
  10
  11   Release: $Id: glossary.rnc 8931 2010-10-20 13:29:20Z nwalsh $
  12
  13   Permission to use, copy, modify and distribute the DocBook schema
  14   and its accompanying documentation for any purpose and without fee
  15   is hereby granted in perpetuity, provided that the above copyright
  16   notice and this paragraph appear in all copies. The copyright
  17   holders make no representation about the suitability of the schema
  18   for any purpose. It is provided "as is" without expressed or implied
  19   warranty.
  20
  21   If you modify the DocBook schema in any way, label your schema as a
  22   variant of DocBook. See the reference documentation
  23   (http://docbook.org/tdg5/en/html/ch05.html#s-notdocbook)
  24   for more information.
  25
  26   Please direct all questions, bug reports, or suggestions for changes
  27   to the docbook@lists.oasis-open.org mailing list. For more
  28   information, see http://www.oasis-open.org/docbook/.
  29
  30   ======================================================================
  31 -->
  32 <grammar ns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:s="http://purl.oclc.org/dsdl/schematron" xmlns:rng="http://relaxng.org/ns/structure/1.0" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
  33   <start combine="choice">
  34     <choice>
  35       <ref name="db.glossary"/>
  36       <ref name="db.glossdiv"/>
  37       <ref name="db.glosslist"/>
  38     </choice>
  39   </start>
  40   <define name="db.publishing.inlines" combine="choice">
  41     <ref name="db.glossary.inlines"/>
  42   </define>
  43   <define name="db.list.blocks" combine="choice">
  44     <ref name="db.glosslist"/>
  45   </define>
  46   <define name="db.navigation.components" combine="choice">
  47     <ref name="db.glossary"/>
  48   </define>
  49   <define name="db.glossary.inlines">
  50     <choice>
  51       <ref name="db.firstterm"/>
  52       <ref name="db.glossterm"/>
  53       <ref name="db._firstterm"/>
  54       <ref name="db._glossterm"/>
  55     </choice>
  56   </define>
  57   <define name="db.ubiq.inlines" combine="choice">
  58     <choice>
  59       <ref name="db._firstterm"/>
  60       <ref name="db._glossterm"/>
  61     </choice>
  62   </define>
  63   <!-- ====================================================================== -->
  64   <define name="db.baseform.attribute">
  65     <optional>
  66       <attribute name="baseform">
  67         <db:refpurpose>Specifies the base form of the term, the one that appears in the glossary. This allows adjectival, plural, and other variations of the term to appear in the element. The element content is the default base form.</db:refpurpose>
  68       </attribute>
  69     </optional>
  70   </define>
  71   <!-- ====================================================================== -->
  72   <div>
  73     <db:refname>glosslist</db:refname>
  74     <db:refpurpose>A wrapper for a list of glossary entries</db:refpurpose>
  75     <define name="db.glosslist.role.attribute">
  76       <attribute name="role"/>
  77     </define>
  78     <define name="db.glosslist.attlist">
  79       <interleave>
  80         <optional>
  81           <ref name="db.glosslist.role.attribute"/>
  82         </optional>
  83         <ref name="db.common.attributes"/>
  84         <ref name="db.common.linking.attributes"/>
  85       </interleave>
  86     </define>
  87     <define name="db.glosslist.info">
  88       <ref name="db._info.title.only"/>
  89     </define>
  90     <define name="db.glosslist">
  91       <element name="glosslist">
  92         <ref name="db.glosslist.attlist"/>
  93         <optional>
  94           <ref name="db.glosslist.info"/>
  95         </optional>
  96         <zeroOrMore>
  97           <ref name="db.all.blocks"/>
  98         </zeroOrMore>
  99         <oneOrMore>
 100           <ref name="db.glossentry"/>
 101         </oneOrMore>
 102       </element>
 103     </define>
 104   </div>
 105   <!-- ====================================================================== -->
 106   <div>
 107     <db:refname>glossentry</db:refname>
 108     <db:refpurpose>An entry in a glossary or glosslist</db:refpurpose>
 109     <define name="db.glossentry.role.attribute">
 110       <attribute name="role"/>
 111     </define>
 112     <define name="db.glossentry.sortas.attribute">
 113       <attribute name="sortas">
 114         <db:refpurpose>Specifies the string by which the element's content is to be sorted; if unspecified, the content is used</db:refpurpose>
 115       </attribute>
 116     </define>
 117     <define name="db.glossentry.attlist">
 118       <interleave>
 119         <optional>
 120           <ref name="db.glossentry.role.attribute"/>
 121         </optional>
 122         <ref name="db.common.attributes"/>
 123         <ref name="db.common.linking.attributes"/>
 124         <optional>
 125           <ref name="db.glossentry.sortas.attribute"/>
 126         </optional>
 127       </interleave>
 128     </define>
 129     <define name="db.glossentry">
 130       <element name="glossentry">
 131         <ref name="db.glossentry.attlist"/>
 132         <ref name="db.glossterm"/>
 133         <optional>
 134           <ref name="db.acronym"/>
 135         </optional>
 136         <optional>
 137           <ref name="db.abbrev"/>
 138         </optional>
 139         <zeroOrMore>
 140           <ref name="db.indexterm"/>
 141         </zeroOrMore>
 142         <choice>
 143           <ref name="db.glosssee"/>
 144           <oneOrMore>
 145             <ref name="db.glossdef"/>
 146           </oneOrMore>
 147         </choice>
 148       </element>
 149     </define>
 150   </div>
 151   <!-- ====================================================================== -->
 152   <div>
 153     <db:refname>glossdef</db:refname>
 154     <db:refpurpose>A definition in a glossentry</db:refpurpose>
 155     <define name="db.glossdef.role.attribute">
 156       <attribute name="role"/>
 157     </define>
 158     <define name="db.glossdef.subject.attribute">
 159       <attribute name="subject">
 160         <db:refpurpose>Specifies a list of keywords for the definition</db:refpurpose>
 161       </attribute>
 162     </define>
 163     <define name="db.glossdef.attlist">
 164       <interleave>
 165         <optional>
 166           <ref name="db.glossdef.role.attribute"/>
 167         </optional>
 168         <ref name="db.common.attributes"/>
 169         <ref name="db.common.linking.attributes"/>
 170         <optional>
 171           <ref name="db.glossdef.subject.attribute"/>
 172         </optional>
 173       </interleave>
 174     </define>
 175     <define name="db.glossdef">
 176       <element name="glossdef">
 177         <ref name="db.glossdef.attlist"/>
 178         <oneOrMore>
 179           <ref name="db.all.blocks"/>
 180         </oneOrMore>
 181         <zeroOrMore>
 182           <ref name="db.glossseealso"/>
 183         </zeroOrMore>
 184       </element>
 185     </define>
 186   </div>
 187   <!-- ====================================================================== -->
 188   <div>
 189     <db:refname>glosssee</db:refname>
 190     <db:refpurpose>A cross-reference from one <db:tag>glossentry</db:tag>
 191  to another</db:refpurpose>
 192     <define name="db.glosssee.role.attribute">
 193       <attribute name="role"/>
 194     </define>
 195     <define name="db.glosssee.otherterm.attribute">
 196       <attribute name="otherterm">
 197         <db:refpurpose>Identifies the other term</db:refpurpose>
 198         <data type="IDREF"/>
 199       </attribute>
 200     </define>
 201     <define name="db.glosssee.attlist">
 202       <interleave>
 203         <optional>
 204           <ref name="db.glosssee.role.attribute"/>
 205         </optional>
 206         <ref name="db.common.attributes"/>
 207         <ref name="db.common.linking.attributes"/>
 208         <optional>
 209           <ref name="db.glosssee.otherterm.attribute"/>
 210         </optional>
 211       </interleave>
 212     </define>
 213     <define name="db.glosssee">
 214       <element name="glosssee">
 215         <s:pattern name="Glosssary 'see' type constraint">
 216           <s:rule context="db:glosssee[@otherterm]">
 217             <s:assert test="local-name(//*[@xml:id=current()/@otherterm]) = 'glossentry' and namespace-uri(//*[@xml:id=current()/@otherterm]) = 'http://docbook.org/ns/docbook'">@otherterm on glosssee must point to a glossentry.</s:assert>
 218           </s:rule>
 219         </s:pattern>
 220         <ref name="db.glosssee.attlist"/>
 221         <zeroOrMore>
 222           <ref name="db.all.inlines"/>
 223         </zeroOrMore>
 224       </element>
 225     </define>
 226   </div>
 227   <!-- ====================================================================== -->
 228   <div>
 229     <db:refname>glossseealso</db:refname>
 230     <db:refpurpose>A cross-reference from one glossentry to another</db:refpurpose>
 231     <define name="db.glossseealso.role.attribute">
 232       <attribute name="role"/>
 233     </define>
 234     <define name="db.glossseealso.otherterm.attribute">
 235       <attribute name="otherterm">
 236         <db:refpurpose>Identifies the other term</db:refpurpose>
 237         <data type="IDREF"/>
 238       </attribute>
 239     </define>
 240     <define name="db.glossseealso.attlist">
 241       <interleave>
 242         <optional>
 243           <ref name="db.glossseealso.role.attribute"/>
 244         </optional>
 245         <ref name="db.common.attributes"/>
 246         <ref name="db.common.linking.attributes"/>
 247         <optional>
 248           <ref name="db.glossseealso.otherterm.attribute"/>
 249         </optional>
 250       </interleave>
 251     </define>
 252     <define name="db.glossseealso">
 253       <element name="glossseealso">
 254         <s:pattern name="Glossary 'seealso' type constraint">
 255           <s:rule context="db:glossseealso[@otherterm]">
 256             <s:assert test="local-name(//*[@xml:id=current()/@otherterm]) = 'glossentry' and namespace-uri(//*[@xml:id=current()/@otherterm]) = 'http://docbook.org/ns/docbook'">@otherterm on glossseealso must point to a glossentry.</s:assert>
 257           </s:rule>
 258         </s:pattern>
 259         <ref name="db.glossseealso.attlist"/>
 260         <zeroOrMore>
 261           <ref name="db.all.inlines"/>
 262         </zeroOrMore>
 263       </element>
 264     </define>
 265   </div>
 266   <!-- ====================================================================== -->
 267   <div>
 268     <db:refname>firstterm</db:refname>
 269     <db:refpurpose>The first occurrence of a term</db:refpurpose>
 270     <define name="db.firstterm.role.attribute">
 271       <attribute name="role"/>
 272     </define>
 273     <define name="db.firstterm.attlist">
 274       <interleave>
 275         <optional>
 276           <ref name="db.firstterm.role.attribute"/>
 277         </optional>
 278         <ref name="db.common.attributes"/>
 279         <ref name="db.common.linking.attributes"/>
 280         <ref name="db.baseform.attribute"/>
 281       </interleave>
 282     </define>
 283     <define name="db.firstterm">
 284       <element name="firstterm">
 285         <s:pattern name="Glossary 'firstterm' type constraint">
 286           <s:rule context="db:firstterm[@linkend]">
 287             <s:assert test="local-name(//*[@xml:id=current()/@linkend]) = 'glossentry' and namespace-uri(//*[@xml:id=current()/@linkend]) = 'http://docbook.org/ns/docbook'">@linkend on firstterm must point to a glossentry.</s:assert>
 288           </s:rule>
 289         </s:pattern>
 290         <ref name="db.firstterm.attlist"/>
 291         <zeroOrMore>
 292           <ref name="db.all.inlines"/>
 293         </zeroOrMore>
 294       </element>
 295     </define>
 296   </div>
 297   <!-- ====================================================================== -->
 298   <div>
 299     <db:refname>firstterm</db:refname>
 300     <db:refpurpose>The first occurrence of a term, with limited content</db:refpurpose>
 301     <define name="db._firstterm.role.attribute">
 302       <attribute name="role"/>
 303     </define>
 304     <define name="db._firstterm.attlist">
 305       <interleave>
 306         <optional>
 307           <ref name="db._firstterm.role.attribute"/>
 308         </optional>
 309         <ref name="db.common.attributes"/>
 310         <ref name="db.common.linking.attributes"/>
 311         <ref name="db.baseform.attribute"/>
 312       </interleave>
 313     </define>
 314     <define name="db._firstterm">
 315       <element name="firstterm">
 316         <s:pattern name="Glossary 'firstterm' type constraint">
 317           <s:rule context="db:firstterm[@linkend]">
 318             <s:assert test="local-name(//*[@xml:id=current()/@linkend]) = 'glossentry' and namespace-uri(//*[@xml:id=current()/@linkend]) = 'http://docbook.org/ns/docbook'">@linkend on firstterm must point to a glossentry.</s:assert>
 319           </s:rule>
 320         </s:pattern>
 321         <ref name="db._firstterm.attlist"/>
 322         <ref name="db._text"/>
 323       </element>
 324     </define>
 325   </div>
 326   <!-- ====================================================================== -->
 327   <div>
 328     <db:refname>glossterm</db:refname>
 329     <db:refpurpose>A glossary term</db:refpurpose>
 330     <define name="db.glossterm.role.attribute">
 331       <attribute name="role"/>
 332     </define>
 333     <define name="db.glossterm.attlist">
 334       <interleave>
 335         <optional>
 336           <ref name="db.glossterm.role.attribute"/>
 337         </optional>
 338         <ref name="db.common.attributes"/>
 339         <ref name="db.common.linking.attributes"/>
 340         <ref name="db.baseform.attribute"/>
 341       </interleave>
 342     </define>
 343     <define name="db.glossterm">
 344       <element name="glossterm">
 345         <s:pattern name="Glossary 'glossterm' type constraint">
 346           <s:rule context="db:glossterm[@linkend]">
 347             <s:assert test="local-name(//*[@xml:id=current()/@linkend]) = 'glossentry' and namespace-uri(//*[@xml:id=current()/@linkend]) = 'http://docbook.org/ns/docbook'">@linkend on glossterm must point to a glossentry.</s:assert>
 348           </s:rule>
 349         </s:pattern>
 350         <ref name="db.glossterm.attlist"/>
 351         <zeroOrMore>
 352           <ref name="db.all.inlines"/>
 353         </zeroOrMore>
 354       </element>
 355     </define>
 356   </div>
 357   <!-- ====================================================================== -->
 358   <div>
 359     <db:refname>glossterm</db:refname>
 360     <db:refpurpose>A glossary term</db:refpurpose>
 361     <define name="db._glossterm.role.attribute">
 362       <attribute name="role"/>
 363     </define>
 364     <define name="db._glossterm.attlist">
 365       <interleave>
 366         <optional>
 367           <ref name="db._glossterm.role.attribute"/>
 368         </optional>
 369         <ref name="db.common.attributes"/>
 370         <ref name="db.common.linking.attributes"/>
 371         <ref name="db.baseform.attribute"/>
 372       </interleave>
 373     </define>
 374     <define name="db._glossterm">
 375       <element name="glossterm">
 376         <s:pattern name="Glossary 'glossterm' type constraint">
 377           <s:rule context="db:glossterm[@linkend]">
 378             <s:assert test="local-name(//*[@xml:id=current()/@linkend]) = 'glossentry' and namespace-uri(//*[@xml:id=current()/@linkend]) = 'http://docbook.org/ns/docbook'">@linkend on glossterm must point to a glossentry.</s:assert>
 379           </s:rule>
 380         </s:pattern>
 381         <ref name="db._glossterm.attlist"/>
 382         <ref name="db._text"/>
 383       </element>
 384     </define>
 385   </div>
 386   <!-- ====================================================================== -->
 387   <div>
 388     <db:refname>glossary</db:refname>
 389     <db:refpurpose>A glossary</db:refpurpose>
 390     <define name="db.glossary.status.attribute">
 391       <ref name="db.status.attribute"/>
 392     </define>
 393     <define name="db.glossary.role.attribute">
 394       <attribute name="role"/>
 395     </define>
 396     <define name="db.glossary.attlist">
 397       <interleave>
 398         <optional>
 399           <ref name="db.glossary.role.attribute"/>
 400         </optional>
 401         <ref name="db.common.attributes"/>
 402         <ref name="db.common.linking.attributes"/>
 403         <optional>
 404           <ref name="db.label.attribute"/>
 405         </optional>
 406         <optional>
 407           <ref name="db.glossary.status.attribute"/>
 408         </optional>
 409       </interleave>
 410     </define>
 411     <define name="db.glossary.info">
 412       <ref name="db._info"/>
 413     </define>
 414     <define name="db.glossary">
 415       <element name="glossary">
 416         <ref name="db.glossary.attlist"/>
 417         <ref name="db.glossary.info"/>
 418         <zeroOrMore>
 419           <ref name="db.all.blocks"/>
 420         </zeroOrMore>
 421         <choice>
 422           <zeroOrMore>
 423             <ref name="db.glossdiv"/>
 424           </zeroOrMore>
 425           <zeroOrMore>
 426             <ref name="db.glossentry"/>
 427           </zeroOrMore>
 428         </choice>
 429         <optional>
 430           <ref name="db.bibliography"/>
 431         </optional>
 432       </element>
 433     </define>
 434   </div>
 435   <!-- ====================================================================== -->
 436   <div>
 437     <db:refname>glossdiv</db:refname>
 438     <db:refpurpose>A division in a glossary</db:refpurpose>
 439     <define name="db.glossdiv.status.attribute">
 440       <ref name="db.status.attribute"/>
 441     </define>
 442     <define name="db.glossdiv.role.attribute">
 443       <attribute name="role"/>
 444     </define>
 445     <define name="db.glossdiv.attlist">
 446       <interleave>
 447         <optional>
 448           <ref name="db.glossdiv.role.attribute"/>
 449         </optional>
 450         <ref name="db.common.attributes"/>
 451         <ref name="db.common.linking.attributes"/>
 452         <optional>
 453           <ref name="db.label.attribute"/>
 454         </optional>
 455         <optional>
 456           <ref name="db.glossdiv.status.attribute"/>
 457         </optional>
 458       </interleave>
 459     </define>
 460     <define name="db.glossdiv.info">
 461       <ref name="db._info.title.req"/>
 462     </define>
 463     <define name="db.glossdiv">
 464       <element name="glossdiv">
 465         <ref name="db.glossdiv.attlist"/>
 466         <ref name="db.glossdiv.info"/>
 467         <zeroOrMore>
 468           <ref name="db.all.blocks"/>
 469         </zeroOrMore>
 470         <oneOrMore>
 471           <ref name="db.glossentry"/>
 472         </oneOrMore>
 473       </element>
 474     </define>
 475   </div>
 476   <!-- ====================================================================== -->
 477   <define name="db.technical.inlines" combine="choice">
 478     <ref name="db.termdef"/>
 479   </define>
 480   <div>
 481     <db:refname>termdef</db:refname>
 482     <db:refpurpose>An inline definition of a term</db:refpurpose>
 483     <define name="db.termdef.role.attribute">
 484       <attribute name="role"/>
 485     </define>
 486     <define name="db.termdef.attlist">
 487       <interleave>
 488         <optional>
 489           <ref name="db.termdef.role.attribute"/>
 490         </optional>
 491         <optional>
 492           <ref name="db.glossentry.sortas.attribute"/>
 493         </optional>
 494         <ref name="db.common.attributes"/>
 495         <ref name="db.common.linking.attributes"/>
 496         <ref name="db.baseform.attribute"/>
 497       </interleave>
 498     </define>
 499     <define name="db.termdef">
 500       <element name="termdef">
 501         <s:pattern name="Glossary term definition constraint">
 502           <s:rule context="db:termdef">
 503             <s:assert test="count(db:firstterm) = 1">A termdef must contain exactly one firstterm</s:assert>
 504           </s:rule>
 505         </s:pattern>
 506         <ref name="db.termdef.attlist"/>
 507         <zeroOrMore>
 508           <ref name="db.all.inlines"/>
 509         </zeroOrMore>
 510       </element>
 511     </define>
 512   </div>
 513 </grammar>