<?xml version = "1.0" encoding = "utf-8"?>
<?xml-stylesheet href="/pool/rng_ht.xslt" type="application/xml"?>
<!-- file KLEIDER/web/src/sitestyle/inclcomp.rng -->
<!--
  Einzubettender Inhalt in DocBook-Dateien 
  "http://herbaer.de/xmlns/20121016/inclcomp"
  2012 Herbert Schiemann <h.schiemann@herbaer.de>
  Borkener Str. 167, 46284 Dorsten, Germany
  GPL Version 2 oder neuer
  Jede Gewährleistung ist ausgeschlossen.

  Das Schema folgt den folgenden Richtlinien:
  - Jedes Attribut und jedes Element wird in einem
    <define>-Element spezifiziert
  - Jedes <define>-Element spezifiziert höchstens ein Attribut oder Element
  - Die Namen der Muster ("Pattern"), die ein Attribut spezifizieren,
    beginnen mit "att_".
  - Die Namen der Muster, die ein Element spezifizieren,
    beginnen mit "el_".
  - Die Dokumentation ist in den define-Elementen enthalten und benutzt
    DocBook-XML-artige Markierungen des Namensraums
    http://herbaer.de/xmlns/20051201/doc
-->
<grammar
  xmlns   = "http://relaxng.org/ns/structure/1.0"
  xmlns:d = "http://herbaer.de/xmlns/20051201/doc"
  ns      = "http://herbaer.de/xmlns/2012101t/inclcomp"
>

<d:info xmlns="http://herbaer.de/xmlns/20051201/doc">
  <title>inclcomp.rng</title>
  <subtitle>Einzubettender Inhalt in DocBook-Dateien </subtitle>
  <date>2012-10-21</date>
  <author>
    <personname>
      <firstname>Herbert</firstname>
      <surname>Schiemann</surname>
    </personname>
    <email>h.schiemann@herbaer.de</email>
  </author>
</d:info>

<d:para>
Die XML-Elemente dieses Namensraums stehen in DocBook-Quelldateien
für den Inhalt, der in der XHTML-Darstellung einzubetten ist.
</d:para>

<define name = "anything">
  <d:para>
    Beliebiger Inhalt
  </d:para>
  <zeroOrMore>
    <choice>
      <element>
        <anyName/>
        <ref name="anything"/>
      </element>
      <attribute>
        <anyName/>
      </attribute>
      <text/>
    </choice>
  </zeroOrMore>
</define><!-- anything -->

<define name = "foreign_att">
  <d:para>
    Attribute anderer XML-Namensräume
  </d:para>
  <zeroOrMore>
    <attribute>
      <anyName>
        <except>
          <nsName ns = ""/>
          <nsName ns = "http://herbaer.de/xmlns/20121016/inclcomp"/>
        </except>
      </anyName>
    </attribute>
  </zeroOrMore>
</define><!-- foreign_att -->

<define name = "foreign_el">
  <d:para>
    Elemente anderer XML-Namensräume
  </d:para>
  <zeroOrMore>
    <element>
      <anyName>
        <except>
          <nsName ns = "http://herbaer.de/xmlns/20121016/inclcomp"/>
        </except>
      </anyName>
      <ref name = "anything"/>
    </element>
  </zeroOrMore>
</define><!-- foreign_el -->

<!--
<ic:include href="helpme/index.xml" idbase="section"/>
-->

<define name = "att_href">
  <d:para>
Der (relative) Pfad einer XML-Datei des Namensraums
<d:tag class = "namespace">http://herbaer.de/xmlns/20121016/components</d:tag>,
die die einzubettenden Dokumente bestimmt.
  </d:para>
  <attribute name = "href">
    <data type = "string"/>
  </attribute>
</define><!-- att_href -->

<define name = "att_sort">
  <d:para>
Der Wert <d:literal>revers</d:literal> bedeutet,
dass die Einträge in umbekehrter Reihenfolge eingefügt werden.
  </d:para>
  <attribute name = "sort">
    <value>revers</value>
  </attribute>
</define><!-- att_sort -->

<define name = "att_idbase">
  <d:para>
Die ID-Werte der eingefügten Abschnitte zu den einzubetttenden Dokumenten
beginnen mit dem Wert dieses Attributes, gefolgt von einem Punkt.
  </d:para>
  <attribute name = "idbase">
    <data type = "string"/>
  </attribute>
</define><!-- att_idbase -->

<define name = "el_include">
  <d:para>
Dieses Element steht in DocBook-Quelltexten für einzubettenden Inhalt.
Zu dem Wurzel-Element des Dokuments,
auf das <d:tag class = "attribute">href</d:tag> verweist,
wird ein Abschnitt (<d:tag class = "element">section</d:tag>-Element) eingefügt,
zu den enthaltenen Elementen werden Unterabschnitte eingefügt.
  </d:para>
  <element name = "include">
    <ref name = "att_href"/>
    <optional>
      <ref name = "att_sort"/>
    </optional>
    <optional>
      <ref name = "att_idbase"/>
    </optional>
    <ref name = "foreign_att"/>
    <ref name = "foreign_el"/>    
 </element>
</define><!-- el_include -->

</grammar>
<!-- end of file KLEIDER/web/src/sitestyle/inclcomp.rng -->
