Der Aufbau von Stil-Definitionen und -Paketen

Jede TeXmacs-Standard-Stil-Definition und jedes TeXmacs-Standard-Stil-Paketberuht auf einer endlichen Anzahl von Unterpaketen. In abstrakter Darstellung ist dies ein Baum mit Labeln. Der Baum, der zum Artikel-Stil, article, gehört, sieht so aus:

Abbildung 1. Der Baum, der den Stil Artikel, article, repräsentiert. Um Platz zu sparen, wurden die Kinder von std und env vereinfachend als vertikale Listen dargestellt.

Die meisten Stilpakete entsprechen einer D.T.D. (data type definition), die die „abstrakte Schnittstelle” des Pakets darstellt, d.h. die exportierten, von außen zugänglichen, Befehle. Z.B. entspricht das Paket std-markup der D.T.D. std-markup. Manchmal können auch mehrere Stil-Pakete der gleichen D.T.D. entsprechen. Dies ist beispielsweise bei header-article und header-book der Fall, die beide der D.T.D. header entsprechen, da sie nur verschiedene Arten der Darstellung von sonst gleichen Befehlen implementieren.

Wenn Sie Ihre eigene Stil-Definition oder Ihr eigenes Stil-Paket schreiben, können Sie das Konstrukt use-package benutzen, um andere Pakete einzubinden Beispielsweise besteht der Stil article im wesentlichen aus der Zeile

<use-package|std|env|header-article|section-article>

Genauer, das Paket use-package läd die Stil-Pakete in der Reihenfolge seiner Argumente. Die Pakete müssen im Pfad $TEXMACS_PACKAGE_PATH liegen, die gemäß Vorgabe ., ~/.TeXmacs/packages und $TEXMACS_PATH/packages enthalten. Außerdem werden Befehle, die der Darstellung von Quellcode dienen, wie z.B. style-with, vor der Evaluierung entfernt.

Bemerkung 1. Wir empfehlen sehr, bevor man sich an das Schreiben eigener Stil-Definitionen macht, einige der Standard-Stil-Definitionen anzusehen. Diese findet man unter

    $TEXMACS_PATH/styles
    $TEXMACS_PATH/packages

Wenn man C-x C-f benutzt, um Dateien zu laden, dann sind die oben genannten Pfade mit im Standard-Pfad. Wenn Sie also das std-markup-Paket ansehen wollen, brauchen sie nur C-x C-f, eingeben und den Datei-Namen std-markup.ts und schließlich return.

Bemerkung 2. Man kann auch die Darstellung von Quellcode in den Stil-Definitionen und -Paketen anpassen, indem man andere Pakete gemeinsam mit dem Basisstil „Quellcode“, source, oder einer auf diesem Basis-Stil basierende Stil-Definition verwendet. In diesem Fall können die so bereitgestellten Makros zur Darstellung des Quellcodes genutzt werden, sie werden aber nicht exportiert, wenn Sie Ihr Paket oder Ihre Stildefinition in einer anderen Datei verwenden.

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