Difference between revisions of "localize"

From Bohemia Interactive Community
Jump to navigation Jump to search
m
(not found strings are logged in .rpt)
 
(29 intermediate revisions by 15 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|LOCALIZE]]
+
{{Command|Comments=
[[Category:Scripting Commands OFP 1.97|LOCALIZE]]
+
____________________________________________________________________________________________
[[Category:Scripting Commands OFP 1.46|LOCALIZE]]
 
[[Category:Scripting Commands ArmA|LOCALIZE]]
 
  
 +
| ofp |Game name=
  
<h2 style="color:#000066"> '''localize ''stringName'''''</h2>
+
|1.00|Game version=
 +
____________________________________________________________________________________________
  
 +
| Used to internationalise text messages. A string is returned from [[Stringtable.csv]] (or [[Stringtable.xml]]) which corresponds to the ''stringName''.<br />
 +
If the key couldn't be found, an empty string ({{Inline code|""}}) is returned and an entry is added to .rpt file, for example <tt>String STR_DN_SNAKE not found</tt>. |Description=
 +
____________________________________________________________________________________________
  
'''Operand types:'''
+
| [[localize]] stringName |Syntax=
  
'''stringName:''' [[String]]
+
|p1= stringName: [[String]] |Parameter 1=
  
'''Type of returned value:'''
+
| [[String]] - text found in corresponding entry in stringtable file |Return value=
  
[[String]]
+
____________________________________________________________________________________________
 +
 
 +
|x1= <code>[[hint]] [[localize]] "STR_WEST"; {{codecomment|// -> "BLUFOR" (in Arma2)}}</code> |Example 1=
 +
|x2= <code>[[hint]] [[format]] ["Go %1", [[localize]] "STR_Q_NORTH"]; {{codecomment|// -> "Go North"}}</code> |Example 2=
 +
|x3= <code>{{codecomment|// STR_ACTION_DROP_WEAPON contains "Drop %1"
 +
// STR_SN_RIFLE contains "Rifle"}}
 +
[[hint]] [[format]] <nowiki>[</nowiki>[[localize]] "STR_ACTION_DROP_WEAPON", [[localize]] "STR_SN_RIFLE"]; {{codecomment|// -> "Drop Rifle"}}</code> |Example 3=
  
'''Description:'''
+
____________________________________________________________________________________________
  
Replace string with given '''stringName''' with corresponding localized text from [[Stringtable.csv|stringtable.csv]].
+
| [[isLocalized]], [[BIS_fnc_localize]], [[WFSideText]], [[parseText]], [[Stringtable.csv]], [[Stringtable.xml]] |See also=
 +
}}
  
 +
<h3 style="display:none">Notes</h3>
 +
<dl class="command_description">
 +
<!-- Note Section BEGIN -->
  
'''Example:'''
+
<!-- Note Section END -->
 +
</dl>
  
'''localize''' "STR_DN_FROG"
+
<h3 style="display:none">Bottom Section</h3>
 +
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Command_Group:_Interaction|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 +
 
 +
<!-- CONTINUE Notes -->
 +
<dl class="command_description">
 +
<dd class="notedate">Posted on September 12, 2014 - 11:55 (UTC)</dd>
 +
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
 +
<dd class="note">
 +
The command [[localize]] will strip all HTML tags from your ''stringtable.xml'' entries, however there is a way to trick it by substituting tags with HTML code instead:
 +
<syntaxhighlight lang="xml"><?xml version="1.0" encoding="utf-8"?>
 +
<Key ID="STR_TEST_KK">
 +
<Original><![CDATA[<t color='#ff0000'>This doesn't work</t>]]></Original>
 +
</Key>
 +
<Key ID="STR_TEST_KK2">
 +
<Original>&lt;t color='#ff0000'&gt;This works&lt;/t&gt;</Original>
 +
</Key></syntaxhighlight>
 +
<code>[[hint]] [[parseText]] [[localize]] "str_test_kk";  {{codecomment|// no change of colour}}</code>
 +
<code>[[hint]] [[parseText]] [[localize]] "str_test_kk2"; {{codecomment|// hint content is in red}}</code>
 +
</dd>
 +
</dl>
 +
<!-- DISCONTINUE Notes -->

Latest revision as of 15:31, 2 September 2018

Introduced with Operation Flashpoint version 1.00
  

Click on the images for descriptions

Introduced in

Game:
Operation Flashpoint
Version:
1.00

Description

Description:
Used to internationalise text messages. A string is returned from Stringtable.csv (or Stringtable.xml) which corresponds to the stringName.
If the key couldn't be found, an empty string ("") is returned and an entry is added to .rpt file, for example String STR_DN_SNAKE not found.

Syntax

Syntax:
localize stringName
Parameters:
stringName: String
Return Value:
String - text found in corresponding entry in stringtable file

Examples

Example 1:
hint localize "STR_WEST"; // -> "BLUFOR" (in Arma2)
Example 2:
hint format ["Go %1", localize "STR_Q_NORTH"]; // -> "Go North"
Example 3:
// STR_ACTION_DROP_WEAPON contains "Drop %1" // STR_SN_RIFLE contains "Rifle" hint format [localize "STR_ACTION_DROP_WEAPON", localize "STR_SN_RIFLE"]; // -> "Drop Rifle"

Additional Information

Multiplayer:
-
See also:
isLocalizedBIS_fnc_localizeWFSideTextparseTextStringtable.csvStringtable.xml

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

Bottom Section

Posted on September 12, 2014 - 11:55 (UTC)
Killzone Kid
The command localize will strip all HTML tags from your stringtable.xml entries, however there is a way to trick it by substituting tags with HTML code instead:
<?xml version="1.0" encoding="utf-8"?>
<Key ID="STR_TEST_KK">
	<Original><![CDATA[<t color='#ff0000'>This doesn't work</t>]]></Original>
</Key>
<Key ID="STR_TEST_KK2">
	<Original>&lt;t color='#ff0000'&gt;This works&lt;/t&gt;</Original>
</Key>

hint parseText localize "str_test_kk"; // no change of colour hint parseText localize "str_test_kk2"; // hint content is in red