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

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

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

إحصائيات

• صفحة إحصائيات