Texts in a properties file are simple value-key pairs separated by an equal sign (=). However, to enable proper translation for these texts, you have to classify the texts with additional information, at least with the text type. You must place the additional information in the line directly above the text element, beginning with the hash sign (#).
The complete line must have one of the following patterns (text type is mandatory, maximum length and additional context information are optional):
-
#<TextType> -
#<TextType>,<MaximumLength> -
#<TextType>,<MaximumLength>:<AdditionalContextInformation> -
#<TextType>:<AdditionalContextInformation>
Text Type (Mandatory)
You need to assign a text type to each text. The text type indicates to which user interface element the text is related. You can use the following main text types:
-
For short texts (up to 120 characters) :
Text Type
Description
XACTAccessibility
XALTAlternative text
XBCBBreadcrumb step
XBLIBullet list item text
XBUTButton text
XCAPCaption
XCELCell
XCKLCheckbox
XCOLColumn header
XCRDTabstrip
XDATData navigation text
XFLDLabel
XFRMFrame
XGLSTerm
XGRPGroup title
XHEDHeading
XLGDLegend text
XLNKHyperlink
XLOGLog entry
XLSTList box item
XMENMenu header
XMITMenu item
XMSGMessage
XRBLRadio button
XRMPRoadmap step
XROWTable Row Heading
XSELSelection
XTBSTab strip text
XTITTable title
XTNDTree node text
XTOLQuick info text
XTXTGeneral text
-
For long texts (more than 120 characters):
Text Type
Description
YACTAccessibility (long)
YBLIBullet list item text
YDEFDefinition
YDESDescription
YEXPExplanation
YFAAFAQ answer
YFAQFAQ
YGLSGlossary definition
YINFInformation
YINSInstruction
YLOGLog entry
YMSEError message
YMSGMessage text (long)
YMSIInformation message long
YMSWWarning message
YTECTechnical text
YTICTicker / Marquee
YTXTGeneral text long
-
For text elements that are not supposed to be translated, use the text type
NOTR.
Maximum Length (Optional)
If necessary, you can provide the maximum text length for translation. It must be greater than the source text length and must never exceed 255.
To ensure that translators have enough space for the translated texts, set an appropriate maximum text length for translation according to the source text length:
|
Length of Source Text in Characters |
How Is the Maximum Text Length for Translation Calculated? |
|---|---|
|
< 8 |
Multiply by 5; minimum 12 characters |
|
8 - 30 |
Multiply by 3 |
|
> 31 |
Multiply by 1.5 |
Additional Context Information (Optional)
You can also add a comment for the translator. This is recommended for all texts.