قالب:Transliteration/doc

هذه صفحة توثيق فرعية لـ قالب:Transliteration.
تتضمن معلومات الاستعمال، التصنيفات وأي محتوى آخر ليس من محتويات الأصل لصفحة القالب.

This template is used on many pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page قبل تنفيذهم.

This template should not be used in citation templates such as Citation Style 1 and Citation Style 2، لأنها تضم markup that will pollute the COinS metadata they produce؛ انظر COinS في المعرفة.

Uses Lua:

Module:Lang

This template is used to mark up text transliterated or romanised from a non-Latin alphabet script to Latin alphabet script.

This template should only be used for the transliterations of non-Latin scripts; for non-English language text displayed in its native script (such as Greek, Cyrillic and Arabic), {{lang}} should be used, which tags non-transliterated text (written in original script). Transl often used alongside that template, to allow non-readers of the script to interpret the text.

This template adds a tooltip label naming the transliteration scheme, and renders text in italics by default. This template is important for MOS:ACCESSIBILITY, as it invisibly tags text with the correct language, allowing for screenreaders to the correct style of pronunciation.

It also displays text in an appropriate font; romanisations marked up in {{lang}} may display in fonts designed for that language's native text, whereas the transl template displays text in the same font as the rest of the article.

Some languages, such as Chinese, have more than one style of transliteration (such as Wade-Giles, pinyin, etc). This template can be used for these different transliteration schemes, though Wikipedia has a number of language-specific templates, some of which support more than one transliteration styles in their parameters, that may be better suited for marking up transliterations.

Example

The following code tags a Ukrainian name and its transliteration according to the Ukrainian National scheme.

Markup	Renders as
{{lang\|uk\|Ярослав Рудницький}} ({{transliteration\|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 {{transliteration|sa|IAST|saṃskṛtam}}. Other transliteration templates that once existed, such as {{ArabDIN}}, are now handled natively by this template: {{transliteration|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 {{transliteration|xx|...}} should be equivalent to using {{lang|xx-Latn|...}}.

Usage

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

two parameters, with ISO 639 language code: {{transliteration|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: {{transliteration|Ogam|MAQI}} means that "MAQI" transliterates an Ogham inscription without specifying the language. Potentially useful when writing systems themselves are under discussion, e.g. {{transliteration|Cyrl|š}}, not {{transliteration|cu|š}} or {{transliteration|ru|š}} when discussing the letter Ш.
three parameters, with ISO 639 language code: {{transliteration|ar|DIN|al-Ḫawārizmī}} / {{transliteration|ar|ALA|al-Khawārizmī}} the second parameter specifies the scheme used (DIN vs. ALA).
three parameters, with ISO 15924 script code: {{transliteration|Arab|DIN|Ḫ}} vs {{transliteration|Arab|ALA|Kh}} for خ.

|italic=no can be added to suppress the default italicization of Latin scripts; however, proper nouns – the names of people and places – are typically not italicized, and as such, generally do not require the use of a transliteration template. Note that there is no need to add italic markup ('') to transliteration templates.

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

Inputting:

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

Results in:

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:

русский {{transliteration|ru|ISO|russkij}}: russkij
Аҧсуа {{transliteration|ab|ISO|aṗsua}}: aṗsua
عربي {{transliteration|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
தமிழ் {{transliteration|ta|ISO|tamiḻ}}: tamiḻ
বাংলা {{transliteration|bn|ISO|baṅla}}: baṅla
ελληνικά {{transliteration|el|ISO|ellēniká}}: ellēniká
ქართული {{transliteration|ka|ISO|k'art'uli}}: k'art'uli
漢語拼音 {{transliteration|zh|ISO|hànyǔ pīnyīn}}: hànyǔ pīnyīn
ภาษาไทย {{transliteration|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 :

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

Tracking category

Category:Transl template errors (0)

TemplateData

قالب:Templatedata header

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

وسائط القالب
وسيط		وصف	نوع	حالة
Language or script code	`1`	ISO 639 language code (e.g., uk) or ISO 15924 script code (e.g., Cyrl)	سطر	مطلوب
Text or transliteration scheme	`2`	Source text to be transliterated, or, optionally, transliteration scheme (e.g., bgn/pcgn)	نص	مطلوب
Text	`3`	Source text to be transliterated (required if a transliteration scheme is entered above)	نص	مقترح

v t e ISO 15924 script codes^[a]^[b] and Unicode^[c]^[d]
ISO 15924			Script in Unicode^[e]
Code	No.	Name	Alias^[f]	Direction	Version	Characters	Remark
Qaai	908	(Private use)					Not in Unicode (Before version 5.2, this was used instead of Zinh)
Notes قالب:Cnote2 begin ^ ISO 15924 publications اعتبارا من 26 أغسطس 2018 (2018-08-26)^[تحديث] ^ ISO 15924 Normative text file اعتبارا من 26 أغسطس 2018 (2018-08-26)^[تحديث] ^ ISO 15924 Changes (including Aliases for Unicode; اعتبارا من 26 أغسطس 2018 (2018-08-26)^[تحديث]) ^ Unicode version 11.0 ^ Unicode charts ^ Unicode uses the "Property Value Alias" (Alias) as the script-name. These Alias names are part of Unicode and are published informatively next to ISO 15924 قالب:Cnote2 end

^ ^أ ^ب ^ت ^ث ^ج ^ح ^خ ^د ^ذ ^ر ^ز "Proposed New Scripts". Unicode Consortium. 2018-05-25. Retrieved 2018-09-12.
^ ^أ ^ب ^ت "Roadmap to the SMP". Unicode Consortium. 2018-08-08. Retrieved 2018-09-12.
^ Michael Everson (1997-09-18). "Proposal to encode Klingon in Plane 1 of ISO/IEC 10646-2".
^ The Unicode Consortium (2001-08-14). "Approved Minutes of the UTC 87 / L2 184 Joint Meeting".

[uniproposed-1] أ ^ب ^ت ^ث ^ج ^ح ^خ ^د ^ذ ^ر ^ز "Proposed New Scripts". Unicode Consortium. 2018-05-25. Retrieved 2018-09-12.

[roadmap-smp-2] أ ^ب ^ت "Roadmap to the SMP". Unicode Consortium. 2018-08-08. Retrieved 2018-09-12.

[3] Michael Everson (1997-09-18). "Proposal to encode Klingon in Plane 1 of ISO/IEC 10646-2".

[4] The Unicode Consortium (2001-08-14). "Approved Minutes of the UTC 87 / L2 184 Joint Meeting".

[1]

[2]

[3]

[4]

[a]

[b]

[c]

[d]

[e]

[f]

قوالب اللغات
أسماء اللغات (ISO 639)
{{ISO 639 name}}
روابط الإنترويكي
{{Wikt-lang}} Module:Language {{Interlanguage link}}
نصوص بلغات أجنبية
{{Lang}} Module:Lang {{Transliteration}} {{Title language}} {{PIE}} (Proto-Indo-European language content)
غيرهم
{{IPA}} (كتابة النطق بالأبجدية الصوتية الدولية) Module:Language/data تصنيف:قوالب الدعم متعدد اللغات بالمعرفة
v t e