Overview. The Dita scanner reads in the original Dita-files and writes out localized files, without breaking the structure of the original files.
The Dita scanner options allow the user to specify how to localize Dita files. The most important settings are the following:
This plug-in is available in Multilizer Enterprise. To get an evaluation version for other Multilizer versions, contact sales(at)multilizer.com.
If elements that user wants to localize contain nested tags, they will be localized too. Nested tags are shown in localizable text and can be modified.
Nested tags can be
When building the localized files, Multilizer gives warnings about all actions performed on nested tags.
The Dita scanner options has the following four tabs:
Scan Preview Data. Specify whether to scan or not the preview data. Preview data is used for the visualization of the original and localized Dita file. The visualization requires a separate Visual Editor plug-in.
Context mode. Dita scanner provides two methods for identifying localizable data:
The use of unique attribute values for identifying localizable data is strongly encouraged.
Native language. Specifies the native language that is used in the target . Set this to match the language in the original document
Default language. Specifies the default language. It is the language that is used in the build process, if there is no translation given in the the build language. The translation search order is following: first the build languages, then the country neutral languages (if the build language is country specific), then the default language. If no translation is found then the native value is used. For example if the project contains English, German and German (Austria) and the build language is German (Austria) and the default language is English the search order is German (Austria) - German - English - native.
Native encoding. Specifies the native encoding that is used in the target with each character set.
Encoding list. Contains the encodings to be used in the localized files. To change the value right click the line and select a new value.
Output directory. Specifies the directory where the localized files will be created. This is the directory where Multilizer creates the localized output files and sub directories. You can control the name of the localized files and directories by setting Type, Coding, Locale separator and Country separator.
Type. Specifies how and where MULTILIZER creates the localized file version(s). Possible options are:
|Subdirectory||Create localized file(s) in sub directories named by language and locale.|
|Bundle name||Append the language and locale information in the output file name.|
|File extension||Replace the original file extension with language and locale information.|
Coding. Selects file name initial coding style. Possible values are:
|ISO||ISO standard coding style.|
|.NET||Microsoft .Net coding style.|
|Windows||Windows coding style.|
Write BOM. Specifies whether to write byte order mark (BOM) characters to the localized DITA file. By default, BOM characters are written when output is Unicode and the input contains BOM characters as well. The user can also choose not to write BOM characters at all or write BOM characters only when the output is Unicode.
Not necessarily all nodes in Dita-files contain localizable data. The names of those tags that contain localizable text can be specified in elements tab. If the localizable tags contain child nodes, they will be localized as well.