Quest Ladder
TeachFORGE.ai
Quest Ladder / الإضافات الذكية
الإضافات الذكية: المنطق والتكرار داخل السؤال
عندما يحتاج سؤال إلى قائمة، أو جدول، أو جملة يتوقف طولها على الأرقام المُولَّدة.
القيمة هي قيمة. أما هذه فقيمة تُجمِّع نفسها بنفسها.
ما الغرض منها
يضع المتغيّر قيمة واحدة. لكن يحتاج السؤال أحيانًا إلى شيء يتوقف شكله على القيم: قائمة من خمسة حدود عندما تكون n خمسة، أو جدول بصف لكل عنصر، أو جملة تقول و قبل آخر عنصر من أي عدد من العناصر.
الإضافة الذكية هي روتين صغير مُسمّى يُنتج ذلك المحتوى. تبنيها مرة واحدة في مكتبة الإضافات الذكية، ثم تُدرجها في أي مكان — نص السؤال، أو تلميح، أو خطوة حل، أو كتلة تعلّم نشط — وتتوسّع في مكانها.
كل واحدة هي صف أكورديون في المكتبة: افتح واحدة لتعديلها، وأغلقها للعمل على أخرى. إضافة إضافة ذكية يُنشئ واحدة، و التكرار هي أسرع طريقة للحصول على متغيّر منها.
تسمية إضافة
تحتوي الإضافة على اسم العرض لك، و معرِّف داخلي يُستخدم في الرمز الذي يُدرجها، ووصف اختياري غرض. اجعل المعرِّف قصيرًا: فهو ما ستقرأه داخل كتلة نص السؤال عندما تعود إليها لاحقًا.
أنواع الخطوات العشرة
الإضافة قائمة من خطوات تُنفَّذ بالترتيب. خمس منها هي الأكثر استخدامًا يوميًا.
| الخطوة | تفعل |
|---|---|
| إضافة نص | تُصدر نصًا، بصيغة عادية أو Markdown أو LaTeX أو شفرة برمجية. |
| عرض عدة مرات | تُكرّر شيئًا عددًا من المرات — صورة، أو رمزًا، أو عبارة. |
| متتالية أرقام (سطر واحد) | تُصدر سلسلة أرقام على سطر واحد، بفاصل تختاره أنت. |
| إذا كان هذا صحيحًا… | تُصدر شيئًا أو آخر بحسب شرط. |
| التكرار لكل رقم… | تعد من قيمة إلى أخرى، وتُصدر شيئًا في كل مرة. |
وهناك خمس خطوات أخرى عندما تحتاج إليها: قيمة محسوبة مؤقتة، كتلة تعبير رياضي، لكل عنصر في القائمة…، طالما استمر الشرط… و جدول من قائمة.
حقولها واضحة بقدر وضوح أسمائها — عندما يكون هذا صحيحًا، فافعل…، وإلا فافعل…، اسم العداد، من، إلى، حجم الخطوة، كم عدد؟، الفارق بين كل عنصر، الفاصل. أنت تصف المحتوى، لا تكتب شفرة برمجية.
استخدام إضافة
بعد حفظ الإضافة، تعرضها الإضافات الذكية القائمة المنسدلة في درج الإدراج. ضمن النص يُسقط الرمز عند مؤشر الكتابة بحيث يتوسّع داخل الجملة التي تكتبها؛ ويجب عليك النقر في حقل نصي أولاً، ويُنبّهك المحرر بذلك إن لم تفعل.
ابنِ الإضافة، واحفظ المسودة، وحينها فقط ابحث عنها في الدرج. فالقائمة المنسدلة تقرأ المكتبة المحفوظة، لذا فإن إضافة كتبتها للتو ولم تحفظها لن تظهر بعد — وهذا يبدو كخلل ولا يكون كذلك.
متى لا تستخدمها
تستحق الإضافة استخدامها عندما يتغيّر شكل المحتوى فعليًا. أما عندما يتغيّر فقط في القيمة، فالمتغيّر العادي أبسط وأسهل قراءة بعد ستة أشهر.
دليل دليل البناء اليدوي يحتوي على أمثلة محلولة لكل نوع من الخطوات، وهو المكان الذي تذهب إليه عندما تريد رؤية إضافة مُجمَّعة بدلاً من وصفها فقط.