String Editor – Arma Reforger
Lou Montana (talk | contribs) m (Text replacement - "|Modding|Tools|Official Tools" to "|Modding|Official Tools") |
Lou Montana (talk | contribs) m (Text replacement - "<syntaxhighlight lang="C#">" to "<enforce>") |
||
Line 139: | Line 139: | ||
'''Localized string''' | '''Localized string''' | ||
< | <enforce> | ||
// formatted text example unlocalized | // formatted text example unlocalized | ||
string testName = "Peter"; | string testName = "Peter"; |
Revision as of 20:17, 30 July 2022
Open String Editor
- In Resource Manager, select Editors → String Editor. In the newly open window select File → Open and in the newly open dialog navigate to the wanted *.st file.
- alternatively, search for the *.st file in Resource Manager's Resource Browser tab and open it by double-clicking it.
Translation Workflow
Status | Operation | Editable | If the string is correct | If the string is incorrect |
---|---|---|---|---|
DEVELOPMENT_PENDING | Fill Target_en_us as translation reference | ![]() |
Change the status to DEVELOPMENT_DONE | Fix it directly in the Target_en_us field |
DEVELOPMENT_DONE | Feature development end, translation requirement confirmation | ![]() |
Change the status to PROOFREADING_PENDING | Set the status back to DEVELOPMENT_PENDING and edit the Target_en_us field |
PROOFREADING_PENDING | Proofreaders acknowledgement | ![]() |
Change the status to PROOFREADING_DONE | Unlock the string, set the status back to DEVELOPMENT_PENDING and edit the Target_en_us_edited field |
PROOFREADING_DONE | Proofreaders validation | ![]() |
Change the status to TRANSLATION_PENDING | Unlock the string, set the status back to DEVELOPMENT_PENDING and edit the Target_en_us_edited field |
TRANSLATION_PENDING | Translators acknowledgement | ![]() |
Change the status to TRANSLATION_DONE | Unlock the string, set the status back to DEVELOPMENT_PENDING and edit the Target_en_us_edited field |
TRANSLATION_DONE | Translators validation | ![]() |
Nothing | Unlock the string, set the status back to DEVELOPMENT_PENDING and edit the Target_en_us field |
ID Convention
A translation id must follow a certain convention. Its name is constituted of specific parts in a specific order, and these parts are separated with a dash ( - ):
Name | Description |
---|---|
Game/Product | Game or Project prefix: AR for Arma Reforger, ENF for Enfusion |
Game Project | Optional, subsequential game project code (e.g a DLC, etc) |
Name | PascalCased string name - e.g MyNewWeapon, SplendidActionOnTruck
Name prefixes/suffixes can exist through the usage of underscores ( _ ):
Iterators are part of the name section too, e.g AOSettings_1, AOSettings_2, AOSettings_3 |
Case | Optional, defines if the string MUST remain uppercase or lowercase.
Can be one of:
|
Platform | Used to determine a string that is only present on a certain platform, as opposed to a string that is present on PC.
Can be one of:
|
Naming Convention
- use meta naming; the id must not be a 1:1 of the original text
- e.g: #AR-ExitConfirmation and not #AR-DoYouWantToQuit
- do not use any of:
- trademarks (use a generic name)
- profanities (for obvious reasons)
- write in English
Examples
- ENF-Settings
- AR-MainMenu
- AR-MainMenu_Options
- AR-OFP-MainMenu_Options_RefreshRate-UC-PS
Writing Convention
A translation text must follow some rules and advices to be valid:
The in-game text should always refer to a stringtable and never be written directly in UI/data.
Do not hardcode:
- text in UI
- text in data (config)
- text in code
- text in image (unless it is part of the lore)
- numeric format (e.g 1000 could be written 1,000 or 1 000 in another language)
- date format (2001-12-01, 01/12/2001, 12/01/2021 etc)
- percentage values (25%, 25 %, %25 etc)
Tips
To use arguments (formatted) text, use %1, %2, etc to include argument 1, 2, etc in the text. to display the percentage sign itself (%), use %%. Composed strings should be restricted to the bare minimum and used only when necessary for translation reasons.
Localized string <enforce> // formatted text example unlocalized string testName = "Peter"; PrintFormat("Hello %1, how are you?", testName); // displays "Hello Peter, how are you?"
// #AR-Test is the translation container's id string testName = "Peter"; PrintFormat("#AR-Test", testName); // displays "Hello Peter, how are you?" as well </syntaxhighlight>
Do not assemble multiple parts to make a sentence, as such construction might be invalid in another language:
Bad Example | Good Example | Explanation |
---|---|---|
Hold Space to Take weapon
|
Hold Space to take weapon
|
The translator does not always know that the value is to be used in a composition
The translation itself might not have been thought for this usage in the first place |
Remaining time: 30 seconds
|
Remaining time: 30 seconds
|
|
Heavy Machinegun
|
Heavy Machinegun
|
Some languages place adjectives in a different order; such translation must then be done in one piece |
Create a Stringtable File
Follow these steps to create a new *.st file:
- In Resource browser select a folder where you want to create a new *.st file
- Use right mouse button to open an option and here select GUI String table
- Set the name of the file
- Choose StringTable class and confirm
- A new *.st was created - all there is to do now is to assign this *.st file to the project
- In Workbench select Options
- In newly open window select Game project
- Navigate to Widget Manager Settings → String Tables → String Table Definition and here:
- String Table Source - select the newly created file
- Languages - press the "+" button to add all desired languages.
Add a New Localised String
- Open String Editor
- Write an Id (stringtable entry key) into the insert section
- Press insert, the new container is created
- Select the new container in the list of containers
- In the Details section, add the original text in the Target_en_us field.
- Fall all other necessary details like Comment, Max Length of the text, all matching labels and so on. Details about those items are in this section of tutorial.
- Save changes by using File → Save (or Ctrl + S)
- Go to Table → Build Runtime Table (or Ctrl + B). Only after the following confirmation is the text ready to be used in game.