تخطَّ إلى المحتوى

كيف تكتب دليلًا

المشرف العامآخر تحديث ١٥ نوفمبر ٢٠٢٦

هذه الصفحة لفريق هلا. لا تظهر في القائمة لكن يمكن لأي شخص لديه الرابط قراءتها. لا يوجد هنا أي سر، فالمحرر نفسه محمي بكلمة مرور.

  1. اذهب إلى https://docs.hala.qa/admin (يفتح /keystatic).

  2. يطلب المتصفح اسم مستخدم وكلمة مرور. اطلبهما من مالك الموقع. بعد عدة محاولات خاطئة يُقفل المحرر لمدة 15 دقيقة.

  3. على الجانب ترى Home وEnglish والعربية (Arabic). لكل لغة مجلد لكل قسم، مثل قائمة الموقع تمامًا.

  1. افتح القسم، مثل العربية ← البيع (نقطة البيع)، واضغط Add.

  2. املأ النموذج:

    • العنوان: قصير ويبدأ بفعل، مثل إجراء عملية بيع.
    • اسم الملف / الرابط: كلمات إنجليزية صغيرة بينها شرطات، مثل make-a-sale. استخدم اسم الملف نفسه للدليل العربي والإنجليزي ليربط زر تبديل اللغة بينهما.
    • الوصف المختصر: جملة واحدة تظهر في نتائج البحث وفي Google.
    • الحالة: Draft (غير منشور) أو In review (منشور مع تنبيه) أو Published.
    • الباقات ومن يمكنه القيام بذلك: تظهر كشارات تحت العنوان.
    • مسار الصفحة في النظام: مثل /pos/create، ويُستخدم لروابط المساعدة "?".
  3. اكتب المحتوى. استخدم زر + (أو اكتب /) لإدراج الكتل: الخطوات، لقطة الشاشة مع مربعات التظليل (بالنسبة المئوية من حجم الصورة)، زر "أرني في النظام"، مربعات الملاحظات، والتبويبات.

  4. اضغط Save في الأعلى.

المقاطع القصيرة (صور متحركة)

Section titled “المقاطع القصيرة (صور متحركة)”

المقطع ثوانٍ قليلة من النظام وهو يعمل، تتكرر مثل صورة GIF: يتحرك المؤشر وينقر ويكتب خطوات المهمة. يعمل المقطع بلا صوت ما دام ظاهرًا على الشاشة، ويستطيع القارئ إيقافه مؤقتًا أو فتحه بحجم أكبر.

  • متى: مقطع واحد على الأكثر لكل دليل، في أعلاه (بعد قبل أن تبدأ وزر أرني في النظام)، لعملية تُفهم بالمشاهدة أسرع من القراءة: بيع في نقطة البيع، نافذة دفع، نموذج من عدة خطوات. تبقى لقطات الشاشة للخطوات، فالمقطع لا يحل محلها.
  • كيف يُصنع: تُسجَّل المقاطع آليًا على النشاط التجاري التجريبي وليس يدويًا، لذلك تعرض دائمًا النظام الحالي باللغتين. اطلب من أحد المطورين إضافة مقطع: يكتب نصًا قصيرًا في scripts/shots/clips/<section>/<guide>.yaml (أي صفحة، وعلى ماذا ينقر وماذا يكتب) ويشغّل node clips.mjs --guide <guide>. فيصنع المقطع الإنجليزي والعربي (ونسخة للهاتف عند الطلب) دون أن يحفظ أي شيء في النظام.
  • في المحرر: أدرج كتلة Clip. Clip path هو المسار بدون اللغة والامتداد، مثل /src/assets/clips/pos/make-a-sale/sale-flow، وتعرض الصفحة المقطع بلغتها. اكتب Alt text (ماذا يعرض المقطع) وCaption إن أردت.
  • اجعل المقطع قصيرًا (6 إلى 15 ثانية) وعن مهمة واحدة. إذا تغيّر النظام أعد تشغيل الروبوت، ولا يتغير الدليل.

يكتب المحرر الصفحة على الخادم، وبعد نحو 15 ثانية من آخر حفظ يُعاد بناء الموقع ويظهر التحديث خلال دقيقة تقريبًا. تُحفظ كل نسخة منشورة، لذلك يمكن استرجاع أي صفحة: اطلب ذلك من أحد المطورين.

يمكنك متابعة آخر نشر من https://docs.hala.qa/admin/status. إذا كان في الصفحة خطأ يتوقف البناء ويبقى الموقع القديم منشورًا، وتعرض صفحة الحالة الخطأ لتصلحه وتحفظ من جديد.

هل كانت هذه الصفحة مفيدة؟