!subnode Fragen zum ST-Guide-Format
!ignore_links
!html_name faqstg

!begin_description

##################################################

!item [Warum erscheinen Bilder bei mir nicht zentriert?] ~

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

##################################################

!item	[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, übergibt man einfach den Namen des
erzeugten Hypertextes. Um das Inhaltsverzeichnis darzustellen, übergibt man
zusätzlich ""Main"". Wie man dem ST-Guide mitteilt, welche Seite welchen
Hypertextes anzuzeigen ist, findet man in der Beschreibung zum HCP.

##################################################

!item [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 (!I)!/no_headlines [stg](!i) läßt sich die Ausgabe dieser
Kopfzeilen unterbinden.

##################################################

!item [Wie wird beim ST-Guide referenziert?] ~

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

Lediglich bei den manuell gesetzten Links durch die Befehle
(!I)(!/link~...)(!i) und (!I)(!/xlink~...(!i) setzt UDO explizite
Querverweise auf andere Kapitel oder Labels.

##################################################

!item [Wie werden Labels umgesetzt?] ~

UDOs Befehl (!I)!/label(!i) wird in den HCP-Befehl ""(!T)@symbol ari(!t)""
umgesetzt.  Dabei ist zu beachten, daß 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.

##################################################

!item [Wie können Popup-Nodes erzeugt werden?] ~

Durch die Befehle (!I)!/pnode(!i) etc. können Kapitel im ST-Guide als Popups
dargestellt werden. Dabei ist folgendes zu beachten:

Beim ST-Guide dürfen in einem Popup lediglich 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 man zuviele Zeilen, Verweise oder Bilder benutzt hat.

##################################################

!item [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äßt sich
leider nicht lösen.

##################################################

!item [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.

##################################################

!item [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,
so haben Sie vergessen, im Vorspann des UDO-Quelltextes folgenden
ST-Guide-Spezialbefehl anzugeben:

!begin_quote
!begin_verbatim
!stg @subject "..."
!end_verbatim
!end_quote

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 findet
man in der Dokumentation des ST-Guide.

##################################################

!end_description

