Difference between revisions of "Stringtable.xml"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Example Format:: Korean and Japanese examples; from google translate so confirmation always welcome)
(Dialogs: Fix info)
Line 78: Line 78:
  
 
====Dialogs====
 
====Dialogs====
As with Description.ext, the preprocessor will replace the values in configs as long as the key name is formatted correctly (see above) :
+
As with Description.ext, the entry must start by "$STR_" to work, and the preprocessor will replace the values in configs as long as the key name is formatted correctly (see above) :
  
 
<code>class RscText_1012: RscText
 
<code>class RscText_1012: RscText
 
{
 
{
 
idc = 1012;
 
idc = 1012;
text = $STR_myTag_someLabelText;
+
text = "$STR_myTag_someLabelText";
tooltip = $STR_myTag_someTip;
+
tooltip = "$STR_myTag_someTip";
 
...</code>
 
...</code>
 
  
 
====CfgRadio====
 
====CfgRadio====

Revision as of 15:45, 22 April 2017

Stringtable.xml

String tables are used to make internationalization easier for the game. They are used in addons, missions, and scripts, and are located in the root of the mission or addon folders.

Any strings that are used in the game can be kept separate from the code, and can therefore easily be edited and expanded into different languages. Instead of using strings directly in the code, you are using a variable. This variable will then contain the actual string, read from stringtable.xml, with the language that's being read depending on the game settings.

Example Format:

<?xml version="1.0" encoding="utf-8" ?> <Project name="Any Name"> <Package name="Mission One"> <Container name="Some Words"> <Key ID="str_myTag_Yes"> <Original>yes</Original> <English>yes</English> <Czech>ano</Czech> <French>oui</French> <German>ja</German> <Italian>sì</Italian> <Polish>tak</Polish> <Portuguese>sim</Portuguese> <Russian>да</Russian> <Spanish>sí</Spanish> <Korean>네</Korean> <Japanese>はい</Japanese> </Key> <Key ID="str_myTag_No"> <Original>no</Original> </Key> </Container> <Container name="Another Container"> <Key ID="str_myTag_another_key"> <Original></Original> </Key> <Key ID="str_myTag_formatted"> <Original>Hello, %1.</Original> </Key> <Key ID="str_myTag_structured"> <Original>Some text &lt;t color='%1'&gt;%2&lt;/t&gt;</Original> </Key> </Container> </Package> </Project>

  • Replace myTag in str_myTag_someKey with your OFPEC tag or other means of personal identification so other addon and mission string names won't collide, potentially breaking your mission - this is just good practice
  • Package and container names appear to only be for organizational use; use them for your own sanity

Template:Important

Usage

Scripts

A string from stringtable.xml can be retrieved and used in a script by using the localize command:

hint ( localize "str_myTag_Yes" );

"Marker1" setMarkerTextLocal localize "str_myTag_SiezeTheTown";

hint format [ localize "str_myTag_formatted", "Dave" ]; // "Hello, Dave."   // str_myTag_formatted: <Original>Hello, %1.</Original>


The stringtable can also hold Structured Text xml tags, if the tag characters < > are encoded as Template:Inline code and Template:Inline code see: HTML Entities

hint parseText format [ localize "str_myTag_structured", "#FF0000", "with Color!" ]; //show 'with Color!' in Red   // str_myTag_structured: <English>Some text &lt;t color='%1'&gt;%2&lt;/t&gt;</English> // after format & parseText: Some text <t color='#FF0000'>with Color!</t>


Description.ext

Stringtable values can be used in the Description.ext config by typing the key as such, Template:Inline code, and without quotation marks; these will be replaced by the preprocessor:

onLoadName = $STR_myTag_missionName; onLoadMission = $STR_myTag_loadMissionText; overviewText = $STR_myTag_overviewText; overviewPicture = $STR_myTag_overviewImage;


Dialogs

As with Description.ext, the entry must start by "$STR_" to work, and the preprocessor will replace the values in configs as long as the key name is formatted correctly (see above) :

class RscText_1012: RscText { idc = 1012; text = "$STR_myTag_someLabelText"; tooltip = "$STR_myTag_someTip"; ...

CfgRadio

Stringtables can also be used for sounds and radio sentences in CfgRadio, also residing in Description.ext:

class CfgRadio { sounds[] = {}; class RadioMsg1 { name = ""; sound[] = {$STR_myTag_sound_RadioMsg1, db-100, 1.0}; title = $STR_myTag_RadioMsg1; }; }; // str_myTag_sound_RadioMsg1: <English>\sound\radiomsg1_en.ogg</English> // <Czech>\sound\radiomsg1_cz.ogg</Czech> // str_myTag_RadioMsg1: <English>I am ready for your orders.</English>


Multiplayer

Template:Informative

A string name could be passed to all clients for localized display: str_myTag_teamKillers: <English>&lt;t color='#dd1111'&gt;Team Killing is NOT Tolerated&lt;/t&gt;&lt;/ br&gt; and will result in a Permanent Ban!</English>

// Server if ( isServer ) then { ["str_myTag_teamKillers","TAG_fnc_localHint"] call BIS_fnc_MP; };

// Clients TAG_fnc_localHint = { if ( ! isDedicated ) then { hintSilent parseText (localize _this); }; };


Languages

Arma 3
English, Czech, French, Spanish, Italian, Polish, Portuguese, Russian, German, Korean**, Japanese** (**region exclusive)
Arma 2 OA
English, Czech, French, Spanish, Italian

Comments