التوقف الاضطراري والوسيطة الجامحة
إيقاف قاتل للتجميع بسبب end ناقصة أو أقواس غير مغلقة أو ملفات مضمّنة خاطئة.
التوقف الاضطراري والوسيطة الجامحة
العَرَض
يتوقف التجميع تمامًا. ينتهي السجل بالرسالة ! Emergency stop. أو تظهر فيه Runaway argument? متبوعة بمقطع طويل من نصك أنت، وغالبًا معها سطر مرافق مثل File ended while scanning use of \textbf أو Paragraph ended before \foo was complete. وعلى خلاف معظم أخطاء LaTeX، لا يُنتج التجميع أي ملف PDF، وكثيرًا ما يشير رقم السطر المُبلَّغ عنه إلى نهاية الملف لا إلى موضع الخطأ الحقيقي.
لماذا يحدث
تأتي الرسالتان من المشكلة نفسها: بدأ TeX قراءة شيء يجب إغلاقه، ثم بلغ نهاية المدخلات قبل أن يصل رمز الإغلاق. عندما تكتب \textbf{، يجمع TeX كل ما يلي حتى } المطابق ويعدّه الوسيطة. وإن لم يأتِ هذا القوس أبدًا، يواصل TeX ابتلاع النص عبر الفقرات والأقسام حتى ينتهي الملف. رسالة “Runaway argument” هي TeX وهو يعرض عليك ما ابتلعه. أما “Emergency stop” فهي استسلام TeX لأنه لا يستطيع المتابعة من دون الجزء الناقص. وينتهي الأمر إلى الحالة النهائية نفسها إذا فُقد \end{document}، أو تُركت بيئة دون إغلاق، أو استُدعي بـ \input ملف غير موجود.
كيف تجد الموضع الحقيقي
لا تثق برقم السطر؛ فهو يحدد المكان الذي نفدت عنده المدخلات على TeX، لا المكان الذي بدأ عنده الخلل. بدلًا من ذلك، اقرأ كتلة Runaway argument? في السجل. الكلمات الأولى من النص المبتلَع تدلك على موضع بداية الوسيطة الجامحة في المستند، وسطر File ended while scanning use of ... يسمّي الأمر الذي لم تُغلق وسيطته. ابحث عن ذلك الأمر قرب النص المقتبس وعُدّ أقواسه.
وإذا لم يكن السجل مفيدًا، فابحث في المستند بحثًا ثنائيًا. علّق النصف الثاني من المتن (أو ضعه بين \iffalse ... \fi) ثم أعد التجميع. فإن اختفى الخطأ، فالمشكلة في النصف الذي أزلته؛ واصل تنصيف الجزء المشتبه به حتى تعزل الفقرة المعيبة. تبدو هذه الطريقة فجّة، لكنها تكشف قوسًا واحدًا ناقصًا في مستند كبير خلال عدد قليل من عمليات التجميع.
المشتبه بهم المعتادون
افحص وجود { بلا } مقابلة قرب الخط الغامق والمائل والحواشي السفلية والتعليقات التوضيحية، لأن هذه الأوامر تأخذ أقواس وسائط تكتبها بنفسك. وتأكد من أن لكل \begin{...} ما يقابله من \end{...} بالاسم نفسه للبيئة. وتأكد من أن الملف ينتهي بـ \end{document} وأن كل \input و\include يسمّي ملفًا موجودًا في ذلك المسار. والمحررات تساعد هنا: يُبرز Oleafly الأقواس المتقابلة وأزواج البيئات أثناء الكتابة، فيلتقط معظم هذه الأخطاء قبل أن يراها المترجم.