Template:Lang/doc: Difference between revisions
No edit summary |
Added detail on language selection and improved general formatting |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
== Overview == | == Overview == | ||
Template for retrieving localized strings from their relevant | 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 per language, such as [[Data:Lang_en.json]] for English. | |||
== Usage == | |||
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 === | |||
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. | |||
=== Examples === | === Examples === | ||
==== Retrieve word by | ==== Retrieve word by key ==== | ||
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> | ||
==== Retrieve string by label ==== | ==== Retrieve string by label ==== | ||
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> | ||
<templatedata> | <templatedata> | ||
Line 28: | Line 36: | ||
}, | }, | ||
"label": { | "label": { | ||
"description": "Used to search for the string by its English | "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": [ | |||
"key", | |||
"label", | |||
"lang_code" | |||
] | |||
} | } | ||
</templatedata> | </templatedata> | ||
<noinclude>[[Category:Template documentation]]</noinclude> | <noinclude>[[Category:Template documentation]]</noinclude> |
Latest revision as of 09:24, 18 September 2024
Overview[edit source]
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 per language, such as Data:Lang_en.json for English.
Usage[edit source]
Use of the Lang
template comes in two forms, either by setting the key
argument or the label
argument (but not both!).
Language Selection[edit source]
Selection of the language is based off of the URL sub-page name, defaulting to English if none is found. For example, Abrams/es
will use language code "es", which is Spanish.
Alternatively, lang_code
can be used to override of the automated language selection.
Examples[edit source]
Retrieve word by key[edit source]
English string: {{Lang|key=BonusClipSize_label}} ->
Ammo
Spanish string: {{Lang|key=BonusClipSize_label|lang_code=es}} ->
de munición
Retrieve string by label[edit source]
English string: {{Lang|label=Ammo}} ->
Ammo
Spanish string: {{Lang|label=Ammo|lang_code=es}} ->
de munición
Parameter | Description | Type | Status | |
---|---|---|---|---|
key | key | Attribute key to directly retrieve the localized string from its JSON file
| String | optional |
label | label | Used to search for the string by its English localized string instead of using the attribute key directly
| String | optional |
lang_code | lang_code | 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.
| String | optional |