قالب:Infobox - ويكيبيديا

قالب:صندوق معلومات مُصمَّم ليكون قالبًا أساسياً، أي قالب يُستخدم لبناء قوالب أخرى. ملاحظة: بوجه عام، لا يُقصد به أن يُستخدم مباشرةً في المقالة، ولكن يمكن استعماله في حالة فردية إذا لزم الأمر. تحتوي صفحة مساعدة:صندوق معلومات على مقدمة حول المحتوى والتصميم الموصى بهما لصناديق المعلومات، بينما تحتوي صفحة ويكيبيديا:دليل الأسلوب/صناديق المعلومات على إرشادات إضافية للأسلوب. انظر ويكيبيديا:قائمة صناديق المعلومات وتصنيف:قوالب صناديق معلومات للحصول على قوائم بصناديق المعلومات الجاهزة والمتخصصة في مواضيع محددة.

الاستخدامات

{{قالب:صندوق معلومات}} هو قالب أساسي يُستخدم لتنظيم قالب معلومات فعلي {{صندوق معلومات موضوع معين}} (مثل {{صندوق معلومات ملكية}}). بالنسبة إلى [[قالب:صندوق معلومات موضوع معين]]، فإن كود القالب سيكون على النحو التالي (بصيغة مبسّطة):

{{Infobox
| name     = {{{name|{{PAGENAME}}}}}
| image    = {{{image|}}}
| caption1 = {{{caption|}}}

| label1   = Former names
|  data1   = {{{former_names|}}}

| header2  = General information

| label3   = Status
|  data3   = {{{status|}}}
... <!-- etc. -->
}}

معلمات تحكم اختيارية

name

إذا تم استخدام هذه المعلمة، فستُضاف روابط "عرض، نقاش، تعديل" أسفل صندوق المعلومات تشير إلى الصفحة المسماة، مع إضافة البادئة قالب: إذا لم يتم تحديد نطاق (namespace). يمكنك استخدام القيمة {{subst:PAGENAME}}؛ ومع ذلك نادرًا ما يكون هذا هو المطلوب لأن ذلك سيؤدي إلى إرسال المستخدمين الذين ينقرون على هذه الروابط في صندوق المعلومات إلى كود القالب نفسه بدلًا من البيانات التي قد يرغبون في تعديلها.

child

انظر قسم الدمج للتفاصيل. إذا تم ضبط هذه القيمة على "yes"، فإن صندوق المعلومات الفرعي هذا سيكون له عنوان، لكن بدون معلمة name. هذه المعلمة فارغة افتراضيًا، ضع "yes" لتفعيلها.

subbox

انظر قسم الصناديق الفرعية للتفاصيل. إذا تم ضبط هذه القيمة على "yes"، فإن هذا الصندوق الفرعي سيكون له عنوان، لكن بدون معلمة name. هذه المعلمة فارغة افتراضيًا، ضع "yes" لتفعيلها. ليس لها أي تأثير إذا كانت معلمة |child= مضبوطة على "yes".

decat

إذا تم ضبطها على "yes"، فلن تُضاف الصفحة الحالية تلقائيًا إلى تصنيف صيانة عندما يحتوي صندوق المعلومات الناتج على مشاكل أو لا يحتوي على قسم بيانات مرئي. اتركها فارغة افتراضيًا أو ضع "yes" لتفعيلها.

autoheaders

إذا تم ضبطها على أي قيمة غير فارغة، فسيتم إخفاء العناوين التي لا يتبعها حقول بيانات. انظر قسم "إخفاء العناوين عند خلو جميع حقول البيانات" لمزيد من التفاصيل.

معلمات المحتوى

Title

هناك طريقتان مختلفتان لوضع عنوان في صندوق المعلومات، إما أن يكون العنوان داخل حدود الصندوق في الخلية العليا من الجدول. أو يوضع كتعليق (caption) فوق الجدول. يمكنك استخدام الطريقتين معًا، أو إحداهما فقط، أو عدم استخدام أي منهما (مع أن ذلك غير مستحسن):

title

النص الذي يُوضع كتعليق فوق الجدول (أو كعنوان قسم قبل كامل محتوى الجدول إذا كان صندوق معلومات فرعي). لأسباب تتعلق بـإتاحة الوصول، فهذا هو الخيار الأكثر توصية.

above

النص الذي يُوضع داخل الخلية العليا من الجدول.

subheader(n)

حقول عناوين إضافية توضع أسفل |title= و|above=، ولكن قبل الصور.

أمثلة:

{{Infobox
 | name       = {{subst:PAGENAME}}
 | title      = النص الموجود في خانة التعليق فوق صندوق المعلومات
 | subheader  = Subheader of the infobox
 | header     = (the rest of the infobox goes here)
}}

{{Infobox
 | name       = {{subst:PAGENAME}}
 | above      = النص في الخلية العُليا داخل صندوق المعلومات
 | subheader  = Subheader of the infobox
 | subheader2 = Second subheader of the infobox
 | header     = (the rest of the infobox goes here)
}}

صور توضيحية

image(n)

الصور التي تُعرض في أعلى القالب. استخدم صيغة الصورة الكاملة، مثل [[File:example.png|200px|alt=نص بديل للصورة]]. الصورة تُوسّط تلقائيًا. راجع:النص البديل لمزيد من المعلومات عن النص البديل (alt text).

caption(n)

النص الذي يُوضع تحت الصور.

البيانات الرئيسية

header(n)

النص المستخدم كعنوان في الصف رقم ر.

label(n)

النص المستخدم كتسمية في الصف رقم ر.

data(n)

النص المعروض كبيانات في الصف رقم ر.

ملاحظة: لكل قيمة معينة لـ (ر)، ليست كل تركيبات المعاملات مسموحة. وجود |header(n)= يؤدي إلى تجاهل |data(n)= و|rowclass(n)= و|label(n)= المرتبطة به (انظر أدناه). كما أن غياب |data(n)= يؤدي إلى تجاهل |label(n)= المرتبطة به. التركيبات الصالحة لأي صف واحد هي: |class(n)= |header(n)= |rowclass(n)= |class(n)= |data(n)= |rowclass(n)= |label(n)= |class(n)= |data(n)= راجع طريقة عرض header4 و label4 و data4 في قسم الأمثلة أدناه.

نطاقات الأرقام

للسماح بالمرونة عند تغيير تخطيط صندوق المعلومات، قد يكون من المفيد عند تطوير صندوق المعلومات استخدام أرقام غير متتابعة لصفوف العناوين والملصقات/البيانات. بحيث يمكن إدخال معاملات لصفوف جديدة في المستقبل دون الحاجة إلى إعادة ترقيم المعاملات الحالية. على سبيل المثال:

 | header3  = Section 1
 |  label5  = Label A
 |   data5  = Data A
 |  label7  = Label C
 |   data7  = Data C
 | header10 = Section 2
 |  label12 = Label D
 |   data12 = Data D

يمكن أيضًا إعادة ترقيم أسماء المعاملات تلقائيًا باستخدام User:Frietjes/infoboxgap.js أو Module:IncrementParams. لا يوجد حد أقصى للأرقام، ولكن يجب ألا يزيد الفاصل بين كل رقم مستخدم وآخر عن 50.

جعل حقول البيانات اختيارية

الصف الذي يحتوي على تسمية (label) دون بيانات (data) لا يُعرض. هذا يُتيح إنشاء صفوف محتوى اختيارية بسهولة داخل صندوق المعلومات. لجعل صف ما اختياريًا، استخدم معاملًا تكون قيمته الافتراضية سلسلة فارغة، كما في المثال التالي:

 | label5 = Population
 |  data5 = {{{population|}}}

بهذه الطريقة، إذا لم يحدد المقال معامل السكان (population) في صندوق المعلومات الخاص به، فلن يتم عرض الصف الخاص بهذا المعامل. بالنسبة للحقول الأكثر تعقيدًا والتي تحتوي على محتوى منسق مسبقًا قد يظهر حتى لو لم يتم تعيين المعامل، يمكنك استخدام تعبير شرط "#if" لجعل هذا المحتوى كله يختفي عندما لا يُستخدم المعامل. على سبيل المثال، تعبير "#if" في المثال التالي يقرأ: "إذا تم توفير المعامل mass، فاعرضه، يليه وحدة 'kg'":

 | label6 = Mass
 |  data6 = {{ #if: {{{mass|}}} | {{{mass}}} kg }}

للمزيد عن دالة #if، انظر هنا.

إخفاء العناوين عند خلو جميع حقول البيانات الخاصة بها

يمكنك أيضًا جعل العناوين تُخفى تلقائيًا عندما يكون القسم الخاص بها فارغًا (أي لا يظهر أي صف بيانات فيه).

ضع في اعتبارك هذا المثال:

{{Infobox
 | title   = Example: header with & without data
 | headerstyle = background: lightgrey

 | header1 = Header1 with empty section
 |  label2 = label2 text |  data2 =
 |  label3 = label3 text |  data3 =
 |  label4 = label4 text |  data4 =

 | header5 = Header5 with data below
 |  label6 = label6 text |   data6 = Some value
}}

إذا أردت إخفاء العنوان عندما لا توجد قيم في |dataN=، استخدم المعامل |autoheaders=y

{{Infobox
 | title   = Example: header with & without data
 | autoheaders = y
 | headerstyle = background: lightgrey

 | header1 = Header1 with empty section
 |  label2 = label2 text |  data2 =
 |  label3 = label3 text |  data3 =
 |  label4 = label4 text |  data4 =

 | header5 = Header5 with data below
 |  label6 = label6 text |  data6 = Some value
}}

إذن، سيتم عرض header1 إذا تم تعريف أي من المعاملات item1 أو item2 أو item3. وإذا لم يُعرّف أي من هذه المعاملات الثلاثة، فلن يُعرض العنوان ولن يظهر صف فارغ قبل المحتوى التالي الظاهر. ملاحظة: إذا احتوت البيانات على عناصر CSS فارغة، مثل |data=<span style="background:yellow;"></span>=، فسيتم اعتبارها غير فارغة (أي تحتوي على بيانات). إذا تم استخدام |autoheaders=y، ولكن هناك عناصر لا ترغب بأن تؤدي إلى ظهور العنوان، ضع |headerX=_BLANK_. هذا سيعمل كعنوان فارغ ويفصل بينه وبين العناصر التالية.

{{Infobox
 | title   = Example: blank header with & without data
 | autoheaders = y
 | headerstyle = background: lightgrey

 | header1 = Header1 with empty section
 |  label2 = label2 text |  data2 =
 |  label3 = label3 text |  data3 =
 |  label4 = label4 text |  data4 =

 | header5 = _BLANK_
 |  label6 = label6 text |  data6 = Some value, but does not trigger header1 or show header5
}}

التذييل

below

النص الذي يوضع في الخلية السفلية. تُستخدم الخلية السفلية عادةً للملاحظات، "انظر أيضًا"، ومعلومات أخرى مشابهة.

معلمات العرض

العناوين المائلة

يمكن جعل عناوين المقالات التي تحتوي على صناديق معلومات مائلة، بما يتوافق مع خط المائل والتنسيقات الأخرى، عبر تمرير معامل italic title: تفعيل العناوين المائلة بتمرير |italic title= من صندوق المعلومات. يكون إيقاف الميزة افتراضيًا (خاصةً لأن الخط المائل يمكن عرضه بأمان فقط للخط اللاتيني، وقد يكون ضروريًا لتمييز اللغات الأجنبية عن اللغة الإنجليزية المحلية في ذلك الخط، لكن قد يكون صعب القراءة للخطوط الأخرى)، مع السماح بتفعيلها في بعض الحالات عبر تمرير |italic title=no. عدم جعل أي عنوان مائلاً بعدم تمرير المعامل على الإطلاق.

تنسيق CSS

فئات HTML والمايكرو فورمات

يدعم هذا القالب إضافة معلومات مايكرو فورمات (microformat) عبر إضافة سمات "class" إلى خلايا البيانات المختلفة، لتحديد نوع المعلومات المحتواة فيها. يمكن تحديد أسماء متعددة للـclass مفصولة بمسافات، بعضها يستخدم كمحددات لتنسيقات مخصصة وفق سياسة المشروع أو حسب الواجهة المستخدمة في تفضيلات المستخدم، وبعضها يستخدم للمايكرو فورمات.

لتعليم صندوق المعلومات على احتواء معلومات hCard، على سبيل المثال، أضف المعامل التالي:

ولكل صف يحتوي على خلية بيانات تشكل جزءًا من بطاقة vCard، أضف معلمة class المقابلة له، مثل:

 | class1 = fn
 | class2 = org
 | class3 = tel

...وهكذا. يمكن أيضًا إضافة فئات (classes) لـ "above" و "title" لأنهما غالبًا ما يُستخدمان لعرض اسم موضوع صندوق المعلومات. للمزيد من المعلومات حول إضافة معلومات مايكرو فورمات إلى ويكيبيديا، راجع Wikipedia:WikiProject Microformats، وللمزيد عن المايكرو فورمات بشكل عام راجع التنسيقات الدقيقة.

الأمثلة

لاحظ كيف أن الصف لا يظهر في صندوق المعلومات المعروض عندما يتم تعريف تسمية (label) بدون وجود خلية بيانات مصاحبة، وكيف يتم عرض جميع الصفوف عندما يتم تعريف عنوان (header) في نفس الصف مع خلية بيانات. كما لاحظ أن العناوين الفرعية (subheaders) لا تكون بخط عريض (bold) بشكل افتراضي مثل العناوين الرئيسية التي تُستخدم لتقسيم قسم البيانات الرئيسي، لأن هذه الوظيفة مخصصة لخلية الـ "above":

Test Infobox

Above text
Caption displayed below File:Example-serious.jpg
Data defined alone
Label and data defined (label)	Label and data defined (data)
Below text

{{Infobox
 |name         = Infobox/doc
 |bodystyle    = 

 |titlestyle   = 
 |abovestyle   = background: #cfc;
 |subheaderstyle =
 |title        = Test Infobox
 |above        = Above text
 |subheader    = Subheader above image
 |subheader2   = Second subheader

 |imagestyle   = 
 |captionstyle = 
 |image        = [[File:Example-serious.jpg|200px|alt=Example alt text]]
 |caption      = Caption displayed below File:Example-serious.jpg

 |headerstyle  = background: #ccf;
 |labelstyle   = background: #ddf;
 |datastyle    = 

 |header1 = Header defined alone
 | label1 = 
 |  data1 = 
 |header2 = 
 | label2 = Label defined alone does not display (needs data, or is suppressed)
 |  data2 = 
 |header3 =
 | label3 = 
 |  data3 = Data defined alone
 |header4 = All three defined (header, label, data, all with same number)
 | label4 = does not display (same number as a header)
 |  data4 = does not display (same number as a header)
 |header5 =
 | label5 = Label and data defined (label)
 |  data5 = Label and data defined (data)

 |belowstyle = background: #ddf;
 |below      = Below text
}}

في هذا المثال، يتم استخدام معلمتي |bodystyle= و|labelstyle= لضبط عرض صندوق المعلومات وتحديد عرض افتراضي لعمود التسميات:

{{Infobox
 |name        = Infobox/doc
 |bodystyle   = width: 20em

 |titlestyle  = 
 |title       = Test Infobox

 |headerstyle = 
 |labelstyle  = width: 33%
 |datastyle   = 

 |header1 = 
 | label1 = Label 1
 |  data1 = Data 1
 |header2 = 
 | label2 = Label 2
 |  data2 = Data 2
 |header3 = 
 | label3 = Label 3
 |  data3 = Data 3
 |header4 = Header 4
 | label4 = 
 |  data4 = 
 |header5 = 
 | label5 = Label 5
 |  data5 = Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

 |belowstyle = 
 |below = Below text
}}

الدمج

يمكن دمج قالب صندوق معلومات داخل آخر باستخدام معامل |child=. تُستخدم هذه الميزة لإنشاء صندوق معلومات معياري أو لتقسيم الصندوق إلى أقسام منطقية محددة بشكل أفضل. سابقاً كان من الضروري استخدام الدمج لإنشاء صناديق معلومات تزيد عن 99 صفًا، أما الآن فلا يوجد حد لعدد الصفوف في نسخة واحدة من {{infobox}}.

{{Infobox
 | title = Top level title
 | data1 = {{Infobox | decat = yes | child = yes
    | title = First subsection
    | label1= Label 1.1
    | data1 = Data 1.1
   }}
 | data2 = {{Infobox | decat = yes | child = yes
  |title = Second subsection
  | label1= Label 2.1
  | data1 = Data 2.1
  }}
 | belowstyle = 
 | below = Below text
}}

لاحظ في الأمثلة أعلاه أن صندوق المعلومات الفرعي موضوع في حقل data وليس header. ولاحظ أن العناوين الفرعية للأقسام ليست بخط عريض إذا لم يتم تحديد ذلك صراحةً. للحصول على عناوين أقسام بخط عريض، ضع صندوق المعلومات الفرعي في حقل header (وليس في label لأن هذا الأخير لن يُعرض!)، وذلك إما باستخدام:

{{Infobox
 | title = Top level title
 | header1 = {{Infobox | decat = yes | child = yes
    | title = First subsection
    | label1= Label 1.1
    | data1 = Data 1.1
   }}
 | header2 = {{Infobox | decat = yes | child = yes
    | title = Second subsection
    | label1= Label 2.1
    | data1 = Data 2.1
   }}
 | belowstyle = 
 | below = Below text
}}

أو باستخدام:

{{Infobox
 | title = Top level title
 | header1 = First subsection
   {{Infobox | decat = yes | child = yes
    | label1 = Label 1.1
    |   data1 = Data 1.1
   }}
 | header2 = Second subsection
   {{Infobox | decat = yes | child = yes
    | label1 = Label 2.1
    |  data1 = Data 2.1
   }}
 | belowstyle = 
 | below = Below text
}}

لاحظ أن إغفال معامل |title=، وعدم إضافة نص قبل صندوق المعلومات المُضمّن، قد يؤدي إلى ظهور صفوف جدول فارغة غير مرغوب فيها، مما يسبب فجوات في العرض البصري. يمكن إخفاء هذه النواتج غير المرغوب فيها باستخدام |rowstyleN=display: none مع استبدال ر برقم الصف (البيانات أو العنوان). لمزيد من الأمثلة والمقالات التي تتضمن صناديق معلومات ضمن صناديق أخرى، راجع Wikipedia:WikiProject Infoboxes/embed.

الصناديق الفرعية

طريقة بديلة للدمج هي استخدام المعامل |subbox=yes، والذي يزيل الإطار الخارجي من صندوق المعلومات الفرعي، مع المحافظة على الهيكل الداخلي للصندوق. ميزة هذه الطريقة هي أن الصندوق الأصل (الأب) والصندوق الفرعي (الابن) لا يشتركان بالضرورة في نفس الهيكل، ولا تكون خلايا التسمية والبيانات مصطفة بين الصندوقين لأنهما ليسا ضمن نفس جدول الأب. مثال:

{{Infobox
 | headerstyle = background-color: #eee;
 | labelstyle  = background-color: #eee;
 | header1 = Main 1
 | header2 = Main 2
 |   data3 = {{Infobox | subbox = yes
    | headerstyle = background-color: #ccc;
    | labelstyle  = background-color:#ddd;
    | header1 = Sub 3-1
    | header2 = Sub 3-2
    |  label3 = Label 3-3    |   data3 = Data 3-3
   }}
 |   data4 = {{Infobox | subbox = yes
    | labelstyle  = background-color: #ccc;
    |  label1 = Label 4-1    |   data1 = Data 4-1
   }}
 |  label5 = Label 5 |   data5 = Data 5
 | header6 = Main 6
}}

يمكن استخدام تقنيات دمج مشابهة داخل معلمات المحتوى لبعض القوالب الأخرى التي تولد جداول (مثل شريط جانبي):

{{Sidebar
 | navbar = off
 | headingstyle = background-color: #eee;
 | heading1 = Heading 1
 | heading2 = Heading 2
 | content3 = {{Infobox | subbox = yes
    | headerstyle = background-color: #ccc;
    | labelstyle = background-color: #ddd;
    | header1 = Sub 3-1
    | header2 = Sub 3-2
    |  label3 = Label 3-3 |   data3 = Data 3-3
   }}
 | content4 = {{Infobox | subbox = yes
    | labelstyle = background-color: #ccc;
    |  label1 = Label 4-1 |   data1 = Data 4-1
   }}
 | heading5 = Heading 5
}}

لاحظ أن الحشو الافتراضي لخلية البيانات الأصلية التي تحتوي كل صندوق فرعي لا يزال ظاهرًا، لذا تكون الصناديق الفرعية أضيق قليلاً من الصندوق الأصل، وهناك تباعد عمودي أكبر بين خلايا الصندوق الأصل مقارنة بالخلايا داخل صناديق فرعية منفصلة.

التحكم في كسر السطر داخل القوائم غير المرتبة المضمنة

يمكن استخدام القالب {{فراغات}} مع {{wbr}} و{{بدون لف}} للتحكم في كسر الأسطر داخل القوائم غير المرتبة (بدون نقاط) المضمنة في صناديق المعلومات (مثل قائمة الممثلين في {{صندوق معلومات فيلم}})، وذلك لمنع التفاف الإدخالات الطويلة بطريقة قد تُفسر على أنها عدة إدخالات منفصلة. للاطلاع على التفاصيل، انظر قالب:wbr.

الصيغة الكاملة الفارغة

(ملاحظة: لا يوجد حد لعدد الصفوف الممكنة؛ يتم هنا عرض 20 صفًا فقط لأنها تعتبر كافية في أغلب الحالات. يمكن تمديد الترقيم حسب الحاجة. كما أن معلمات "class" الخاصة بالمايكرو فورمات لم تُدرج لأنها غير مستخدمة بشكل شائع.)

{{Infobox
| name           = {{subst:PAGENAME}}
| child          = {{{child|}}}
| subbox         = {{{subbox|}}}
| italic title   = {{{italic title|no}}}
| templatestyles = 
| child templatestyles = 
| grandchild templatestyles = 
| bodystyle      = 

| titlestyle     = 
| abovestyle     = 
| subheaderstyle = 
| title          = 
| above          = 
| subheader      = 

|   imagestyle   = 
| captionstyle   = 
|   image        = 
| caption        = 
|   image2       = 
| caption2       = 

| headerstyle    = 
|  labelstyle    = 
|   datastyle    = 
| header1  = 
|  label1  = 
|   data1  = 
| header2  = 
|  label2  = 
|   data2  = 
| header3  = 
|  label3  = 
|   data3  = 
| header4  = 
|  label4  = 
|   data4  = 
| header5  = 
|  label5  = 
|   data5  = 
| header6  = 
|  label6  = 
|   data6  = 
| header7  = 
|  label7  = 
|   data7  = 
| header8  = 
|  label8  = 
|   data8  = 
| header9  = 
|  label9  = 
|   data9  = 
| header10 = 
|  label10 = 
|   data10 = 
| header11 = 
|  label11 = 
|   data11 = 
| header12 = 
|  label12 = 
|   data12 = 
| header13 = 
|  label13 = 
|   data13 = 
| header14 = 
|  label14 = 
|   data14 = 
| header15 = 
|  label15 = 
|   data15 = 
| header16 = 
|  label16 = 
|   data16 = 
| header17 = 
|  label17 = 
|   data17 = 
| header18 = 
|  label18 = 
|   data18 = 
| header19 = 
|  label19 = 
|   data19 = 
| header20 = 
|  label20 = 
|   data20 = 

| belowstyle     = 
| below          = 
}}

يتطلب قالب صندوق المعلومات وجود امتدادات سكريبتو وأنماط القوالب. يحتوي مشروع ترانزويكي على نسخة من هذا القالب تم تعديلها لتعمل على منصات ميدياويكي أخرى.

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

تصنيفات التتبع

انظر أيضا