XML exchange format¶
The XML format used by the l10nmgr is a simple XML format that can be used with all state-of-the-art localisation and translation tools. The Localization Manager ships with the required settings files that specify translatable and non-translatable elements. Currently settings files are available for the following tools: across, DéjàVu, SDL Trados and SDL Passolo. Settings files for other tools can easily be set up. The file format for the export & import of translatable data of a TYPO3 website is a localization-friendly XML format. The default encoding of XML files is UTF-8. Context information One important feature of the XML format is that the translatable contents (<data> elements) are grouped according to the context of the page on which they occur (<pageGrp>). To get a preview of the source web page, the URL can be reassembled by combining the <baseURL> with the ID attribute of the <pageGrp> element and the ID of the source language (<sysLang>):
http://<baseURL>/index.php?id=pageGrp:id&L=<sysLang>
Structure¶
Element name |
Semantics |
---|---|
<TYPO3L10N> |
Root element |
<head> |
Header with meta information |
<t3_l10ncfg> |
ID of Localization Manager configuration used for the export. |
<t3_sysLang> |
ID of target language (equal to IDs of website languages) |
<t3_sourceLang> |
ISO-639-1 language code for source language |
<t3_targetLang> |
ISO-639-1 language code for target language |
<t3_baseURL> |
Base URL of TYPO3-Website to be translated |
<t3_workspaceId> |
ID of workspace from which has been exported |
<t3_count> |
Number of exported data sets |
<t3_wordCount> |
Word count of source text |
<t3_internal> |
Internal messages |
<t3_skippedItem> |
Elements skipped during export |
<t3_description> |
Error messages |
<t3_key> |
Key of skipped element |
<t3_formatVersion> |
Version number of XML format |
<pageGrp> |
Grouping element that embraces all translatable elements of a page. The id- attribute indicates the page ID. The sourceUrl attribute indicates the url of the source language webpage. |
<data> |
Translatable contents. Used attributes: table = database table from which contents has been exported elementUid = UID of localizable data set key = Trigger for localization command. Syntax: table:NEW/ t3_sysLang/elementUid:fieldname (Initial localization) table:elementUid:fieldname (Update localization, elementUid is ID of data set to be updated) |
<data> can further contain all kind HTML elements. Number and type of elements can vary for every TYPO3 installation. |