6.1 Dokumentstruktur

Die Dokumentstruktur wird in Agora in einer XML-Datei docstrct.xml beschrieben. Die Datei befindet sich im .../WEB-INF/repository-Verzeichnis der jeweiligen Anwendung. Unser obiges Beispielprojekt DigitalLibrary könnte also seine docstrct.xml unter folgendem Pfad abgelegt haben: /data/tomcat5/webapps/DigitalLibrary/WEB-INF/repository

Die Datei ist folgendermaßen strukturiert

Klammer und oberster Knoten bildet die <agora-collection>. Danach folgt die <language-list>. Sie legt fest, in welcher Sprache die Web-Anwendung präsentiert werden soll. Sollen mehrere Sprachen unterstützt werden, müssen pro XML-Element die entsprechenden Sprachen definiert werden.

Beispiel für eine Konfiguration für die Sprachen 'Deutsch' (de) und 'Englisch' (en):

...
<language-list>
    <language>de</language>
    <language>en</language>
</language-list>
...

Es folgen die:

• <collection-list>

  eine Agora-Anwendung kann verschiedene Dokument-Kollektionen verwalten. Diese werden in der <collection-list> definiert.

  Beispiel für zwei Kollektionen (c1 und c2) :

  ...
  <collection-list>
    <collection name="c1">
      <name xml:lang="en">Novels</name>
        <element-ref ref="Volume" />
    </collection>
    <collection name="c2">
      <name xml:lang="en">Poems</name>
        <element-ref ref="Volume" />
    </collection>
  </collection-list>
  ...
  

• <element-list>

  umfaßt die Menge der definierte Dokument-Elemente. Jedes Element kann mit beliebigen Unterelementen <element-ref> und mit beliebigen Attributen <attribute-ref> versehen werden.

  Beispiel:

  ...
  <element-list>
    <element name="Novel">
      <name xml:lang="de">Roman</name>
      <name xml:lang="en">Novel</name>
         <element-ref ref="Chapter"/>
         <attribute-ref ref="Title"/>
         <attribute-ref ref="DocLanguage"/>
         <attribute-ref ref="Author"/>
         <attribute-ref ref="Translator"/>
         <attribute-ref ref="Editor"/>
    </element>
  ...
  

  ...
    <element name="Poem">
      <name xml:lang="de">Gedicht</name>
      <name xml:lang="en">Poem</name>
         <element-ref ref="Strophe"/>
         <attribute-ref ref="Title"/>
         <attribute-ref ref="DocLanguage"/>
         <attribute-ref ref="Author"/>
         <attribute-ref ref="Translator"/>
    </element>
  ...
  </element-list>
  ...
  

• <attribute-list>

  definiert alle in der Elementliste referenzierten Attribute. - Es kann also kein losgelöstes Attribut geben kann. Ein Attribut ist nur in Zusammenhang und als Beschreibung eines Elements möglich. Attribute sind nicht strukturiert, d. h. bei ihrer Bekanntmachung in der Dokumentstruktur wird nur jeweils ihr Name plus mögliche Varianten in den verschiedenen Sprachen angegeben..

  Beispiel

  ...
  <attribute-list>
      <attribute name="Title">
        <name xml:lang="en">Title</name>
        <name xml:lang="de">Titel</name>
      </attribute>
      ...
      <attribute name="Chapter">
        <name xml:lang="en">Chapter</name>
        <name xml:lang="de">Kapitel</name>
      </attribute>
      ...
  </attribute-list>
  ...
  

Ausführliche Beschreibung der docstrct.xml siehe unter: http://digbib.srz-berlin.de:8080/info/docu/docstrct.html