الگو:Transl

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

این الگو برای نشانه‌گذاری متنی به‌کار می‌رود که از خطی غیر از خط لاتین به نویسه‌گردانی‌شده یا لاتین‌نویسی‌شده در خط لاتین تبدیل شده است.

این الگو فقط برای نویسه‌گردانی متنِ خطوط غیرلاتین به‌کار می‌رود؛ برای متن غیرفارسی که با خط بومیِ خودش نمایش داده می‌شود (مانند یونانی، سیریلیک یا عربی) باید از الگوی {{Lang}} استفاده شود. در عمل، این دو الگو معمولاً در کنار هم به‌کار می‌روند تا خوانندگانی که با خط اصلی آشنایی ندارند نیز بتوانند متن را بخوانند.

این الگو هنگام عبور موس روی متن، یک راهنمای ابزار با نام طرح نویسه‌گردانی نمایش می‌دهد و متن را به‌طور پیش‌فرض به‌صورت کج می‌نویسد.

افزون بر این، متن را با قلم مناسب نمایش می‌دهد: لاتین‌نویسی‌هایی که با {{Lang}} نشانه‌گذاری شوند ممکن است با قلمی خاص زبان مبدأ نمایش داده شوند، در حالی که این الگو متن را با همان قلمی که در باقی مقاله به‌کار رفته نمایش می‌دهد.

برخی زبان‌ها مانند زبان چینی چند سبک نویسه‌گردانی دارند (مانند وید جایلز، پین‌یین و دیگران). این الگو از همهٔ این طرح‌ها پشتیبانی می‌کند، اما ویکی‌پدیا الگوهای ویژهٔ هر زبان نیز دارد که بعضی از آنها بیش از یک طرح نویسه‌گردانی را در پارامترهای خود می‌پذیرند و ممکن است برای نشانه‌گذاری گزینهٔ بهتری باشند.

مثال

کد زیر یک نام اوکراینی و نویسه‌گردانی ملی آن را نشانه‌گذاری می‌کند:

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

نتیجه: Ярослав Рудницький ([Yaroslav Rudnytskyi] )

دلیل وجود

این الگو برای یکپارچه‌سازیِ همهٔ الگوهای «نویسه‌گردانی» (مانند {{IAST}} و {{ISOtranslit}}) ساخته شده است. آن الگوها هنوز قابل استفاده‌اند، اما در عمل فقط همین الگو را فرامی‌خوانند یا به آن تغییرمسیر داده می‌شوند. برای نمونه، {{IAST|saṃskṛtam}} میان‌بری برای {{transl|sa|IAST|saṃskṛtam}} است.

این الگو از {{Lang}} جدا نگه داشته شده تا موضوع‌های قالب‌بندی (با کلاس‌های CSS) و شناسایی طرح نویسه‌گردانی به‌درستی مدیریت شوند. در نهایت اگر این نکات به‌خوبی در پروندهٔ CSS و/یا {{Lang}} رسیدگی شوند، استفاده از {{transl|xx|...}} معادل با {{lang|xx-Latn|...}} خواهد بود.

کاربرد

این الگو را می‌توان به دو شیوه به‌کار برد، با یا بدون مشخص‌کردن طرح نویسه‌گردانی:

• دو پارامتر با کد زبان ایزو ۶۳۹: {{transl|ar|al-Khwarizmi}} به این معنی است که «al-Khwarizmi» نویسه‌گردانی‌شده از عربی است، با طرحی نامشخص یا کلی.
• دو پارامتر با کد خط ایزو ۱۵۹۲۴: {{transl|Ogam|MAQI}} به این معنی است که «MAQI» نویسه‌گردانیِ یک کتیبهٔ اوگام است بدون مشخص‌کردن زبان. این حالت زمانی مفید است که خود سامانهٔ نگارش موضوع بحث است؛ مثلاً {{transl|Cyrl|š}} به‌جای {{transl|cu|š}} یا {{transl|ru|š}} برای حرف Ш.
• سه پارامتر با کد زبان ایزو ۶۳۹: {{transl|ar|DIN|al-Ḫawārizmī}} یا {{transl|ar|ALA|al-Khawārizmī}}. پارامتر دوم، طرح نویسه‌گردانی به‌کاررفته را مشخص می‌کند (DIN در برابر ALA).
• سه پارامتر با کد خط ایزو ۱۵۹۲۴: {{transl|Arab|DIN|Ḫ}} در برابر {{transl|Arab|ALA|Kh}} برای حرف ﺥ‎.

نیازی به افزودن نشانه‌گذاری ایتالیک ('') به متنِ درون این الگو نیست؛ متن خودکار به‌صورت کج نمایش داده می‌شود. اسامی خاص — نام افراد و مکان‌ها — معمولاً کج نوشته نمی‌شوند؛ در این موارد از |italic=no برای غیرفعال‌کردن کج‌نویسیِ پیش‌فرض استفاده کنید.

توجه: کد زبان باید ایزو ۶۳۹ یا یک برچسبِ خصوصیِ آی‌ای‌تی‌اف باشد (به الگو:Lang/توضیحات#برچسب‌های زبان خصوصی نگاه کنید)؛ سایر شکل‌های برچسب‌های زبانی BCP 47 پشتیبانی نمی‌شوند.

کدهای طرح نویسه‌گردانی

کدهای طرح‌های پشتیبانی‌شده را می‌توان در منبع پودمان:Lang/data دید — در ساختار دادهٔ translit_title_table برای هر کد، طرح نویسه‌گردانیِ متناظر فهرست شده است. این کدها بسته به زبان متفاوت‌اند؛ برای نمونه، کد «ISO» در عربی به ISO 233 اشاره می‌کند ولی در تایلندی به ISO 11940.

پارامترها

پارامترهای پشتیبانی‌شده

پارامتر	توضیح	نام‌های جایگزین
|1=	کد زبان ایزو ۶۳۹ یا کد خط ایزو ۱۵۹۲۴. الزامی.
|2=	یا متن نویسه‌گردانی‌شده (در حالت دو‌پارامتری)، یا نام طرح نویسه‌گردانی (در حالت سه‌پارامتری).
|3=	متن نویسه‌گردانی‌شده، در حالتی که پارامتر ۲ نام طرح است.
|italic=	کنترل کج‌نویسی متن. مقادیر مجاز: yes، no، invert، unset، inherit (پیش‌فرض). برای نام‌های خاص از no استفاده کنید.	|italics=، |i=

مثال‌ها

ورودی:

• {{transl|ar|[[محمد بن موسی خوارزمی|al-Khwarizmi]]}} / [[DIN 31635]]: {{transl|ar|DIN|al-Ḫawārizmī}} / [[DIN 31635|ISO 233]]: {{transl|ar|ISO|al-H̱awārizmī}} / [[لاتین‌نویسی الا-ال‌سی|ALA]]: {{transl|ar|ALA|al-Khawārizmī}}
• RTGS: {{transl|th|phasa thai}} / ISO 11940: {{transl|th|ISO|p̣hās̄ʹāthịy}}
• {{Script/Cuneiform|[[زبان سومری|𒅴𒂠]]}} {{transl|sux|EME.GIR<sub>15</sub>}} / {{Script/Cuneiform|[[زبان هیتی|𒉈𒅆𒇷]]}} {{transl|hit|ne-ši-li}}

خروجی:

• 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ī
• தமிழ் {{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

برای اعمال یک سبک به همهٔ متن‌های نشانه‌گذاری‌شده با این الگو، یک گزینگر CSS بنویسید که همهٔ متن‌های دارای واژهٔ transliteration یا romanization در ویژگیِ title را در‌بر گیرد. برای نمونه، با افزودن کد زیر به common.css شخصی، همهٔ نویسه‌گردانی‌ها به رنگ

Transl
مختصات رنگ
منبع	[بدون منبع]

نمایش داده خواهند شد:

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

ردهٔ ردیابی

• رده:خطاهای الگوی نویسه‌گردانی

داده‌های الگو

متنی را که از زبان یا سامانهٔ نگارش خاصی نویسه‌گردانی شده — و در صورت تمایل، طبق یک طرح نویسه‌گردانیِ ویژه — نشانه‌گذاری می‌کند.

پارامترهای الگو[ویرایش داده‌های الگو]

پارامتر		توضیحات	نوع	وضعیت
کد زبان یا خط	1	کد زبان ایزو ۶۳۹، که می‌تواند با کد خط ایزو ۱۵۹۲۴ نیز همراه باشد مثال ar (عربی)، sr-Cyrl (صربی به خط سیریلیک)، und-Hani (زبان نامشخص با نویسه‌های چینی)	خط	ضروری
متن یا طرح نویسه‌گردانی	2	متن نویسه‌گردانی‌شده با حروف لاتین، یا (در حالت سه‌پارامتری) نام طرح نویسه‌گردانی (مانند DIN، ISO، ALA، pinyin) که در این صورت پارامتر سوم، خود متن است.	رشته	ضروری
متن	3	متن نویسه‌گردانی‌شده با حروف لاتین. تنها در صورتی الزامی است که پارامتر دوم نام طرح نویسه‌گردانی باشد.	رشته	پیشنهادشده
کج‌نویسی	italic italics i	کنترل کج‌نویسی متن نویسه‌گردانی‌شده. برای نام‌های خاص از مقدار «no» استفاده کنید تا کج‌نویسیِ پیش‌فرض غیرفعال شود. مقدارهای پیشنهادی yes no invert unset inherit پیش‌فرض inherit	رشته	اختیاری

جستارهای وابسته

• {{Lang}} — برای نشانه‌گذاری متن به زبان غیرفارسی در خط بومی خودش
• {{Langx}} — مانند Lang ولی نام زبان را هم پیش از متن نمایش می‌دهد و پارامتر |translit= دارد
• {{Script}} — برای نشانه‌گذاری نمادها در خطی خاص بدون ارتباط با زبان معین
• نویسه‌گردانی — مقالهٔ مفهومی
• لاتین‌نویسی الا-ال‌سی — یک طرح متداول نویسه‌گردانی
• فهرست‌های کدهای ایزو ۶۳۹ — کدهای زبان
• ایزو ۱۵۹۲۴ — کدهای خط

توضیحات بالا تراگنجانده‌شده از الگو:Transl/توضیحات است. (ویرایش | تاریخچه)
ویرایشگران می‌توانند در صفحات تمرین (ایجاد | آینه) و آزمایشی (ایجاد) این الگو را آزمایش کنند.
لطفاً رده‌ها را به زیرصفحهٔ /توضیحات بیفزایید. زیرصفحه‌های این الگو.