علامات استفهام بدلًا من الأرقام

التسميات تحتاج إلى تمريرة أخرى؛ وموضع التسمية يأتي بعد التعليق التوضيحي.

علامات استفهام بدلًا من الأرقام

تجمّع المستند، وفي المكان الذي ينبغي أن يظهر فيه رقم شكل أو معادلة يعرض ملف PDF العلامتين ??. هذا ليس خطأ في شيفرتك المصدرية. هكذا يعرض LaTeX إحالة لم يستطع حلّها بعد، وغالبًا ما يكفي في الإصلاح أن تجمّع مرة أخرى.

لماذا لا تكفي تمريرة واحدة

يقرأ LaTeX مستندك من الأعلى إلى الأسفل في تمريرة واحدة. فعندما يصادف \label يكتب الرقم الحالي في ملف .aux؛ وعندما يصادف \ref يبحث عن الرقم في ملف .aux الذي كتبته التمريرة السابقة. وفي أول تجميع لا توجد تمريرة سابقة، فتُطبع كل إحالة على هيئة ??. تقرأ التمريرة الثانية ملف .aux المكتمل وتملأ الأرقام. يعيد المترجم المضمَّن في Oleafly التمريرات تلقائيًا حتى تستقر الأرقام، لكن إن كنت تشغّل pdflatex يدويًا، فالتجميع الثاني من مهمتك.

حين تبقى ?? بعد التمريرة الثانية

إذا استمرت علامات الاستفهام، فمرّ على ثلاثة فحوص. أولًا، قارن الهجاء في \ref بالهجاء في \label حرفًا بحرف؛ فالتسميات حساسة لحالة الأحرف، والمسافة الزائدة تُحتسب. ثانيًا، افحص موضع التسمية. يسجل \label قيمة آخر عدّاد جرى تقديمه، وفي العنصر العائم يكون \caption هو الذي يقدّم العدّاد، فيجب أن تأتي التسمية بعد التعليق التوضيحي:

\begin{figure}
\centering
\includegraphics[width=0.7\textwidth]{plot.pdf}
\caption{Convergence of the estimator.}
\label{fig:convergence}
\end{figure}
Figure~\ref{fig:convergence} shows the effect.

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

قراءة التحذيرات

يخبرك السجل بالحالة التي أنت فيها. رسالة “There were undefined references” تعني أن \ref واحدة على الأقل لم تجد شيئًا. ورسالة “Label(s) may have changed. Rerun to get cross-references right” تعني أن تمريرة أخرى ستصلح الأمر. ورسالة “Label multiply defined” تعني أن أمرَي \label يشتركان في اسم واحد، وأن LaTeX يستعمل أحدهما بصمت، فغيّر الأسماء حتى تصبح كل تسمية فريدة. واعتماد اصطلاح تسمية ببادئات eq: وfig: وtab: يجعل التصادمات نادرة ويسهّل البحث في الشيفرة؛ وسير عمل التسميات نفسه مشروح في درس أرقام المعادلات والإحالات إليها.

العودة إلى قراءة السجلات