View source for Template:Transl/doc

<noinclude>{{documentation subpage}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{COinS safe|n}}
===Purpose===
This template is intended to unify all "transliteration" templates, such as {{tl|IAST}} and {{tl|ISOtranslit}}. These templates are still usable, but they just transclude this one (e.g. <code><nowiki>{{IAST|saṃskṛtam}}</nowiki></code> is a shortcut for <code><nowiki>{{transl|sa|IAST|saṃskṛtam}}</nowiki></code>; others like {{tlx|ArabDIN}} have been deprecated in favor of <code><nowiki>{{transl|ar|DIN|...}}</nowiki></code>).

The transliteration is marked as belonging in the "latinx" class of [[MediaWiki:Common.css]] (note, this renders obsolete the "IAST" class formerly used by  {{tl|IAST}}).

This template is kept separate from {{tl|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 {{tl|lang}}, using <code><nowiki>{{transl|xx|...}}</nowiki></code> should be equivalent to using <code><nowiki>{{lang|xx-Latn|...}}</nowiki></code>, 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: <code><nowiki>{{transl|ar|al-Khwarizmi}}</nowiki></code> means that "al-Khwarizmi" is a transliteration from the Arabic in a loose or unspecified scheme.
*two parameters, with [[ISO 15924]] script code: <code><nowiki>{{transl|Ogam|MAQI}}</nowiki></code> means that "MAQI" transliterates an [[Ogham]] inscription without specifying the language. Potentially useful when writing systems themselves are under discussion, e.g.  <code><nowiki>{{transl|Cyrl|š}}</nowiki></code>, not <code><nowiki>{{transl|cu|š}}</nowiki></code> or <code><nowiki>{{transl|ru|š}}</nowiki></code> when discussing the letter {{script|Cyrl|[[Ш]]}}.

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

====Examples====
'''code:'''
*<code><nowiki>{{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ī}}</nowiki></code>
*<code><nowiki>[[Royal Thai General System of Transcription|RTGS]]: {{transl|th|phasa thai}} / [[ISO 11940]]: {{transl|th|ISO|p̣hās̄ʹāthịy}}</nowiki></code>
*<code><nowiki>{{cuneiform|[[Sumerian language|&#x12174;&#x120a0;]]}} {{transl|sux|EME.GIR<sub>15</sub>}} / {{cuneiform|6|[[Hittite language|𒉈𒅆𒇷]]}} {{transl|hit|''ne-ši-li''}}</nowiki></code>
'''result:'''
*{{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|&#x12174;&#x120a0;]]}} {{transl|sux|EME.GIR<sub>15</sub>}} / {{cuneiform|6|[[Hittite language|𒉈𒅆𒇷]]}} {{transl|hit|''ne-ši-li''}}

'''ISO''':
*{{lang|ru|[[Russian language|русский]]}} <code><nowiki>{{transl|ru|ISO|russkij}}</nowiki></code>:  {{transl|ru|ISO|russkij}}
*{{lang|ab|[[Abkhaz language|Аҧсуа]]}} <code><nowiki>{{transl|ab|ISO|aṗsua}}</nowiki></code>: {{transl|ab|ISO|aṗsua}}
*{{lang|ar|[[Arabic language| عربي ]]}} <code><nowiki>{{transl|ar|ISO|ʿarabī}}</nowiki></code>:  {{transl|ar|ISO|ʿarabī}}
*: ISO has huge issues transliterating ''alif'', so it's better to use the Library of Congress transliteration, the [[DIN 31635|German Institute for Standardization]] or [[Hans Wehr transliteration]]; see [[Arabic transliteration]]
*{{lang|ta|[[Tamil language|தமிழ் ]]}} <code><nowiki>{{transl|ta|ISO|tamiḻ}}</nowiki></code>: {{transl|ta|ISO|tamiḻ}}
*{{lang|bn|[[Bengali language|বাংলা ]]}} <code><nowiki>{{transl|bn|ISO|baṅla}}</nowiki></code>: {{transl|bn|ISO|baṅla}}
*{{lang|el|[[Greek language|ελληνικά ]]}} <code><nowiki>{{transl|el|ISO|ellēniká}}</nowiki></code>: {{transl|el|ISO|ellēniká}}
*{{lang|ka|[[Georgian language|ქართული]]}}  <code><nowiki>{{transl|ka|ISO|k'art'uli}}</nowiki></code>: {{transl|ka|ISO|k'art'uli}}
*{{lang|zh|[[Pinyin|漢語拼音]]}} <code><nowiki>{{transl|zh|ISO|hànyǔ pīnyīn}}</nowiki></code>: {{transl|zh|ISO|hànyǔ pīnyīn}}
*{{lang|th|[[Thai language|ภาษาไทย]]}} <code><nowiki>{{transl|th|ISO|p̣hās̄ʹāthịy}}</nowiki></code>: {{transl|th|ISO|p̣hās̄ʹāthịy}}

===See also===
*{{tl|lang}}
*{{tl|script}}
**{{tl|BMP}}
**{{tl|SMP}}
**{{tl|runic}}
**{{tl|cuneiform}}
*[[Romanization]]
*[[List of ISO transliterations]]

{{ISO 15924/footer}}

<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Multilingual support templates]]</includeonly>