قالب:لغة

صفحة القالب متضمنة في قرابة 10٬000 صفحة ويمكن ملاحظتها على نطاق واسع. أختبر تغييرات القالب في /الملعب أو /المختبر أو صفحات فرعية، أو عبر صفحة المستخدم الفرعية. فكر في مناقشة التغييرات في صفحة نقاش قبل تنفيذها.

هذا القالب لا ينبغي أن يُستخدم في قوالب الاستشهاد مثل أسلوب الاستشهاد 1 ^{[الإنجليزية]} وأسلوب الاستشهاد 2 ^{[الإنجليزية]} لأنه يتضمن ترميزًا من شأنه أن يلوّث بيانات COinS ^{[الإنجليزية]} الوصفية التي تُنتجها تلك القوالب؛ طالع ويكيبيديا:COinS ^{[الإنجليزية]}.

هذا القالب يستعمل لوا:

Module:Lang (ملعب)

الغرضُ من هذا القالب هو الإشارةُ إلى أنّ مقطعًا من النصّ ينتمي إلى لغةٍ بعينها غير لغة الصفحة ككلّ (والافتراضي في هذه الموسوعة هو العربية). يمكن استخدامه داخل السطر، أو إحاطة عناصر كتلية به مثل <poem>، أو الفقرات، أو القوائم، أو عناصر ‎div‎.

يفرض القالبُ إمالةَ النصّ افتراضيًّا (ويمكن تعطيل ذلك، كما أنّه لا ينطبق على بعض أنظمة الكتابة)، كما يمكنه أن يوجّه متصفِّحات الويب لاختيار خطٍّ أنسب، أو قارئاتِ الشاشة لاختيار نوعٍ معيّن من النطق، وغير ذلك. انظر § Rationale لمزيدٍ من المعلومات.

البنية والاستخدام

{{لغة|رمز اللغة|النص}}

يجب أن يكون رمز اللغة رمزًا وفق أيزو 639. راجع قائمة رموز أيزو 639-1 للرموز الثنائية الأحرف، وقائمة رموز أيزو 639-3 التي تُعرِّف الرموز الثلاثية الأحرف وتهدف إلى شمول جميع اللغات الطبيعية المعروفة.

يدعم القالب أيضًا وسم لغة مجموعة مهندسي الإنترنت المصوغة بصورةٍ صحيحة باستخدام رموزٍ فرعية تحدِّد خطَّ الكتابة أو الإقليم و/أو المتغيِّر. ورمز اللغة في ISO 639 هو اختصار من حرفين أو ثلاثة أحرف صغيرة لاسم اللغة. فمثلًا الفرنسية رمزها fr:

قالت: "{{لغة|fr|Je suis française.}}" → قالت: "Je suis française."

وبما أنّ جميع اللغات ذات الرموز الثنائية في أيزو 639-1 يمكن أيضًا تمثيلها بنظائرها الثلاثية في أيزو 639-2 وما بعده، يُستحسَن استخدام أقصر وسم لغةٍ ممكن يَكفي لوصف اللغة المقصودة.^[1] لذا، مع أنّ الفرنسية يمكن تمثيلها بالرمز fra (ISO 639-2)، فالأَولى استخدام رمز ISO 639-1 الأقصر fr. وبالمثل، لا تُدرَج معلومات الخطّ أو الإقليم أو المتغيِّر إلا عندما تُحدِث تمييزًا ضروريًّا. وللاطلاع على قائمةٍ مُحدَّثة بالرموز المتاحة للغات والخطوط والأقاليم والمتغيّرات، يُرجى الرجوع إلى سجلّ الرموز الفرعية للغة لدى IANA.

افتراضيًّا، يضع هذا القالب المقالات ضمن التصنيف الفرعي الملائم من تصنيف:مقالات تحوي نصا بغير العربية. ولمنع ذلك — مثلًا عند استخدام {{لغة}} داخل وصلة ويكي أو في وسيط title في الاستشهاد — أضِف الوسيط |التصنيف=لا.

الوسائط

الوسائط المدعومة في لغة
الوسيط	التعريف	يُتجاوز بواسطة	أسماء أخرى
`\|الرمز=`	وسم لغة وفق IETF للمحتوى في `النص`	–	`\|1=`
`\|النص=`	نصّ بغير العربية	–	`\|2=`
`\|يمين=`	تشير قيمة `نعم` إلى أنّ نظام الكتابة في `\|النص=` يُكتب من اليمين إلى اليسار؛ القيم المقبولة: `لا` (افتراضي)، `نعم`	الرمز الفرعي للخطّ في `\|الرمز=` (إن وُجِد)
`\|italic=`	انظر الجدول «عمليات الوسيط لغة\|مائل=»؛ القيم المقبولة: `yes`، `لا`، `unset`، `invert`، `default`	–	`\|italics=`، `\|i=`
`\|size=`	يحدّد حجم الخطّ للمحتوى في `text`؛ استخدم قيمة مناسبة لخاصية CSS `font-size`؛ ويُفضَّل أن تكون نسبةً مئوية (`%`) أو بوحدة `em`، لا قيمةً ثابتة بوحدة `px`.	–
`\|proto=`	القيم المقبولة: `no` (افتراضي) أو `yes` (افتراضي لوسوم الاستخدام الخاص التي تحتوي على الرمز الفرعي `-x-proto`)؛ عند ضبطها على `yes` (افتراضيًا أو صراحةً) تُسبق النتيجة بنجمة للدلالة على «غير مُستشهد بها».	–
`\|cat=`	يعطّل التصنيف الآلي؛ وهو مرآةٌ لـ `\|nocat=`؛ القيم المقبولة: `no`، `n`، `false`، `f`، `off`، `0`	–
`\|nocat=`	يعطّل التصنيف الآلي؛ وهو مرآةٌ لـ `\|cat=`؛ القيم المقبولة: `yes`، `y`، `true`، `t`، `on`، `1`	–

عمليات الوسيط لغة|مائل=
قيمة \|مائل=	الوصف	كود المثال	النتيجة	ترميز HTML
الوسيط غير موجود؛ الوسيط موجود دون تعيين؛ قيمة غير صالحة	تطبّق الوحدة نمطًا من: الإمالة التلقائية أو الرمز الفرعي للخطّ `latn`؛ وإلا يرث من الترميز الخارجي؛ القيم غير الصالحة تُعامَل كافتراضي	`{{لغة\|ru\|тундра}}`	тундра	`<span title="نص باللغة الروسية"><span lang="ru" dir="ltr">тундра</span></span>`
		`{{لغة\|ru\|tûndra}}`	tûndra	`<span title="نص باللغة الروسية"><i lang="ru" dir="ltr">tûndra</i></span>` ترميز غير صحيح؛ هذا يتطلّب `\|ru-Latn`.
		`{{لغة\|fr\|toundra}}`	toundra	`<span title="نص باللغة الفرنسية"><i lang="fr" dir="ltr">toundra</i></span>`
		`{{لغة\|ru-Latn\|tûndra}}`	tûndra	`<span title="نص باللغة الروسية"><i lang="ru-Latn" dir="ltr">tûndra</i></span>`
`default`		`{{لغة\|ru\|тундра\|italic=default}}`	тундра	`<span title="نص باللغة الروسية"><span lang="ru" dir="ltr">тундра</span></span>`
		`{{لغة\|fr\|toundra\|italic=default}}`	toundra	`<span title="نص باللغة الفرنسية"><i lang="fr" dir="ltr">toundra</i></span>`
		`{{لغة\|ru-Latn\|tûndra\|italic=default}}`	tûndra	`<span title="نص باللغة الروسية"><i lang="ru-Latn" dir="ltr">tûndra</i></span>`
`no`	تفرض الوحدة نمطًا قائمًا؛ تتجاوز الإمالة التلقائية؛ وتتجاوز الرمز الفرعي `latn`؛ وتتجاوز الترميز الخارجي	`{{لغة\|ru\|тундра\|italic=no}}`	тундра	`<span title="نص باللغة الروسية"><span lang="ru" dir="ltr" style="font-style: normal;">тундра</span></span>`
		`{{لغة\|fr\|toundra\|italic=no}}`	toundra	`<span title="نص باللغة الفرنسية"><span lang="fr" dir="ltr" style="font-style: normal;">toundra</span></span>`
		`{{لغة\|ru-Latn\|tûndra\|italic=no}}`	tûndra	`<span title="نص باللغة الروسية"><span lang="ru-Latn" dir="ltr" style="font-style: normal;">tûndra</span></span>`
		`''{{لغة\|fr\|toundra\|italic=no}}''`	toundra	`''<span title="نص باللغة الفرنسية"><span lang="fr" dir="ltr" style="font-style: normal;">toundra</span></span>''`
`yes`	تفرض الوحدة الإمالة؛ وتتجاهل الإمالة التلقائية؛ وتتجاهل الرمز الفرعي `latn`	`{{لغة\|ru\|тундра\|italic=yes}}`	тундра	`<span title="نص باللغة الروسية"><i lang="ru" dir="ltr">тундра</i></span>` ترميز غير صحيح حسب .
`yes`		`{{لغة\|ru-Latn\|tûndra\|italic=yes}}`	tûndra	`<span title="نص باللغة الروسية"><i lang="ru-Latn" dir="ltr">tûndra</i></span>`
`unset`	لا تطبّق الوحدة أيّ نمط؛ يرث النمط من الترميز الخارجي؛ يعطّل الإمالة التلقائية؛ ويتجاوز الرمز الفرعي `latn`.	`{{لغة\|ru\|тундра\|italic=unset}}`	тундра	`<span title="نص باللغة الروسية"><span lang="ru" dir="ltr">тундра</span></span>`
		`''{{لغة\|ru\|тундра\|italic=unset}}''`	тундра	`''<span title="نص باللغة الروسية"><span lang="ru" dir="ltr">тундра</span></span>''` ترميز غير صحيح حسب .
		`{{لغة\|ru-Latn\|tûndra\|italic=unset}}`	tûndra	`<span title="نص باللغة الروسية"><span lang="ru-Latn" dir="ltr">tûndra</span></span>`
		`''{{لغة\|ru-Latn\|tûndra\|italic=unset}}''`	tûndra	`''<span title="نص باللغة الروسية"><span lang="ru-Latn" dir="ltr">tûndra</span></span>''`
`invert`	لا تطبّق الوحدة أيّ نمط؛ تعكس النمط داخل الترميز الداخلي؛^[ا] تعطّل الإمالة التلقائية؛ وتتجاوز الرمز الفرعي `latn`.	`{{لغة\|ru\|тундра\|italic=invert}}`	тундра	`<span title="نص باللغة الروسية"><span lang="ru" dir="ltr">''тундра''</span></span>` ترميز غير صحيح حسب .
		`{{لغة\|ru\|''тундра''\|italic=invert}}`	тундра	`<span title="نص باللغة الروسية"><span lang="ru" dir="ltr">тундра</span></span>`
		`{{لغة\|ru-Latn\|tûndra\|italic=invert}}`	tûndra	`<span title="نص باللغة الروسية"><span lang="ru-Latn" dir="ltr">''tûndra''</span></span>`
		`{{لغة\|ru-Latn\|''tûndra''\|italic=invert}}`	tûndra	`<span title="نص باللغة الروسية"><span lang="ru-Latn" dir="ltr">tûndra</span></span>`

بيانات القالب

هذا توثيق بيانات لهذا القالب، مستخدم بواسطة المحرر المرئي وأداة الترجمة والأدوات الأخرى.

بيانات قالب: «لغة»

يشير إلى أن جزءً معينًّا من النص ينتمي إلى لغةٍ محددةٍ. يسمح للمتصفحات بعرض اللغات الأجنبية ونطقها بشكل صحيح.

وسائط القالب[تحرير بيانات القالب]
هذا القالب يفضل التنسيق بنفس السطر للوسائط.
وسيط		وصف	نوع	حالة
Language tag	`1` `code`	A language tag, or an ISO 639 language code. مثال fr	نص	مطلوب
Text	`2` `text`	The text belonging to the language specified. مثال Je suis française.	نص	مطلوب
Right to left	`rtl`	Indicates that the language should be displayed from right to left. غيابي no مثال yes	نص	اختياري
Italicize	`italic` `italics` `i`	Italicizes the text غيابي yes مثال no	بولياني	اختياري
Font-size	`size`	sets font-size مثال 120%, 1.2em	غير معروف	اختياري
cat	`cat`	دون وصف	غير معروف	اختياري
nocat	`nocat`	دون وصف	غير معروف	اختياري

مراجع

↑ "Language tags in HTML and XML" لدى رابطة الشبكة العالمية

↑ اكتب عنوان المرجع بين علامتي الفتح <ref> والإغلاق </ref> للمرجع invertunset

التوثيق في الأعلى مضمن من قالب:لغة/شرح.
يمكن للمحررين تجريب تعديلاتهم على القالب في صفحات ملعب ومختبر .
من فضلك أضف التصنيفات في الصفحة الفرعية للقالب /شرح. الصفحات الفرعية لقالب.

[1] "Language tags in HTML and XML" لدى رابطة الشبكة العالمية

[invertunset-2] اكتب عنوان المرجع بين علامتي الفتح <ref> والإغلاق </ref> للمرجع invertunset

[1]

[ا]

الوسيط	التعريف	يُتجاوز بواسطة	أسماء أخرى
`\|الرمز=`	وسم لغة وفق IETF للمحتوى في `النص`	–	`\|1=`
`\|النص=`	نصّ بغير العربية	–	`\|2=`
`\|يمين=`	تشير قيمة `نعم` إلى أنّ نظام الكتابة في `\|النص=` يُكتب من اليمين إلى اليسار؛ القيم المقبولة: `لا` (افتراضي)، `نعم`	الرمز الفرعي للخطّ في `\|الرمز=` (إن وُجِد)
`\|italic=`	انظر الجدول «عمليات الوسيط لغة\|مائل=»؛ القيم المقبولة: `yes`، `لا`، `unset`، `invert`، `default`	–	`\|italics=`، `\|i=`
`\|size=`	يحدّد حجم الخطّ للمحتوى في `text`؛ استخدم قيمة مناسبة لخاصية CSS `font-size`؛ ويُفضَّل أن تكون نسبةً مئوية (`%`) أو بوحدة `em`، لا قيمةً ثابتة بوحدة `px`.	–
`\|proto=`	القيم المقبولة: `no` (افتراضي) أو `yes` (افتراضي لوسوم الاستخدام الخاص التي تحتوي على الرمز الفرعي `-x-proto`)؛ عند ضبطها على `yes` (افتراضيًا أو صراحةً) تُسبق النتيجة بنجمة للدلالة على «غير مُستشهد بها».	–
`\|cat=`	يعطّل التصنيف الآلي؛ وهو مرآةٌ لـ `\|nocat=`؛ القيم المقبولة: `no`، `n`، `false`، `f`، `off`، `0`	–
`\|nocat=`	يعطّل التصنيف الآلي؛ وهو مرآةٌ لـ `\|cat=`؛ القيم المقبولة: `yes`، `y`، `true`، `t`، `on`، `1`	–

قوالب اللغة
أسماء اللغات (أيزو 639)
{{اسم أيزو 639}}
روابط إنترويكي
{{لغة ويكاموس}} وحدة:Wikt-lang وحدة:Wikt-lang/data {{Interlanguage link}}
نصوص بلغة أجنبية
{{لغة}} {{اللغة}} وحدة:Lang {{رومنة}} {{نقحرة}} {{لغة العنوان}}
أخرى
{{أصد}} {{باللغة}} {{لغة وصلة}}
ع ن ت