Project:Manual/ar
 هذه الصفحة مخصصة لنقاش أعمال صياغة دليل مستخدم ميدياويكي وتنسيقها. دليل المستخدم موجود في نطاق الاسم |
المحتويات
لأخذ فكرة عامة حول النطاقات المخصوصة لكل محتوى، طالع مشروع:نطاقات.
- ما هو المحتوى الذي ينبغي تواجده في النطاق Manual: «الدليل»؟
- أي معلومة تتعلق بإنشاء ويكي جديد
- أي معلومة حول النقل/الترقية/التصدير/الاستيراد
- توثيقات لـ Maintenance scripts
- أي معلومة حول hooks/API «خطافات»/تخطيط قاعدة البيانات إلخ.
- ما هو المحتوى الذي ينبغي «عدم تواجده» في النطاق Manual: «الدليل»؟
- أي مساعدة أساسية حول الاستخدام والتحرير. هذه تنتمي للنطاق Help: «مساعدة»
- الامتدادات المُلحقة والأدوات الغير مضمنّة في توزيعة ميدياويكي الافتراضية. (نطاق Extension:)
Structure
Skins
Skin documentation describes how developers and admins can use and create skins.
- Landing page: دليل:أسطح
- Navigation template: Template:Skins
Documentation for individual skins is stored outside the Manual: namespace in the Skin: namespace.
Extensions
Extension documentation describes how developers and admins can use and create extensions.
- Landing page: دليل:امتدادات
- Navigation template: قالب:امتدادات
Documentation for individual extensions is stored outside the Manual: namespace in the Extension: namespace.
Extension development
There is a set of pages that provides information for developers about how to create and modify extensions. Some of these pages are specific to extensions, like the extension.json schema, while others also include information that is relevant to MediaWiki core developers, like the hooks documentation.
The landing page for extension development is Manual:Developing extensions. All pages related to extension development should include the navigation template Template:Extension development at the end of the page, with the exception of individual hook and configuration variable pages.
Extension points
In the docs, strategies for extending MediaWiki core in extensions, skins, and user scripts/gadgets are referred to as extension points. Documentation about how to use extension points should be stored on a dedicated page in the Manual: namespace, such as دليل:وصلات. To help developers discover these extension points, the extension points available to extensions, skins, and user scripts are linked from their respective development landing pages.
Extension points used by extensions should be listed on:
Extension points used by skins should be listed on:
Extension points used by user scripts/gadgets should be listed on:
Discussion
Some discussion has been held regarding the layout of the Manual: namespace, but no formal decision has been made. The main debate is whether Manual pages should be organized in a flat hierarchy, with all pages at the root level, or with subtopics as subpages of the main topics. Here is where prior discussion has taken place:
Editorial guidelines
Formatting
to be discussed
Colors
to be discussed
Screenshots
- Use http://test.leuksman.com/view/Main_Page for taking screenshots (note: currently not working)
- Screenshots should be cut to show only the relevant part of the site (no browser surroundings).
Tables
to be discussed
Naming scheme non-English pages
Some general discussions about internationalisation are at مشروع:سياسة اللغة.