Files
FireBee_Setup/tools/st-gui15

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