قالب:ملف ميدياويكي

ملف ميدياويكي:‎ {{{1}}}
الموقع:	/
النص المصدري:	master • 1.42.4 • 1.41.5 • 1.39.11
الفئات:	البحث عن الكود المصدري • البحث عن التوثيق

توثيق القالب

يعرض صندوق معلومات عن ملف موجود في لب برمجيات ميدياويكي، مع وصلات إلى الكود المصدري للملف في الأفرع الرئيسية المستقرة القديمة، وكذلك وصلات شبكية إلى فئاتها وواجهاتها في صفحات توثيق بي إتش بي المولّدة.

{{MW file|FILENAME|PATH
|class1=CLASS
|class2=CLASS
|class3=CLASS
|...
|interface1=INTERFACE
|interface2=INTERFACE
|interface3=INTERFACE
|NotInGit=REASON
}}

• FILENAME هو اسم الملف، مشتملًا على الامتداد.
  • لو جرت إعادة تسمية الملف مؤخرًا، يمكنك استخدام معاملات stable= وlegacy= لذكر الاسم القديم حتى تعمل الوصلات الشبكية؛ صوف تحتاج لتحديث استدعاء القالب حينما ينتقل الإصدار الذي تغير الاسم إليه من رئيسي إلى مستقر إلى قديم.
• PATH هو مسار الملف؛ لا تذكر فيه الشرطة المائلة البادئة، بل اذكر الشرطة الماثلة التابعة. لا تدرج أي شيء في حالة الملفات الموجودة في المجلد الرئيسي.
• إن متغيرات الدالة class هي أمور اختيارية، ولو أضيفت سوف تصل شبكيًا إلى أعمال التوثيق المولّدة. يجب أن تكون القيمة CLASS هي اسم الفئة، كما هي مستخدمة في معرف الموارد الموحد. مثال، سوف يتولد من «Parser» وصلة شبكية إلى «classParser.html». يسمح القالب بعدد يصل إلى ستة معاملات فئات، class1-class6
• INTERFACE مشابه. يسمح القالب بعدد يصل إلى ثلاثة معاملات واجهة
• متغيرات الدالة NotInGit اختيارية ويجب أن تستخدم فقط لو كان الملف غير موجود في غت لسبب ما (أظن أن هذا ينطبق على LocalSettings.php لا غير). REASON هو السبب الذي يُعرض في صندوق المعلومات. لاحظ أن NotInGit يتأثر باستخدام الأحرف اللاتينية الكبيرة أو الصغيرة!

يستخدم الدليل الإرشادي هذا القالب استخدامًا واسعًا.

أمثلة

{{MW file|index.php|}}

ملف ميدياويكي:‎ index.php
الموقع:
النص المصدري:	master • 1.42.4 • 1.41.5 • 1.39.11
الفئات:	البحث عن الكود المصدري • البحث عن التوثيق

{{MW file|Article.php|includes/page/
|class1=Article
}}

ملف ميدياويكي:‎ Article.php
الموقع:	includes/page/
النص المصدري:	master • 1.42.4 • 1.41.5 • 1.39.11
الفئات:	Article

---

{{MW file|WikiPage.php|includes/page/
|class1=WikiPage
|interface1=Page
}}

ملف ميدياويكي:‎ WikiPage.php
الموقع:	includes/page/
النص المصدري:	master • 1.42.4 • 1.41.5 • 1.39.11
الفئات:	WikiPage • Page

---

{{MW file|LocalSettings.php|
|NotInGit=تنشئ أثناء التثبيت
}}

ملف ميدياويكي:‎ LocalSettings.php
الموقع:
النص المصدري:	غير موجود في غت (تنشئ أثناء التثبيت)
الفئات:

انظر أيضا

• {{Git file }} — وصلة شبكية بسيطة إلى ملف موجود على غيريت (من mediawiki/core أو خلاف ذلك)
• تصنيف:صفحات كود ميدياويكي البرمجي التي لا تحتوي على اسم رتبة — الصفحات غير كاملة التعبئة تسرد آليًا باستخدام هذا القالب

Displays an informative box about a file in MediaWiki core, with links to its source code in master, stable, and legacy branches, and links to its classes and interfaces in the generated PHP documentation.

Template parameters[Edit template data]

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
nodisplaytitle	nodisplaytitle	no description	Unknown	optional
File name	1	no description	Unknown	required
File path	2	no description	Unknown	required
Not in Git?	NotInGit	Whether the version is in Git version control (only rarely used for files like LocalSettings.php and DevelopmentSettings.php)	Boolean	optional
Stable MediaWiki version	stable	no description	Unknown	optional
Legacy MediaWiki version	legacy	no description	Unknown	optional
LTS MediaWiki Version	lts	Long-Term Support version for MediaWiki	Unknown	optional
Class 1	class1	no description	Unknown	suggested
Class 2	class2	no description	Unknown	optional
Class 3	class3	no description	Unknown	optional
Class 4	class4	no description	Unknown	optional
Class 5	class5	no description	Unknown	optional
Class 6	class6	no description	Unknown	optional
Interface 1	interface1	no description	Unknown	suggested
Interface 2	interface2	no description	Unknown	optional
Interface 3	interface3	no description	Unknown	optional
Example	example	no description	Unknown	optional

---

Maintenance: noslash

يمكن للمحررين تجريب تعديلاتهم على القالب في صفحات ملعب (أنشئ | مرآة) و مختبر (أنشئ).
الصفحات الفرعية لـ قالب.