الإعدادات: التمارين

#أنماط التمارين

تعرّف الخاصية exerciseStyles الأنماط المسمّاة التي يختارها التمرين بـ:::exercise{style="…"}. النمط شكلُ عائلة من التمارين؛ أما الأسئلة والإجابات فتبقى في Markdown (انظر التمارين). يأتي افتراضيًا نمط واحد هو exercise، فتعمل الحاوية دون أي إعداد؛ وتعريف exerciseStyles يستبدله، وأول نمط مُعرَّف هو الذي يأخذه التمرين الذي لا style له. كل الحقول اختيارية، والقيم الافتراضية تتبع لغة المستند حيث تختلف المدارس: تسميات الخيارات، وعلامتا صح وخطأ، وطريقة كتابة القسمة المطوّلة، والكلمات المطبوعة.

const config: PostextConfig = {
  exerciseStyles: [
    {
      id: 'activity',
      box: 'activity-frame',
      number: { shape: 'disc', background: { hex: '#2a5ea8', model: 'hex' } },
      instruction: { fontFamily: 'Noto Kufi Arabic' },
      options: { marker: 'circle' },
      blank: { look: 'dots', width: 'answer' },
      area: { kind: 'grid', lines: 4 },
      level: { glyph: '★', empty: '☆' },
      icons: { pair: { glyph: '👥' } },
    },
    { id: 'quiz', extends: 'activity', options: { layout: 'row', columns: 4 } },
  ],
};

#الرقم

تضبط number رقم التمرين. الرقم المجرد عريض، باللون الرئيسي، تليه نقطة؛ والرقم داخل شكل أبيض في قرص أو مربع أو مربع مستدير الزوايا باللون الرئيسي، ولا يليه شيء.

#التعليمة

تضبط instruction الفقرات التي يبدأ بها التمرين. والحقول غير المحددة تأخذ قيم النص الأساسي.

#الخيارات

تضبط options خيارات سؤال الاختيار (- [ ] …).

#الفراغات

تضبط blank كيف يُطبع [[…]] في نص التلميذ: مساحة بقدر الإجابة عليها خط أو نقاط أو مربع، ولا تُرسم الإجابة نفسها.

#صح أو خطأ

تضبط trueFalse الإجابتين في آخر العبارة.

#التوصيل

تضبط match تمرين الأزواج.

#بنك الكلمات

تضبط bank إطار الكلمات في تمرين الفراغات الذي فيه bank أو ::bank[…]، وفي كل تمرين تصنيف. ويُطبع الإطار حيث كُتب السطر ::bank، وإلا فتحت التعليمة.

#مساحة الكتابة

تضبط area المساحة تحت السؤال المفتوح، وتحت الجملة المبعثرة، وفي أعمدة تمرين التصنيف.

#الشبكات

تضبط grid خانات البحث عن الكلمات والكلمات المتقاطعة والعمليات في أعمدة.

#العمليات الحسابية

تضبط arithmetic العمليات في أعمدة.

#الصعوبة

تضبط level العلامات التي تطبعها level في الحاوية بعد الرقم، بحجم أصغر.

#الأيقونات

تربط icons معرّفًا بأيقونة نشاط (شفهي، كتابي، عمل في ثنائيات، استماع، آلة حاسبة)، تُطبع بعد الرقم حين تسمّيها الحاوية: icon="pair".

تُطبع الأيقونة رمزًا داخل السطر بعد الرقم: صورة resourceId إن سمّت واحدة، وإلا فـglyph بخط fontFamily وبلون color (لون النص إن لم يُحدَّد). تقف على خط أساس التعليمة بارتفاع size em، ويُقرأ alt في موضعها.

#الإجابات

تضبط answers الإجابات حيثما ظهرت: في طبعة المعلم، وفي البند النموذجي لتمرين example، والدوائر والمربعات الممتلئة، والخطوط المرسومة بين الأزواج، والحروف والأرقام في الشبكات.

#ألوان الشاشة

تضبط digital كيف يعرض عارض HTML وكتب EPUB الإجابة بعد فحصها.

#إعدادات الكتاب

تحمل الخاصية exercises إعدادات الكتاب كله: الطبعة، وموضع طباعة الحلول، والبذرة التي يُخلط منها كل شيء، وطبعات الشاشة. والكتاب الذي لا يحدد exercises ولا exerciseStyles يُصفّ ويُحسب بصمته كما كان.

const config: PostextConfig = {
  exercises: {
    edition: 'student',
    solutions: { placement: 'chapterEnd', layout: 'key' },
    seed: 3,
    digital: { check: 'instant' },
  },
};

#الحلول

exercises.solutions، وفوقها solutions في النمط لتمارين ذلك النمط.

#الطبعات على الشاشة

تضبط exercises.digital سلوك التمارين في عارض HTML وكتب EPUB.

ويمكن أن تكون للشاشة إعدادات تمارين خاصة بها: تأخذ htmlViewer.overrides أيضًا exercises وexerciseStyles، وتُدمجان فوق إعدادات الكتاب قبل أن يصفّ عارض HTML صفحاته. فتحتفظ الطباعة بحلولها في آخر الفصل وتخفيها الشاشة، أو تحذف الشاشة مساحات الكتابة التي لا حاجة للقارئ بها.

const config: PostextConfig = {
  htmlViewer: {
    overrides: {
      exercises: { solutions: { placement: 'none' } },
      exerciseStyles: [{ id: 'exercise', area: { kind: 'none' }, blank: { minWidth: { value: 6, unit: 'em' } } }],
    },
  },
};