Configuring Amaya

Amaya uses different configuration files to get initial values for global parameters, dialogue strings, shortcuts, windows size and windows position. You can change the default values by creating or updating the following configuration files:

Home Page

You can change the default home page of Amaya by editing the HOME_PAGE variable in the registry file.

Document Windows

Parameters related to the particular schema HTML are stored in the HTML.conf file. In that file there are different sections, one by Presentation Schema, that allows user to control position and size of document windows defined by the presentation schema:

For each view, in both the open and geometry sections, there is a list of four parameters specifying the x_position, the y_position, the width, and the height of that view. The value of the x_position and the y_position are automatically incremented by Amaya to display diffent document views at different places on the screen.

Default Colors

User interface colors have default values that can be modified in the registry file of the user. The following parameters are used:

To take into account any change to these options, you need to restart Amaya.

Colors Palette

CSS allows the user to color documents with one of the 152 predefined colors. During initialization, the editor loads its color table to present them in a palette. If you have problems with your color resources, you can reduce by half the number of colors loaded by the editor by editing the following option in the registry file:

To take into account any changes to this option, you need to restart Amaya.

Dialogue Language

The dialogue language is defined by the variable LANG in the registry file. The default language is English (value en_US). At the moment, only two languages are available: English (en) and French (fr). When launched, Amaya loads dialogue files according to the current dialogue language: en- files or fr- files. These dialogue files are located in the directory Thot/config.

In Thot, a document is specified according to a schema. In Amaya, the dialogue message that are displayed when parsing a document or when saving it under a specific schema are given in the Thot/amaya/HTML.code file, where the code suffix is a language abbreviation (e.g., en or fr). This file has 4 sections:

It's possible to adapt Amaya to new ISO-Latin-1 languages by writing corresponding dialogue files. These dialogue files have to be located in the same directory Thot/config, and must use the right ISO 639 code as a prefix (it- for Italian, de- for German, etc.). The specific HTML.code file also has to be created.

Printer command

The standard printer command is defined by the THOTPRINTER registry file variable. If this command is not well adapted of the current system, the user have to update it before printing using the "Print Setup" command or change this variable in the registry file.

Keyboard Shortcuts

It is useful to be able to invoke menu commands directly from the keyboard. The Thot toolkit provides a facility that let user accomplish this by means of an application keyboard shortcuts file. This file defines a list of associations between a keyboard sequence an the invoked corresponding command.

The syntax used to define an association is:

 Directive = KeySeq ':' IdentCommand ;
 KeysSeq = KeySet [ ',' KeySet ] ;
 KeySet = [ Modifier ] [ 'Shift' ] Key ;
 Key = '<Key>' KeyValue / '<Key>' SpecialKey ;
 Modifier = 'Ctrl' / 'Alt' / 'Meta' ;
 KeyValue = 'a' / 'b' / ... ;
 SpecialKey = 'Escape' / 'Delete' / 'Space' / 'BackSpace' / 
              'Return' / 'Up' / 'Down' / 'Left' / 'Right' / 
              'Home' / 'End' / 'F1' / ... / 'L1' / ... / 'R1' / ... ;
 IdentCommand = 'TtcInsertChar(' Char ')' / NAME '()' ;
 Char = KeyValue / OctalValue ;  OctalValue = '\' NUMBER ; 

For an example, see the standard amaya.keyboard file, which is located in the config directory.

The list of available commands is:


Irène Vatton
Webmaster
$Date: 1997/12/19 12:02:17 $