ST-Guide v1.5e February 1997
===========================================================================
*** ST-Guide can now display 16 colour images! ***
Some new variables have been added. Please refer to the Update History
node (in the ST-Guide hypertext) and read through the ST-GUIDE.INF file
for more details.
Installation guide
------------------
To minimise the risk of other software affecting the installation of
ST-Guide perform the installation after a reboot on a 'clean' minimum
system!
Extracting the archives
Extract the contents of the archives OR copy the contents of the master
disk onto the root directory of your boot partition/disk.
Either method should preserve the directory structure and ensures ST-GUIDE
can locate its files. Double check to ensure ST-GUIDE.ACC and ST-GUIDE.INF
reside in the root directory of the boot partition or disk.
Configuring ST-Guide
Using a text editor (eg Everest) load ST-GUIDE.INF and carefully read
through the options. Each option is described in detail followed by the
option line itself. Lines preceded with a '#' character are NOT currently
active.
It's important the path entries are correct otherwise ST-Guide won't be
able to find its files:
PATHS: The path where HYP files are located, more than one path can be
entered, use the ';' character to separate paths.
HYPFOLD: The default path used by the file selector and HCP.
HYPTOP: The default hypertext loaded when ST-GUIDE is called without
parameters.
REF: The path to the ALL.REF file, which may already be listed in the
PATHS variable. It's not needed during installation and can be
added later.
HCP: The path to the compiler, HCP.TTP.
ST-GUIDE should not be renamed as some applications which offer on-line
help may not be able to find it.
Managing your hypertexts
------------------------
Each hypertext consists of a HYP and a REF file. The HYP file contains the
compiled hypertext and the REF file contains the references defined in the
hypertext.
Using REFLINK.TTP it's possible to combine the references contained in
each REF file into a single ALL.REF file.
There are several ways of adding the contents of an individual REF file to
ALL.REF:
a) Install REFLINK.TTP as an application for '*.REF' files using the
desktop. After installation a double click on any REF file on the
desktop will call REFLINK.TTP and add the contents of the REF file to
an ALL.REF file located using the REF path in ST-GUIDE.INF.
b) Drag a REF file/s onto REFLINK.TTP.
c) Run REFLINK.TTP and manually enter the path to the desired REF file.
Catalogue your collection
-------------------------
Using STOOL.TOS it's possible to automatically catalogue all your
hypertexts thematically. This does however depend on the author of the
hypertext including the necessary infomation in the hypertext header.
On starting STOOL.TOS each of the paths entered in the ST-GUIDE.INF PATH
entry is searched for HYP format hypertexts and creates a hypertext
called CATALOG.HYP. this can be loaded via the 'Open' option from the
'Extras' menu in ST-GUIDE.ACC or installed as the default hypertext in
ST-GUIDE.INF.
Finally
-------
Reboot your computer and we wish you every success using ST-Guide.
Registration
------------
The registered English Master disk includes the following programs
designed for use with ST-Guide:
ST-Guide Lite:
Cut down distribution which may be included by authors with any programs
which use ST-Guide format hypertexts.
HypTree v3 Beta:
Status: Freeware
Programmed by: Martin Osieka
Displays the tree structure of ST-Guide hypertexts
Katalog-Maker:
Status: Freeware
Programmed by: Christoph Spengler
Katalog-Maker makes a simple catalogue of hypertext files. It may be used
instead of the ST-Guide bundled STOOL which is more comprehensive but
harder to use.
RefCheck v1.3:
Status: Freeware
Programmed by: Frank R<>ger
Checks the consistency of the $REF (ALL.REF) file
Remarker v0.4:
Status: Shareware
Programmed by: Christoph Spengler
Remarker is a utility which allows comments to hypertext pages to be saved
in a separate file for each text.
ST-Guide Creator 4:
Status: Freeware
Programmed by: Gregor Duchalski
Includes 5 Tools for ST-Guide:
TXT2STG -Generates an ST-Guide STG format text from an ASCII file.
Text attributes, title generation and heirarchical chapter
referencing can be automatically added.
STGALIAS -Generates alias names for pages.
APPEND -Appends one file to another.
UFP2STG -Changes the PC UFP format Star Trek data to ST-Guide format.
TELE2STG -Converts the Tele Office handbook into STG format. [German]
---------------------------------------------------------------------------
EOF
