<TeXmacs|1.0.4.5>

<style|tmdoc>

<\body>
  <tmdoc-title|Eigene Plugins schreiben>

  Um ein Plugin <verbatim|<em|myplugin>> zuschreiben, sollten Sie zuerst ein
  Verzeichnis erstellen

  <\verbatim>
    \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|myplugin>
  </verbatim>

  das Sie alle notwendigen Dateien enthalten wird. Denken Sie bitte daran,
  dass der <verbatim|$TEXMACS_HOME_PATH> gemäÿ Vorgabe
  <verbatim|$HOME/.TeXmacs> ist. Zusätzlich können Sie die folgenden
  Verzeichnisse erzeugen, falls Sie sie brauchen sollten:

  <\description-dash>
    <item*|<verbatim|bin>>Für Binärdateien.

    <item*|<verbatim|doc>>Für die Dokumentation (noch nicht unterstützt).

    <item*|<verbatim|langs>>Für Sprach-Dateien wie z.B. Wörterbücher (noch
    nicht unterstützt).

    <item*|<verbatim|lib>>Für Bibliotheken.

    <item*|<verbatim|packages>>Für Stil-Pakete.

    <item*|<verbatim|progs>>Für <value|scheme>-Programme.

    <item*|<verbatim|src>>Für Quellcode.

    <item*|<verbatim|styles>>Für Stil-Definitionen.
  </description-dash>

  Generell gilt, Dateien, die sich in diesen Verzeichnissen befinden, werden
  automatisch erkannt, wenn <TeXmacs> startet. Wenn z.B. ein <verbatim|bin>
  Unterverzeichnis existiert, dann wird

  <\verbatim>
    \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|myplugin>/bin
  </verbatim>

  automatisch zu der <verbatim|PATH>-Kontext-Variablen hinzugefügt. Beachten
  Sie, dass die Verzeichnisstruktur eines Plugins derjenigen von
  <verbatim|$TEXMACS_PATH> ähnelt.

  <\example>
    Der simpelste Typ von Plugins besteht nur aus Daten-Dateien, wie z.B.
    einer Sammlung von Stil-Definitionen und Stil-Paketen. Dazu genügt es,
    die Verzeichnisse

    <\verbatim>
      \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|myplugin>

      \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|myplugin>/styles

      \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|myplugin>/packages
    </verbatim>

    herzustellen und die Dateien in die entsprechenden Verzeichnisse zu
    kopieren. Danach werden diese automatisch nach einem Neu-Start von
    <TeXmacs>, in den Menüs <menu|Document|Style> bzw. <menu|Document|Use
    package> erscheinen.
  </example>

  Komplexere Plugins, wie z.B. Plugins mit zusätzlichem <value|scheme> oder
  <value|cpp> Code muss man meist noch eine
  <value|scheme>-Konfigurations-Datei erstellen

  <\verbatim>
    \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|myplugin>/progs/init-<em|myplugin>.scm
  </verbatim>

  Diese Konfigurations-Datei sollte eine Anweisung der folgenden Form

  <\scheme-fragment>
    (plugin-configure <em|myplugin>

    \ \ <em|configuration-options>)
  </scheme-fragment>

  enthalten. Darin beschreiben <verbatim|<em|configuration-options>> die
  Tätigkeiten, die beim Start durchzuführen sind, einschlieÿlich der Frage,
  ob der Code in Ordnung ist. In den nachfolgenden Abschnitten werden wir
  anhand von einfachen Beispielen dir Arbeitsweise und die Programmierung von
  Plugins erläutern. Viele weitere Beispiele finden Sie unter

  <\verbatim>
    \ \ \ \ $TEXMACS_PATH/examples/plugins

    \ \ \ \ $TEXMACS_PATH/plugins
  </verbatim>

  Einige werden eingehender im Kapitel über
  <hyper-link|Schnittstellen|../interface/interface.de.tm> beschrieben.

  <tmdoc-copyright|1998--2002|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".>

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