Ein Beispiel mit C++ Code

Das minimal plugin

betrachten wir das Beispiel minimal im Verzeichnis

    $TEXMACS_PATH/examples/plugins/minimal

Es besteht aus den Dateien:

    minimal/Makefile
    minimal/progs/init-minimal.scm
    minimal/src/minimal.cpp

Um das Plugin auszuprobieren müssen Sie das Verzeichnis

    $TEXMACS_PATH/examples/plugins/minimal

rekursiv in das Verzeichnis $TEXMACS_PATH/progs kopieren oder in das Verzeichnis $TEXMACS_HOME_PATH/progs. Danach müssen Sie in dem Verzeichnis minimal den Befehl

    make

ausführen und so den Programmcode minimal.cpp zu einer Binärdatei kompilieren

    minimal/bin/minimal.bin

Wenn Sie jetzt TeXmacs neu starten sollte das Plugin automatisch erkannt werden.

Wie es funktioniert.

Das minimal Plugin demonstriert eine Minimal-Schnittstelle zwischen TeXmacs und einem externen Programm. Dieses Programm und sein Quellcode in minimal.cpp wird eingehender im Kapitel über Schittstellen erklärt. Die Initialisierungs-Datei init-minimal.scm enthält den folgenden Code:

(plugin-configure minimal

(:require (url-exists-in-path? "minimal.bin"))

(:launch "minimal.bin")

(:session "Minimal"))

Die :require Option prüft, ob minimal.bin im Suchpfad gefunden werden kann. Deshalb wird die Initialisierungs-Routine abgebrochen, wenn Sie vergessen haben sollten, das Plugin zu kompilieren. Die :launch Option erklärt, wie das externe Programm aufzurufen ist. Die :session Option sorgt dafür, dass der Befehl EinfügenSitzungMinimal bereitsteht, um eine minimal Sitzung zu erzeugen.

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