عرض مصدر موسوعة حسوب:دليل التحرير

<noinclude>{{DISPLAYTITLE:دليل التحرير}}</noinclude>
من السهل جدًا تعديل محتويات صفحة من صفحات الموسوعة، فكل ما عليك فعله:
# اضغط على زر «عدل» الموجود في القائمة المنسدلة الظاهرة عند الضغط على اسم الصفحة
# أجرِ التعديلات التي ترغب بها
# اضغط على زر «احفظ الصفحة».
هذا كل ما في الأمر! لكننا سنورد في هذه الصفحة دليلًا تفصيليًا لمساعدتك في التحرير.

== إضافة ملخص للتعديلات ==
قبل أن تحفظ تغييرًا أجريته، فمن المفضَّل أن تضيف ملاحظةً بسيطةً في حقل «ملخص» الذي يصف التغييرات التي أجريتها.

لا حاجة أن تقلق كثيرًا حول هذا الملخص، ولا تفكر مطولًا فيه، فكل ما عليك أن تكتبه هو وصف عام لما فعلته، مثل «تصحيح خطأ إملائي» أو «إضافة مثال».

هذا الملخص يظهر في تاريخ الصفحة مما يساعد بقية المحررين على معرفة ما الذي قمتَ به بسهولة وسرعة.

== مراجعة التعديلات ==
هنالك زر اسمه «مراجعة تعديلاتك» يظهر الفرق بين النسخة الحالية للصفحة والنسخة السابقة، مما يسمح لك بالتأكد من صحة تعديلات.

== إنشاء صفحات جديدة ==
تسمح الموسوعة بإضافة روابط إلى صفحات غير موجودة (والتي ستُنشَأ مستقبلًا)، تكون هذه الروابط باللون الأحمر، والضغط عليها يؤدي إلى الانتقال إلى الصفحة الجديدة لإنشائها، وهذه هي إحدى طرائق إنشاء الصفحات الجديدة.

أما الطريقة الأكثر شيوعًا هي كتابة رابط URL للصفحة الجديدة في شريط العنوان في المتصفح. مثلًا:<blockquote><nowiki>https://wiki.hsoub.com/</nowiki>'''PAGENAME'''</blockquote>

=== الصفحات الفرعية في الموسوعة ===
نستعمل في الموسوعة الصفحات الفرعية لإنشاء هيكلية للتوثيق، وتكون هنالك صفحة رئيسية لكل لغة أو تقنية مثل PHP أو SQL، وتنحدر الصفحات الفرعية التابعة لها منها مثل <nowiki/>[[CSS/background]] أو [[HTML/img]]. يُضاف رابط الصفحة بعد إنشائها إلى الفهرس في المكان المناسب.

على سبيل المثال، إذا أردنا إضافة خاصية جديدة في توثيق CSS، فننتقل إلى عنوان URL الآتي:<blockquote><nowiki>https://wiki.hsoub.com/CSS/</nowiki>'''property'''</blockquote>

=== اسم الصفحة ===
يكون اسم الصفحة عادةً باللغة الإنكليزية، واحرص على استخدام حالة الأحرف المناسبة، يجدر بالذكر أنَّ معظم صفحات الويكي تستخدم شيفرة خاصة لتعديل اسم الصفحة الظاهر إلى اسمٍ آخر، وبهذا نستطيع الحصول على روابط URL ذات بنية موحّدة للصفحات، إضافةً إلى توفير عنوان دقيق (وباللغة العربية إن لزم الأمر). الشيفرة التي يجب أن تضعها في أوّل صفحتك هي:<syntaxhighlight lang="text">
<noinclude>{{DISPLAYTITLE:عنوان الصفحة}}</noinclude>
</syntaxhighlight>

== المحرر المرئي ==
المحرر المرئي هو المحرر الافتراضي لتحرير صفحات الموسوعة. سنشرح هنا استخدامه.

=== فتح المحرر المرئي ===
[[ملف:VisualEditor-Opening.png|بديل=الضغط على زر «عدل» في القائمة المنسدلة|تصغير|200x200بك|طريقة فتح المحرر المرئي]]
اضغط على زر «عدل» الموجود في القائمة المنسدلة الظاهرة عند الضغط على اسم الصفحة، قد يأخذ تحميل المحرر المرئي والصفحة برهة.

=== شريط الأدوات ===
يظهر شريط الأدوات الخاص بالمحرر المرئي في أعلى الشاشة عندما تبدأ التعديل، ويحتوي على الأيقونات الشائعة للمحررات النصية.
[[ملف:VisualEditor-Toolbar.png|بديل=شريط الأدوات|مركز|تصغير|400x400بك|شريط الأدوات]]

=== الفقرات ===
لاحظ إمكانية إضافة ترويسات وغيرها من أنواع الفقرات من القائمة المنسدلة الموجودة في شريط الأدوات.
[[ملف:VisualEditor-Paragraph.png|بديل=أنواع الفقرات|مركز|تصغير|400x400بك|تغيير أنواع الفقرات باستخدام شريط الأدوات]]
احرص على وضع ترويسة «عنوان» لعناوين الصفحة الرئيسية، وضع ضمنها ترويسات «عنوان فرعي 1» وهكذا... لا تستعمل الترويسة «عنوان الصفحة» أبدًا.

=== تنسيق النصوص ===
هنالك إمكانية لتغيير طريقة تنسيق النصوص عبر جعلها '''عريضةً''' أو ''مائلة'' أو <code>شيفرةً</code> إلى آخر، وذلك باستخدام القائمة المسندلة الخاصة بالتنسيق:
[[ملف:VisualEditor-Formatting.png|بديل=قائمة تنسيق النصوص|مركز|تصغير|400x400بك|قائمة تنسيق النصوص]]

=== القوائم ===
إذا احتوت الفقرة على قائمة منقطة أو مرقمة، فيمكنك تنسيقها باستخدام القائمة المعنونة «هيكل».
[[ملف:VisualEditor-Numbering.png|بديل=قائمة «هيكل»|مركز|تصغير|400x400بك|قائمة «هيكل»]]

=== إدراج ===
يمكن إدراج صورة أو شيفرة أو جدول في الموسوعة، وذلك باستخدام قائمة إدراج الموجودة في شريط أدوات المحرر المرئي:
[[ملف:VisualEditor-Insert.png|بديل=قائمة إدراج|مركز|تصغير|400x400بك|قائمة إدراج]]

=== خيارات الصفحة ===
يمكننا المحرر المرئي من تغيير ضبط الصفحة، وهذا يتضمن عنوان الصفحة، والتصنيفات، وإجراء تحويلات، وخلاف ذلك من الأمور.
[[ملف:VisualEditor-Settings.png|بديل=قائمة خيارات الصفحة|مركز|تصغير|400x400بك|قائمة خيارات الصفحة]]

=== الروابط ===
من المهم جدًا وضع روابط لجميع الصفحات التي يمكن وضع روابط إليها في الموسوعة، وهذا يعزز البنية التي تربط الصفحات مع بعضها. يمكن إضافة رابط عبر الضغط على الزر الموافق له في شريط الأدوات.
[[ملف:VisualEditor-Links.png|بديل=إضافة رابط|مركز|تصغير|400x400بك|إضافة رابط]]

=== حفظ التغييرات ===
اضغط على زر «احفظ التغييرات» لكي يظهر لك مربع حوار يطلب منك كتابة ملخص عمّا عدلته، وغير ذلك من الخيارات.
[[ملف:VisualEditor-Save.png|بديل=مربع حفظ الصفحة|مركز|تصغير|400x400بك|مربع حفظ الصفحة]]