Perle Systems DS1 - Manual (Page 42)

Language support
42 IOLAN Device Server User’s Guide, Version 1.0
5. To set an individual user to the new language, go to the Users menu and, in the Language field
select Customlang . In the CLI (only) you can set individual users or all users to the new
language; see the set user * command.
6. The user will see the change of language when he/she logs out ( Main Menu , Sessions Menu ,
Logout ) and logs back into the Device Server. If, as Admin user, you change your language
setting to Customlang , you will see the text menus display in the new language when you save
and exit the Change User form.
Note: If you download a new software version, you can continue to use your language unchanged;
however, we recommend translating the new strings, which will be added to the end of the
language file. A Reset to Factory Defaults will reload the Customlang as English.
On successful download, the Customlang in the Device Server will be overwritten by the
new language.
Translation Guidance
To help you with your translation, of supplied ASCII text language files we offer the following
guidance:
z The Device Server will support languages other than English (and the supplied German and
French languages). The English language file, english.txt, displays the character length of each
line at the beginning of the line. If a translated line goes over that character length, it will be
displayed truncated in the Menu, CLI, or WebManager.
z Translate line for line, do not omit lines if you do not know the translation; leave the original
untranslated text in place. Also, you must maintain the same sequential order of lines. It is a good
practice to translate the file using a text editor that displays line numbers, so you can periodically
verify that the line sequence has not changed from the original file (by comparing it to the
original file).
z Keep all translations in quotes, otherwise the line will not display properly.
z Each line must end with a carriage return.
z If a line contains only numbers, for example 38400, leave that line in place, unchanged (unless
you are using a different alphabet).
Software Upgrades and Language Files
If you receive a software upgrade for the Device Server, the language files supplied on the
supplemental diskette/CD might also have been updated. We will endeavour to provide a list of those
changes in another text file on the same supplemental diskette/CD.
Note: The upgrade of your software (firmware) will not change the display of the language in the
Menu, CLI, or WebManager.
If you are already using one of the supplied languages, French or German, you probably want to
update the language file in the Device Server. Until you update the Device Server with the new
language file, new text strings will appear in English.
If you are already using a language translated from an earlier version, you probably want to amend
your translation. When a language file is updated, we will try to maintain the following convention:
1. New text strings will be added to the bottom of the file (not inserted into the body of the existing
file).
2. Existing text strings, if altered, will be altered in sequence; that is, in their current position in the
file.
3. The existing sequence of lines will be unchanged.
4. Until you have the changes translated, new text strings will appear in the Menu, CLI, or
WebManager in English.