ملفات فئات الجامعة التي لا تُجمَّع

الفرز: الخطأ الأول، والمحرك، والحزم القديمة، والبحث الثنائي.

ملفات فئات الجامعة التي لا تُجمَّع

قوالب الرسائل الجامعية نوع خاص من الشيفرة القديمة. فقد كتب طالب دراسات عليا ملف الفئة قبل خمس عشرة سنة على توزيعة TeX السائدة آنذاك، ثم تخرّج وترك الملف مجمّدًا بينما مضى النظام البيئي لـ LaTeX قُدمًا. فحين تنزّل universitythesis.cls اليوم فيتوقف بشاشة من الأخطاء، فالغالب أن الفئة ليست معطوبة بقدر ما هي عالقة في الزمن. ومع ذلك فأنماط الإخفاق متوقعة، وترتيب ثابت للفرز يحل معظمها.

ابدأ بالخطأ الأول فقط

يتسلسل إخفاق LaTeX: أمر واحد غير معرَّف في وقت مبكر من الفئة قد يُنتج عشرات الأخطاء اللاحقة التي لا معنى لها. مرّر السجل إلى أول سطر يبدأ بـ !، وأصلح ذلك الخطأ، وأعد التجميع قبل أن تقرأ أي شيء آخر. وتكرار هذه الحلقة كثيرًا ما يزيل جدار الأخطاء المرعب في ثلاث أو أربع تمريرات. فإن كان الخطأ الأول أمرًا مجهولًا، فدرس تسلسل التحكم غير المعرَّف يرشدك خلال التشخيص.

افحص المحرك

تفترض قوالب كثيرة محركًا بعينه وتفشل فشلًا غريبًا مع أي محرك سواه. فالفئة التي تحمّل fontspec أو تضبط الخطوط بالاسم تتطلب XeLaTeX أو LuaLaTeX؛ والفئة المبنية على أوليات خاصة بـ pdftex قد تفشل مع المحركين كليهما. ابحث عن تعليق قرب أعلى ملف الفئة أو سطر في تعليمات الجامعة يسمّي المحرك المقصود، وطابقه قبل تنقيح أي شيء آخر. وتُلخَّص الفروق في أي محرك يناسب هذا المشروع.

حدّث ما تتحكم فيه

تحمّل القوالب القديمة حزمًا متقادمة توجد بدائلها الحديثة أصلًا في توزيعتك، فيتنازع الاثنان؛ ويسرد درس حزم تتنازع فيما بينها التركيبات الكلاسيكية. والاستراتيجية العملية أن تترك ملف الفئة نفسه كما هو، لأن متطلبات تنسيق الجامعة موجودة فيه، وأن تحدّث الديباجة الخاصة بك وحدها: احذف أسطر \usepackage المتقادمة، وحمّل hyperref متأخرًا، وتجنب إعادة تحميل أي شيء تحمّله الفئة أصلًا.

ابحث في الديباجة بحثًا ثنائيًا

حين يستعصي الخطأ على الفحص، علّق النصف الثاني من الديباجة وأعد التجميع. فإن اختفى الخطأ، فالمسبّب في النصف المعلَّق؛ أعد نصفه وكرر العملية. ومن بضع عمليات تجميع تعزل السطر الوحيد المسؤول، وهذا أسرع بكثير من التفكير في ديباجة لم تكتبها.

ابحث قبل أن تتعب

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

العودة إلى المستندات الطويلة