Editing Template:Lang/doc

Warning: You are not logged in. Once you make an edit, a temporary account will be created for you. Learn more. Log in or create an account to continue receiving notifications after this account expires, and to access other features.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
== Overview ==
== Overview ==
This template retrieves localized strings from their relevant JSON file, based on the language code. If no language code is found in the URL, it defaults to english.
Template for retrieving localized strings from their relevant JSON file, based on the language code in the URL. If no language code is found in the URL, it defaults to English.


Localizations of this type come from the game files and have a file (Data:Lang xx.json) per language, such as [[Data:Lang en.json]].
Localizations of this type come from the game files and have a file per language, such as [[Data:Lang_en.json]] for English.


=== Usage ===
== Usage ==
Use of the {{tl|Lang}} template comes in two forms, either by setting the <code>key</code> argument or the <code>label</code> argument '''(but not both!)'''.
Use of the <code>Lang</code> template comes in two forms, either by setting the <code>key</code> argument or the <code>label</code> argument '''(but not both!)'''.


=== Language selection ===
=== Language Selection ===
Selection of the language is based off of the URL sub-page name, defaulting to english if none is found. For example, <code>Abrams/es</code> will use language code "es" (spanish).
Selection of the language is based off of the URL sub-page name, defaulting to English if none is found. For example, <code>Abrams/es</code> will use language code "es", which is Spanish.


Alternatively, <code>lang_code</code> can be used to override of the automated language selection.
Alternatively, <code>lang_code</code> can be used to override of the automated language selection.
Line 14: Line 14:
=== Examples ===
=== Examples ===
==== Retrieve word by key ====
==== Retrieve word by key ====
English string: <code><nowiki>{{Lang|key=BonusClipSize_label}}</nowiki></code> Output: {{Lang|key=BonusClipSize_label}}
English string: <code><nowiki>{{Lang|key=BonusClipSize_label}} -></nowiki></code> {{Lang|key=BonusClipSize_label}}<br><br>
 
Spanish string: <code><nowiki>{{Lang|key=BonusClipSize_label|lang_code=es}} -></nowiki></code> {{Lang|key=BonusClipSize_label|lang_code=es}}<br><br>
Spanish string: <code><nowiki>{{Lang|key=BonusClipSize_label|lang_code=es}}</nowiki></code> Output: {{Lang|key=BonusClipSize_label|lang_code=es}}


==== Retrieve string by label ====
==== Retrieve string by label ====
English string: <code><nowiki>{{Lang|label=Ammo}}</nowiki></code> Ouput: {{Lang|label=Ammo}}
English string: <code><nowiki>{{Lang|label=Ammo}} -></nowiki></code> {{Lang|label=Ammo}}<br><br>
 
Spanish string: <code><nowiki>{{Lang|label=Ammo|lang_code=es}} -></nowiki></code> {{Lang|label=Ammo|lang_code=es}}<br><br>
Spanish string: <code><nowiki>{{Lang|label=Ammo|lang_code=es}}</nowiki></code> Output: {{Lang|label=Ammo|lang_code=es}}


<templatedata>
<templatedata>
{
{
"params": {
"params": {
"lang_code": {
"key": {
"description": "Optional language code to override the language. See Data:LangCodes.json.",
"description": "Attribute key to directly retrieve the localized string from its JSON file",
"example": "es, cs, pt-br",
"example": "BonusClipSize_label",
"type": "string"
"type": "string"
},
},
"key": {
"lang_code": {
"description": "Attribute key to directly retrieve the localized string from its JSON file.",
"description": "Two-letter language code for selecting language of string. Note that this should not usually be used, as the lang code will be pulled from the URL subpage.",
"example": "BonusClipSize_label",
"example": "en",
"type": "string",
"type": "string",
"required": true
"default": "Defaults to \"en\" (English), or if the URL has the code at the end, it will use that"
},
},
"label": {
"label": {
"description": "Used to search for the string by its english localized string instead of using the attribute key directly.",
"description": "Used to search for the string by its English localized string instead of using the attribute key directly",
"example": "Ammo",
"example": "Ammo",
"type": "string"
"type": "string"
}
}
},
},
    "description": "",
"paramOrder": [
"paramOrder": [
"key",
"key",
"label",
"label",
"lang_code"
"lang_code"
],
]
"description": " ",
"format": "inline"
}
}
</templatedata>
</templatedata>
<includeonly>[[Category:Language templates]]</includeonly><noinclude>[[Category:Template documentation]]</noinclude>
<noinclude>[[Category:Template documentation]]</noinclude>
Please note that all contributions to The Deadlock Wiki are considered to be released under the Creative Commons Attribution-NonCommercial-ShareAlike (see Deadlock:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!
Cancel Editing help (opens in new window)
Preview page with this template

Pages included on this page: