Configuration
As the recommended standard for datatypes, the preference file for the
hypertext.datatype is called `hypertext.prefs' and is searched first in the `
PROGDIR:Prefs/DataTypes' and then in `Env:DataTypes' directory. The following
options are currently available using ReadArgs() argument parsing with the
following templates. Each template is introduced with a prefix. This prefix has to
be the very first in a line :
- PATH : PATH/M/A
- PATH
- Specifies the directories, which should be used for searching for any
documents or embedded objects. Same as AmigaGuide PATH environment
variable.
- KEYFILE : KEYFILE/A
- KEYFILE
- Specifies the full path of the HTDS keyfile. This keyfile is needed
to use HTDS without restrictions. See Registration .
- GLOBAL : SHOWLINK/S,GLOBALTOC/S,ENDLESSTABCYCLE/S,SECURE/S,REXXSUFFIX/K,
LISTINDENT/N/K,NODEINDEXING/S
- SHOWLINK
- If this option is set, the link address will be shown in the window
title, if the user press down the link button. So the user can check,
where the link point to it, before following the link.
This feature is implemented for the upcoming html.datatype subclass. I
know that almost all Web-Browser show the linked address just by moving
the mouse over the link. But this behaviour can't be implemented due to
the fact BOOPSI handle input events. Any BOOPSI gadget must be active
to get input events, but activation of a BOOPSI gadget is subject of
the application, which uses the BOOPSI gadget (MultiView).
- GLOBALTOC
- If this option is set then any HyperText object, which hasn't a Table
of Contents entry, the contents button is set to the `HTDS_TOC.hguide'
document in the directory `Help:<language>'.
You can use the provided ARexx script `AddTOCEntry.rexx' to add the
object currently displayed in MultiView to this global table of contents.
- ENDLESSTABCYCLE
- If this option is set, tabcycle is endless. That means, if the last
link is active and you cycle forward, the first link is activated and
vice versa.
- SECURE
- If this option is set, you cannot start any program or ARexx script
from a link.
- REXXSUFFIX
- This option is for compatibility with AmigaGuide. The
amigaguide.datatype uses a suffix of `guide', where the HyperGuide uses
normal `rexx' suffix. So if you want AmigaGuide compatibility set this
option to `guide'.
- LISTINDENT
- Specifies the default number aof spaces to indent any list related
indention.
- NODEINDEXING
- Enables node indexing for subdatatypes, which supports multiple nodes
within one document/file. Currently only the HyperGuide datatype
supports this.
- BACKGROUND : DISABLEBGPIC/S,DEFBGPIC/K,DEFBGPEN/N/K,DEFFGPEN/N/K,DEFALTFGPEN/N/K,
DEFBGCOLOR/K,DEFFGCOLOR/K,DEFALTFGCOLOR/K
- DISBALEBGPIC
- disables any background picture. If you don't want background picture
even for documents you haven't the control turn this option on.
- DEFBGPIC
- specifies a default background picture for all hypertext objects.
- DEFBGPEN
- specifies a default background pen for all hypertext objects.
- DEFFGPEN
- specifies a default foreground (text) pen for all hypertext objects.
- DEFALTFGPEN
- specifies a default alternate foreground (text) pen for all hypertext
objects. This pen is used for foreground, if the foreground pen equals
to the background pen.
- DEFBGCOLOR
- same as `DEFBGPEN' except you can specify a color expression.
- DEFFGCOLOR
- same as `DEFFGPEN' except you can specify a color expression.
- DEFALTFGCOLOR
- same as `DEFALTFGPEN' except you can specify a color expression.
- NODEINDEX : ENABLE/S,DDIR=DATABASEDIR/K,MINSIZE/N/K,EXCLUDEDEVS/K/M
- ENABLE
- enables node indexing
- DATABASEDIR
- Specifies the directory to store the index files for each indexed
document.
- MINSIZE
- specifies the minimum size of a document to be indexed. The default
value is 10K.
- EXCLUDEDEVS
- is used to specify a list of device (path) names, which shouldn't
generally indexed. For example "Ram Disk:" is a potential candidate.
See Also
Node Indexing , Color Expressions
HTML Conversion by html.export V40.4 , HTDS HTML-Export Class (C) 1997 by Stefan Ruppert