Files
2022-11-14 10:05:42 +01:00

2512 lines
92 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

##ACE-STGPAR 4 2013
@database "ST-Guide Dokumentation"
@subject "Dokumentation/ST-Guide"
@author "H. Weets, C. Wempe, V.Burggr„f"
@$VER: st-guide.hyp (@:"__DATE__")
@help "Hilfe-Seite zum ST-Guide"
@options +gz-s-d12
@extern HCP "hcp.hyp/Main"
@extern RefLink "reflink.hyp/Main"
@extern STool "stool.hyp/Main"
@extern STOOL "stool.hyp/Main"
@extern MAN2STG "man2stg.hyp/Main"
@extern Remarker "Remarker.hyp/Main"
@extern STG-FAQ "stg-faq.hyp/Main"
@node Main "Dokumentation des ST-Guide"
@prev Main
@next Einleitung
@xref "hcp.hyp/Main" "Hypertext-Compiler HCP"
@xref "reflink.hyp/Main" "Referenz-File Linker RefLink"
@xref "stool.hyp/Main" "Katalog-Utility STool"
@xref "1st_conv.hyp/Main" "Konverter 1stConv"
@xref "pc_conv.hyp/Main" "Konverter PC-Conv"
@xref "man2stg.hyp/Main" "Manual-Page Konverter MAN2STG"
@xref "Remarker.hyp/Main" "Notizen-Manager Remarker"
@xref "STG-FAQ.hyp/Main" "Oft gestellte Fragen STG-FAQ"
@symbol r ST-Guide
@limage "st-guide.img" 0
@line 3 2 0
@line 3 2 1
@line 5 0 1
@line 31 2 0
@line 31 2 1
@line 33 0 1
Allgemeines Der ST-Guide und seine Umgebung
ú Einleitung ú Hypertexte anderer Formate
ú Philosophie ú @{"Der ST-Guide und das AV-Protokoll" link "AV-Protokoll"}
ú Funktions<6E>bersicht
@line 31 2 0
@line 31 2 1
@line 33 0 1
ú Konfiguration Sonstiges
ú @{Dateitypen link HCP.HYP/Dateitypen} ú Rechtliches
ú Verwendete Software
@line 3 2 0
@line 3 2 1
@line 5 0 1
Bedienung des ST-Guide ú Update-History
ú Icon-Leiste
@line 31 2 0
@line 31 2 1
@line 33 0 1
ú Maus-Funktionen Zu guter letzt ...
ú Tastatur-Funktionen ú Wie schreibe ich einen Hypertext?
ú Auto-Locator ú Danksagung
@endnode
@node Einleitung
@toc Main
Einleitung ST-Guide
@line 1 75 0 0 7
"Kein Mensch liest heute Anleitungen ..."
@{B}HALT!@{0} Diese Zeiten sind vorbei. Oder?
Wie dem auch sei, es ist nun ganz klar der Zeitpunkt gekommen, wo diese
Anleitung einer Auffrischung bedarf! Der ST-Guide ist mittlerweile zu
einem weit verbreiteten System geworden, wurde bereits komplett (Programm
und Dokumentation) ins Englische <20>bersetzt und geh”rt zur Standard-
@{Konfiguration ignore} vieler heimischer und beruflich genutzter Atari-Systeme.
(Pardon: seit einiger Zeit auch verst„rkt auf Apple's unter MagiCMac!)
Immer weniger Autoren wollen es sich heute noch nehmen lassen, ihrem
Programm eine Online-@{Hilfe ignore} in Form eines Hypertextes beizulegen. Es gibt
Lexika, Sach-šbersichten, @{Info ignore}-Brosch<63>ren, Gesetzes-Texte und sogar schon
ein Labyrinthspiel als ST-Guide-Hypertexte, dazu eine Unmenge an Online-
Dokumentationen - eben alles, was sich irgendwie in einem Hypertext
unterbringen l„žt.
@line 20 35 0 0 7
@{B}Aber warum Hypertext?@{b}
Als Hypertext erh„lt ein Textdokument gewissermažen eine zus„tzliche
Dimension: man kann nicht nur linear durch den Text "wandern", sondern
auch "quer-feld-ein" zu anderen Textstellen springen. Jede Zeichenkette im
Text kann als Querverweis markiert werden. Damit lassen sich sinnverwandte
Seiten kreuz und quer miteinander verbinden oder einfach in eine griffige
Gliederung bringen.
Der Vorteil: Der Leser bekommt den Text in <20>bersichtlicher Form und in
kleinen H„ppchen pr„sentiert, insbesondere sind bei entsprechender
Aufmachung des Textes alle Kapitel schnell durch ein paar Mausklicks oder
Tastendr<EFBFBD>cke zu erreichen.
Damit steht es jedem offen, wie er/sie den Hypertext lesen will: entweder
h<EFBFBD>bsch der Reihe nach oder ganz gezielt ab einem bestimmten Punkt.
@{B}Und nun geht's los!@{0}
An dieser Stelle sei angemerkt, daž @{B}dieser@{0} Hypertext sich durch
fortw„hrendes Bl„ttern mittels des Pfeil-nach-rechts-Icons oder auch durch
@box 23 9 1
@box 33 3 1
die Tastenkombination Control -  lesen l„žt! Zwar kommt man dabei
nicht automatisch an @{B}jeder@{0} Seite dieses Hypertextes, wohl aber an den
wesentlichen Stationen vorbei. N„here Erl„uterungen k”nnen bei Bedarf
unterwegs durch entsprechende Mausklicks eingesehen werden.
Da sich vieles weiterentwickelt hat, empfiehlt es sich auch f<>r "alte
Hasen", sich diesen Hypertext mal wieder anzutun. Er taugt gleichzeitig als
Demonstration der ST-Guide-F„higkeiten, wie z.B. der @{Grafik link "Linien, Pfeile und Boxen"}.
@rbox 17 35 3
Viel Spaž mit dem ST-Guide!!!
@endnode
@node Philosophie
@toc Main
Die Philosophie des ST-Guide ST-Guide
@line 1 75 0 0 7
Hypertexte sind neu. Vielleicht scheint das nicht so, wenn man bedenkt,
daž es sie schon seit Jahren gibt, aber verglichen mit der herk”mmlichen
Form, den B<>chern, bedeuten sie neben den neuen M”glichkeiten auch eine
neue Art der Pr„sentation - und damit auch ein Umlernen in der Bedienung.
Um es nicht unn”tig schwierig zu machen, orientiert sich der ST-Guide
weitestgehend an der Art, wie B<>cher aufgebaut sind:
ú Haupt-Inhaltsverzeichnis und evtl. Unterverzeichnisse
ú Ein alphabetischer Index
ú Nach Kapiteln geordnet der eigentliche Textk”rper
Was bedeutet dies bei der Bedienung?
ú Man kann seitenweise vorw„rts oder r<>ckw„rts bl„ttern
ú Man kann von jeder Seite aus zum dar<61>berliegenden
(Zwischen-)Inhaltsverzeichnis springen (Inhalt-Icon)
ú Man kann von <20>berall aus in den @{Index link Index} springen
ú Man kann als Lesezeichen Marken auf Seiten setzen
ú Anmerkungen sind in Form von "Siehe auch"-Verweisen m”glich
ú Zur Schnellorientierung gibt es eine Hilfe-Seite, vergleichbar
etwa mit der r<>ckseitigen Kurzzusammenfassung eines Buches
@endnode
@node Funktions<6E>bersicht "Funktions<6E>bersicht des ST-Guide"
@toc Main
Funktions<EFBFBD>bersicht des ST-Guide ST-Guide
@line 1 75 0 0 7
Es versteht sich von selbst, daž der ST-Guide mehr kann, als nur ein Buch
zu "imitieren". Er ist ein sehr lebendiges System. St„ndig befindet sich
eine Reihe von interessierten Leuten in der Diskussion dar<61>ber, wie der
ST-Guide noch besser gemacht werden kann. Das Resultat der bisherigen
Bem<EFBFBD>hungen ist eine Anzahl n<>tzlicher Funktionen, die hier hier kurz
umrissen sei:
@{B}Davon profitieren Sie beim Lesen von Hypertexten:@{0}
ú Umfangreiche Grafik-F„higkeiten
- Popup-Nodes als Alternative zu den normalen Seiten
- Einbindung von Grafiken, siehe z.B. die Seite "Symbolleiste"
- Linien, Pfeile und verschiedene Boxentypen @{I}@{"<- Tip!" ignore}@{0}
- Unterschiedliche Text-Attribute
ú Geringer Speicherverbrauch auf der Diskette/Festplatte
ú Geringer Speicherverbrauch im Arbeitsspeicher des Computers
ú Datenbankqualit„ten:
1. Die zu den Hypertexten geh”renden Referenz-Dateien k”nnen mit dem
RefLink zu einer globalen Stichwortdatei aller Hypertexte
zusammengef<65>gt werden, in der dann per REF-Suche binnen kurzem jeder
irgendwo erkl„rte Begriff gefunden wird.
2. Das Utility STool sammelt automatisch alle vorhandenen Hypertexte
ein und macht daraus einen Katalog, wobei die in den Hypertexten
enthaltenen Gliederungsinformationen verwendet werden.
ú Benutzung sowohl als Accessory wie auch als Programm
ú Sie k”nnen auch Hypertexte anderer Formate an den ST-Guide anpassen
ú Weitgehende Tastatur-Bedienbarkeit (alternativ zur Maus)
ú Mehrere Suchfunktionen, darunter auch Žhnlichkeitssuche
ú Sogar aus normalen ASCII-Texten kann auf Hilfeseiten verzweigt werden
ú Wenn GDOS l„uft, kann der Anzeige-Zeichensatz selbst ausgew„hlt werden
ú Die Benutzung ist kostenlos, aber Spenden sind erbeten (Fairware)
@line 20 35 0 0 7
@{B}Davon profitieren Sie, wenn Sie selbst Hypertexte schreiben wollen:@{0}
ú Leicht erlernbare Syntax der Befehle
ú Verweise zu anderen Seiten werden vom Compiler automatisch erstellt!
ú Ein @{Index link Index} wird vom Compiler automatisch erstellt
ú Alle Seiten eines Hypertextes befinden sich in einer Datei (kompakt!)
ú Grože Vielfalt der Gestaltungsm”glichkeiten
@autorefoff
ú Der ST-Guide taugt als kontextabh„ngige Online-Hilfe f<>r Programme
@autorefon
ú Einbindung der Original-RSC-Files von Programmen m”glich
ú Der ST-Guide ist mittlerweile sehr verbreitet!
@endnode
@node Konfiguration
@toc Main
Konfiguration ST-Guide
@line 1 75 0 0 7
Wie pažt man den ST-Guide an die Umgebung an?
Alle Komponenten des ST-Guide k”nnen <20>ber eine Datei konfiguriert werden,
welche den Namen ST-GUIDE.INF tr„gt und sich im durch die
Environmentvariable HOME angegebenen Ordner oder im Wurzelverzeichnis des
Bootlaufwerkes befinden muž (meist C:\).
Sie ist i.w. so aufgebaut wie die Environment-Dateien diverser
Auto-Ordner-Environment-Setzer (tolles Wort...).
In der Datei ST-GUIDE.INF werden mehrere Variablen gesetzt, wovon der
ST-Guide selbst einige auswertet, andere wiederum werden von externen
Zusatz-Programmen ben”tigt. Die mitgelieferte ST-GUIDE.INF enth„lt bereits
ein vollst„ndiges Set von Einstellungen (mit Kommentaren) und braucht nicht
ver„ndert zu werden, wenn das ST-Guide-Archiv im Wurzelverzeichnis der
C:-Platte entpackt wurde.
Folgende Variablen werden vom ST-Guide ausgewertet:
@box 3 12 12
PATHS
@{HCP link "ST-GUIDE.INF" HCP}
@{HYPFIND link "ST-GUIDE.INF" HYPFIND}
HYPFOLD
REF Wichtige Zugriffspfade
@{REMARKER link "ST-GUIDE.INF" REMARKER}
EXTVIEW
DEFHYP
HYPTOP
PRINTER
MARKFILE
<ext>
@box 3 12 3
TXTCOLOR
REFCOLOR Nur bei Farbe relevant
BCK3D
@box 3 12 4
FONT
XFONT
WINSIZE Erscheinungsbild des ST-Guide-Fensters
TXTOFFSET
TABSIZE
@box 3 12 3
RIGHTBACK
REFONLY Maus-Verhalten
BACKWIND
@box 3 12 4
HCP_OPT
ARROWPATCH Sonstige
NOREFBOX
$<name>
@{B}Beispiel f<>r den Aufbau einer Zeile dieser Datei:@{0}
...
HYPFOLD=c:\guides\
...
Das ganze ist Zeilenorientiert und es d<>rfen sich keinerlei <20>berfl<66>ssige
Leerzeichen in den Zeilen befinden. Die Syntax ist
<Variable>=<Wert>
Man beachte, daž keine Leerzeichen vor oder hinter dem '=' stehen d<>rfen
und <Wert> @{B}ohne@{0} Hochkommata angegeben wird.
@endnode
@node "Symbolleiste" "Icon-Leiste"
@toc Main
@next "Zur<75>ck-Icon"
@symbol "Icon-Leiste"
@xref "Tastatur-Funktionen"
@xref "Maus-Funktionen"
@xref "Auto-Locator"
Die Icons im ST-Guide-Fenster ST-Guide
@line 1 75 0 0 7
Die oben im Fenster des ST-Guide sichtbaren Icons dienen der einfachen
Steuerung des Programms sowie dem <20>bersichtlichen Bl„ttern im Text. Sie
sind immer nur dann ausw„hlbar, wenn die gew<65>nschte Funktion auch sinnvoll
ist. So l„žt sich z.B. das Index-Icon nur dann aufrufen, wenn Sie sich
nicht bereits auf der Index-Seite befinden - logisch eigentlich.
Nicht-ausw„hlbare Icons sind immer "disabled", d.h. hell dargestellt.
@{Zur<75>ck link "Zur<75>ck-Icon"} Marken Inhalt @{Index link "Index-Icon"} Siehe auch Info Extra
@line 5 0 2 1 1
@line 15 0 2 1 1
@line 25 0 2 1 1
@line 35 0 2 1 1
@line 45 0 2 1 1
@line 55 0 2 1 1
@line 65 0 2 1 1
@image back3.icn 3
@image stk3.icn 8
@image mark.icn 13
@image prev.icn 18
@image up.icn 23
@image next.icn 28
@image end.icn 33
@image kat.icn 38
@image see.icn 43
@image help.icn 48
@image info.icn 53
@image open.icn 58
@image extra.icn 63
@image remarker.icn 68
@line 10 0 2 2
@line 20 0 4 2
@line 30 0 2 2
@line 40 0 4 2
@line 50 0 2 2
@line 60 0 4 2
@line 70 0 2 2
History-Popup n„chste Seite Hilfe-Seite @{Remarker link "Extra -> Remarker"}
vorige Seite Katalog Datei laden
Die auf den Icons liegenden Funktionen k”nnen fast alle auch per Tastatur
aufgerufen werden.
@endnode
@node "Maus-Funktionen"
@prev "Extra -> Remarker"
@xref "Symbolleiste" "Icon-Leiste"
@xref "Tastatur-Funktionen"
@xref "Auto-Locator"
Maus-Funktionen ST-Guide
@line 1 75 0 0 7
Die Mausbedienung ist recht einfach gehalten. Fast <20>berall wird lediglich
der einfache Klick mit der linken Maustaste ben”tigt. Dies gilt sowohl bei
den Icons, als auch beim Anklicken von Text im Fenster.
@{B}Merke:@{0} Nicht nur als solche kenntlich gemachte Verweise k”nnen angeklickt
werden, sondern auch nicht-markierte Worte, sofern nicht die REFONLY-
Variable in der ST-GUIDE.INF gesetzt wurde. Der ST-Guide sucht dann in der
vom RefLink erzeugten globalen Stichwort-Datei (REF) nach dem angeklickten
Wort und zeigt eine entsprechende Seite an, falls die Suche erfolgreich
war.
In wenigen Ausnahmef„llen gibt es aber vom einfachen Linksklick abweichende
Maus-Bedienungen:
@symbol "Block-Popup"
ú Ein gehaltener Mausklick mit anschliežendem Ziehen der Maus dient zum
zeilenweisen Markieren eines Blockes. Der markierte Bereich kann nach
Loslassen der Maustaste mittels Auswahl im erscheinenden Popup auf das
Klemmbrett kopiert oder gedruckt werden.
ú Rechte Maustaste als Alternative zum Zur<75>ck-Icon, falls die Variable
RIGHTBACK in der ST-GUIDE.INF definiert ist und der Klick dann
geschieht, wenn der Mauszeiger sich gerade im ST-Guide-Fenster befindet.
Diese Funktion ist von einigen Betriebssystemen gewissermažen nicht voll
"abgesegnet" und daher zun„chst nicht aktiviert. Mausfetischisten
m”gen aber in der schnellen R<>cksprungm”glichkeit einen Gewinn sehen.
Ihnen zuliebe wurde diese Funktion implementiert.
@endnode
@node "Tastatur-Funktionen"
@xref "Symbolleiste" "Icon-Leiste"
@xref "Maus-Funktionen"
@xref "Auto-Locator"
@toc Main
@symbol ar Tastaturbedienung
@symbol a Tastatur
Tastatur-Funktionen ST-Guide
@line 1 75 0 0 7
Der ST-Guide l„žt sich fast komplett per Tastatur bedienen. Die
Steuerfunktionen werden dabei durch Steuertasten bzw. in Verbindung mit
diesen ausgel”st. Werden dagegen alphanumerische Zeichen eingegeben, dann
tritt der Auto-Locator in Funktion.
@{B}Hier nun die definierten Tastatur-Shortcuts:@{0}
ú Cursortasten - Zeilen/Spaltenweise scrollen
(wie Scrollpfeile am Fenster)
ú Shift+Cursortasten - Seitenweise scrollen
(wie Klicks <20>ber/unter/neben die Slider)
ú Ziffernblock -
Ctrl-Cursor hoch/links - zur vorigen Seite bl„ttern
ú Ziffernblock +
Ctrl-Cursor runter/rechts - zur n„chsten Seite bl„ttern
(wie Icon [->])
ú Escape, Undo - zur <20>bergeordneten Seite
(wie Zur<75>ck-Icon)
ú Home - zum Anfang der aktuellen Seite
(wie Slider ganz nach oben schieben)
ú Shift-Home - zum Ende der aktuellen Seite
(wie Slider ganz nach unten schieben)
ú Tab - Markierung auf n„chste Referenz setzen
(zyklisch)
ú Shift-Tab - Markierung auf vorige Referenz setzen
(zyklisch)
ú Return, Enter - markierte Referenz anzeigen
ú ALT-T - Inhalts-Seite zeigen (wie Inhalt-Icon)
ú ALT-X - Indexseite zeigen (wie Index-Icon)
ú Ctrl-I - Programm Information (wie Info-Icon)
ú Help - zeigt Hilfe-Seite des aktuellen Textes
(wie Hilfe-Icon)
ú ALT-K - Katalog laden
##CHANGED
ú ALT-D - DEFHYP laden
ú ALT-R - Remarker ”ffnen, falls dieser l„uft oder
die Variable REMARKER definiert ist
ú Ctrl-O - Datei laden (wie Laden-Icon)
ú SHIFT-CTRL-O - wie CTRL-O, nur mit *.* als Pattern im
erscheinenden Fileselektor
ú Ctrl-F - Pattern suchen (wie Extra -> Suchen)
ú Ctrl-G - Pattern erneut suchen
(wie Extra -> Weitersuchen)
ú ALT-E - Stack l”schen (wie Extra -> Stack l”schen)
ú Ctrl-C - aktuelle Seite ins Clipboard kopieren
(wie Extra -> Kopieren)
ú Ctrl-V - Inhalt des Clipboard ins Fenster laden
(wie Extra -> Einf<6E>gen)
ú Ctrl-P - aktuelle Seite drucken
(wie Extra -> Seite drucken)
ú Ctrl-Q, CTR-U - ST-Guide schliežen
(wie Closer am Fenster anklicken)
##CHANGED
ú F1...F10 - eine von 10 Marken abrufen
ú Shift-F1...Shift-F10 - eine von 10 Marken definieren
@endnode
@node "Auto-Locator"
@toc Main
@xref "Symbolleiste" "Icon-Leiste"
@xref "Tastatur-Funktionen"
@xref "Maus-Funktionen"
Auto-Locator ST-Guide
@line 1 75 0 0 7
Werden Zeichen aller Art ohne irgendwelche Steuertasten eingegeben, so
interpretiert der ST-Guide die Eingabe als zu suchende Zeichenkette. Die
Icons verschwinden in diesem Fall vor<6F>bergehend, und es erscheint ein
Textbereich, in dem die eingegebene Zeichenkette angezeigt wird und
editiert werden kann.
Bei jedem eingegebenen Zeichen wird sofort versucht, die komplette
Zeichenkette case-insensitive in der aktuellen Seite zu finden; die Anzeige
scrollt dann automatisch zur entsprechenden Zeile. Diese Suche ist eine
reine Textsuche und macht daher keinen Unterschied zwischen Verweisen und
"nacktem" Text. Ist die gefundene Stelle ein Verweis, so gen<65>gt ein Druck
@box 9 5 1
@box 34 8 1
auf die Tab -Taste (gefolgt von Return ) oder ein Mausklick, um diesen
aufzurufen.
@box 9 8 1
Mit der Insert -Taste kann im verbleibenden Seitenrest erneut nach dem
@box 45 11 1
eingegebenen Suchmuster gesucht werden. Die Backspace -Taste l”scht
zeichenweise von hinten den eingegebenen Suchstring, bei gleichzeitigem
@box 13 7 1
Dr<EFBFBD>cken von Shift l”scht sie sofort die ganze Zeile.
Sobald per Cursortasten oder Maus irgendeine Fenster-Scroll-Aktion
ausgel”st wird, erscheint sofort wieder die Icon-Leiste, folglich wird der
Autolocator-Textbereich <20>berdeckt, bis er erneut aktiviert wird. Die
eingegebene Zeichenkette bleibt aber erhalten und wird bei erneuter
Autolocator-Aktion fortgesetzt. Beim Wechsel zu einer anderen Hypertext-
Seite wird sie jedoch gel”scht.
@endnode
@node "Hypertexte anderer Formate"
@toc Main
Hypertexte anderer Formate ST-Guide
@line 1 75 0 0 7
@{B}1stGuide@{b}
Ein alternatives, schon l„nger auf dem Markt befindliches Hypertext-
System ist der 1stGuide von Guido Vollbeding.
Um den Umstieg von diesem auf unser System zu erleichtern (z.B. um
Speicherplatz auf Diskette/Festplatte zu sparen), wurde ein
Konvertierungsprogramm Namens 1stConv geschrieben, welches die f<>r den
1stGuide verwendbaren Texte in das ST-Guide Format umwandeln kann.
Da der 1stGuide ebenfalls das AV- und das PureC-Help Protokoll beherrscht,
kann dieser einfach gegen den ST-Guide ausgetauscht werden.
@line 20 35 0 0 7
@{B}PureC-Help@{b}
Damit der Umstieg auf den ST-Guide leichter f„llt, wurde er voll
kompatibel zum PureC-HelpACC gemacht, zumindest was die Meldungen angeht,
d.h. der ST-Guide versteht alle Meldungen, die auch das PureC-ACC
auswerten kann und beantwortet sie entsprechend.
Das bedeutet insbesondere, daž Programme, welche das PureC-ACC
unterst<EFBFBD>tzen, automatisch auch mit dem ST-Guide arbeiten, hierzu ist der
ST-Guide lediglich in "PC_HELP.ACC" umzubenennen, damit die Programme ihn
auch als solchen erkennen und ansprechen.
F<EFBFBD>r Programmierer interessant ist hierzu die @{"Liste der Meldungen" link "PureC-Protokoll"}.
Ein Konvertierungsprogramm, mit dem PureC-Helptexte in das ST-Guide-Format
gewandelt werden k”nnen, ist Teil dieses Systems und tr„gt den Namen
PC-Conv.
@endnode
@node "AV-Protokoll" "Der ST-Guide und das AV-Protokoll"
@toc Main
Das AV-Protokoll ST-Guide
@line 1 75 0 0 7
@autorefoff
Das AV-Protokoll stammt urspr<70>nglich vom alternativen Desktop GEMINI, hat
jedoch mittlerweile eine sehr weite Verbreitung gefunden, so daž es mir
sinnvoll erschien, dieses zu unterst<73>tzen.
@line 20 35 0 0 7
F<EFBFBD>r Programmierer interessant ist hierzu die Liste der Meldungen,
folgende Nacrichten werden erkannt/verwendet:
@symbol ai VA_START
* @{B}VA_START@{0}: (0x4711)
@{U}APP -> ACC@{0}: "erwache aus deinem Schlaf und beginne mit der Arbeit";
@{U}ACC -> APP@{0}: evtl. AV_ACCWINDOPEN, nachdem das Fenster ge”ff-
net und die evtl. angegebene Datei geladen wurde. Falls eine
Kommandozeile angegeben wurde und sich mehr als ein Argument darin
befindet, so wird alles ab dem ersten Leerzeichen als Name der
anzuzeigenden Seite interpretiert.
Laut AV-Doku m<>ssen alle Dateinamen in Grožbuchstaben und mit
vollst„ndigem Pfad angegeben werden. Um diesem Umstand Rechnung zu
tragen und trotzdem zuzulassen, daž die aufrufende Applikation nicht
weiž, wo sich der Hypertext befindet, wurde als Spezialfall das
'Laufwerk' "*" implementiert: Angabe von "*:\AES.HYP" veranlažt den
ST-Guide, die Datei AES.HYP auf allen angegebenen Pfaden zu suchen.
Aufruf mit 'C:\AES.HYP appl_init' w<>rde also AES.HYP laden und daraus
die Seite <appl_init> anzeigen.
Aufruf mit 'C:\AES.REF appl_init' w<>rde den Begriff <appl_init> in der
Datei AES.REF suchen und im Erfolgsfall die Datei AES.HYP laden und daraus
die Seite anzeigen, in der das gesuchte Symbol definiert wurde.
Aufruf mit 'C:\AES.HYP' w<>rde die angegebene Datei laden und die erste
Seite aus ihr darstellen.
Aufruf mit 'appl_init' w<>rde diesen Begriff in der durch 'REF'
angegebenen Datei suchen und die passende Seite aus der betreffenden
Datei darstellen
@symbol ai VA_DRAGACCWIND
* @{B}VA_DRAGACCWIND@{0}: (0x4725)
APP -> ACC: "es wurde eine Datei auf eines deiner Fenster gezogen,
hier hast du den Pfad"; der Guide l„dt daraufhin die so angegebene
Datei und zeigt sie im Fenster an. Auch hier muž der vollst„ndige
Zugriffspfad angegeben werden.
@symbol ai AV_SENDKEY
* @{B}AV_SENDKEY@{0}: (0x4710)
ACC -> APP: "es wurde eine Taste gedr<64>ckt, mit der ich nichts anfangen
kann, hier hast du sie"; hierdurch wird die Benutzung aller
Shortcuts der Applikation erm”glicht, auch wenn das ACC Besitzer des
obersten Fensters ist.
@symbol ai AV_STARTPROG
* @{B}AV_STARTPROG@{0}: (0x4723)
ACC -> APP: "starte mal das in dieser Meldung angegebene Programm mit
der evtl. ebenfalls angegebenen Kommandozeile"; Der Guide benutzt
diese Meldung f<>r die Ausf<73>hrung von SYSTEM Anweisungen. Thing und
GEMINI unterst<73>tzen hier auch die Angabe von nicht ausf<73>hrbaren
Dateien, f<>r deren Endung dann ein Programm gesucht und gestartet
wird.
APP -> ACC: VA_PROGSTART, wird vom Guide jedoch ignoriert.
@symbol ai AV_ACCWINDOPEN
* @{B}AV_ACCWINDOPEN@{0}: (0x4724)
ACC -> APP: "ich habe gerade ein Fenster ge”ffnet"; da das Handle
dieses Fensters mitgeliefert wird, dient es u.a. dem Zweck, das
Window-Cycling der Hauptapplikation auf die Fenster der ACC's
auszuweiten oder dem ACC zu melden, wenn Objekte auf eines seiner
Fenster gezogen wurden (siehe VA_DRAGACCWIND);
@symbol ai AV_ACCWINDCLOSED
* @{B}AV_ACCWINDCLOSED@{0}: (0x4726)
ACC -> APP: "ich habe gerade eines meiner Fenster geschlossen";
Gegenst<73>ck zu ACCWINDOPEN.
@symbol ai AV_EXIT
* @{B}AV_EXIT@{0}:
ACC -> APP: "ich melde mich ab - und Tsch<63>ž"
@symbol ai AV_PROTOKOLL
*@{B}AV_PROTOKOLL@{0}:
ACC -> APP: "hier bin ich"
@autorefon
@endnode
@node Rechtliches
@toc Main
@symbol ai Fairware
Rechtliches ST-Guide
@line 1 75 0 0 7
Dieses Hypertext-System ist Fairware, d.h. jedermann kann es unbegrenzt
lange kostenlos benutzen und an jede Person weitergeben, vorausgesetzt,
daž die Weitergabe kostenlos ist. @{B}Bei regelm„žiger Benutzung sollte
der Autor jedoch mit einer Spende bedacht werden, da nur so die
Weiterentwicklung dieses Systems gew„hrleistet ist.@{0}
Der ST-Guide darf als Zusatz zu eigenen Programmpaketen weitergegeben
werden, egal welcher Art diese sind, d.h. auch innerhalb von Shareware und
kommerziellen Progammen, ohne daž hierf<72>r Lizenzgeb<65>hren f„llig werden
(obwohl ein kleine Anerkennung in diesem Fall wohl mehr als fair w„re). Es
muž aber ein Hinweis vorhanden sein, daž der ST-Guide Fairware und von mir
ist, so daž beim Endanwender nicht der Eindruck entsteht, daž seine Spende
f<EFBFBD>r den ST-Guide im Kaufpreis des Paketes enthalten ist.
Nett w„re es in diesem Fall, wenn mir eine Disk mit dem betreffenden
Programm und dem zugeh”rigen Hypertext zugesand w<>rde, quasi als
Belegexemplar.
Da es der Hauptverwendungszweck des ST-Guide ist, Dokumentationen zu
anderen Programmen zu schreiben, darf er in zwei Formen weitergegeben
werden:
a) Vollst„ndig, als komplettes Programmpaket mit allen zugeh”rigen
Dateien. Diese Form ist auf jeden Fall vorzuziehen, auch wenn die
Weitergabe innerhalb eines anderen Programmpaketes erfolgt.
b) Nur der Viewer und die Dokumentation, falls die Weitergabe
innerhalb eines anderen Programmpaketes erfolgt @{B}und@{b} eine
Dokumentation zu diesem Programm im Format des ST-Guide dabei
ebenfalls mitgeliefert wird.
Soweit die Weitergabe als Zugabe zu irgendwelchen Programmen oder durch
PD-H„ndler erfolgt, erbitte ich eine kurze Mitteilung dar<61>ber, damit ich
a) absch„tzen k”nnen, wie weit das Paket sich verbreitet, und
b) evtl. Auskunft <20>ber Updates geben k”nnen.
Nat<EFBFBD>rlich bin ich auch sehr daran interessiert zu sehen, in welchen
Programmen der ST-Guide verwendet wird. Wem es also m”glich ist, kann mir
gerne auch eine Kopie seines Programmes zukommen lassen.
@index Spenden
Spenden: In diesem Programmpaket steckt inzwischen sehr viel Arbeit.
Trotzdem habe ich mich entschieden es als Fairware zu
ver”ffentlichen, um jedem zu erm”glichen, damit Dokumentationen
zu seinen Programmen zu schreiben. Es w„re aber nur fair, mir
eine kleine Anerkennung f<>r meine Arbeit zukommen zu lassen.
Auch kleine Spenden motivieren mich, auch in Zukunft noch an
diesem Projekt zu arbeiten, es zu erweitern und zu verbessern.
Kein Programm ist wirklich fehlerfrei, deshalb kann und will ich
keinerlei Garantien f<>r die Lauff„higkeit oder Tauglichkeit dieses Paketes
f<EFBFBD>r irgendeinen Zweck <20>bernehmen und k”nnen insbesondere nicht haftbar
gemacht werden f<>r irgendwelche Sch„den, die durch die Benutzung dieses
Paketes theoretisch entstehen k”nnten.
@Index "Holgers Adresse"
@ALabel "Adresse"
F<EFBFBD>r Lob, Kritik, Vorschl„ge und Spenden bin ich folgendermažen
erreichbar:
Holger Weets
Tangastrasse 45
D-26121 Oldenburg
E-Mail: Holger Weets @ OL (Mausnet)
holger_weets@ol.maus.de (Internet)
Bankverbindung:
KTO: 023-182 041
BLZ: 280 501 00
Landessparkasse zu Oldenburg
Wer eine neue Version direkt von mir haben m”chte, schicke bitte einen
frankierten R<>ckumschlag, eine DD/HD-Disk und 10 Mark an diese Adresse.
Dieser Betrag dient mir als Aufwandsentsch„digung, denn ich m”chte bei
diesem Projekt wenigstens nicht auch noch draufzahlen.
@endnode
@node "Verwendete Software"
@toc Main
Verwendete Software ST-Guide
@line 1 75 0 0 7
Folgende Programme wurden zur Implementierung dieses Systemes verwendet:
* @{U}SOZOBON V2.00x10@{u}
als C-Compiler System
Autoren: die SOZOBON-Leute, Christian Wempe und Holger Weets
* @{U}ACE@{u}
als Editor und Programmierumgebung
Autor: Holger Weets
* @{U}RED@{u}
als Resource-Editor
Autor: Holger Weets
* @{U}C-RSC@{u}
als Umwandler der Resourcen in C-Quelltext
Autor: Holger Weets
* @{U}LHarc bzw. dessen Sourcecodes@{u}
als Basis f<>r die Implementierung des Ein- und Auspackens der
Hypertext-Seiten
Autor: Yoshi, Christian Grunenberg
@endnode
@node Danksagung
@toc Main
Danksagung ST-Guide
@line 1 75 0 0 7
An dieser Stelle m”chte ich mich bei ein paar Leuten bedanken:
- @{B}Volker Burggr„f@{0}
f<>r die Arbeit, die er durch den Support des Paketes in der Maus OL
hatte, und f<>r seine kreativen und benutzernahen Anregungen. Aužerdem
ist ihm die Neuauflage dieser Dokumentation zu verdanken.
- @{B}Christoph Zwerschke@{0}
f<>r seine besonders ausgiebigen Tests aller Komponenten und seine
n<>tzlichen Tips
- @{B}Peter Nagel@{0},
@{B}Dirk Theisen@{0},
@{B}J”rg Westheide@{0},
@{B}Frank R<>ger@{0},
@{B}Ralf Zimmermann@{0},
@{B}Gregor Duchalski@{0}
und @{B}Christian Grunenberg@{0}
f<>r ihre Bugreports und ihre Werbung sowie die Verbreitung des Systems
- @{B}Peter West@{0}
f<>r die šbersetzung der Dokumentation ins englische
- @{B}Joe Connor@{0}
f<>r die šberarbeitung/Korrektur der englischen Dokumentation sowie den
Support in England
- @{B}Christoph Spengler, Frank R<>ger, Dirk Hagedorn@{0}
f<>r ihre Zusatz-Tools, die das Paket noch Leistungsf„higer machen
- und nat<61>rlich allen Leuten, die mich sonst noch durch nette Post
motiviert haben
@endnode
@node "Hypertext?"
@next "Hypertext?"
@xref "hyp.hyp/Schreiben eines Hypertextes" "Schreiben eines Hypertextes"
@symbol a "Hypertext?"
Wie schreibe ich einen Hypertext? ST-Guide
@line 1 75 0 0 7
Hier<EFBFBD>ber gibt eine entsprechende Seite in der @{"HCP-Dokumentation" link "hcp.hyp/Schreiben eines Hypertextes"}
einige Ausk<73>nfte.
Ansonsten kann diese gleichermažen berechtigte wie oft gestellte Frage hier
nicht ersch”pfend beantwortet werden. Wer weitere z<>ndende Anregungen
braucht, dem seien die STG-FAQ empfohlen, eine Ansammlung oft gestellter
Fragen, die ebenfalls als Hypertext vorliegt. Und eine Lekt<6B>re der
Befehlserl„uterungen in der HCP-Dokumentation darf wohl vorausgesetzt
werden.
@box 5 64 5
@{B}Im <20>brigen sollte der mitgelieferte Quelltext zum ST-GUIDE-
Hypertext gen<65>gend Beispiele liefern, wie die Kommandos des
HCP einzusetzen sind!@{0}
@{B}Gestaltung:@{0}
- Es gibt derzeit keine bindenden Regeln f<>r die Gestaltung von
Hypertexten, aber mit Sicherheit wird die Praxistauglichkeit sehr zur
Einstufung zwischen 'gut' und 'schlecht' beitragen.
Wer Anregungen sucht, sei auf die vielen schon vorhandenen Hypertexte
verwiesen, unter denen sich sehr gute - aber leider auch einige
schlecht gemachte finden lassen.
- Als vorteilhaft hat es sich erwiesen, den Seiten-Namen auch im Fenster
als Titelzeile nochmals zu erw„hnen (wie es ja auch hier praktiziert
wird). Somit geht er n„mlich nicht verloren, wenn Sie eine komplette
Seite drucken oder Kopieren wollen.
@endnode
@node "Update-History"
@prev "Update-History"
@next "Update-History"
Žnderungen in diesem Update ST-Guide
@line 1 75 0 0 7
@autorefoff
27.11.96:
---------
ST-Guide : Iconify noch mal umgestrickt, sollte jetzt unter MagiC und
MTOS optimale Ergebnisse liefern
ST-Guide : Probleme mit mehreren Bildern in einer Zeile i.Z. mit Fonts
kleiner 12 Pixel H”he behoben
ST-Guide : neue Variable NOREFBOX schaltet die bei der REF-Suche er-
scheinende Suchbox ab
ST-Guide : Probleme mit dem Slider auf sehr langen Seiten behoben
ST-Guide : Katalog-Icon erg„nzt
ST-Guide : wenn Remarker nicht in der INF-Datei angemeldet ist und von
Hand nachgestartet wird, verschwand dessen Icon bei einem
Fontwechsel im ST-Guide
ST-Guide : TOS-Programme werden jetzt unter MagiC ohne AV Server im
Fenster (VT 52) gestartet
ST-Guide : "Stack l”schen" ist wieder disabled, wenn der Stack leer ist
ST-Guide : nach 'copy' bekommen alle laufenden Programme eine SC_CHANGED
Nachricht (im Mtasking)
ST-Guide : bei externen Referenzen wird jetzt alles ab dem ersten '/' oder
'\\' als Titel angesehen, die Angabe von Pfaden zu den Dateien
ist also nicht mehr m”glich (macht ohnehin nur Probleme), daf<61>r
aber die Verwendung der Pfadtrenner in Nodenamen
(siehe auch Option -k des hcp)
ST-Guide : 'Marke setzen' und 'gehe zu Marke' sind zugunsten von 10 frei
definierbaren Marken per Funktionstaste entfernt worden; Setzen
erfolgt per Shift-Fx, Abrufen per Fx
ST-Guide : neue Variable MARKFILE enth„lt Zugriffspfad zu der Datei, in der
die gesetzten Marken beim Schliežen des ST-Guide automatisch
gespeichert und aus der sie beim ™ffnen des ST-Guide automatisch
wieder geladen werden; hiermit ist insbesondere das Anlegen
einer Liste der "wichtigsten" Hypertextseiten m”glich
ST-Guide : neues Icon neben dem History-Icon ”ffnet ein Popup mit allen
gesetzten Marken, Klick ruft sie ab, Shift-Klick setzt sie
ST-Guide : Sicherheitsabfragen f<>r den Fall eingebaut, daž der Hypertext
defekt ist oder z.B. gel”scht wurde, w„hrend ST-Guide ihn
anzeigt
ST-Guide : kleinen Bug behoben, der bei Speicherknappheit auftrat
ST-Guide : kann Bilder jetzt zentriert darstellen
ST-Guide : Fenster kann nicht mehr kleiner als Iconleiste plus drei
Textzeilen gemacht werden, um Darstellungsfehler zu vermeiden
ST-Guide : Positionierungsfehler bei Grafik-Objekten im Zusammenhang mit
Fonts, die schmaler oder breiter als der Systemfont sind,
behoben
ST-Guide : Probleme mit Case sensitiven Filesystemen im Zusammenhang mit
anzuzeigenden Nicht-Hypertexten behoben
ST-Guide : in den Dialogen sind jetzt die 3D-Flags gesetzt und ab 16 Farben
werden die Dialoge hellgrau unterlegt
ST-Guide : Die Tasten PageUp und PageDown werden ausgewertet
ST-Guide : neue Variable BACKWIND macht das Fenster im Hintergrund
bedienbar, getopped wird es dann mit Rechtsklick
ST-Guide : Die Alertboxen 'XY konnte nicht ge”ffnet werden' haben jetzt
eine kontextsensitive Hilfe
ST-Guide : Bug im Zusammenang mit @@tree und Seiten die direkt mit einem
Attribut beginnen behoben
ST-Guide : Scrolling ist jetzt auch im hintenliegenden Fenster flimmerfrei,
wenn der Arbeitsbereich ganz sichtbar ist, das Fenster also nicht
verdeckt wird
ST-Guide : hoffentlich Workaround f<>r Probleme beim Dauerscrollen
(pl”tzliche Blockmarkierung) gefunden
ST-Guide : Probleme des FileFinders mit langen Dateinamen behoben
ST-Guide : neue Variable FORMFEED sorgt beim Ausdrucken daf<61>r, daž am Ende
ein FormFeed ausgegeben wird
ST-Guide : zeigt jetzt Bilder mit bis zu 16 Farben an, ich denke das ist
ein guter Kompromiss, denn f<>r einen Hypertext sinnvolle
Grafiken lassen sich damit erstellen und solche Bilder halten
sich von der Gr”že her in Grenzen, so das die Hypertexte da-
durch nicht allzusehr aufgebl„ht werden
ST-Guide : in Farbtiefen mit weniger als 16 oder mehr als 256 Farben
werden bunte Bilder in S/W angezeigt; ST-Guide dithert die
Bilder dazu mit einem speziell f<>r Snapshots von Dialogen o.„.
optimierten Verfahren (Defaultmaske) oder der im .stg zum be-
treffenden Bild vorgegebenen Maske
ST-Guide : neue Variable XFONT, mit der ein 2. Font f<>r die Fenster-
darstellung angegeben werden kann; umgeschaltet wird per CTRL-Z
ST-Guide : Fehler beim Scrollen w„hrend des Blockmarkierens in Farbe
behoben
HCP : Zeilen l„nger als 127 Zeichen (netto) werden jetzt immer um-
brochen
HCP : Fehler beim Recompilieren von XREF behoben
HCP : Warnung bei Benutzung undefinierter Variablen eingebaut
HCP : um die Zeichenfolge '@@:' in den Text zu bekommen, ist '@@@@:'
zu schreiben
HCP : heftigen internen Fehler behoben, der beim šbersetzen von
Hypertexten zuweilen zu Abst<73>rzen oder defekten xref's f<>hrte
HCP : Probleme mit SEHR langen Zeilen (>256 Zeichen) jetzt
hoffentlich behoben
HCP : "verz„hlt" sich nicht mehr beim Laden der Bilder, zum Schluž
sollte in der Ausgabe jetzt immer 'none' stehen
HCP : Probleme mit unpaarigen indexon/indexoff behoben
HCP : '-j' funktionierte offenbar nicht als Parameter f<>r @@options,
behoben
HCP : neue Option -k<value> zum Setzen von Flags
HCP : Erweiterung f<>r Bilder: zentrierte Darstellung durch Angabe
von 0 als X-Koordinate
HCP : beide 'ž' werden vom Autoreferenzer nicht als Worttrenner
benutzt, vorher funktionierte es mit dem einen 'ž' und mit dem
anderen nicht
HCP : einige Newlines entfernt, damit mehr auf den Bildschirm pažt
(f<>r Consolefenster, die nicht zur<75>ckscrollen k”nnen)
HCP : Fehler bei @@if im Zusammenhang mit Zahl-Konstanten behoben
HCP : '+q' hebt '-q' jetzt auf, damit z.B. Voreinstellungen in
HCP_OPT lokal r<>ckg„ngig gemacht werden k”nnen
HCP : per +i1 kann jetzt ein "verteilter" Index erstellt werden, d.h.
eine eigene Seite f<>r jeden Buchstaben
HCP : Probleme mit @@uses auf REF-Files und Benutzung dortiger @@symbols
behoben
HCP : keine <20>berfl<66>ssigen Blanks mehr auf den Indexseiten
HCP : bei @@image & @@limage kann jetzt optional eine Dithermaske
angegeben werden, die der ST-Guide dann statt der Defaultmaske
zum Konvertieren bunter Bilder in S/W verwendet.
HCP : kleinen Bug im Zusammenhang mit @@uses und pnodes behoben
HCP : Probleme bei @@uses mit langen Dateinamen entfernt
HCP : Headerkennung f<>r Mac definiert (3), f<>r Hyperion
HCP : schreibt neuen OS-Header in REF-Files f<>r Hyperion
HCP : l„žt jetzt ein Leerzeichen am Zeilenende drin, f<>r Hyperion
HCP : neue Kommandos @@x, @@{... x} und @@os f<>r Hyperion
@autorefon
@endnode
@node "Zur<75>ck-Icon"
@prev "Symbolleiste"
@toc "Symbolleiste"
@alias "zur<75>ck"
Das Zur<75>ck-Icon ST-Guide
@line 1 75 0 0 7
@image "back3.icn" 1
Der ST-Guide merkt sich, in welcher Reihenfolge man welche Seiten
aufgerufen hat, indem er sie auf einem Stack (Stapel) ablegt, der
bis zu sechzehn Seiten fažt.
Mit dem Zur<75>ck-Icon kann man nun in umgekehrter Reihenfolge wieder
zur<75>ckbl„ttern, also quasi den gleichen Weg wieder zur<75>ckgehen, auf
dem man bis zur aktuellen Seite gekommen ist. Dies funktioniert
freilich nur dann, wenn auch Seiten auf dem Stapel liegen, was z.B.
beim ersten ™ffnen des ST-Guide noch nicht der Fall ist. Wenn Bedarf
besteht, l„žt sich auch per Knopfdruck sofort der Stack l”schen.
@box 53 5 1
@box 64 6 1
Diese Funktion l„žt sich auch mit den Tasten Esc oder Undo sowie
mit der rechten Maustaste (falls RIGHTBACK gesetzt ist) ausf<73>hren.
Will man mit einem Satz um @{B}mehrere@{0} Seiten zur<75>ckspringen, dann kann
man mit dem nebenliegenden Icon das History-Popup aufrufen.
@endnode
@node "History-Popup"
@toc "Symbolleiste"
History-Popup ST-Guide
@line 1 75 0 0 7
@image "stk3.icn" 1
Durch Klick auf dieses Icon kann man gleich um mehrere Seiten
zur<75>ckspringen. Es werden die letzten zw”lf Eintr„ge des Stacks
(Seiten-Stapel) in Form eines History-Popups angezeigt. Nun kann per
Mausklick direkt zu einem von ihnen zur<75>ckgesprungen werden.
Dabei erscheint die zuletzt gelesene Seite ganz oben, die erste
ganz unten.
Die Darstellung im Popup betr„gt aber nicht mehr als vierzig
Zeichen! Alles, was dar<61>ber hinausgeht, wird abgeschnitten.
Das Icon ist nicht anw„hlbar, wenn sich keine Hypertextseiten auf
dem Stapel befinden. Dies ist beim ersten ™ffnen des ST-Guide der
Fall und nach Ausf<73>hren der Funktion "Stack l”schen".
Die Vermutung, daž man mit diesem Popup durch Auswahl des ersten
Eintrags das gleiche erreicht wie mit dem Zur<75>ck-Icon, ist
zutreffend! (Der inhaltliche Zusammenhang dieser beiden Icons ist
deshalb auch durch die schmalere Trennlinie zwischen ihnen
verdeutlicht.)
Das Zur<75>ck-Icon stellt lediglich einen schnelleren Zugang
zur @{B}zuletzt@{0} gelesenen Seite dar.
@endnode
@node "Marken"
@toc "Symbolleiste"
Marken-Popup ST-Guide
@line 1 75 0 0 7
@image "mark.icn" 1
Durch Klick auf dieses Icon ”ffnet sich ein Popup mit maximal 10
definierten Marken, aus denen dann eine per Mausklick ausgew„hlt
werden kann.
Sie erscheinen in der Reihenfolge, in der sie den Funktionstasten
zugeordnet sind, <20>ber die sie definiert (Shift-Fx) und abgerufen
(Fx) werden k”nnen.
Die so definierten Marken bleiben auch nach dem Ausschalten des
Rechners erhalten, sofern die Variable MARKFILE entsprechend
gesetzt wurde, denn in diesem Fall speichert und l„dt ST-Guide
die Marken vollautomatisch.
@endnode
@node "Inhalt-Icon"
@toc "Symbolleiste"
@alias "Inhalt"
Das Inhalt-Icon ST-Guide
@line 1 75 0 0 7
@image "up.icn" 1
@box 43 11 1
@box 55 3 1
Nach Bet„tigung dieses Icons (oder Alternate - T ) zeigt der
ST-Guide die hierarchisch <20>ber der gerade angezeigten Seite liegende
Hypertextseite an. Dies kann die Hauptseite des Hypertextes sein
(Haupt-Inhaltsverzeichnis), oder aber ein Unterverzeichnis, das zwar
der aktuellen Seite <20>bergeordnet ist, sich seinerseits aber
unterhalb einer noch "h”her" gelegenen Seite befindet. Wiederholtes
Klicken muž demnach binnen kurzem zur Hauptseite des Hypertextes
f<>hren - je nachdem, wie tief drin man sich vorher befunden hat.
@box 15 18 1
Hauptverzeichnis Ein Klick auf das Inhalt-Icon
@line 24 -10 2
@line 24 0 2
@line 24 10 2
bewirkt also immer einen Sprung um
eine "Etage" nach oben. Wie viele
@box 10 8 1
@box 20 8 1
@box 30 8 1
Seite1 Verz.1 Seite2 Etagen es gibt, h„ngt allein vom
@line 24 -5 2
@line 24 5 2
Autor des jeweiligen Hypertextes
ab. Ist man ganz oben gelandet,
@box 15 8 1
@box 25 8 1
Seite3 Seite4 wird das Icon inaktiv (hell).
Um bei Bet„tigung des Inhalt-Icons eine andere Seite als die
physikalisch erste angezeigt zu bekommen, muž sie vom Autor des
Hypertextes per '@{"@toc" link "hcp.hyp/Kommando @toc"}'-Kommando als
Inhalt-Seite definiert worden sein.
Zur vorher betrachteten Seite kann wie immer per Zur<75>ck-Icon
zur<75>ckgekehrt werden.
@endnode
@node "Index-Icon"
@toc "Symbolleiste"
Das Index-Icon ST-Guide
@line 1 75 0 0 7
@image "end.icn" 1
Mit diesem Knopf springt man zum Ende des "Buches", n„mlich in den
@{Index link Index}, um nach einem bestimmten Stichwort zu suchen.
Der ST-Guide zeigt dabei diejenige Seite des aktuellen Hypertextes
an, welche den Namen 'Index' tr„gt. Diese wird automatisch vom HCP
erzeugt, falls der Autor des Textes dies nicht manuell getan hat.
@box 53 11 1
@box 65 3 1
Der Index l„žt sich auch mit der Kombination Alternate - X ”ffnen.
Auf dieser Seite befinden sich stichwortartig und in alphabetischer
Reihenfolge alle wichtigen Begriffe des Hypertextes, zu denen
nat<61>rlich per Mausklick gesprungen werden kann.
@endnode
@node "vorige Seite"
@toc "Symbolleiste"
@alias "<"
@alias "<-"
Vorige Seite ST-Guide
@line 1 75 0 0 7
@image "prev.icn" 1
Nach Bet„tigung dieses Icons zeigt der ST-Guide die physikalisch
vorhergehende Seite im Hypertext oder die Seite, welche durch die
'@{"@prev" link "hcp.hyp/Kommando @prev"}'-Direktive im Quelltext als Vorg„ngerseite definiert wurde.
@box 43 9 1
@box 53 3 1
Per Tastatur geht das entweder mit Control -  oder mit
@box 12 3 1
der - -Taste auf dem Ziffernblock.
@endnode
@node "n„chste Seite"
@toc "Symbolleiste"
@alias ">"
@alias "->"
N„chste Seite ST-Guide
@line 1 75 0 0 7
@image "next.icn" 1
Nach Bet„tigung dieses Icons zeigt der ST-Guide die physikalisch
n„chste Seite im Hypertext oder die Seite, welche durch die
'@{"@next" link "hcp.hyp/Kommando @next"}'-Direktive im Quelltext als Folgeseite definiert wurde.
@box 43 9 1
@box 53 3 1
Per Tastatur geht das entweder mit Control -  oder mit
@box 12 3 1
der + -Taste auf dem Ziffernblock.
@endnode
@node "Siehe auch"
@toc "Symbolleiste"
@xref "hcp.hyp/Kommando @xref" "Das @xref-Kommando"
@alias "siehe auch"
Siehe auch ST-Guide
@line 1 75 0 0 7
@image "see.icn" 1
Wenn das Icon anw„hlbar ist, dann bedeutet dies, daž der Autor des
Hypertextes f<>r die aktuelle Seite einen oder mehrere Querverweise
zu anderen Seiten (auch Seiten in anderen Hypertexten) eingebaut
hat (hierf<72>r dient das '@{"@xref" link "hcp.hyp/Kommando @xref"}'-Kommando).
Ein Klick auf das Icon ”ffnet ein Popup, in der alle Querverweise
untereinander aufgef<65>hrt sind. Das gew<65>nschte braucht nun nur noch
ausgew„hlt zu werden. Nat<61>rlich kann das Popup auch ohne Auswahl
wieder verlassen werden.
Der Vorteil dieses Vorgehens ist es, daž Verweise dieser Art immer
sofort im Zugriff sind und keinen Platz im Textbereich verbrauchen.
@endnode
@node "Hilfe-Seite"
@toc "Symbolleiste"
@symbol Hilfe
@symbol a "Hilfe-Icon"
Hilfe-Seite ST-Guide
@line 1 75 0 0 7
@image "help.icn" 1
Falls per '@{"@help" link "hcp.hyp/Kommando @help"}' eine Hilfe-Seite angegeben wurde, so wird diese,
ansonsten eine Seite Namens 'Help' im aktuell geladenen Text
gesucht und bei erfolgreicher Suche angezeigt. Der Sinn der Sache
ist das schnelle Auffinden einer kurzen Zusammenfassung des
Inhaltes eines Hypertextes, weshalb jeder Text eine solche Seite
@box 60 6 1
enthalten sollte. Alternativ zum Icon kann auch die Help -Taste
gedr<64>ckt werden.
Existiert eine solche Seite nicht, ist das Hilfe-Icon nicht
ausw„hlbar.
@endnode
@node "Info-Dialog"
@toc "Symbolleiste"
@alias Info
@symbol a "Info-Icon"
@index Info
Info-Dialog ST-Guide
@line 1 75 0 0 7
@image "info.icn" 1
Diese Funktion zeigt einen Dialog, aus dem der Name des Programms,
die Versionsnummer sowie der Autor und dessen Adresse zu entnehmen
@box 36 9 1
@box 46 3 1
sind. Die Tastenkombination Control - I tut dasselbe.
@autorefoff
Aužerdem findet sich hier ein Knopf mit der Aufschrift 'Hilfe', bei
dessen Bet„tigung diese Onlinehilfe zum ST-Guide nachgeladen und
gezeigt wird.
@autorefon
Angezeigt werden hier aber auch relevante Informationen zur aktuell
angezeigten Datei, dieses sind Autor, Thema, Dateiname und Version
des Textes. Alle Angaben werden nat<61>rlich nur gezeigt, sofern sie im
Hypertext angegeben wurden (@{"@author" link "hcp.hyp/Kommando @author"}, @{"@database" link "hcp.hyp/Kommando @database"}, @{"@$VER:" link "hcp.hyp/Kommando @$VER:"}).
@endnode
@node "Datei laden"
@toc "Symbolleiste"
@alias Laden
@symbol a "Laden-Icon"
@index Laden
Datei laden ST-Guide
@line 1 75 0 0 7
@image "open.icn" 1
Mit dieser Funktion kann ein Hypertext oder eine ASCII-Datei
geladen werden, die Erkennung erfolgt dabei automatisch. Es
erscheint hierzu ein Fileselektor, in dem die gew<65>nschte Datei
ausgew„hlt werden kann, wonach sie, falls ausreichend Speicher
vorhanden ist, geladen wird. Die Tastenkombination f<>r diese
@box 33 9 1
@box 43 3 1
Funktion lautet <20>brigens Control - O .
Der voreingestellte Pfad f<>r den Selektor wird folgendermažen
gew„hlt:
1. Variable HYPFOLD (in der Datei ST-GUIDE.INF), falls diese
existiert,
2. Pfad der zuletzt geladenen Datei, falls HYPFOLD nicht
existiert oder
3. aktueller Pfad, falls noch keine Datei geladen und HYPFOLD
nicht existiert.
@line 20 35 0 0 7
Falls es sich bei der gew„hlten Datei nicht um einen Hypertext
handelt, verf„hrt der ST-Guide folgendermažen:
1. in der INF-Datei wird die Endung dieser Datei als Variable
gesucht (also "IMG=" f<>r eine Datei Namens BILD.IMG)
2. falls 1. fehlschl„gt, wird die Variable EXTVIEW in der
INF-Datei gesucht
3. falls 1. und 2. erfolglos waren, zeigt ST-Guide die Datei
selber im ASCII Format an, ansonsten wird das zugewiesene
Programm zun„chst unter den bereits laufenden Applikationen
gesucht, und falls es dort nicht gefunden wird, so beauftragt
ST-Guide den Desktop mit dem Start des betreffenden
Programmes. Letzteres funktioniert allerdings nur, wenn der
verwendete Desktop <20>ber entsprechende Funktionen verf<72>gt,
d.h. wenn er das AV Protokoll implementiert hat.
Falls ein AV-f„higer Desktop verwendet wird, kann die anzuzeigende
Datei auch direkt auf das Fenster des ST-Guide gezogen werden.
@endnode
@node "Extra-Popup"
@toc "Symbolleiste"
@alias Extra
Das Extra-Popup ST-Guide
@line 1 75 0 0 7
@image "extra.icn" 1
Bei Klick auf dieses Symbol erscheint ein Popup-Men<65>
mit folgender Auswahl:
Tastaturbedienung:
@box 15 18 10
Suchen ^F Beschriftungen wie diese
@line 42 -9 1 2
Weitersuchen ^G hier bedeuten ein Dr<44>cken
Stack l”schen E des entsprechenden Buch-
@{G}------------------@{g} stabens bei gehaltener
@box 43 11 1
Kopieren ^C Alternate -Taste.
Einf<6E>gen ^V Solche Beschriftungen
@line 42 -9 0 2
Seite drucken ^P bedeuten ein Dr<44>cken des
@{G}------------------@{g} entsprechenden Buchstabens
@box 58 9 1
Font Z bei gehaltener Control -Taste.
@{Remarker link "Extra -> Remarker"} R
@endnode
@node "Katalog"
@toc "Symbolleiste"
@xref "katalog.hyp/Main" "Katalog anzeigen"
Katalog ST-Guide
@line 1 75 0 0 7
@image "kat.icn" 1
@box 50 11 1
@box 62 3 1
Mit dieser Funktion (auch aufrufbar durch Alternate - K ) kann die
von STool erzeugte Katalog-Datei nachgeladen werden. Genaugenommen
wird die Datei, die durch die Variable HYPTOP in der ST-GUIDE.INF
festgelegt wurde, nachgeladen.
Falls Sie noch keinen Katalog erzeugt haben, oder falls Ihr
vorhandener Katalog nicht mehr ganz aktuell ist, da neue Hypertexte
hinzugekommen sind, k”nnen Sie auch gleich hier einen aktuellen
erzeugen lassen. Ein Klick auf den unten sichtbaren "Knopf" startet
STool. Hoffenlich. Wenn nicht, dann ist wahrscheinlich die folgende
Zeile in Ihrer ST-GUIDE.INF falsch oder nicht vorhanden:
$@{STOOL ignore}=<pfad>stool.tos
@box 19 7 1
@{STool system $STOOL} starten!
Zum Kontrollieren k”nnen Sie den Katalog ja nun gleich mal @{aufrufen link "katalog.hyp/Main"}!
@endnode
@node "Extra -> Suchen"
@xref "Extra -> Weitersuchen"
@toc "Extra-Popup"
@symbol a "Suchen-Dialog"
@symbol ai Suchfunktionen
@symbol ai Suchen
Suchen ST-Guide
@line 1 75 0 0 7
@box 53 9 1
@box 63 3 1
Bei Auswahl dieser Funktion (auch aktivierbar durch Control - F )
erscheint ein Dialog, in dem ein Suchbegriff eingegeben werden kann.
Folgende Kn”pfe stehen zur Auswahl:
@box 10 50 5
@box 12 9 1
@box 22 11 1
@box 34 14 1
@box 49 9 1
Im Text Als Seite Als REFerenz Abbruch
@box 12 21 1
@box 34 24 1
In allen Seiten ... aller Hypertexte
@endnode
@node "Extra -> Weitersuchen"
@xref "Extra -> Suchen"
@toc "Extra-Popup"
@alias Weitersuchen
@index Weitersuchen
Weitersuchen ST-Guide
@line 1 75 0 0 7
Durch diese Funktion wird die aktuelle Seite erneut nach dem zuletzt
verwendeten Muster durchsucht, die Suche beginnt jedoch in der zweiten
sichtbaren Zeile des Fensters, damit nicht erst gescrollt werden muž, um
die Suche fortf<74>hren zu k”nnen.
@box 49 9 1
@box 59 3 1
Die Tastenkombination f<>r diese Funktion lautet Control - G .
@endnode
@node "Extra -> Stack l”schen"
@toc "Extra-Popup"
@alias "Stack l”schen"
Stack l”schen ST-Guide
@line 1 75 0 0 7
Diese Funktion l”scht den Stack (Stapel), auf dem die Seiten abgelegt
werden, zu denen per 'zur<75>ck' gelangt werden kann. Alternativ kann auch
@box 23 11 1
@box 35 3 1
die Tastenkombination Alternate - E gedr<64>ckt werden.
Sowohl das Zur<75>ck-Icon, als auch das History-Popup werden durch diese
Aktion deaktiviert.
@endnode
@node "Extra -> Kopieren"
@toc "Extra-Popup"
@alias Kopieren
@xref "Extra -> Einf<6E>gen"
@index Kopieren
Kopieren ST-Guide
@line 1 75 0 0 7
@box 37 9 1
@box 47 3 1
Diese Funktion (oder der Tastencode Control - C ) schreibt die aktuelle
Seite als @{ASCII ignore}-Text ins Clipboard und stellt sie damit allen anderen
GEM-Applikationen zur Verf<72>gung. Falls noch kein Clipboard existiert, so
wird eines erzeugt, und zwar wie <20>blich auf dem Bootlaufwerk als Ordner
CLIPBRD.
@box 42 7 1
Wird bei dieser Aktion gleichzeitig eine Shift -Taste gedr<64>ckt gehalten,
so wird der vorige Klemmbrettinhalt nicht <20>berschrieben, sondern der neue
Text wird an den vorhandenen angeh„ngt.
@endnode
@node "Extra -> Einf<6E>gen"
@toc "Extra-Popup"
@xref "Extra -> Kopieren"
@symbol ai Einf<6E>gen
@alias Paste
@index Paste
Einf<EFBFBD>gen ST-Guide
@line 1 75 0 0 7
@box 57 9 1
@box 67 3 1
Durch Bet„tigung dieses Eintrags oder durch Dr<44>cken von Control - V wird
der ST-Guide veranlažt, die Datei SCRAP.TXT vom Clipboard zu laden, falls
m”glich, und sie dann im Fenster anzuzeigen.
@endnode
@node "Extra -> Seite drucken"
@toc "Extra-Popup"
@alias "Seite drucken"
@index "drucken"
Seite drucken ST-Guide
@line 1 75 0 0 7
@box 60 9 1
@box 70 3 1
Diese Funktion (auch aufrufbar durch die Tastenkombination Control - P )
macht genau das, was man von ihr erwarten sollte, n„mlich die aktuelle
Seite als @{ASCII ignore}-Text auf den Drucker ausgeben.
Das ber<65>chtigte "Atari-ž" wird dabei vom ST-Guide automatisch in das
"richtige ž" gewandelt, sodaž alle Umlaute korrekt im Ausdruck erscheinen
sollten.
Alternativ gibt es die M”glichkeit, in der ST-GUIDE.INF die Variable
PRINTER zu definieren. In diesem Fall wird beim Aufruf der Drucken-Funktion
statt eines direkten Ausdrucks das dort angegebene Programm gestartet.
Der Inhalt der auszudruckenden Seite wird dabei auf das Klemmbrett kopiert.
Diese Umleitung funktioniert auch im Block-Popup.
Wie bereits klar sein d<>rfte, kann man also die Drucken-Funktion einerseits
zum Aufruf eines externen Druck-Programms, andererseits aber auch
zweckentfremdet einsetzen, um z.B. einen Editor o.„. aufzurufen.
@endnode
@node "Extra -> Font"
@toc "Extra-Popup"
@symbol a "Anzeige-Zeichensatz"
@alias Font
Font ST-Guide
@line 1 75 0 0 7
Der ST-Guide unterst<73>tzt das sogenannte Font-Protokoll von Christian
Grunenberg. Es wird dazu die Environment-Variable FONTSELECT ausgewertet.
Falls diese Variable nicht gesetzt ist, versucht der ST-Guide einen im
Autoordner installierten Selektor zu finden (UFSL, FONTSEL, CALVINO,
HUGO), und benutzt diesen.
Falls auf einem dieser Wege ein Fontselektor aufrufbar ist, kann <20>ber
diesen Eintrag des Extra-Popups ein beliebiger Zeichensatz gew„hlt werden,
mit dem der ST-Guide den Text in seinem Fenster anzeigen soll.
Falls kein Fontselektor installiert ist, so erscheint eine entsprechende
Meldung, und falls kein GDOS installiert ist, kann nur der
Systemzeichensatz zur Darstellung verwendet werden.
Anmerkung: Bei den meisten verf<72>gbaren Hypertexten wird davon ausgegangen,
daž ein Monospaced-Font, also ein nicht-proportionaler Zeichensatz,
eingestellt ist. Daher sei auch hier empfohlen, grunds„tzlich mit solchen
Monospaced-Fonts zu arbeiten, um allzu heftige Verzerrungen im Seitenbild
zu vermeiden.
@box 49 11 1
@box 61 3 1
Die Tastenkombination f<>r diese Funktion lautet Alternate - Z .
@endnode
@node "Extra -> Remarker"
@xref "remarker.hyp/Main" "Notizen-Tool REMARKER"
@next "Maus-Funktionen"
@toc "Extra-Popup"
@{Remarker ignore} ST-Guide
@line 1 75 0 0 7
@image "remarker.icn" 1
Der REMARKER ist ein von Christoph Spengler geschriebenes
Zusatz-Programm zum ST-Guide, mit dem sehr einfach Notizen zu
bestimmten Hypertextseiten erstellt, abgespeichert und jederzeit
wieder hervorgeholt werden k”nnen. Der ST-Guide ist auf die
Zusammenarbeit mit dem Remarker bestens vorbereitet.
Falls die Variable REMARKER in der @{"ST-GUIDE.INF" link "ST-GUIDE.INF" REMARKER} definiert ist
oder Remarker ebenfalls l„uft, kann dieser Men<65>punkt im Extra-Popup
@box 46 11 1
@box 58 3 1
ausgew„hlt oder per Tastenkombination Alternate - R aktiviert
werden. Der ST-Guide ruft dann den Remarker auf bzw. startet ihn.
Wenn sich der REMARKER bereits im Speicher befindet, zeigt der
ST-Guide dies, indem ganz rechts in der Icon-Leiste das Notiz-Symbol
sichtbar ist.
Am REMARKER-Icon lassen sich zwei Dinge ablesen:
1. Wenn es sichtbar ist, bedeutet dies, daž der Remarker sich
bereits im Speicher befindet.
2. Das Icon kennt aužerdem zwei Zust„nde: entweder ist es hell
oder kr„ftig gezeichnet. Im letzteren Fall heižt das, daž eine
oder mehrere Anmerkungen zur aktuell dargestellten Hypertext-
Seite exisieren.
@{B}Achtung:@{0} Das Remarker-Icon ist auch dann anw„hlbar, wenn es hell
dargestellt ist! In dieser Eigenschaft weicht es von den anderen
Icons ab, aber man bekommt dadurch einen schnelleren Zugriff auf
den Remarker, wenn man Anmerkungen eingeben will. Wem dies
"inkonsistent" erscheint, der kann nat<61>rlich weiterhin die
Men<65>-Auswahl <20>ber das Extra-Popup benutzen.
Nach Aufruf ”ffnet der REMARKER also sein Fenster und zeigt diese
Anmerkungen, so vorhanden. Andernfalls bleibt das Anmerkungsfenster
nat<61>rlich leer, aber neue Anmerkungen k”nnen nun eingegeben werden.
N„heres erl„utert die Remarker-Anleitung.
Anmerkung: Der REMARKER ist ein Shareware-Programm.
@endnode
@pnode ins
@noref
'case insensitive' bedeutet, daž Grožbuchstaben wie Klein-
buchstaben behandelt werden und umgekehrt.
'TEST', 'test' und 'Test' sind danach identische Pattern.
@endnode
@node "PureC-Protokoll" "Das PureC-Help Protokoll"
@toc "Hypertexte anderer Formate"
@next PureC-Protokoll
@prev PureC-Protokoll
PureC-Protokoll ST-Guide
@line 1 75 0 0 7
Der grunds„tzliche Aufbau einer solchen Meldung ist:
buffer[0] = <Meldungs-Typ> (z.B. AC_HELP)
buffer[1] = <Sender ID> (von appl_init)
buffer[2] = <Versionsnummer> (bei AC_REPLY)
0 (alle anderen)
buffer[3] = Zeiger auf Suchwort (High) (bei AC_HELP)
<Handle des ACC-Fensters> (bei AC_REPLY)
0 (alle anderen)
buffer[4] = Zeiger auf Suchwort (Low) (bei AC_HELP)
0 (alle anderen)
buffer[5] = 0x1993 (evtl. bei AC_HELP)
0 (alle anderen)
buffer[6] = Zeiger auf Indexdatei (High) (falls AC_HELP und 0x1993)
0 (sonst)
buffer[7] = Zeiger auf Indexdatei (Low) (falls AC_HELP und 0x1993)
0 (sonst)
@symbol ai AC_HELP
* @{B}AC_HELP@{0} (1025)
@{U}APP -> ACC@{0}: "zeige mal die Infos zum angegebenen Begriff"
@{U}ACC -> APP@{0}: AC_REPLY (siehe dort), nachdem die passende Datei
dazu gesucht und die gew<65>nschte Seite angezeigt, bzw. die Suche
erfolglos abgebrochen wurde.
Die Suche nach dem Begriff erfolgt in der durch 'REF' bzw. der in der
Meldung angegebenen Datei. Gefunden werden auch „hnliche Begriffe.
@symbol ai AC_REPLY
* @{B}AC_REPLY@{0} (1026)
@{U}ACC -> APP@{0}: Antwort auf alle Meldungen;
@symbol ai AC_VERSION
* @{B}AC_VERSION@{0} (1027)
@{U}APP -> ACC@{0}: "sag mir, welche Versionsnummer Du tr„gst"
@{U}ACC -> APP@{0}: AC_REPLY (siehe dort)
@symbol ai AC_COPY
* @{B}AC_COPY@{0} (1028)
@{U}APP -> ACC@{0}: "schreibe mal die aktuelle Seite ins Clipboard"
@{U}ACC -> APP@{0}: AC_REPLY (siehe dort), nachdem die aktuelle Seite
als ASCII-Text (SCRAP.TXT) ins Clipboard geschrieben wurde.
@endnode
@pnode "Popup-Nodes"
Dies ist ein Beispiel f<>r
eine @{B}Popup-Node.@{0}
Pnodes dienen f<>r kurze
Erkl„rungen zu bestimmten
Begriffen, ohne daž dabei
ein neues Fenster ge”ffnet
werden muž.
@endnode
@pnode "Text-Attribute"
normal
@{B}fett@{0}
@{U}unterstrichen@{0}
@{I}kursiv@{0}
@{G}hell@{0}
@{O}umrandet@{0}
@{S}schattiert@{0}
@endnode
@node "Linien, Pfeile und Boxen"
@prev "Linien, Pfeile und Boxen"
@toc "Funktions<6E>bersicht"
@symbol a "Linien, Pfeile und verschiedene Boxentypen"
Linien, Pfeile und Boxen ST-Guide
@line 1 75 0 0 7
## 1. Zeile
@line 63 2 0
@line 65 0 16
@line 1 32 16
@box 1 32 16 0
@box 33 16 8 2
@box 49 8 4 4
@box 57 4 2 6
@box 61 2 1 7
## 2. Zeile
All
## 3. Zeile
@rbox 16 2 1 7
@box 57 2 1 7
diese
## 4. Zeile
Objekte
## 5. Zeile
@rbox 9 16 8 2
@box 49 4 2 6
@box 53 2 1 7
sind blož
## 6. Zeile
Anwendungen
## 7. Zeile
@rbox 13 8 4 4
@box 49 2 1 7
@box 37 8 4 6
von ST-Guide-
## 8. Zeile
@rbox 15 4 2 6
@box 43 4 2 7
Grafikbefehlen!
## 9. Zeile
@line 17 -16 8
@line 17 -15 8
@line 17 -13 8
@line 17 -9 8
@line 17 -4 8
@line 17 4 8
@line 17 9 8
@line 17 13 8
@line 17 15 8
@line 17 16 8
@box 33 8 4 4
@line 61 -12 6 0 7
@line 59 -10 5 0 6
@line 57 -8 4 0 5
@line 55 -6 3 0 4
@line 53 -4 2 0 3
@line 51 -2 1 0 2
@box 63 2 1 7
## 10. Zeile
@box 39 4 2 7
@box 63 2 1 6
@box 61 2 1 7
## 11. Zeile
@box 70 2 1 3
@box 63 2 1 5
@box 61 2 1 6
@box 59 2 1 7
@{" " link %hihi}
## 12. Zeile
@line 69 -3 1 2
@box 63 2 1 4
@box 61 2 1 5
@box 59 2 1 6
@box 57 2 1 7
## 13. Zeile
@box 33 4 2 6
@box 37 2 1 7
@box 63 2 1
@box 61 2 1 4
@box 59 2 1 5
@box 57 2 1 6
@box 55 2 1 7
;-)
## 14. Zeile
@box 63 2 1 2
@box 61 2 1 3
@box 59 2 1 4
@box 57 2 1 5
@box 55 2 1 6
@box 53 2 1 7
## 15. Zeile
@box 33 2 1 7
@box 63 2 1 1
@box 61 2 1 2
@box 59 2 1 3
@box 57 2 1 4
@box 55 2 1 5
@box 53 2 1 6
@box 51 2 1 7
## 16. Zeile
@box 63 2 1
@box 61 2 1 1
@box 59 2 1 2
@box 57 2 1 3
@box 55 2 1 4
@box 53 2 1 5
@box 51 2 1 6
@box 49 2 1 7
## 17. Zeile
@line 1 64 0
Und nun kommt das beste: Ein kurzer Maus-Klick auf das einsame
schraffierte K„stchen ganz rechts ...
@endnode
@node "Diskette/Festplatte"
@toc Funktions<6E>bersicht
Diskette und Festplatte ST-Guide
@line 1 75 0 0 7
Der ST-Guide geht sehr sparsam mit Ihren Massenspeichern um:
- Der Compiler ist in der Lage, Hypertexte zu "packen", also ihren
Platzbedarf zu verringern. Dazu benutzt der den LH5-Algorithmus,
den auch der Packer LHARC verwendet. Auf diese Weise k”nnen
Hypertext-Dateien (mit der Endung HYP) um bis zu zwei Drittel
verkleinert werden. Beim Ansehen des Hypertextes werden die gepackten
Seiten ohne sp<73>rbaren Zeitverlust wieder ausgepackt und auf dem
Bildschirm angezeigt.
- Ein weiterer Platzvorteil ergibt sich aus der Tatsache, daž ein
Hypertext immer als eine Datei gespeichert wird:
Bei Hypertext-Systemen, die f<>r jede Hilfeseite eine neue Datei anlegen,
entsteht der Nachteil, daž jede dieser Dateien - sei sie auch noch so
klein - mindestens einen Cluster Ihres Disk- oder Plattenspeichers
verbraucht, das entspricht einem tats„chlichen Verbrauch von mindestens
1024 Bytes, bei grožen Platten auch 16 KB oder mehr.
Enth„lt ein Hypertext viele Seiten, deren Umfang deutlich geringer ist
als 1024 Bytes, so erh”ht sich der tats„chliche Speicherbedarf um ein
vielfaches (jede noch so kleine Seite verschlingt mindestens einen
Cluster).
Der ST-Guide kennt dieses Problem nicht, da alle Seiten (obendrein in
komprimierter Form) in einer einzigen Datei abgelegt werden, sodaž keine
Cluster-Reste entstehen.
@endnode
@node "Arbeitsspeicher"
@toc Funktions<6E>bersicht
Arbeitsspeicher ST-Guide
@line 1 75 0 0 7
Der Arbeitsspeicher Ihres Computers wird durch den ST-Guide nur wenig
belastet:
- das ST-GUIDE.ACC selbst ist sehr kurz, viel k<>rzer als andere vom
Leistungsumfang her vergleichbare Programme
- Zwar sind Hypertexte immer als eine komplette Datei abgespeichert,
bei der Anzeige wird aber nur ein kleiner Teil davon in den RAM-
Speicher geladen, n„mlich nur die gerade anzuzeigende Seite!
Damit "blockiert" der ST-Guide keinen nennenswerten Teil Ihres
Arbeitsspeichers.
@endnode
@node "Accessory"
@toc Funktions<6E>bersicht
Accessory ST-Guide
@line 1 75 0 0 7
Der ST-Guide kann als Accessory oder als Programm gestartet werden,
das bleibt Ihrer freien Entscheidung <20>berlassen. Bei Bedarf einfach
umbenennen!
Grunds„tzlich empfiehlt sich aber der Einsatz als Accessory, und zwar
insbesondere dann, wenn sie kein Multitasking-Betriebssystem besitzen.
So kann der ST-Guide auch aus anderen Programmen heraus aufgerufen werden,
sei es in seiner Funktion als Online-Hilfe oder als universelles Begriffs-
Suchsystem f<>r Texteditoren usw.
@endnode
@node "ASCII"
@next ASCII
@toc Funktions<6E>bersicht
@xref "Extra -> Suchen"
ASCII ST-Guide
@line 1 75 0 0 7
Selbst dann, wenn die angezeigte Datei nur reinen ASCII-Text enth„lt,
k”nnen Sie mit dem ST-Guide auf andere Texte verzweigen.
Das geht so: Wenn Sie auf einen Begriff im Text klicken, pr<70>ft der
ST-Guide (mittels der sogenannten Referenz-Suche), ob es eine
Erkl„rungs-Seite zu diesem Begriff gibt und zeigt sie ggf. an.
Dazu muž dieser Begriff nicht besonders hervorgehoben sein, es kommt
lediglich darauf an, daž die angeklickte Zeichenkette gefunden wird.
Existiert sie nicht, so sucht der ST-Guide nach „hnlichen Begriffen
und zeigt eine Liste der gefundenen Verweise an.
@endnode
@node "Hilfe-Seite zum ST-Guide"
@next "Hilfe-Seite zum ST-Guide"
@prev "Hilfe-Seite zum ST-Guide"
@toc Main
Hilfe-Seite zum ST-Guide ST-Guide
@line 1 75 0 0 7
Dieser Text stellt die Dokumentation des vorliegenden Hypertext-Sytems
dar und beschreibt die Funktionsweise und Anwendung aller zu diesem System
geh”renden Komponenten.
An dieser Stelle sei aus aktuellem Anlaž noch einmal erw„hnt, daž der
ST-Guide Fairware ist, um Spenden in jeder H”he also ausdr<64>cklich
gebeten wird, um die Weiterentwicklung dieses Programmes zu
gew„hrleisten (ich freue mich auch <20>ber kleine Spenden...)
Kritik und Anregungen an
Holger Weets
Tangastr. 45
26121 Oldenburg
E-Mail: Holger Weets @ OL (Mausnet)
Spenden: Landessparkasse zu Oldenburg
Kto.: 023-182 041
BLZ.: 280 501 00
@endnode
@node %hihi
@prev %hihi
@next %hihi
@{"Linien, Pfeile und Boxen" ignore} ST-Guide
@line 1 75 0 0 7
@line 63 2 0
@line 65 0 16
@line 1 32 16
@box 1 32 16 0
@box 33 16 8 2
@box 49 8 4 4
@box 57 4 2 6
@box 61 2 1 7
All
@rbox 16 2 1 7
@box 57 2 1 7
diese
Objekte
@rbox 9 16 8 2
@box 49 4 2 6
@box 53 2 1 7
sind blož
Anwendungen
@rbox 13 8 4 4
@box 49 2 1 7
@box 37 8 4 6
von ST-Guide-
@rbox 15 4 2 6
@box 43 4 2 7
Grafikbefehlen!
@line 17 -16 8
@line 17 -15 8
@line 17 -13 8
@line 17 -9 8
@line 17 -4 8
@line 17 4 8
@line 17 9 8
@line 17 13 8
@line 17 15 8
@line 17 16 8
@box 33 8 4 4
@line 61 -12 6 0 7
@line 59 -10 5 0 6
@line 57 -8 4 0 5
@line 55 -6 3 0 4
@line 53 -4 2 0 3
@line 51 -2 1 0 2
@box 63 2 1 7
@box 39 4 2 7
@box 63 2 1 6
@box 61 2 1 7
@box 63 2 1 5
@box 61 2 1 6
@box 59 2 1 7
@box 63 2 1 4
@box 61 2 1 5
@box 59 2 1 6
@box 57 2 1 7
@box 33 4 2 6
@box 37 2 1 7
@box 63 2 1 3
@box 61 2 1 4
@box 59 2 1 5
@box 57 2 1 6
@box 55 2 1 7
Voila!
@box 63 2 1 2
@box 61 2 1 3
@box 59 2 1 4
@box 57 2 1 5
@box 55 2 1 6
@box 53 2 1 7
@box 33 2 1 7
@box 63 2 1 1
@box 61 2 1 2
@box 59 2 1 3
@box 57 2 1 4
@box 55 2 1 5
@box 53 2 1 6
@box 51 2 1 7
@box 63 2 1
@box 61 2 1 1
@box 59 2 1 2
@box 57 2 1 3
@box 55 2 1 4
@box 53 2 1 5
@box 51 2 1 6
@box 49 2 1 7
@line 1 64 0
Na bitte: hat geklappt! Nochmal? - UNDO-Taste dr<64>cken!
@endnode
@node "ST-GUIDE.INF"
@toc Konfiguration
@prev "ST-GUIDE.INF"
@next "ST-GUIDE.INF"
@symbol a "INF-Datei"
ST-GUIDE.INF ST-Guide
@line 1 75 0 0 7
Folgende Variablen werden zur Zeit benutzt:
@alabel TABSIZE
* @{B}TABSIZE@{0}
enth„lt die gew<65>nschte Tabulatorweite. Ist diese Variable nicht
vorhanden, so wird der Wert 8 verwendet. (hcp, ST-Guide)
@alabel WINSIZE
* @{B}WINSIZE@{0}
enth„lt die Gr”že des ST-Guide Fensters beim ersten ™ffnen desselben.
ist diese Variable nicht vorhanden, so wird das Fenster mit voller
Bildschirmgr”že ge”ffnet.
WINSIZE=100,100,400,200
wird das Fenster des ST-Guide beim ersten ™ffnen in die Mitte eines
640x400 Pixel Bildschirmes positionieren.
(ST-Guide)
##CHANGED
@alabel TXTOFFSET
* @{B}TXTOFFSET@{0}
enth„lt den vertikalen Abstand des Fensterinhalts von der Trennlinie
unterhalb der Icons in Pixeln. Der Defaultwert betr„gt 6 Pixel. Mit
diese Variable kann also den Hypertexten - je nach pers”nlichem
Geschmack - ein "oberer Rand" gegeben werden, ohne daž dieser vom
Hypertext-Autor per Leerzeile vorzugeben ist.
(ST-Guide)
@alabel "REFCOLOR"
* @{B}REFCOLOR@{0}
REFCOLOR=<Farbe> setzt die Textfarbe f<>r Referenzen auf <Farbe>. Wird
diese Variable gesetzt, so stellt ST-Guide Referenzen nicht mehr Fett
und Unterstrichen dar, sondern in normaler Schrift mit der angegebenen
Farbe.
Diese Variable wird in monochromen Aufl”sungen ignoriert.
(ST-Guide)
@alabel "TXTCOLOR"
* @{B}TXTCOLOR@{0}
TXTCOLOR=<Farbe> setzt die Textfarbe auf <Farbe>.
Diese Variable wird in monochromen Aufl”sungen ignoriert.
(ST-Guide)
##CHANGED
@alabel "BCK3D"
* @{B}BCK3D@{0}
BCK3D=<egal> setzt Farbe des Fensterhintergrundes auf hellgrau; wird
diese Variable nicht angegeben, dann zeigt der ST-Guide ein Fenster
mit einem weižen Hintergrund.
Diese Variable wird in monochromen Aufl”sungen ignoriert.
(ST-Guide)
@alabel "PATHS"
* @{B}PATHS@{0}
enth„lt eine durch Kommata oder Semikoli getrennte Liste von Pfaden,
welche zum Auffinden von Dateien verwendet wird, welche <20>ber externe
Referenzen (siehe link) angezeigt werden sollen.
PATHS=c:\guides\;c:\;c:\bin\
wird, falls eine Datei gesucht wird, diese nacheinander in
C:\GUIDES\
C:\
und
C:\BIN\
suchen
(ST-Guide, STool)
@alabel "EXTVIEW"
* @{B}EXTVIEW@{0}
enth„lt den Namen desjenigen ACC/PRG, welches mit dem Anzeigen von
nicht Hypertext-Dateien beauftragt werden soll, sofern f<>r die Endung
der betreffenden Datei kein Viewer angemeldet wurde. Die Angaben
sollten mit vollst„ndigem Pfad erfolgen, sofern nicht sichergestellt
ist, daž der betreffende Viewer bereits l„uft (also als ACC
installiert ist)
@alabel "<ext>"
Ein Viewer f<>r bestimmte Dateiformate wird <20>brigens installiert durch
<Endung>=Programm (Beipiel: IMG=C:\BIN\1stview.prg)
Der so angegebene Viewer wird bei Bedarf zun„chst gesucht und danach
entweder zum Starten an den Desktop weitergegeben oder vom ST-Guide
selbst gestartet, sofern MagiC 2 installiert ist.
Falls weder diese Variable noch die durch die Endung der Datei
vorgegebene Variable existiert, so wird die betreffende Datei im ASCII
Format vom ST-Guide angezeigt.
(ST-Guide)
@alabel "HCP_OPT"
* @{B}HCP_OPT@{0}
enth„lt die Default-Optionen f<>r den HCP. Diese werden vor dem
Einlesen der Kommandozeile gesetzt und k”nnen somit durch direktes
Angeben beim Aufruf <20>berschrieben werden.
(hcp)
@symbol PRINTER
* @{B}PRINTER@{0}
Falls diese Variable gesetzt ist in der Form
PRINTER=<programm> (z.B. PRINTER=C:\TOOLS\PRINTER.APP)
dann wird die Drucken-Funktion nicht vom ST-Guide selbst ausgef<65>hrt,
sondern der markierte Block bzw. die aktuelle Seite wird auf das
Klemmbrett kopiert, und das hier angegebene Programm wird gestartet.
(ST-Guide)
@symbol FORMFEED
* @{B}FORMFEED@{0}
Sorgt daf<61>r, daž nach dem Drucken einer Seite ein Formfeed auf
den Drucker ausgegeben wird.
(ST-Guide)
##CHANGED
@symbol MARKFILE
* @{B}MARKFILE@{0}
Wenn diese Variable gesetzt ist, dann speichert der ST-Guide in die
dort angegebene Datei automatisch bei Žnderungen alle definierten
Marken und l„dt sie auch automatisch wieder aus dieser Datei.
Beispiel: MARKFILE=c:\guides\marken.dat
(ST-Guide)
##CHANGED
@symbol ri "HCP"
* @{B}HCP@{0}
enth„lt den vollst„ndigen Zugriffspfad des HCP und dient zum Starten
desselben.
(STool, HypFind)
##CHANGED
@symbol ri "HYPFIND"
* @{B}HYPFIND@{0}
enth„lt den vollst„ndigen Zugriffspfad des HypFind, dem Tool zum
@{Suchen ignore} von Pattern @{"in allen Seiten" link "Suchen in allen Seiten"} eines/aller Hypertexte.
(ST-Guide)
##CHANGED
@symbol ri "REMARKER"
* @{B}REMARKER@{0}
enth„lt optional ein '!' sowie den vollst„ndigen Zugriffspfad des
Remarker-Tools; ist diese Variable ohne '!' definiert, so startet
ST-Guide das Tool beim ™ffnen des Fensters direkt nach; unabh„ngig
@box 36 11 1
vom '!' Flag wird Remarker bei Alternate -R nachgestartet, sofern
diese Variable gesetzt ist.
REMARKER=C:\ST-GUIDE\REMARKER.PRG
@box 57 11 1
startet Remarker automatisch beim ™ffnen, sowie bei Alternate -R
REMARKER=!C:\ST-GUIDE\REMARKER.PRG
@box 30 11 1
startet Remarker nur bei Alternate -R
(ST-Guide)
@alabel "HYPFOLD"
* @{B}HYPFOLD@{0}
enth„lt den Defaultpfad f<>r Hypertexte. Wird also beim šbersetzen
keine Ausgabedatei angegeben, so erzeugt der HCP die Hypertext-Datei
in dem durch diese Variable angegebenen Verzeichnis. Der ST-Guide
nutzt diese Variable ebenfalls, und zwar als Default-Pfad f<>r den
Fileselektor.
Auch der HypFind erzeugt seine Ausgabedatei in diesem Verzeichnis.
(ST-Guide, hcp, HypFind)
@alabel ARROWPATCH
* @{B}ARROWPATCH@{0}
Falls diese Variable definiert ist (Wert ist egal), der ST-GUIDE als
ACC gestartet wird und dies nicht unter einem MultiTask Betriebsystem,
so behebt ST-Guide den bekannten Fehler des Betriebsystems, welcher
bewirkt, daž die Scrollpfeile sowie die Pager an Fenstern von ACCs
nicht funktionieren.
Die bessere Alternative zu diesem Patch ist allerdings die
Installation von ARROWFIX oder (besser) WINX im Autoordner. ST-Guide
behebt diesen Fehler nur f<>r sich selbst, alle anderen ACCs werden
damit auch weiterhin Probleme haben!
(ST-Guide)
##CHANGED
@alabel "NOREFBOX"
* @{B}NOREFBOX@{0}
Setzen dieser Variable (der zugewiesene Wert ist egal) bewirkt, daž
beim Suchen in der REF-Datei die kleine Box nicht erscheint, in der
das Suchwort angezeigt wird.
(ST-Guide)
##CHANGED
@alabel "RIGHTBACK"
* @{B}RIGHTBACK@{0}
Falls diese Variable definiert ist (Wert egal), so wird das Bet„tigen
der rechten Maustaste wie ein Klick auf den 'zur<75>ck' Button interpre-
tiert. Defaultm„žig ist diese Variable nicht gesetzt, weil das a) den
Nachteil hat, daž Aktionen im hintenliegenden Fenster nicht mehr
m”glich sind, und b) werden Rechtsklicks von den verschiedenen TOS-
Versionen unterschiedlich behandelt (Quelle: Martin "WINX" Osieka)
(ST-Guide)
##CHANGED
@alabel "BACKWIND"
* @{B}BACKWIND@{0}
Macht das Fenster des ST-Guide hintenliegend benutzbar, getopped
wird es dann mit Rechtsklick.
(ST-Guide)
##CHANGED
@alabel "REFONLY"
* @{B}REFONLY@{0}
Wenn diese Variable definiert ist (Wert egal), dann werden Klicks auf
nicht als Verweis markierte Textstellen ignoriert
(ST-Guide)
@alabel "DEFHYP"
* @{B}DEFHYP@{0}
enth„lt den vollst„ndigen Zugriffspfad der Datei, die beim Aufruf des
ST-Guide @{U}ohne Parameter@{0} automatisch geladen werden soll.
(ST-Guide)
@alabel "HYPTOP"
* @{B}HYPTOP@{0}
enth„lt den vollst„ndigen Zugriffspfad des Katalog-Hypertextes,
welcher durch STool automatisch erzeugt werden kann. ST-Guide l„dt die
hier angegebene Datei automatisch, falls beim ersten Aufruf keine
Parameter angegeben wurden und auch keine Default-Datei definiert ist
(durch DEFHYP)
(ST-Guide, STool)
@alabel "FONT"
* @{B}FONT@{0}
enth„lt den zu benutzenden Font und die gw<67>nschte Gr”že in folgendem
Format: FONT,SIZE
Beispiel: 98,9 (GEMINI Bold, kleiner Satz)
Der ST-Guide liest diese Var. beim ™ffnen des Fensters, der Font kann
also zwischen zwei Programmstarts ge„ndert werden, jedoch nicht solange
ST-Guide l„uft. Wird FONT zu 0 angegeben (z.B. 0,9), dann wird der
Systemzeichensatz mit der angegebenen Gr”že verwendet.
Prinzipiell funktioniert dies nat<61>rlich auch mit Proportional
Zeichens„tzen, jedoch stimmen dann die Positionen von Grafik-Objekten
evtl. nicht mehr ganz, da hier in diesem Falle mit einer gemittelten
Zeichenbreite gerechnet wird.
(ST-Guide)
##CHANGED
@alabel "XFONT"
* @{B}XFONT@{0}
enth„lt den zu benutzenden Font und die gw<67>nschte Gr”že in folgendem
Format: FONT,SIZE
Definiert einen 2. Defaultfont; zwischen den bei FONT und XFONT an-
gegebenen Fonts kann direkt per CTRL-Z umgeschaltet werden;
Sinnvoll z.B. dann, wenn zum Lesen ein Proportionalfont verwendet
wird und eine Seite eine Tabelle enth„lt.
@alabel "REF"
* @{B}REF@{0}
enth„lt den Pfad & Namen derjenigen REF-Datei, welche vom ST-Guide zum
Auffinden von Begriffen verwendet wird, welche nicht im aktuellen
Dokument definiert wurden. Diese Datei wird auch vom RefLink
defaultm„žig f<>r alle Aktionen verwendet.
(ST-Guide, RefLink, hcp)
@alabel "$<name>"
* @{B}$<name>@{0}
kann mehrfach vorkommen (freilich mit unterschiedlichen Namen) und
enth„lt jeweils den vollst„ndigen Pfad eines externen Programms, das
dann mit dem @{"@{ system }" link "hcp.hyp/system"}-Kommando aus Hypertexten heraus gestartet werden
kann.
Beispiel:
$stool=c:\st-guide\stool.tos
Wer Hypertexte schreibt, die von dieser Funktion Gebrauch machen, muž
dar<61>ber Auskunft geben, welche $-Zeilen ben”tigt werden.
(ST-Guide)
@endnode
@node "Suchen im Text"
@toc "Extra -> Suchen"
@prev "Suchen im Text"
@symbol a " Im Text "
Suchen im Text ST-Guide
@line 1 75 0 0 7
Der eingegebene Begriff wird in der aktuellen Seite ab der ersten
sichtbaren Zeile bis zum Textende in allen Zeilen gesucht. Wird er
gefunden, so wird die entsprechende Zeile neue erste Zeile des
Fensters. Die Suche erfolgt case insensitive und kann durch die
Funktion 'Weitersuchen' wiederholt werden.
@endnode
@node "Suchen als Seite"
@toc "Extra -> Suchen"
@symbol a " Als Seite "
Suchen als Seite ST-Guide
@line 1 75 0 0 7
Diese Suchart forscht in der aktuellen Indextabelle nach der
eingegebenen Zeichenkette. Es k”nnen Wildcards verwendet werden und der
Vergleich erfolgt @{"case insensitive" link ins}.
@symbol ai Trefferliste
Wird mehr als ein Treffer gefunden, so erscheint ein Dialog, in dem
alle passenden Namen aufgef<65>hrt sind. Der gew<65>nschte Begriff kann hier
durch Mausklick oder Tastatur ausgew„hlt werden. Hierzu ist immer eine
der Trefferzeilen selektiert,
Return w„hlt diese Zeile aus
Cursor Up setzt die Selektierung auf die vorige Zeile
Cursor Down setzt die Selektierung auf die n„chste Zeile
Undo wirkt wie der Abbruch-Button
Shift Up zeigt die vorige Seite der Liste
Shift Dn zeigt die n„chste Seite der Liste
Home zeigt die erste Seite der Liste
Shift Home zeigt die letzte Seite der Liste
Der Slider bewirkt (nat<61>rlich) Onlinescrolling und funktioniert
ansonsten wie in einem GEM-Fenster.
Die Trefferzeilen enthalten jeweils den Namen der Seite sowie das Thema
des zugeh”rigen Hypertextes. Wird als Treffer ein Verweis innerhalb
einer Seite gefunden, so wird dieser hinter dem Namen der Seite, durch
einen Punkt getrennt ebenfalls gezeigt.
@symbol ai Žhnliche
@symbol a „hnliche
Wird kein exakter Treffer gefunden, jedoch „hnliche Begriffe, so werden
diese zur Auswahl gestellt. Žhnlich ist hierbei wie folgt definiert:
- Grož/Kleinschreibung wird ignoriert
- '„' wird wie 'ae' behandelt, '<27>' wie 'ue' etc.
- '*' passt auf beliebig viele Zeichen
- '?' passt auf genau ein Zeichen
- abh„ngig von der L„nge des Suchwortes d<>rfen sich ein paar
Zeichen unterscheiden ('option' passt auf 'optoin')
@endnode
@node "Suchen als REFerenz"
@toc "Extra -> Suchen"
@symbol "REF-Suche"
@symbol a " Als REFerenz "
Suchen als REFerenz ST-Guide
@line 1 75 0 0 7
Der eingegebene Begriff wird in der durch die Variable 'REF'
angegebenen Datei gesucht, ansonsten ist diese Suchart identisch mit
dem Suchen als Seite.
Um es verst„ndlicher auszudr<64>cken: Bei dieser Art der Suche handelt es
sich um die Suche nach einem Stichwort bzw. einer Zeichenkette in der
globalen Stichwortdatei (REF), die vom RefLink durch Zusammenf<6E>gen der
Stichwortdateien der einzelnen Hypertexte erzeugt wurde. Es wird also
nicht nur in einem Hypertext, sondern in der Stichwortliste aller
mit dem RefLink bearbeiteten Hypertexte gesucht.
Diese Suche wird z.B. dann benutzt, wenn man bei einem entsprechend
ausgestatteten Texteditor ein Wort markiert und die Help-Funktion
aktiviert. Wenn irgendwo eine Hypertextseite zu dem gesuchten Wort bzw.
der gesuchten Zeichenkette (k”nnen auch mehrere Worte sein) existiert,
dann findet der ST-Guide diese Seite und zeigt sie an.
@endnode
@node "Suchen in allen Seiten"
@toc "Extra -> Suchen"
@next "Suchen in allen Seiten"
@symbol a " ... aller Hypertexte "
@symbol a " In allen Seiten "
Suchen in allen Seiten [... aller Hypertexte] ST-Guide
@line 1 75 0 0 7
F<>r diese Art der Suche bedient sich der ST-Guide eines externen Tools
namens HypFind, welches dem Paket beiliegt und <20>ber die Variable
@{HYPFIND link "ST-GUIDE.INF" HYPFIND} definiert sein muž.
Die Suche erfolgt case insensitiv und das Tool erzeugt als Ausgabe eine
Trefferliste in Form eines Hypertextes, der vom ST-Guide nach der
Terminierung von HypFind automatisch nachgeladen wird. Damit HypFind
aufgerufen werden kann ist
- entweder MagiC installiert, dann startet ST-Guide das Tool selbst, oder
- es wird ein AV-Desktop verwendet, wie z.B. Thing oder Gemini (evtl.
funktioniert das auch mit Ease), in diesem Fall beauftragt ST-Guide den
Desktop mit dem Starten von HypFind
Alle Anwender, bei denen keine der beiden Bedingungen erf<72>llt sind,
k”nnen HypFind nur von Hand starten.
@endnode
@node "Konverter"
@symbol a 1stConv
@symbol a PC-Conv
Konverter ST-Guide
@line 1 75 0 0 7
Die Konverter, um aus anderen Hypertext-Formaten ST-Guide-Quelltexte zu
erzeugen, befinden sich in einem anderen Archiv, das derzeit den Namen
STG-UT10.LZH tr„gt. Diese Konverter befanden sich urspr<70>nglich im
ST-Guide-Archiv, werden aber seit einiger Zeit separat angeboten. Sollten
Sie die Hypertexte zu diesen Tools besitzen, so ist dies hier ein
geeigneter Absprungpunkt zu ihren Anleitungen:
@box 15 9 1
@box 38 9 1
@{" 1stConv " link "1st_conf.hyp/Main"} @{" PC-Conv " link "pc_conv.hyp/Main"}
@endnode
@node "%Oh nein" "Oh nein!"
@toc Main
@prev "%Oh nein"
@next "%Oh nein"
Oh nein ... ST-Guide
@line 1 75 0 0 7
... so einfach ist das nicht! Wo wollen Sie denn hin? Na gut, @{zur<75>ck ignore} zum
@{Index link Index} d<>rfen Sie noch wieder.
Wie bitte? Ok, also auch zur @{Hauptseite link Main}.
@endnode
##------------------------------------------
@node "%e1" "Pattern nicht gefunden"
@toc "%e1"
@next "%e1"
@prev "%e1"
Das gesuchte Pattern wurde nicht gefunden.
M”gliche Ursachen:
- Sie haben den Begriff als Seite gesucht, und eine solche Seite existiert
im aktuellen Hypertext nicht;
Abhilfe: versuchen sie es evtl. mit einem „hnlichen Begriff erneut, oder
schauen sie im Index nach.
- Sie haben den Begriff in der aktuellen Seite suchen lassen, und dort
kommt er nicht vor;
Abhilfe: versuchen sie es evtl. mit einem „hnlichen Begriff erneut, oder
suchen sie eine Seite, die thematisch eher zu ihrem Begriff pažt.
- die REF-Datei des Hypertextes, der den gesuchten Begriff n„her erkl„rt,
wurde nicht in die durchsuchte REF-Datei aufgenommen;
Abhilfe: Benutzen sie RefLink oder RefCheck, um die betreffende REF-
Datei zu erg„nzen.
- Sie haben keinen Hypertext auf ihrer Platte, der den gesuchten Begriff
n„her erkl„rt;
Abhilfe: vielleicht hat einer ihrer Bekannten einen passenden Hypertext
f<>r sie?
@endnode
@node "%e3" "Datei nicht gefunden"
@toc "%e3"
@next "%e3"
@prev "%e3"
Der Hypertext, in dem der gesuchte Begriff n„her erkl„rt wird, wurde
nicht gefunden, obwohl seine REF-Datei noch existiert.
M”gliche Ursachen:
- Sie haben den Hypertext einmal besessen, ihn dann aber gel”scht und die
REF-Datei dabei nicht aktualisiert;
Abhilfe: benutzen sie RefLink oder RefCheck, um die "REF-Leiche" zu
entfernen.
- Sie besitzen den Hypertext immer noch, aber ST-Guide kann ihn nicht
finden, weil er sich in einem Verzeichnis befindet, daž nicht durchsucht
wurde;
Abhilfe: kopieren sie den Hypertext in ihr Guides-Verzeichnis bzw. in
eines der Verzeichnisse, die sie in der ST-Guide.inf Datei in der
"PATHS=" Zeile angegeben haben, oder erweitern sie diese Zeile um das
Verzeichnis, in dem sich der Hypertext befindet.
@endnode
@node "%e4" "REF-Datei nicht gefunden"
@toc "%e4"
@next "%e4"
@prev "%e4"
Die REF-Datei wurde nicht gefunden.
M”gliche Ursachen:
- Sie haben keine REF-Datei anlegen lassen;
Abhilfe: benutzen sie RefLink oder RefCheck, um dies nachzuholen.
- Sie haben zwar eine REF-Datei, diese jedoch nicht oder nicht korrekt
in der ST-Guide.inf Datei angegeben;
Abhilfe: tragen sie in ihrer ST-Guide.inf Datei in der "REF=" Zeile
den richtigen Pfad und Namen der Datei ein, oder kopieren sie ihre
REF-Datei in das bei "REF=" angegebene Verzeichnis.
@endnode
@node "%e5" "Programm nicht gefunden"
@toc "%e5"
@next "%e5"
@prev "%e5"
Ein Programm sollte aus dem Hypertext heraus gestartet werden, dessen
Pfad in der ST-Guide.inf angegeben sein sollte, es aber nicht war.
M”gliche Ursachen:
- Der Autor des Hypertextes hat vergessen Ihnen mitzuteilen, daž sie Ihre
ST-Guide.inf Datei anpassen m<>ssen;
Abhilfe: fragen sie den Autor des betreffenden Hypertextes, was hier
zu tun ist.
- Sie haben vergessen, die n”tigen Erweiterungen in der ST-Guide.inf Datei
vorzunehmen;
Abhilfe: holen sie das Vers„umte umgehend nach.
@endnode
@node "%e6" "Datei nicht erzeugbar"
@toc "%e6"
@next "%e6"
@prev "%e6"
Eine Datei konnte nicht angelegt werden.
M”gliche Ursachen:
- Der Datentr„ger ist randvoll;
Abhilfe: L”schen sie einige Dateien oder schaffen sie sich einen
gr”žeren Datentr„ger an.
- im entsprechenden Verzeichnis existiert eine schreibgesch<63>tzte Datei
gleichen Namens;
Abhilfe: L”schen sie das 'nur lesen' Attribut der Datei, indem sie
sie im Desktop selektieren und den Menuepunkt 'zeige Info' ausw„hlen.
@endnode
@node "%e7" "Datei nicht gefunden"
@toc "%e7"
@next "%e7"
@prev "%e7"
Die gew<65>nschte Datei wurde nicht gefunden, kann also auch nicht angezeigt
werden.
M”gliche Ursachen:
- Sie besitzen diese Datei nicht;
Abhilfe: fragen sie den Autor des Hypertextes bzw. den Autor des
Programmes, der/das den ST-Guide mit der Anzeige dieser Datei be-
auftragt hat, woher sie das Dokument bekommen k”nnen.
- Sie besitzen diese Datei zwar, haben sie aber in einem Archiv oder in
einem Verzeichnis versteckt, in dem ST-Guide sie nicht sucht;
Abhilfe: kopieren sie die Datei in ihr Guides-Verzeichnis bzw. in
eines der Verzeichnisse, die sie in der ST-Guide.inf Datei in der
"PATHS=" Zeile angegeben haben, oder erweitern sie diese Zeile um das
Verzeichnis, in dem sich die Datei befindet.
- Sie haben die Datei umbenannt;
Abhilfe: geben sie der Datei wieder den urspr<70>nglichen Namen.
@endnode
##------------------------------------------
@pnode " Abbruch "
Dieser Knopf verl„žt den Dialog,
ohne eine Suche zu starten.
@endnode