صياغة الطلبات للنماذج كي يُجمَّع TeX
أرسل المقدمة، واطلب الفروق، وجمّع الإجابة دائمًا.
صياغة الطلبات للنماذج كي يُجمَّع TeX
اطلب من نموذج محادثة شيفرة LaTeX وستحصل في الغالب على شيفرة تبدو سليمة لكنها لا تُجمَّع في مستندك. فالنموذج لا يعرف أي فئة تستخدم، ولا أي حزم تحمّل، ولا أي ماكرو عرّفت، فيجيب عن مستند عام ليس مستندك. ثم يتعطل الناتج بسبب حزم ناقصة أو تعريفات متعارضة لحظة لصقه. وأغلب ذلك يمكن تجنبه بثلاث عادات في كتابة الطلبات، وقاعدة صارمة واحدة: جمّع قبل أن تثق.
أرسل المقدمة
مقدمة مستندك هي السياق الذي يفتقر إليه النموذج. ألصقها، أو على الأقل سطر \documentclass وقائمة \usepackage، واطلب «مقطعًا يُجمَّع تحت هذه المقدمة». وتمنع هذه العادة وحدها أكثر الإخفاقات شيوعًا: أن تعتمد الإجابة بصمت على tikz أو siunitx أو حزمة أخرى لم تحمّلها أبدًا. كما توجّه النموذج نحو الأوامر التي توفرها بيئتك فعلًا. وإذا كان مشروعك يعرّف ماكرو، فأدرجها أيضًا، للأسباب الواردة في أعطِ النموذج جدول رموزك.
اسأل عمّا تعتمد عليه الإجابة
أضف طلبًا ثابتًا: «إذا احتاجت شيفرتك إلى أي حزمة لم أحمّلها، فاذكرها صراحةً في أعلى إجابتك». فهذا يحوّل الاعتماديات الخفية إلى قائمة مراجعة ظاهرة. وحين يسمّي الرد حزمة، فأنت من يقرر إضافتها، بدلًا من اكتشاف الاعتمادية في صورة خطأ Undefined control sequence بعد ثلاث تجميعات. وهذا الخطأ وتشخيصه مشروحان في Undefined control sequence.
اطلب الفروق لا إعادة كتابة
حين تريد تغييرًا في نص موجود، ألصق أصغر مقطع ذي صلة واطلب من النموذج ألا يغيّر إلا ما يتطلبه الطلب، مع بيان ما غيّره. فإذا أعطيته ملفًا كاملًا أعاد الكتابة بحرية: يعيد تنسيق فقرات لم تُمَس، ويعيد ترتيب أسطر المقدمة، وربما أسقط شيئًا على الأرض. ويضيع التغيير الحقيقي وسط هذا الاضطراب. أما التعديل الصغير الموصوف فهو ما يمكنك مراجعته فعلًا. وداخل Oleafly، استخدم التحرير المضمّن لمعاينة استبدال مركّز، أو اختر Ask for approval في المحادثة لمراجعة إجراءات الأدوات قبل تشغيلها، كما هو موضح في المساعد داخل Oleafly.
جمّع قبل أن تثق
لا تعتمد أبدًا شيفرة LaTeX لم تجمّعها، مهما بدت معقولة. ألصق الاقتراح في مستندك، وجمّع، واقرأ أول خطأ إن وُجد. وتغذية النموذج برسالة الخطأ تلك، مع المقطع المسبب لها، تنتج في الغالب محاولة ثانية تعمل. وأبقِ المشروع تحت Git ليمكن التراجع عن أي تغيير بمساعدة النموذج بأمر واحد، وهو إعداد مشروح في ضع الورقة على GitHub. النموذج يقترح، والمُجمِّع يحكم.