When writing hypertext, give some thought to basic terminology, and try to
phrase your writing to use consistent concepts and terms which can be explained
in a paragraph or so. These concepts and terms become minor or topic headers,
with corresponding topic references used throughout the text.
Consistency Will Be Rewarded
You may not have noticed the high degree of precision or consistency in the
help file cross-referencing, but it is there. For example, because Printer
Errors is not a sub-string of the word Printer Error, it will not
function as a topic reference. If you want to use the phrase, you may have to
key on an alias, just a portion of the phrase, or change the wording of
your thoughts to incorporate the prevailing form. On one hand, this may cause
some distortion, but it could also lead to breakthroughs of clarity in thought.
Let us know which it does for you.
Converting to hypertext
Any document that uses consistent terminology can be converted to
Proceed as follows:
For an explanation of how to create the topic references, and headers, see
hypertext objects starting with
Compiling a document links each
Select the Translate
command, then select the
document to compile. You can interrupt hypertext compilation at any time
without harm to the document.
Smart Characters scans the hypertext document twice. The Scanning hypertext
Line ... pass extracts each topic header and its location and builds a
topic table in a new document window. The Re-
hypertext Line ... pass updates each
topic reference pointer(12-
in the document with the corresponding topic header location. If a topic header
is not found in the topic table, Smart Characters writes an error message after
the topic table in a new document window.
Check for Errors
Examine the new document window and save it to a file named
FileName.err. The entries at the end of the file are error messages
preceded by the line number that made the invalid reference. Edit the document
to eliminate errors and recompile.
Copyright © 1996 Apropos, Inc.