doc/devel/format/basics/tm-docs.de.tm

<TeXmacs|1.0.4.2>

<style|tmdoc>

<\body>
  <tmdoc-title|<TeXmacs>-Dokumente>

  <TeXmacs>-Dokumente sind nat<61>rlich <TeXmacs>-B<>ume, diese haben allerdings
  eine spezielle Form, die im folgenden beschrieben wird. Unter einem
  <TeXmacs>-Dokument wird hier eine Datei bezeichnet, die unter <TeXmacs>
  erstellt, sich im Speicher (Puffer) befindet oder auf einem Speichermedium
  gespeichert wurde. Textst<73>cke, also Teile von Dokumenten, sind zwar auch
  <TeXmacs>-B<>ume, aber normalerweise keine Dokumente.

  Die Wurzel eines Dokuments muss der Standard-Operator <markup|document>
  sein. Er hat notwendigerweise die beiden Kinder\ 

  <\explain|<explain-macro|TeXmacs|Version><explain-synopsis|<TeXmacs>
  Version>>
    Dieser Operator ist notwendig und spezifiziert die Version von <TeXmacs>,
    die zum abspeichern des Dokuments benutzt wurde.
  </explain>

  <\explain|<explain-macro|body|Inhalt><explain-synopsis|Dokumenten-Rumpf >>
    Dieser notwendige Operator spezifiziert den Rumpf des Dokuments, also im
    Endeffekt den Inhalt.
  </explain>

  Zu diesen beiden notwendigen Operatoren k<>nnen weitere Operatoren/Kinder
  hinzutreten, sofern diese aus den folgenden ausgew<65>hlt werden:

  <\explain>
    <explain-macro|style|Version>

    <explain-macro|style|<with|font-shape|right|<explain-macro|tuple|style|pack-1|<with|mode|math|\<cdots\>>|pack-n>>><explain-synopsis|<translate|style|english|german>
    und <translate|packages|english|german>>
  <|explain>
    Ein <translate|style|english|german> und zus<75>tzliche
    <translate|packages|english|german>.
  </explain>

  <\explain|<explain-macro|project|Verweis><explain-synopsis|Projekthinweis>>
    Damit kann ein Verweis auf ein Projekt hinzugef<65>gt werden, zu dem das
    Dokument geh<65>rt.\ 
  </explain>

  <\explain|<label|initial-env><explain-macro|initial|Tabelle><explain-synopsis|Start-Kontext>>
    Hiermit kann ein Kontext festgelegt werden, mit dem das Dokument
    gestartet wird: z.B. Seitengr<67><72>e, Randma<6D>e, usw.. Die <src-arg|Tabelle>
    hat die Form <explain-macro|collection|Bindung-1|<with|mode|math|\<cdots\>>|Bindung-n>.
    Jede <src-arg|Bindung-<no-break>i> hat die Form
    <explain-macro|associate|Variable-i|Wert-i> und setzt die Kontextvariable
    <src-arg|Variable-i> auf den Startwert <src-arg|Wert-i>. Startwerte f<>r
    Kontextvariable, die nicht in der Tabelle enthalten sind, werden durch
    den Basis-Stil und die Stilpakete festgelegt.\ 
  </explain>

  <\explain|<explain-macro|references|Tabelle><explain-synopsis|Verweise>>
    Wahlweise eine Liste aller g<>ltigen Verweise auf eine Marke \RLabel'' in
    dem Dokument. Auch wenn diese Information von <TeXmacs> automatisch
    erzeugt werden kann, ist es sinnvoll eine solche Tabelle abzuspeichern,
    denn es braucht mehrere Durchg<68>nge, um eine solche Tabelle automatisch zu
    erzeugen. Um anwenderfreundliches Verhalten des Editors zu erreichen,
    werden Verweise zusammen mit dem Dokument gespeichert.

    Die <src-arg|Tabelle> hat eine <20>hnliche Form wie in der vorgehenden
    Operation. Hier wird ein \RTuple`` mit jedem Verweis verbunden. Dieses
    Tuple hat entweder die Form <explain-macro|tuple|Inhalt|Seiten-Nr> oder
    <explain-macro|tuple|Inhalt|Seiten-Nr|Datei>. Der <src-arg|Inhalt>
    enth<74>lt den Text, der gezeigt wird, wenn der Verweis angesprochen wird,
    und <src-arg|Seiten-Nr> enth<74>lt die dazugeh<65>rige Nummer der Seite. Die
    Option \R<src-arg|Datei>'' gibt die Datei an, in welcher die Marke
    \RLabel'' definiert wurde. Das ist nur notwendig, wenn das Dokumente zu
    einem Projekt geh<65>rt, das aus mehreren Dateien besteht.
  </explain>

  <\explain|<explain-macro|auxiliary|Tabelle><explain-synopsis|zus<75>tzliche
  Hilfsdaten zu einem Dokument>>
    Dies ist eine wahlweise Tabelle, die zus<75>tzliche Hilfsdaten abspeichert.
    Wie oben k<>nnen diese Daten automatisch aus dem Dokument selbst berechnet
    werden, diese Berechnungen k<>nnen aber aufw<66>ndig sein und unter Umst<73>nden
    auch Werkzeuge ben<65>tigen, die m<>glicherweise auf Ihrem System nicht
    vorhanden sind. Die <src-arg|Tabelle>, wird <20>hnlich wie oben definiert,
    assoziiert die Hilfsdaten mit einem Schl<68>ssel. Standard-Schl<68>ssel sind
    u.a. <verbatim|bib>, <verbatim|toc>, <verbatim|idx>, <verbatim|gly> usw..
  </explain>

  <\example>
    Ein Beispiel f<>r ein Dokument, das nur den einfachen Text \RHallo Welt!''
    enth<74>lt, liefert den folgenden Baum,

    <\equation*>
      <tree|<with|mode|text|<markup|document>>|<tree|<with|mode|text|<markup|TeXmacs>>|<with|mode|text|<TeXmacs-version>>>|<tree|<with|mode|text|<markup|style>>|article>|<tree|<with|mode|text|<markup|body>>|<tree|<with|mode|text|<markup|document>>|Hallo
      Welt!>>>
    </equation*>
  </example>

  Wie Sie sehen, kann unterhalb der Dokument-Wurzel mit Standard-Operator
  <markup|document> der Standard-Operator <markup|document> erneut auftreten.
  Diese <20>ste sind in der Regel keine Dokumente, das die Kinder
  <explain-macro|TeXmacs|Version> und <explain-macro|body|Inhalt> fehlen.

  <tmdoc-copyright|2004|Joris van der Hoeven>

  <tmdoc-license|Permission is granted to copy, distribute and/or modify this
  document under the terms of the GNU Free Documentation License, Version 1.1
  or any later version published by the Free Software Foundation; with no
  Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  Texts. A copy of the license is included in the section entitled "GNU Free
  Documentation License".>
</body>

<\initial>
  <\collection>
    <associate|language|german>
    <associate|preamble|false>
  </collection>
</initial>