عرض مصدر قالب:ترجمة أدب/شرح

{{صفحة توثيق فرعية}}
{{Uses TemplateStyles|Template:ترجمة أدب/styles.css}}
== الاستخدام ==

يمكن استخدام هذا القالب عندما يتم عرض نص الآية بلغته الأصلية وترجمته إلى اللغة الإنجليزية معًا. يعرض النص الأصلي بخط مائل والترجمة بخط [[روماني]]. ويمكن اختياريًا عرض المصادر لكل نص أسفل النص. ويتم تعيين المعلمة الرئيسية على النحو التالي:

<pre>
{{ترجمة أدب
|lang=رمز اللغة أيزو 639 أو علامة لغة IETF
|النص الأصلي
|الترجمة
|attr1=إسناد النص الأصلي
|attr2=إسناد الترجمة
|width=عرض كل المحتويات px
}}
</pre>

{{معلومات أكثر|قائمة رموز أيزو 639-1|قائمة رموز أيزو 639-2}}

'''{{وسط|كافة المعلمات بتنسيق أفقي.}}'''
<syntaxhighlight lang="wikitext">
{{ترجمة أدب|lang=|rtl1=|italicsoff=|head1=|<!--original text-->|attr1=|lang2=|rtl2=|italicsoff2=|head2=|<!--translation-->|attr2=}}
</syntaxhighlight>

'''{{وسط|كافة المعلمات بتنسيق رأسي}}'''
<syntaxhighlight lang="wikitext">
{{ترجمة أدب
 | lang = 
 | rtl1 = 
 | italicsoff = 
 | head1 =
 | <!--original text-->
 | attr1 = 
 | lang2 = 
 | rtl2 = 
 | italicsoff2 = 
 | head2 =
 | <!--translation-->
 | attr2 = 
}}
</syntaxhighlight>

== أمثلة ==
=== مثال أساسي ===
أول معلمتان مطلوبتان وتحتويات النصوص الأصلية والمترجمة. على سبيل المثال:

{{توصيف|
<syntaxhighlight lang="wikitext">
{{ترجمة أدب
|head1=German|lang=de
|Sprechen Sie Deutsch?
Bist du sicher?
|head2=العربية|lang2=ar
|هل تتحدث الالمانية؟
هل أنت متأكد؟}}
</syntaxhighlight>
|{{ترجمة أدب
|head1=German|lang=de
|Sprechen Sie Deutsch?
Bist du sicher?
|head2=العربية|lang2=ar|rtl2=y
|هل تتحدث الألمانية؟
هل أنت متأكد؟}}
}}

على الرغم من أن {{وسيط|lang|de}} يُحذف في الأمثلة البسيطة، يجب تحديد معلمة {{وسيط|lang}} في الاستخدام العادي لأي لغة غير الإنجليزية.

يتم الاحتفاظ بفواصل الأسطر في نصوص التعليمات البرمجية في العرض. الترميز الإضافي مثل {{كود|lang=HTML|code=<br />}} غير مطلوب، ولكن سيتم عرضه أيضًا إذا تم تضمينه. كما هو موضح أدناه، يمكن أيضًا إضافة المراجع المضمنة المنسقة بشكل صحيح إلى كلا النصين.

=== مثال كامل ===
المعاملات {{وسيط|attr1}} و {{وسيط|attr2}} اختيارية، ويجب تسميتها، ولا تحتفظ بفواصل الأسطر في الكود. وهي تهدف إلى تضمين الإسنادات لـ (1) النص الأصلي و(2) الترجمة. يمكن استخدام أيًا منهما، أو كلاهما، أو لا شيء منهما. سيتم عرض محتواهما مسبوقًا بشرطة وبنص مخفض قليلاً. هذه النصوص لا تلتف تلقائيًا؛ إذا كان اللف الآلي مطلوبًا، يمكن استخدام {{كود|lang=HTML|code=<br />}} كما هو موضح أدناه.

المعامل {{وسيط|lang}} اختياري، والذي يحتوي على رمز اللغة، بنفس تنسيق قالب {{قا|رمز اللغة}}. على سبيل المثال:

{{Markupv
|markup=<syntaxhighlight lang="wikitext">
{{ترجمة أدب|lang=es|rtl2=y
|¿Qué es la vida? — Una ilusión,
Una sombra, una ficción,
Y el mayor bien es pequeño;
Que toda la vida es sueño,
Y los sueños sueño son.<ref>{{استشهاد بكتاب|عنوان=La vida es sueño|الأخير=Calderón de la Barca|الأول=Pedro|مؤلف-وصلة=Pedro Calderón de la Barca|محرر-الأخير=Comfort|محرر-الأول=William Wistar|مكان=New York|ناشر=American Book Company|تاريخ=1904|صفحة=104|مسار=https://archive.org/details/lavidaessueo00comfgoog}}</ref>
|ما هي الحياة؟ - وهمٌ،
ظلٌ، خيالٌ، والخير الأكبر صغيرٌ،
فالحياة كلها حلمٌ،
والأحلام بدورها أحلام.<ref>كالديرون دراماس، ص 78-79. لندن: هنري اس. كينغ آند كو، 1873.</ref>
|attr1=[[بيدرو كالديرون دي لا باركا]]: [[الحياة حلم]]<br />الفصل الثاني ، المشهد 19 ، الأسطر 1197-1201
|attr2=دينيس فلورنس ماك كارثي
}}
{{مراجع}}
</syntaxhighlight>
|renders=<nowiki/>{{ترجمة أدب|lang=es|rtl2=y
|¿Qué es la vida? — Una ilusión,
Una sombra, una ficción,
Y el mayor bien es pequeño;
Que toda la vida es sueño,
Y los sueños sueño son.<ref>{{استشهاد بكتاب|عنوان=La vida es sueño|الأخير=Calderón de la Barca|الأول=Pedro|مؤلف-وصلة=Pedro Calderón de la Barca|محرر-الأخير=Comfort|محرر-الأول=William Wistar|مكان=New York|ناشر=American Book Company|تاريخ=1904|صفحة=104|مسار=https://archive.org/details/lavidaessueo00comfgoog}}</ref>
|ما هي الحياة؟ - وهمٌ،
ظلٌ، خيالٌ، والخير الأكبر صغيرٌ،
فالحياة كلها حلمٌ،
والأحلام بدورها أحلام.<ref>كالديرون دراماس، ص 78-79. لندن: هنري اس. كينغ آند كو، 1873.</ref>
|attr1=[[بيدرو كالديرون دي لا باركا]]: [[الحياة حلم]]<br />الفصل الثاني ، المشهد 19 ، الأسطر 1197-1201
|attr2=دينيس فلورنس ماك كارثي
}}
{{مراجع}}
}}
لاحظ أن الترميز <syntaxhighlight lang="wikitext" inline><ref>...</ref></syntaxhighlight> أضيف قبل معامل الإسناد.

=== تجاوز الخط المائل ===
إذا تم تعيين {{وسيط|italicsoff}} بأي قيمة، فسيتم إيقاف تشغيل الخط المائل للعمود الأول. هذا مفيد للنصوص الأصلية المكتوبة بأحرف غير لاتينية، والتي قد لا تكون الحروف المائلة مفيدة أو مناسبة لها:

{{توصيف|
<syntaxhighlight lang="wikitext">
{{ترجمة أدب|lang=ka|italicsoff=y|
მელნად ვიხმარე გიშრის ტბა და კალმად მე ნა რხეული,
ვინცა ისმინოს, დაესვას ლახვარი გულსა ხეული.
|attr1=[[شوتا روستافلي]]: من [[الفارس ذو جلد النمر]]
|للحبر استخدمت بحيرة من الأسود اللامع، وللقلم استخدمت بلورة مرنة.
من يسمع، سيخترق قلبه رمح متشابك.}}
</syntaxhighlight>
|{{ترجمة أدب|lang=ka|italicsoff=y|
მელნად ვიხმარე გიშრის ტბა და კალმად მე ნა რხეული,
ვინცა ისმინოს, დაესვას ლახვარი გულსა ხეული.
|attr1=[[شوتا روستافلي]]: من [[الفارس ذو جلد النمر]]
|للحبر استخدمت بحيرة من الأسود اللامع، وللقلم استخدمت بلورة مرنة.
من يسمع، سيخترق قلبه رمح متشابك.}}
}}

=== نص يمين-إلى-يسار ===
إذا تم تعيين {{وسيط|rtl1}} على أي قيمة، فإن نص العمود الأول يتم محاذاته إلى اليمين. هذا مفيد للنصوص الأصلية في اللغات التي تكتب من اليمين إلى اليسار مثل العربية، كما هو موضح أدناه:
{{توصيف|
<syntaxhighlight lang="wikitext">
{{ترجمة أدب|lang=ar|italicsoff=y|rtl1=y|
خل الذنوب صغيرهاو كبيرها ذاك التقى
و اصنع كماش فوق أرض الشوك يحذر ما يرى
لا تحقرن صغيرةً إن الجبال من الحصى
|Abandon sins, big and small – that is Tawqa
And be like the one who walks on a thorny path, he is cautious of what he sees
Do not belittle the small sins; truly mountains are made from pebbles}}
</syntaxhighlight>
|{{ترجمة أدب|lang=ar|italicsoff=y|rtl1=y|
خل الذنوب صغيرهاو كبيرها ذاك التقى
و اصنع كماش فوق أرض الشوك يحذر ما يرى
لا تحقرن صغيرةً إن الجبال من الحصى
|Abandon sins, big and small – that is Tawqa
And be like the one who walks on a thorny path, he is cautious of what he sees
Do not belittle the small sins; truly mountains are made from pebbles}}
}}

== نصائح ==
=== أحرف خاصة ===
كما هو الحال مع العديد من القوالب الأخرى، إذا ظهرت الأحرف <code>=</code> أو <code><nowiki>|</nowiki></code> في نصوص الأبيات، فستؤدي إلى تعطيل عرض القالب. أسهل حل هو استبدالها بـ <code>{{[[قالب:=|=]]}}</code> أو {{tlx|!}} على التوالي.

=== ترميز اللغة ===
يغطي المعامل {{وسيط|lang}} الكتلة الأولى من النص في هذا القالب. من الأفضل إضافة رمز اللغة لاي نص آخر غير العربية، كما هو موضح في قسم [[#مثال كامل|المثال الكامل أعلاه]].

يشبه المعامل {{وسيط|lang2}} المعامل {{وسيط|lang}} ولكن يغطي الكتلة الثانية من النص.

=== الإزاحة ===
المسافة البادئة الذي يوفرها هذا القالب تقريبًا تساوي {{كود|lang=HTML|code=<blockquote>}} و {{xtag|poem}} في الأمثلة التالية:

{{توصيف|
<syntaxhighlight lang="wikitext">
نص.
<blockquote>نص بمسافة بادئة.</blockquote>
نص إضافي.
</syntaxhighlight>
|نص.
<blockquote>نص بمسافة بادئة.</blockquote>
نص إضافي.
}}
{{توصيف|
<syntaxhighlight lang="wikitext">
نص.
<poem style="margin-left: 3em; font-style:italic">نص بمسافة بادئة.</poem>
نص إضافي.
</syntaxhighlight>
|نص.
<poem style="margin-left: 3em; font-style:italic">نص بمسافة بادئة.</poem>
نص إضافي.
}}

ومع ذلك، يبدو مختلفًا بشكل ملحوظ على الهواتف المحمولة، ويفتقر إلى دلالة {{كود|lang=HTML|code=<blockquote>}}.

=== النثر ===
على الرغم من أن القالب محسّن للشعر، إلا أنه يعمل بنفس الكفاءة للنثر. على سبيل المثال:
{{ترجمة أدب|lang=la|
Gallia est omnis divisa in partes tres, quarum unam incolunt Belgae, aliam Aquitani, tertiam qui ipsorum lingua Celtae, nostra Galli appellantur. Hi omnes lingua, institutis, legibus inter se differunt. Gallos ab Aquitanis Garumna flumen, a Belgis Matrona et Sequana dividit. Horum omnium fortissimi sunt Belgae, propterea quod a cultu atque humanitate provinciae longissime absunt, minimeque ad eos mercatores saepe commeant atque ea quae ad effeminandos animos pertinent important, proximique sunt Germanis, qui trans Rhenum incolunt, quibuscum continenter bellum gerunt. Qua de causa Helvetii quoque reliquos Gallos virtute praecedunt, quod fere cotidianis proeliis cum Germanis contendunt, cum aut suis finibus eos prohibent aut ipsi in eorum finibus bellum gerunt.|attr1=[[يوليوس قيصر]], ''{{رمز لغة|la|[[تعليقات على الحرب الغالية]]}}'' 1.1
|All Gaul is divided into three parts, one of which the Belgae inhabit, the Aquitani another, those who in their own language are called Celts, in our Gauls, the third. All these differ from each other in language, customs and laws. The river Garonne separates the Gauls from the Aquitani; the Marne and the Seine separate them from the Belgae. Of all these, the Belgae are the bravest, because they are furthest from the civilization and refinement of [our] Province, and merchants least frequently resort to them, and import those things which tend to effeminate the mind; and they are the nearest to the Germans, who dwell beyond the Rhine, with whom they are continually waging war; for which reason the Helvetii also surpass the rest of the Gauls in valor, as they contend with the Germans in almost daily battles, when they either repel them from their own territories, or themselves wage war on their frontiers.|attr2=translated by W.A. McDevitte and W.S. Bohn}}

== بيانات القالب ==
<templatedata>
{
 "description": "يمكن استخدام هذا القالب لتوفير ترجمة جنبًا إلى جنب لنص ما.",
 "params": {
 "1": {
 "label": "النص الأصلي ",
 "type": "unknown",
 "autovalue": "",
 "required": true
 },
 "2": {
 "label": "الترجمة",
 "type": "unknown",
 "autovalue": "",
 "required": true
 },
 "head1": {
 "label": "عنوان أو عنوان النص الأصلي"
 },
 "head2": {
 "label": "عنوان أو عنوان النص المترجم."
 },
 "italicsoff": {
 "label": "إيقاف الخط العريض (النص الأصلي)",
 "description": "إذا تم تعيينها على أي قيمة، فإن الخط العريض في العمود الأول يتم إيقافه. هذا مفيد للنصوص الأصلية في النصوص غير اللاتينية، حيث قد لا يكون الخط العريض مفيدًا أو مناسبًا.",
 "example": "y"
 },
 "italicsoff2": {
 "label": "إيقاف الخط العريض (الترجمة)",
 "description": "إذا تم تعيينها على أي قيمة، فإن الخط العريض في العمود الثاني يتم إيقافه. هذا مفيد للنصوص الأصلية في النصوص غير اللاتينية، حيث قد لا يكون الخط العريض مفيدًا أو مناسبًا.",
 "example": "y"
 },
 "rtl1": {
 "label": "من اليمين إلى اليسار (النص الأصلي)",
 "description": "إذا تم تعيينها على أي قيمة، فإن النص في العمود الأول يتم محاذاته إلى اليمين. هذا مفيد للنصوص الأصلية في اللغات التي تكتب من اليمين إلى اليسار مثل العربية.",
 "example": "y"
 },
 "rtl2": {
 "label": "من اليمين إلى اليسار (الترجمة)",
 "description": "إذا تم تعيينها على أي قيمة، فإن النص في العمود الثاني يتم محاذاته إلى اليمين. هذا مفيد للنصوص الأصلية في اللغات التي تكتب من اليمين إلى اليسار مثل البشتو.",
 "example": "y"
 },
 "lang": {
 "label": "رمز اللغة (النص الأصلي)",
 "description": "رمز اللغة ISO 639 أو علامة اللغة IETF للعمود الأول من النص.",
 "example": "fr"
 },
 "lang2": {
 "label": "رمز اللغة (الترجمة)",
 "description": "رمز اللغة ISO 639 أو علامة اللغة IETF للعمود الثاني من النص.",
 "example": "it"
 },
 "attr1": {
 "label": "الإسناد (النص الأصلي)",
 "description": "الإسنادات للنص الأصلي",
 "example": "رينيه ديكارت (1644) ، ''مبادئ الفلسفة''"
 },
 "attr2": {
 "label": "الإسناد (الترجمة)",
 "description": "الإسنادات للترجمة",
 "example": "جون سميث (1959)"
 },
 "width": {
 "label": "العرض (جميع النصوص)",
 "description": "تحديد عرض القالب الذي يحتوي على المحتوى بأكمله.",
 "example": "100%"
 }
 },
 "paramOrder": [
 "1",
 "2",
 "head1",
 "head2",
 "lang",
 "italicsoff",
 "rtl1",
 "attr1",
 "lang2",
 "italicsoff2",
 "rtl2",
 "attr2",
 "width"
 ]
}
</templatedata>

== انظر أيضًا ==
{{Quotation templates}}

<includeonly>{{ملعب آخر||
}}</includeonly>