وحدة:بطاقة/شرح
هذه صفحة توثيق وحدة:بطاقة الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه. |
صُنفت هذه الوحدة على أنها في مرحلة بيتا. عندما تصل الوحدة لهذه المرحلة، يمكن أن يوسع استخدامها في الصفحات الأخرى. لكن يجب توخي الحذر من أن الوحدات في هذه المرحلة ما زالت حديثة العهد لذلك وجب توخي الحذر عند الاستخدام وملاحظة أي أخطاء تنتج عنها. من العرف أن المجتمع سوف يوصل الوحدات في هذه المرحلة للتي بعدها عبر صفحات النقاش الخاصة بالوحدة أو أي مكان يعلن عن هذه الوحدة عبر ملاحظة أن هذه الوحدة تعمل بشكل صحيح والجميع راضٍ عن أدائها. |
لماذا هذا الأسلوب ؟
هذه الوحدة تعمل على جعل عملية استحداث قوالب البطاقات (أو قوالب معلومات أو Infobox) أسهل/أبسط ما يمكن من خلال تعريفات بسيطة في وحدات فرعية.
- المميزات
- استحداث القوالب يندرج ضمن عملية البرمجة واستعمال وحدات فرعية بلغة لوا (Lua) يضبط المكتوب لضمان غياب الأخطاء.
- عملية ترتيب البيانات المعروضة بسيطة ولا تستدعي تغيير الأرقام (مثلما هو الحال مع module:InfoBox).
- توفر مكتبات لجلب البيانات الأكثر استعمالا لاقتصاد الوقت والكود.
- الجمع في مكان واحد للمبرمج/المطور لتوفير التعليمات والشروح.
- توفر أدوات مساعدة لتحيين صفحة الشرح بصورة آنية وآلية أو نصف آلية (مثل : الصيغة وبيانات القالب ..) بعد تحيين الوحدة أو أحد المكتبات المساعدة.
الاستخدام
هذه الوحدة تستعمل لعرض قالب معلومات (Infobox) أو بطاقة بالاعتماد على وحدة فرعية تحتوي على بيانات حول مضمون هذا القالب. تسمح هذه الوحدة بإجراء استجوابات بصورة مبسطة لويكي بيانات لجلب ما توفر من البيانات.
استحداث قالب معلومة (أو بطاقة) يمر بخطوتين :
- إنشاء وحدة فرعية بعنوان من الشاكلة : وحدة:بطاقة/قالب/اسم_قالب
- مثال : وحدة:بطاقة/قالب/لعبة
- إنشاء قالب يستعمل لاحقا في المقالات. محتوى هذا القالب سيكون :
{{#استدعاء:بطاقة|تركيب|وحدة=اسم_الوحدة_الفرعية}}
- مثال :
{{#استدعاء:بطاقة|تركيب|وحدة=لعبة}}
- مثال :
محتوى الوحدة الفرعية
- محتوى فارغ
return {
maincolor = '#DDDDDD' -- اللون المستعمل لعنوان البطاقة
,parts = {} -- محتويات البطاقة
}
- محتوى نموذجي
local generic = require( 'وحدة:بطاقة/أدوات' )
return {
-- اللون المستعمل لعنوان البطاقة
maincolor = '#DDDDDD',
-- محتويات البطاقة
parts = {
generic.title(),
{type = 'subtitle', value = {'الاسم_الأصلي'}},
generic.logo(),
generic.mainimage(),
{type = 'table', title = 'معلومات عامة', rows = {
{type = 'row',
label = 'الصانع',
value ={'صانع','manufacturer'},
wikidata = {property='P176'}
},
{type = 'row',
label = 'أسماء أخرى',
value ={'أسماء_أخرى','aka'},
},
{type = 'row',
label = '[[شركة أم]]',
value ={'شركة_أم','parent_company'},
},
}},
}
}
- محتوى متقدم يجمع التعليمات بالشروح
return {
-- شرح مختصر عن وظيفة البطاقة
description = "بطاقة تعريفية عن ...",
-- اللون المستعمل لعنوان البطاقة
maincolor = '#DDDDDD',
-- محتويات البطاقة
parts = {
generic.title(),
{type = 'subtitle', value = {'الاسم_الأصلي'}},
generic.logo(),
generic.mainimage(),
{type = 'table', title = 'معلومات عامة', rows = {
{type = 'row',
label = 'الصانع',
value ={'صانع','manufacturer'},
wikidata = {property='P176'},
metadata = {
description = "تسمية صانع المنتج",
option = "required", -- تظهر عند التحرير المرئي على أنها معلومة ضرورية يجب توفيرها
type = "string",
}
},
{type = 'row',
label = 'أسماء أخرى',
value ={'أسماء_أخرى','aka'},
metadata = {
description = "أسماء أخرى متداولة",
option = "suggested",
type = "string",
}
},
{type = 'row',
label = 'تاريخ التأسيس',
value ={'تأسيس','founded'},
metadata = {
description = "تاريخ التأسيس الشركة",
option = "suggested",
-- تظهر عند التحرير المرئي على أنها معلومة تمثل تاريخا لذا وجب كتابة بنسق التواريخ.
type = "date"
}
},
}},
}
}
إحصائيات
الأيقونات المتوفرة
خلفية فاتحة | خلفية فاتحة وأيقونة على اليسار | خلفية داكنة |
---|---|---|
aerostat | aerostat | aerostat |
aikido | aikido | aikido |
alpinisme | alpinisme | alpinisme |
arbitre | arbitre | arbitre |
arc | arc | arc |
archives2 | archives2 | archives2 |
arduino | arduino | arduino |
electro | electro | electro |
artiste | artiste | artiste |
artsmartiauxjap | artsmartiauxjap | artsmartiauxjap |
association | association | association |
athletisme | athletisme | athletisme |
audio | audio | audio |
auteur | auteur | auteur |
autogire | autogire | autogire |
automobile | automobile | automobile |
avion | avion | avion |
aviron | aviron | aviron |
badminton | badminton | badminton |
baseball | baseball | baseball |
basket-ball | basket-ball | basket-ball |
bd | bd | bd |
biathlon | biathlon | biathlon |
biere | biere | biere |
book | book | book |
universite | universite | universite |
boxe | boxe | boxe |
calendrier | calendrier | calendrier |
camera | camera | camera |
canada | canada | canada |
cardinal | cardinal | cardinal |
catch | catch | catch |
chateau | chateau | chateau |
chimie | chimie | chimie |
cinema | cinema | cinema |
commonwealth | commonwealth | commonwealth |
communication | communication | communication |
cyclisme | cyclisme | cyclisme |
deportation | deportation | deportation |
diplomatie | diplomatie | diplomatie |
disney | disney | disney |
droit | droit | droit |
drone-civil | drone-civil | drone-civil |
egypte-antique | egypte-antique | egypte-antique |
entreprise | entreprise | entreprise |
entreprise-blanc | entreprise-blanc | entreprise-blanc |
equitation | equitation | equitation |
escalade | escalade | escalade |
escalade | escalade | escalade |
escrime | escrime | escrime |
espagne | espagne | espagne |
eveque | eveque | eveque |
factory | factory | factory |
floorball | floorball | floorball |
fondeur | fondeur | fondeur |
football | football | football |
footballblack | footballblack | footballblack |
footUS | footUS | footUS |
futsal | futsal | futsal |
golf | golf | golf |
grappe | grappe | grappe |
gymnastique | gymnastique | gymnastique |
handball | handball | handball |
handballblack | handballblack | handballblack |
helicoptere | helicoptere | helicoptere |
hockey | hockey | hockey |
hockey-sur-gazon | hockey-sur-gazon | hockey-sur-gazon |
hospitaliers | hospitaliers | hospitaliers |
humain | humain | humain |
informatique | informatique | informatique |
internet | internet | internet |
israel-judaisme | israel-judaisme | israel-judaisme |
jeu | jeu | jeu |
jeu-role | jeu-role | jeu-role |
jeuvideo | jeuvideo | jeuvideo |
jeuvideov3 | jeuvideov3 | jeuvideov3 |
judo | judo | judo |
karate | karate | karate |
kayak | kayak | kayak |
kickboxing | kickboxing | kickboxing |
lutte | lutte | lutte |
macintosh | macintosh | macintosh |
malte | malte | malte |
map | map | map |
medecine | medecine | medecine |
mets | mets | mets |
militaire | militaire | militaire |
money | money | money |
money_coin | money_coin | money_coin |
montreal-metro | montreal-metro | montreal-metro |
metro | metro | metro |
montreal-train | montreal-train | montreal-train |
moteur-avion | moteur-avion | moteur-avion |
mosque | mosque | mosque |
musee | musee | musee |
museum | museum | museum |
papyrus | papyrus | papyrus |
musique | musique | musique |
music | music | music |
natation | natation | natation |
nations-unies | nations-unies | nations-unies |
omnisports | omnisports | omnisports |
palace | palace | palace |
paralympique | paralympique | paralympique |
persofiction | persofiction | persofiction |
petrole | petrole | petrole |
planeur | planeur | planeur |
plateforme | plateforme | plateforme |
poker | poker | poker |
presse | presse | presse |
pretendant | pretendant | pretendant |
projet | projet | projet |
project | project | project |
psychologie | psychologie | psychologie |
quebec | quebec | quebec |
recherche | recherche | recherche |
rinkhockey | rinkhockey | rinkhockey |
rome-antique | rome-antique | rome-antique |
route | route | route |
rugby | rugby | rugby |
rugbyblack | rugbyblack | rugbyblack |
satellite | satellite | satellite |
sautski | sautski | sautski |
science-fiction | science-fiction | science-fiction |
serie-video | serie-video | serie-video |
ski-alpin | ski-alpin | ski-alpin |
snooker | snooker | snooker |
software | software | software |
sport | sport | sport |
sport-automobile | sport-automobile | sport-automobile |
squash | squash | squash |
stadium | stadium | stadium |
starwars | starwars | starwars |
surf | surf | surf |
taekwondo | taekwondo | taekwondo |
television | television | television |
templiers | templiers | templiers |
tennis | tennis | tennis |
tennis-de-table | tennis-de-table | tennis-de-table |
tennis-de-tableblack | tennis-de-tableblack | tennis-de-tableblack |
timbre | timbre | timbre |
train | train | train |
triathlon | triathlon | triathlon |
ultimate | ultimate | ultimate |
union-europeenne | union-europeenne | union-europeenne |
video | video | video |
voile | voile | voile |
volleyball | volleyball | volleyball |
water-polo | water-polo | water-polo |