تسلسل تحكم غير معرَّف
أسماء أوامر غير معروفة: أخطاء إملائية، وحزم مفقودة، ومحرك خاطئ.
تسلسل تحكم غير معرَّف
العَرَض
يتوقف التجميع مع الرسالة ! Undefined control sequence. ثم يعرض السجل السطر الذي وقع فيه الخطأ مقسومًا إلى قسمين: كل ما قرأه TeX حتى الأمر المخالف، بما فيه ذلك الأمر، في سطر واحد، وبقية سطر المصدر تحته. والرمز الأخير في السطر العلوي هو الأمر الذي لم يتعرف عليه TeX، ما يجعل هذا الخطأ من أسهل الأخطاء تحديدًا لموضعه بدقة.
لماذا يحدث
تسلسل التحكم هو أي شيء يبدأ بشرطة مائلة عكسية. ليس لدى TeX مفردات ثابتة: الأوامر موجودة فقط لأن النواة أو فئة المستند أو إحدى الحزم أو أمر \newcommand الخاص بك قد عرّفها. وعندما يقرأ TeX شرطة مائلة عكسية يتبعها اسم لم يعرّفه شيء، لا يستطيع تخمين ما قصدته فيتوقف. والخطأ لا يتعلق أبدًا بكون الأمر «خاطئًا» بوجه عام، بل بكون هذا الاسم غير معروف في هذا المستند، عند هذه النقطة، وتحت هذا المحرك.
أصلحه بثلاثة فحوص
افحص الإملاء أولًا. فكتابة \texbf بدل \textbf، أو \lable بدل \label، أو مسافة شاردة تقسم الاسم إلى نصفين، تفسر معظم الحالات. ويقودك رقم السطر في السجل مباشرةً إلى الخطأ المطبعي.
إذا كان الإملاء سليمًا فالأرجح أن الحزمة التي تعرّف الأمر مفقودة. فالأمر \includegraphics لا يفعل شيئًا بدون \usepackage{graphicx}، ويحتاج \toprule إلى booktabs، ويحتاج \SI إلى siunitx. ويظهر هذا بأشد صوره عندما تنسخ مقتطفًا من مستند آخر أو من إجابة أحد النماذج: فقد جاء نص المتن ولم يأتِ سطر الديباجة. ابحث عن الحزمة التي تعرّف الأمر في شرح كل أمر، وأضف السطر \usepackage، وأعد التجميع. وإذا لم تكن الحزمة نفسها مثبتة، فراجع تثبيت حزمة مفقودة.
إذا كانت الحزمة محمّلة واستمر الخطأ، فاشتبه في المحرك. فبعض الأوامر لا توجد إلا في محرك بعينه: الأمر \fontspec وما يتصل به يتطلب XeLaTeX أو LuaLaTeX، وسيفشل تحت pdfLaTeX بهذا الخطأ تحديدًا. والقوالب التي تحدد محركًا في توثيقها تفعل ذلك عادةً لهذا السبب. ويشرح أي محرك لهذا المشروع الفروق بين المحركات.
مسألتان دقيقتان تستحقان المعرفة
الترتيب مهم: فالأمر المستخدم قبل سطر \usepackage الذي يعرّفه يظل غير معرّف عند تلك النقطة، لذا أبقِ تحميل الحزم في الديباجة، أعلى \begin{document}. وكثيرًا ما يخفي خطأ واحد خطأً آخر، لأن TeX بعد تعافيه قد يسيء قراءة كل ما يليه. أصلح أول تسلسل تحكم غير معرّف في السجل، ثم أعد التجميع، وبعدها فقط انظر في ما تبقى.