Template:Transl

Template documentation[view] [edit] [history] [purge]

This template is used to indicate that a text is transliterated from a particular script into the Latin script (that is, common English alphabetical). Optionally, it can be transliterated according to a specific transliteration scheme.

By definition, it is only to be used to show transliterations scripts from non-Latin scripts, such as Greek (α), Cyrillic (Д) and Arabic (ج‎).

It adds a tooltip label naming the scheme and normally renders the text in italics. It also invisibly tags it for web browsers, so that they may use a more appropriate font or screen readers to use a particular kind of pronunciation, and so on.

{{transl}} is similar to {{lang}}, which tags non-transliterated text (written in original script). It often used alongside that template, to allow non-readers of the script to interpret the text.

For example, the following code tags a Ukrainian name and its transliteration according to the Ukrainian National scheme.

Markup	Renders as
{{lang|uk|Ярослав Рудницький}} ({{transl|uk|ukrainian|Yaroslav Rudnytskyi}})	(Yaroslav Rudnytskyi)

Rationale

This template is intended to unify all "transliteration" templates, such as {{IAST}} and {{ISOtranslit}}. These templates are still usable, but they just transclude or are redirected back to {{transl}}. For example, (e.g. {{IAST|saṃskṛtam}} is a shortcut for {{transl|sa|IAST|saṃskṛtam}}; others like ArabDIN are handled natively by this template: {{transl|ar|DIN|...}}).

This template is kept separate from {{lang}} to address formatting issues (via css classes) and identification of transliteration schemes used. Ultimately, if these concerns are smartly addressed in the css file and/or in {{lang}}, using {{transl|xx|...}} should be equivalent to using {{lang|xx-Latn|...}}, viz. stating that the string is a Romanization by adding "-Latn" to the language code.

Usage

There are two ways of using this template: with or without specifying the transliteration scheme used:

• two parameters, with ISO 639 language code: {{transl|ar|al-Khwarizmi}} means that "al-Khwarizmi" is a transliteration from the Arabic in a loose or unspecified scheme.
• two parameters, with ISO 15924 script code: {{transl|Ogam|MAQI}} means that "MAQI" transliterates an Ogham inscription without specifying the language. Potentially useful when writing systems themselves are under discussion, e.g. {{transl|Cyrl|š}}, not {{transl|cu|š}} or {{transl|ru|š}} when discussing the letter ШTemplate:Script/doc/id-unk/core.

• three parameters, with ISO 639 language code: {{transl|ar|DIN|al-Ḫawārizmī}} / {{transl|ar|ALA|al-Khawārizmī}} the second parameter specifies the scheme used (DIN vs. ALA).
• three parameters, with ISO 15924 script code: {{transl|Arab|DIN|Ḫ}} vs {{transl|Arab|ALA|Kh}} for ﺥ‎.

To suppress the default italicization of Latin scripts, add |italic=no. This parameter is useful for proper nouns, for example.

Note that the language code is ISO 639, not the IETF BCP 47 language tags that allow variants.

Transliteration scheme codes

Codes for supported transliteration schemes can be seen by viewing the source of Module:Lang/data — the translit_title_table data-structure lists for each such code the corresponding transliteration schemes. These may vary by language — e.g. code "ISO" means scheme ISO 233 for Arabic but ISO 11940 for Thai.

Examples

code:

• {{transl|ar|[[al-Khwarizmi]]}} / [[DIN 31635]]: {{transl|ar|DIN|al-Ḫawārizmī}} / [[ISO 233]]: {{transl|ar|ISO|al-H̱awārizmī}} / [[ALA-LC Romanization|ALA]]: {{transl|ar|ALA|al-Khawārizmī}}
• [[Royal Thai General System of Transcription|RTGS]]: {{transl|th|phasa thai}} / [[ISO 11940]]: {{transl|th|ISO|p̣hās̄ʹāthịy}}
• {{cuneiform|[[Sumerian language|𒅴𒂠]]}} {{transl|sux|EME.GIR<sub>15</sub>}} / {{cuneiform|6|[[Hittite language|𒉈𒅆𒇷]]}} {{transl|hit|''ne-ši-li''}}

result:

• al-Khwarizmi / DIN 31635: al-Ḫawārizmī / ISO 233: al-H̱awārizmī / ALA: al-Khawārizmī
• RTGS: phasa thai / ISO 11940: p̣hās̄ʹāthịy
• 𒅴𒂠 EME.GIR₁₅ / 𒉈𒅆𒇷 ne-ši-li

ISO:

• {{transl|ru|ISO|russkij}}: russkij
• {{transl|ab|ISO|aṗsua}}: aṗsua
• {{transl|ar|ISO|ʿarabī}}: ʿarabī

  ISO has huge issues transliterating alif, so it's better to use the Library of Congress transliteration, the German Institute for Standardization or Hans Wehr transliteration; see Arabic transliteration and MOS:APOSTROPHE

• {{transl|ta|ISO|tamiḻ}}: tamiḻ
• {{transl|bn|ISO|baṅla}}: baṅla
• {{transl|el|ISO|ellēniká}}: ellēniká
• {{transl|ka|ISO|k'art'uli}}: k'art'uli
• {{transl|zh|ISO|hànyǔ pīnyīn}}: hànyǔ pīnyīn
• {{transl|th|ISO|p̣hās̄ʹāthịy}}: p̣hās̄ʹāthịy

CSS

In order to apply a style to all text marked as transliteration, use a CSS selector that chooses all text with transliteration in the title attribute (tooltip). For instance, if you add the following to your common.css, all transliterations will be colored teal:

[title~=transliteration] { color: teal; }

Tracking category

• Category:Transl template errors (0)

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Transl

Marks a text span transliterated from a particular language or writing system, and, optionally, according to a specific transliteration system.

Template parameters

Parameter		Description	Type	Status
Language or script code	1	ISO 639 language code (e.g., uk) or ISO 15924 script code (e.g., Cyrl)	Line	required
Text or transliteration scheme	2	Source text to be transliterated, or, optionally, transliteration scheme (e.g., bgn/pcgn)	String	required
Text	3	Source text to be transliterated (required if a transliteration scheme is entered above)	String	suggested

See also

• {{lang}}
• {{script}}
• Romanization
• List of ISO transliterations

|- class="sortbottom" | colspan="8" | Notes Template:Cnote2 begin Template:Cnote2 Template:Cnote2 Template:Cnote2 Template:Cnote2 Template:Cnote2 Template:Cnote2 Template:Cnote2 Template:Cnote2 end |}

The above documentation is transcluded from Template:Transl/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.