5.1 Locale |
5.2 Site |
5.3 User |
↩︎ | ↖︎ | ↑︎ | ↘︎ | ↪︎ |
soyMAIL provides three levels of customization.
The [.LANG] directory contains the default English language message file, EN.TXT. This can be copied to another, language-indicative file name and the text of the messages modified appropriately. The content of these files is not intended to be used for site-local changes to messages. Directives in the soyMAIL configuration file are for this purpose. The language files are global components of the soyMAIL distribution.
If you wish to put a language-specific message file together for soyMAIL please contribute it back into the soyMAIL community. Note that messages can be used in all sorts of contexts, particularly inside string literal quotes - both single and double. It is therefore necessary to substitute the HTML entities ", ’, etc., for anything that might be misinterpreted as JavaScript code quotes (i.e. " (0x22) and ' (0x27)). If soyMAIL reports a message file fatal error the SOYMAIL$WATCH facility (see 7.1 Run-time Problem Solving) can be used to help determine the underlying problem.
The [.HELP] directory contains the default English language, on-line, content-sensitive help files. These contain the help information and HTML markup. Each file name contains an indication of the language, where the English version might be HELP_EN.HTML, the French language version HELP_FR.HTML, etc. These files are dynamically accessed and composed by soyMAIL when a user accesses on-line help. The users language option is used to search for a possible file with that language indicated in the name. If not found it supplies the default English language version. One or (preferably) all of each of the help topic files can be copied to a language-specific instance and translated. As with message files please make any such resources available to the general soyMAIL community.
The soyMAIL configuration file has several directives intended to allow site-specific information to be included in soyMAIL pages at appropriate locations.
The SMTP host and apparent source of messages can be specified.
The obviously VMS-specific portions of soyMAIL (e.g. the VMS options panel, the extract button) may be 'hidden'.
Users options may be defaulted and overridden.
For example; to provide a language default other than English, perhaps German:
To force a site to use a particular (perhaps corporate) theme
The user option to specify a "From:"address line can be disabled with
In addition a site-specific help file can be created in the [.HELP] directory. It must be named SITE_language>.HTML (note the leading underscore, which means it will not be overwritten by a soyMAIL update, and the language component). If this file is found during help composition it is appended to the primary help page (that obtained in help by using the [help] button) and is intended for providing site information and/or links of local relevance.
The options button in the main menu provides on-line access to user option settings.
In addition there are some less commonly used options that must be manually edited into the options file. The file is named SOYMAIL_OPTIONS.TXT and located in the user's mail area (with MAIL.MAI). Once inserted they are propagated during on-line option changes.
Directive | Description |
---|---|
[accessability-1] | enables a heavy underscore beneath each line of the message listing (accessability [sic] :-) |
[message-attachment-panel] | 0 below the message (default), 1 above |
[options-panel-expand] | 0 user options panels 'just wide enough', 1 panels 100% of main panel (Wm(B)K special :-) |
[preview-size] | the maximum number of characters displayed in a message preview (default 1024) |
↩︎ | ↖︎ | ↑︎ | ↘︎ | ↪︎ |