Zusammenfassung der Konfigurations-Optionen für Plugins

Wie bereits gesagt wurde, sollte die Scheme-Konfigurations-Datei myplugin/progs/init-myplugin.scm eines Plugins mit dem Namen plugin eine Anweisung der Form

enthalten. Hier folgt eine Liste von vorhandenen configuration-options:

(:require condition)

Diese Option spezifiziert eine Bedingung condition, die erfüllt sein muss, damit das Plugin funktioniert. Normalerweise wird überprüft, ob bestimmte Dateien vorhanden sind. Wenn die Bedingung nicht wahr ist, dann wird TeXmacsso weitermachen, als ob das Plugin gar nicht existiert. Die Konfiguration wird abgebrochen. Die :require Option ist normalerweise die allererste.

(:version version-cmd)

Diese Option führt einen Scheme-Ausdruck version-cmd aus, der zu der Version des Plugins evaluiert.

(:setup cmd)

Diese Anweisung wird nur ausgeführt, wenn die Version des Plugins sich seit dem letzten Aufruf von TeXmacs geändert hat. Das passiert eigentlich nur, wenn Sie neue Versionen von TeXmacs oder Hilfsanwendungen neu installiert haben..

(:initialize cmd)

Diese Option führt den Scheme-Ausdruck cmd aus. Er folgt normalerweise unmittelbar auf :require option, so dass das Plugin nur konfiguriert wird, wenn es auch existiert. Auch große Plugins sollten eine kleine myplugin/progs/init-myplugin.scm Datei haben, damit der TeXmacs-Start nicht zu sehr verzögert wird, denn diese Routine muss bei jedem Start abgearbeitet werden. darum sollte der Großteil der Scheme-Anweisungen in einer eigenen Datei untergebracht werden, die von dem Initialisierungs-Befehl geladen wird.

(:launch shell-cmd)

Diese Option erklärt, dass das Plugin Ausdrücke über eine Pipeline evaluieren kann, die eine Hilfsanwendung benutzt, welche mit dem System-Befehl shell-cmd gestartet wird..

(:link lib-name export-struct options)

Diese Option entspricht weitgehend :launch, nur wird die externe Anwendung damit dynamisch eingebunden. Weitere Informationen finden Sie im Abschnitt Dynamisch ladbare Bibliotheken.

(:session menu-name)

Diese Option erklärt, dass das Plugin ein Anwendung unterstützt, die in interaktiven Sitzungen Eingaben evaluieren kann. Ein Menü-Punkt menu-item wird in das Menü Einfügen→Sitzung eingetragen, um damit solche Sitzungen zu starten.

(:serializer ,fun-name)

Wenn das Plugin zur Evaluierung taugt, dann dient diese Option dazu die Scheme-Funktion fun-name zu benennen, die TeXmacs-Bäume ind Zeichenketten umformt.

(:commander ,fun-name)

Diese Anweisung entspricht weitgehend :serializer, nur dass :commander benutzt wird, um spezielle Befehle in Zeichenketten umzuwandeln .

(:tab-completion #t)

Diese Anweisung erklärt, dass das Plugin Text-Ergänzungen unterstützt.

(:test-input-done #t)

Diese Anweisung erklärt, dass das Plugin ein Routine hat, die testen kann, ob die Eingabe vollständig ist.