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

أضف وصلات
من ويكيبيديا، الموسوعة الحرة

لماذا هذا الأسلوب ؟[عدل]

هذه الوحدة تعمل على جعل عملية استحداث قوالب البطاقات (أو قوالب معلومات أو 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 = "" -- قيمة ثابتة
}

الأيقونات المتوفرة[عدل]

خلفية فاتحةخلفية فاتحة
وأيقونة على اليسار		خلفية داكنة
aerostataerostataerostat
aikidoaikidoaikido
alpinismealpinismealpinisme
arbitrearbitrearbitre
arcarcarc
archives2archives2archives2
arduinoarduinoarduino
electroelectroelectro
artisteartisteartiste
artsmartiauxjapartsmartiauxjapartsmartiauxjap
associationassociationassociation
athletismeathletismeathletisme
audioaudioaudio
auteurauteurauteur
autogireautogireautogire
automobileautomobileautomobile
avionavionavion
avironavironaviron
badmintonbadmintonbadminton
baseballbaseballbaseball
basket-ballbasket-ballbasket-ball
bdbdbd
biathlonbiathlonbiathlon
bierebierebiere
bookbookbook
universiteuniversiteuniversite
boxeboxeboxe
calendriercalendriercalendrier
cameracameracamera
canadacanadacanada
cardinalcardinalcardinal
catchcatchcatch
chateauchateauchateau
chimiechimiechimie
cinemacinemacinema
commonwealthcommonwealthcommonwealth
communicationcommunicationcommunication
cyclismecyclismecyclisme
deportationdeportationdeportation
diplomatiediplomatiediplomatie
disneydisneydisney
droitdroitdroit
drone-civildrone-civildrone-civil
egypte-antiqueegypte-antiqueegypte-antique
entrepriseentrepriseentreprise
entreprise-blancentreprise-blancentreprise-blanc
equitationequitationequitation
escaladeescaladeescalade
escaladeescaladeescalade
escrimeescrimeescrime
espagneespagneespagne
evequeevequeeveque
factoryfactoryfactory
floorballfloorballfloorball
fondeurfondeurfondeur
footballfootballfootball
footballblackfootballblackfootballblack
footUSfootUSfootUS
futsalfutsalfutsal
golfgolfgolf
grappegrappegrappe
gymnastiquegymnastiquegymnastique
handballhandballhandball
handballblackhandballblackhandballblack
helicopterehelicopterehelicoptere
hockeyhockeyhockey
hockey-sur-gazonhockey-sur-gazonhockey-sur-gazon
hospitaliershospitaliershospitaliers
humainhumainhumain
informatiqueinformatiqueinformatique
internetinternetinternet
israel-judaismeisrael-judaismeisrael-judaisme
jeujeujeu
jeu-rolejeu-rolejeu-role
jeuvideojeuvideojeuvideo
jeuvideov3jeuvideov3jeuvideov3
judojudojudo
karatekaratekarate
kayakkayakkayak
kickboxingkickboxingkickboxing
lutteluttelutte
macintoshmacintoshmacintosh
maltemaltemalte
mapmapmap
medecinemedecinemedecine
metsmetsmets
militairemilitairemilitaire
moneymoneymoney
money_coinmoney_coinmoney_coin
montreal-metromontreal-metromontreal-metro
metrometrometro
montreal-trainmontreal-trainmontreal-train
moteur-avionmoteur-avionmoteur-avion
mosquemosquemosque
museemuseemusee
museummuseummuseum
papyruspapyruspapyrus
musiquemusiquemusique
musicmusicmusic
natationnatationnatation
nations-uniesnations-uniesnations-unies
omnisportsomnisportsomnisports
palacepalacepalace
paralympiqueparalympiqueparalympique
persofictionpersofictionpersofiction
petrolepetrolepetrole
planeurplaneurplaneur
plateformeplateformeplateforme
pokerpokerpoker
pressepressepresse
pretendantpretendantpretendant
projetprojetprojet
projectprojectproject
psychologiepsychologiepsychologie
quebecquebecquebec
rechercherechercherecherche
rinkhockeyrinkhockeyrinkhockey
rome-antiquerome-antiquerome-antique
routerouteroute
rugbyrugbyrugby
rugbyblackrugbyblackrugbyblack
satellitesatellitesatellite
sautskisautskisautski
science-fictionscience-fictionscience-fiction
serie-videoserie-videoserie-video
ski-alpinski-alpinski-alpin
snookersnookersnooker
softwaresoftwaresoftware
sportsportsport
sport-automobilesport-automobilesport-automobile
squashsquashsquash
stadiumstadiumstadium
starwarsstarwarsstarwars
surfsurfsurf
taekwondotaekwondotaekwondo
televisiontelevisiontelevision
templierstemplierstempliers
tennistennistennis
tennis-de-tabletennis-de-tabletennis-de-table
tennis-de-tableblacktennis-de-tableblacktennis-de-tableblack
timbretimbretimbre
traintraintrain
triathlontriathlontriathlon
ultimateultimateultimate
union-europeenneunion-europeenneunion-europeenne
videovideovideo
voilevoilevoile
volleyballvolleyballvolleyball
water-polowater-polowater-polo
مجلوبة من «https://ar.wikipedia.org/w/index.php?title=وحدة:بطاقة/شرح&oldid=66538068»