ويكي مصدر:توثيق قالب

التوثيق هو صفحة فرعية لشرح قوالب ويكي مصدر. يضمن التوثيق في القالب لكنه لا يضمن في الصفحات التي يستخدم فيها القالب.

أين يوجد

يوجد في أسفل نص معظم القوالب الجزء التالي: <noinclude>{{توثيق}}</noinclude>. جزء {{توثيق}} لكي يظهر توثيق القالب في صفحة القالب، وجزء <noinclude></noinclude> لكي لا يظهر التوثيق عند استخدام القالب في صفحة معينة.

كيف ينشأ

يوضع <noinclude>{{توثيق}}</noinclude> في نهاية النص في صفحة القالب.

كيف يعدل

تظهر أربع وصلات بجانب العنوان تصل إلى أربع صفحات فرعية للقالب:

  1. [شرح]: تصل إلى صفحة الشرح الفرعية، وهو الشرح الذي يظهر في صفحة القالب. تصف طريقة استعمال القالب وأمثلة لاستعماله.
  2. [ملعب]: تصل إلى صفحة الملعب فرعية. مخصصة لتجربة نص القالب وتطويره دون التأثير في الصفحات التي يستخدم فيها.
  3. [مختبر]: تصل إلى صفحة المختبر الفرعية. مخصصة لاختبار الملعب ومعاينة أحواله.
  4. [وسائط]: تصل إلى صفحة الوسائط الفرعية. مخصصة لمعطيات القالب التي تظهر عند استخدام معالج الوسائط.

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

الشرح

إذا أنشأت صفحة الشرح تظهر وصلاتان إضافيان:

  1. [عدل]: لتعديل صفحة الشرح. يعدل الشرح بحسب تعديل القالب.
  2. [حدث]: لتحديث صفحة الشرح. بعد تعديل القالب، إن كانت في صفحة الشرح أمثلة لاستخدام القالب، يضغط على هذه الوصلة لإظهار التعديلات الأخيرة.

إذا لم تنشأ صفحة الشرح وعين اسم صفحة شرح أخرى في |شرح=، تظهر بدل وصلة الشرح الوصلة التالية:

  1. [عام]: تصل إلى صفحة الشرح العام، وتستعمل للوصل إلى شرح مركزي لمجموعة من القوالب المترابطة دون إنشاء شرح منفرد لكل واحد منها.