فرما:Transl/دَستاویز ہُنٛد کوڈ وُچھِو

{{Documentation subpage}}
{{High use}}
{{COinS safe|n}}
{{Lua|Module:Lang}}

This template is used to indicate that a text is [[Transliteration|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 (&alpha;), 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. 

{{tl|transl}} is similar to {{tl|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 |
<nowiki>{{lang|uk|Ярослав Рудницький}} ({{transl|uk|ukrainian|Yaroslav Rudnytskyi}})</nowiki>
|
{{lang|uk|Ярослав Рудницький}} ({{transl|uk|ukrainian|Yaroslav Rudnytskyi}})
}}

==Rationale==
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 or are redirected back to <nowiki>{{transl}}</nowiki>.  For example, (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 ArabDIN are handled natively by this template: <code><nowiki>{{transl|ar|DIN|...}}</nowiki></code>).

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.{{clarify|date=September 2015|reason=Is this working this way presently? If not, what are the plans to fix it?}}

==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|[[ﺥ]]}}.

To suppress the default italicization of Latin scripts, add {{para|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 tag]]s that allow variants.

===Transliteration scheme codes===
Codes for supported transliteration schemes can be seen by viewing the source of [[:Module:Lang/data]] — the {{code|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:'''
*<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| عربي ]]}} <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]] and [[MOS:APOSTROPHE]]
*{{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}}

==CSS==
In order to apply a style to all text marked as transliteration, use a CSS selector that chooses all text with <code>transliteration</code> in the title attribute (tooltip). For instance, if you add the following to [[Special:MyPage/common.css|your common.css]], all transliterations will be colored {{color|teal}}:
<syntaxhighlight lang="CSS">
[title~=transliteration] { color: teal; }
</syntaxhighlight>

==Tracking category==
* {{clc|Transl template errors}}

==TemplateData==
{{templatedata header}}
<templatedata>
{
	"description": "Marks a text span transliterated from a particular language or writing system, and, optionally, according to a specific transliteration system.",
	"params": {
		"1": {
			"label": "Language or script code",
			"description": "ISO 639 language code (e.g., uk) or ISO 15924 script code (e.g., Cyrl)",
			"required": true,
			"type": "line"
		},
		"2": {
			"label": "Text or transliteration scheme",
			"description": "Source text to be transliterated, or, optionally, transliteration scheme (e.g., bgn/pcgn)",
			"required": true,
			"type": "string"
		},
		"3": {
			"label": "Text",
			"description": "Source text to be transliterated (required if a transliteration scheme is entered above)",
			"required": false,
			"suggested": true,
			"type": "string"
		}
	}
}
</templatedata>

==See also==
*{{tl|lang}}
*{{tl|script}}
*[[Romanization]]
*[[List of ISO transliterations]]
{{ISO 15924 script codes and related Unicode data|state=collapsed}}
<includeonly>{{Sandbox other||
[[Category:Wikipedia multilingual support templates]]
[[Category:Templates that add a tracking category]]

}}</includeonly>