وحدة:بطاقة/شرح

لماذا هذا الأسلوب ؟

هذه الوحدة تعمل على جعل عملية استحداث قوالب البطاقات (أو قوالب معلومات أو Infobox) أسهل/أبسط ما يمكن من خلال تعريفات بسيطة في وحدات فرعية.

المميزات

• استحداث القوالب يندرج ضمن عملية البرمجة واستعمال وحدات فرعية بلغة لوا (Lua) يضبط المكتوب لضمان غياب الأخطاء.
• عملية ترتيب البيانات المعروضة بسيطة ولا تستدعي تغيير الأرقام (مثلما هو الحال مع module:InfoBox).
• توفر مكتبات لجلب البيانات الأكثر استعمالا لاقتصاد الوقت والكود.
• الجمع في مكان واحد للمبرمج/المطور لتوفير التعليمات والشروح.
• توفر أدوات مساعدة لتحيين صفحة الشرح بصورة آنية وآلية أو نصف آلية (مثل : الصيغة وبيانات القالب ..) بعد تحيين الوحدة أو أحد المكتبات المساعدة.

الاستخدام

هذه الوحدة تستعمل لعرض قالب معلومات (Infobox) أو بطاقة بالاعتماد على وحدة فرعية تحتوي على بيانات حول مضمون هذا القالب. تسمح هذه الوحدة بإجراء استجوابات بصورة مبسطة لويكي بيانات لجلب ما توفر من البيانات.

استحداث قالب معلومة (أو بطاقة) يمر بخطوتين :

1. إنشاء وحدة فرعية بعنوان من الشاكلة : وحدة:بطاقة/قالب/اسم_قالب
   • مثال : وحدة:بطاقة/قالب/لعبة
2. إنشاء قالب يستعمل لاحقا في المقالات. محتوى هذا القالب سيكون : {{#استدعاء:بطاقة|تركيب|وحدة=اسم_الوحدة_الفرعية}}
   • مثال :{{#استدعاء:بطاقة|تركيب|وحدة=لعبة}}

محتوى الوحدة الفرعية

محتوى فارغ

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" 
				}
		},
	  }},
	}
}

توثيق المعطيات (metadata)

metadata = {
		description = "", -- شرح مختصر
		option = "",  -- أهمية المعلومة :  required / suggested / deprecated
		type = "", --  نوع المعلومة : number/boolean/date/url/wiki-file-name/line/content
		example = "", -- مثال عن نص يساعد في ملء صحيح للخانة 
		suggestedvalues = {}, -- قائمة لقيم مقترحة مساعدة.
		autovalue = ""; -- قيمة مولدة آليا مثل :{{subst:CURRENTYEAR}}
		default = "" -- قيمة ثابتة
}

الأيقونات المتوفرة

خلفية فاتحة	خلفية فاتحة وأيقونة على اليسار	خلفية داكنة
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