Das Plugin in die TeXmacs-Distribution einbinden

Nehmen wir einmal an, dass Sie erfolgreich, wie im vorgehenden Abschnitt beschrieben, eine Schnittstelle zu TeXmacs in einem Anwenderprogramm angelegt haben. Dann wird es Zeit die Unterstützung für das Programm in die Standard-TeXmacs-Distribution zu übertragen. Weitere Verbesserungen bleiben danach möglich.

Seit der TeXmacsVersion 1.0.1.5 ist es sehr leicht, eine Schnittstelle so anzupassen, dass Sie direkt in TeXmacs integriert wird. Sie brauchen nur ein Verzeichnis zu erzeugen, das den Namen Ihres Plugins, myplugin, trägt:

    $TEXMACS_HOME_PATH/plugins/myplugin

$TEXMACS_HOME_PATH ist vorgabemäßig ~/.TeXmacs. In einem Unter-Verzeichnis, plugins, Ihres TeXmacs-Verzeichnisses können Sie alle Standard Plugins finden, die mit Ihrer TeXmacs-Distribution. ausgeliefert werden. Diese bieten gute Beispiele zur Nachäffung.

Das myplugin-Verzeichnis sollte eine ähnliche Unterverzeichnis-Struktur aufweisen, wie Ihr TeXmacs-Verzeichnis. Allerdings sollte es nur die Verzeichnisse enthalten, die Sie wirklich brauchen. In jedem Fall brauchen Sie aber eine Datei progs/init-myplugin.scm, die definiert, wie Ihr Plugin zu initialisieren ist. Normalerweise ist dies ein Scheme-Befehl der folgenden Form:

    (plugin-configure myplugin

(:require (file-in-path "myplugin"))

(:launch "shell-cmd")

(:format "input-format" "output-format")

(:session "Myplugin"))

Der erste Teil des Befehls ist ein Prädikat, dass überprüft, ob das Plugin auf diesen bestimmten System überhaupt verwendet werden kann. Meist überprüft es, ob ein bestimmtes Programm in einem bestimmten Pfad vorhanden ist. Nur dann, wenn dies erfüllt ist, wird der zweite Teil ausgeführt. Der Befehl :launch bedeutet hier, dass das Plugin mit shell-cmd. The command shell-cmd aus Befehl der System-Umgebung gestartet werden soll: meist in der Form: myplugin –texmacs. Der :format-Befehl erklärt , welche Formate für Eingabe und Ausgabe benutzt werden sollen. Normalerweise ist das Eingabe-Format verbatim, wörtlich, und das Ausgabe-Format allgemein . Andere mögliche Formate sind scheme, latex, html und ps. Die Option :session macht nimmt den Befehl in das Menü EinfügenSitzungMyplugin auf.

Wenn alles gut arbeitet und Sie Ihr System anderen innerhalb der offiziellen TeXmacs-Distribution zur Verfügung stellen wollen, dann kontaktieren Sie mich unter vdhoeven@texmacs.org.

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".