ST-Guide

Warum erscheinen Bilder bei mir nicht zentriert?

Beschaffen Sie sich die aktuelle ST-Guide-Version. ST-Guide Release 15 kann Bilder selbständig zentrieren.

Wie werden die Titelseite und das Inhaltsverzeichnis erzeugt?

Titelseite und Inhaltsverzeichnis werden jeweils auf einer eigenen Seite dargestellt. Die Titelseite hat dabei den Namen Titel, dem Inhaltsverzeichnis wird dabei der primäre Name Main zugewiesen.

Um den ST-Guide die erste Seite des Hypertextes (was meistens die Titelseite sein wird) darstellen zu lassen, übergeben Sie einfach den Namen des erzeugten Hypertextes. Um das Inhaltsverzeichnis darzustellen, übergeben Sie zusätzlich Main. Wie Sie dem ST-Guide mitteilen, welche Seite welchen Hypertextes anzuzeigen ist, finden Sie in der Beschreibung zum HCP.

Wie entferne ich die Kopfzeilen?

UDO erzeugt standardmäßig auf jeder Seite eine Kopfzeile, gebildet aus dem Titel und dem Namen des im Hypertext besprochenen Programms. Die Kopfzeilen werden unterstrichen dargestellt.

Durch den Schalter !no_headlines [stg] lässt sich die Ausgabe dieser Kopfzeilen unterbinden.

Wie wird beim ST-Guide referenziert?

Die Referenzierung wird fast komplett dem HCP des ST-Guide überlassen.

Nur bei den manuell gesetzten Links durch die Kommandos (!link) und (!xlink) setzt UDO explizite Querverweise auf andere Kapitel oder Labels.

Wie werden Labels umgesetzt?

UDOs Kommando !label wird in den HCP-Befehl @symbol ari umgesetzt. Dabei ist zu beachten, dass noch kein anderes Kapitel oder Label mit gleichem Namen existiert, da der HCP dies bemängeln würde.

Labels werden (wie bei den anderen Formaten auch) automatisch referenziert und gelangen darüber hinaus auch in den Index des Hypertextes.

Wie können Popup-Nodes erzeugt werden?

Durch die Befehle !pnode usw. können Kapitel im ST-Guide als Popups dargestellt werden. Dabei ist folgendes zu beachten:

Beim ST-Guide dürfen in einem Popup nur 12 Zeilen mit maximal 60 Zeichen stehen. Außerdem dürfen in einem Popup keine Bilder oder Verweise benutzt werden.

UDO bricht Zeilen eines Popup-Nodes auf 60 Zeichen um, achtet aber nicht darauf, ob Sie zuviele Zeilen, Verweise oder Bilder benutzt haben.

In den Popup-Nodes steht am Ende immer eine Leerzeile, wieso?

UDO bearbeitet einen Quelltext Zeile für Zeile. Beim Auftreten einer Leerzeile oder eines Kommandos wird der letzte Absatz samt einer zusätzlichen Leerzeile ausgegeben.

Dies ist auch bei den Popup-Nodes nicht anders. Das Problem lässt sich leider nicht lösen.

In Tabellen sind manche Zellen verschoben, warum?

Der ST-Guide besitzt eine eingebaute Italic-Korrektur, die leider auch bei Tabellen zuschlägt und Leerzeichen einfügt. Das ist ein Problem des ST-Guide und kann nur von dessen Autor, Holger Weets, geändert werden.

Man sollte daher bei Tabellen, die für den ST-Guide eingesetzt werden, möglichst auf Kursivschrift verzichten, solange es keine neuere ST-Guide-Version gibt.

Der HCP meldet mir den Fehler please add...?

Falls der HCP die Fehlermeldung please add a @subject-command to this text am Ende der Übersetzung des erzeugten ST-Guide-Quelltextes erzeugt, haben Sie vergessen, im Vorspann des UDO-Quelltextes folgenden ST-Guide-Spezialbefehl anzugeben:

!stg @subject "..."

Anstelle der Punkte müssen Sie die Rubriken angegeben werden, in die ein Hypertext eingeordnet werden kann. Bei einem kleinen Tool geben Sie z.B. Dokumentation/Utilities an. Weitere Informationen zu diesem Thema finden Sie in der Dokumentation des ST-Guide.

Wie erzeuge ich eine eigene Titelseite?

Falls Ihnen das Layout der Titelseite, die UDO mit !maketitle erzeugen kann, nicht gefällt, können Sie sich mit nur wenigen Handgriffen Ihre eigene Titelseite erzeugen.

Im folgenden Beispiel wird nach !begin_document nur für den ST-Guide eine eigene Titelseite mittels eines Kapitels erzeugt, welches nicht im Inhaltsverzeichnis erscheint. Am Ende der Titelseite wird das Wort Inhaltsverzeichnis angegeben, dass ein Link zu eben diesem vom ST-Guide erzeugt wird.

!docinfo [program] Titelseiten mit UDO

!begin_document

!ifndest [stg]

!maketitle

!else

!node* Titel

!begin_center
Der Hypertext zu ""Hello, World!"" (!nl)
Version 8.4
!end_center

!begin_table [cc]
Autor:             !! Vertrieb:
Reiner C. Anfänger !! Ultra-Supra-Soft
Feldweg 42         !! Postfach 4711
D-98755 Irgendwo   !! D-12345 Sonstwo
!end_table

!smallskip

!begin_center
Inhaltsverzeichnis
!end_center

!endif

!tableofcontents

!node Jetzt geht's lohoos
Dies ist das erste Kapitel.

!node Feierabend
Schluss jetzt!

!end_document

Warum ist es besser, auf Blocksatz zu verzichten?

Warum das denn?, werden Sie sich vielleicht fragen. Nun, mit Hyperion/HypC gibt es von Martin Osieka ein Programmpaket für den Apple Macintosh, mit dem Sie ST-Guide-Hypertexte auch hier schreiben, umwandeln und darstellen können.

Im Gegensatz zum ST-Guide können jedoch mit Hyperion auch Hypertexte vernünftig mit proportionalen Zeichensätzen dargestellt werden, falls kein Blocksatz benutzt wird.

Sie sollten daher Hypertexte mit allgemeinem Inhalt nicht mit Blocksatz erstellen, denn interessierte Hyperion-Benutzer würden es Ihnen verübeln.

Bei Hypertexten, die nur auf dem Atari Sinn ergeben (z.B. für ein Programm), können Sie natürlich ruhigen Gewissens Blocksatz verwenden.