Translator Format for 4.6xx Maps - E4000029 - 24 April 2001

From 4.619 the MAPMAKE program will support printing maps in a simplified version of the MAPPOST format that produces plain text files that can be translated into other languages without the need for DP4 knowledge. The MAPPOST program will have an option to post these files back and will create maps in the new language combining the text from the translation with the other properties of the base map.

The facility is used as follows:

  1. Extract the maps' text in the new "Translator" format.
  2. Translate the file from the original language to the new language.
  3. Post the translated file back into a new language code with MAPPOST.

Extraction

Extraction is performed with the DP4 MAPMAKE program. Run the MAPMAKE program and specify the database which contains the mapsets that you want to have translated.

If the mapset already has maps defined for more than one language, you may select which of these languages you want to use as the base for the translation by setting the language number to the required value. This can be done via the Set Language option on the initial MAPMAKE menu.

In each case, in the Map Printing dialog, in the Print Format field, choose Translator Format.
Enable the "Include Help Messages" option unless you specifically do not want to translate these.

In the standard DP4 Print dialog, define an output file to receive the data.

Translation Editing

Using an editor program which can process plain text files, edit the file which was output in the phase above. Replace each item of text in the initial language with text in the new language. Make sure that you only alter text in help messages or between quotes for controls. Be careful not to translate the keywords used by MAPPOST such as Static,Button,Edit etc.

At the start of the file is a line which begins #language. This will be emitted with the value unset. This must be changed to be the number of the DP4 language for which the translation is being made.
Do not change the line marked #translation.

Importing the Translation

When all the required changes have been made to the translation file, it can be put into the database using MAPPOST. The translation file is posted in the same manner as normal 'mappost' files.

As the translation file is processed, for each map specified, MAPPOST accesses the current map which is defined for the base language (defined by the #translation line) and creates a version of that map for the new language (defined by the #language line). No map properties are taken from the translation file. The new map will use the properties of the base map, including size.

For each field within the base language map, MAPPOST expects to find a corresponding field in the translation file.

When processing has finished, MAPPOST will terminate as normal.

Limitations

MAPPOST creates the translated version of the map by combining the properties of the maps and controls from the base language with the text in the new language. If you make changes to the base language map you will need to repeat the translation process.

The sizes and positions of all the controls in the translated map are the same as in the base language. Therefore you should allow additional space when designing maps that are to be translated. It is suggested that you allow at least 100% extra for controls whose text consists of a short single word, 50-70% extra for short single words, and 30% extra for longer phrases. In future an option may be provided to report on controls that are not large enough for the text they contain.

The font, and therefore the character set, for the translated map is assumed to be the same as in the base language. This may well cause problems when translating between languages that typically use different character sets. In future a facility to automatically translate fonts into an appropriate character set will be provided.

DP4 Version Compatibility

4.616+ (with updated DLLS). You must post the file trans.m6 to your system database using MAPPOST.

These are the 4.619 released versions (with the patch for k4000043)

Downloads

4.619 Win32 MAPPOST,MAPMAKE