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
(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ü
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.