الإحالات المرجعية في LaTeX: \label و\ref
ضع \label{key} مباشرةً بعد ما تريد الإحالة إليه (بعد \section{...}، أو بعد \caption{...}، أو داخل معادلة) واكتب \ref{key} حيث تريد رقمه؛ ويملأ Scissor LaTeX الرقم عند التنضيد.
ضع العلامة، ثم أحِل
للإحالة المرجعية نصفان. يعلّم \label{key} شيئًا مرقّمًا، ويطبع \ref{key} رقمه. والمفتاح أي اسم تختاره؛ أما البادئات مثل sec: وfig: وtab: وeq: فهي عادة تجعل المفاتيح سهلة القراءة، لا قاعدة.
الإحالة إلى قسم وشكل
\section{Results}
\label{sec:results}
\begin{figure}[h]
\centering
\begin{tikzpicture}
\draw (0,0) -- (1,0.8) -- (2,0.3) -- (3,1.1);
\end{tikzpicture}
\caption{Measured values.}
\label{fig:values}
\end{figure}
Section~\ref{sec:results} shows the values in Figure~\ref{fig:values}.
العلامة ~ بين الكلمة والإحالة مسافة لا ينقطع عندها السطر أبدًا، فتبقى "Figure" ورقمها في السطر نفسه.
أين تضع العلامة
تأخذ العلامة رقم أقرب شيء مرقّم قبلها:
| للإحالة إلى | ضع \label | يطبع \ref |
|---|---|---|
| قسم | مباشرةً بعد \section{...} (أو \subsection أو \chapter) | 2، 2.1 |
| شكل أو جدول | بعد \caption{...}، داخل العنصر العائم | 1 |
| معادلة | داخل equation أو align مرقّمة | 1 |
| بند في قائمة | بعد \item في enumerate | 2، 2b |
| مبرهنة | داخل theorem وlemma والبيئات المشابهة | 1 |
| حاشية سفلية | داخل نص \footnote{...} | 2 |
المعادلات
يطبع \eqref{key} رقم المعادلة بين قوسين، كما تُعرض أرقام المعادلات عادةً. ويعطي \ref{key} الرقم وحده.
\eqref و\ref لمعادلة
\begin{equation}
a^2 + b^2 = c^2
\label{eq:pythagoras}
\end{equation}
Equation~\eqref{eq:pythagoras} is famous; its number is \ref{eq:pythagoras}.تحصل كتلة align أو gather على رقم واحد في Scissor LaTeX، لا رقم لكل صف. ولا يُحتفظ إلا بأول \label في الكتلة، لذا تطبع الإحالة إلى علامة صف لاحق ??. راجع المعادلات والمحاذاة والترقيم للتفاصيل.
أوامر تضيف الاسم: \autoref و\cref
يطبع \autoref (من hyperref) و\cref (من cleveref) نوع الشيء مع رقمه، فلا تحتاج إلى كتابة "Figure" بنفسك. ويتبع \cref الإعدادات الافتراضية لـ cleveref: أحرف صغيرة وأسماء مختصرة ("fig." و"eq.")، ويعطي \Cref في بداية الجملة الاسم الكامل بحرف أول كبير.
\autoref و\cref و\Cref
\section{Method}
\label{sec:method}
\begin{equation}
y = 44x
\label{eq:line}
\end{equation}
\begin{table}[h]
\centering
\caption{Settings.}
\label{tab:settings}
\begin{tabular}{lr} Runs & 44 \\ \end{tabular}
\end{table}
\autoref{sec:method} uses \cref{tab:settings} and \cref{eq:line}.
\Cref{tab:settings} lists the runs.
ويستطيع cleveref أيضًا الإحالة إلى عدة علامات دفعة واحدة، وإلى نطاق:
قوائم ونطاقات باستخدام \cref
\begin{equation} a = 1 \label{eq:a} \end{equation}
\begin{equation} b = 2 \label{eq:b} \end{equation}
See \cref{eq:a,eq:b}, or \crefrange{eq:a}{eq:b}.تُقرأ خيارات الحزمة capitalise (أو capitalize) وnoabbrev وnameinlink، وكذلك \crefname و\Crefname في الديباجة.
خيارات cleveref و\crefname
\documentclass{article}
\usepackage{amsmath}
\usepackage[capitalise,noabbrev]{cleveref}
\crefname{table}{Tab.}{Tabs.}
\begin{document}
\begin{equation} E = mc^2 \label{eq:e} \end{equation}
\begin{table}[h]
\centering
\caption{Masses.}
\label{tab:m}
\begin{tabular}{l} 44 kg \\ \end{tabular}
\end{table}
\cref{eq:e} uses the mass in \cref{tab:m}.
\end{document}
| الأمر | في Scissor LaTeX | ملاحظات |
|---|---|---|
\ref{key} | يعمل | الرقم فقط. |
\eqref{key} | يعمل | الرقم بين قوسين. |
\pageref{key} | يعمل | رقم الصفحة التي فيها العلامة. |
\autoref{key} | جزئيًا | "Section 2" و"Figure 1" و"Table 1" و"Theorem 1". وللمعادلات يطبع الرقم وحده، لا "Equation 1". |
\cref و\Cref | يعمل | علامة واحدة أو عدة علامات؛ بأسماء cleveref الافتراضية، أو بأسمائك من \crefname. |
\crefrange و\cpageref و\namecref | يعمل | نطاق، أو الصفحة، أو الاسم وحده. |
\nameref{key} | جزئيًا | يطبع الرقم، لا عنوان القسم. |
\vref{key} | جزئيًا | يطبع الرقم، دون "on the next page". |
\hyperref[key]{text} | يعمل | يطبع نصك رابطًا إلى العلامة. |
الصفحات والعلامات المفقودة
يطبع \pageref الصفحة التي توجد فيها العلامة. والإحالة إلى علامة غير موجودة تطبع ?? بخط عريض، كما يفعل LaTeX قبل تشغيله الثاني، ويسرد تبويب «المشكلات» كل علامة مفقودة مرة واحدة: "References to labels that do not exist (shown as ??): sec:nowhere".
\pageref وعلامة مفقودة
\section{Data}
\label{sec:data}
The data is described on page~\pageref{sec:data}.
This label does not exist: Section~\ref{sec:nowhere}.تبويب المشكلات: References to labels that do not exist (shown as ??): sec:nowhere
ما يختلف عن تثبيت TeX
للحزم، راجع cleveref وhyperref؛ والأدلة الكاملة متاحة على CTAN: cleveref وhyperref.
أسئلة وأجوبة
لماذا تظهر الإحالة على شكل ?? في LaTeX؟
العلامة غير موجودة، أو مكتوبة بطريقة مختلفة عن \ref. وفي Scissor LaTeX قد يعني ذلك أيضًا أن العلامة هي الثانية في كتلة align، التي لا تحصل إلا على رقم واحد.
كيف أحيل إلى معادلة مع الأقواس؟
استخدم \eqref{key} من amsmath. يطبع الرقم بين قوسين، مثلًا (1).
ما الفرق بين \ref و\autoref؟
يطبع \ref الرقم فقط. ويضيف \autoref النوع، مثل "Figure 1" أو "Section 2"، فيوفّر عليك كتابة الكلمة بنفسك.
كل مثال في هذه الصفحة ينضّده Scissor LaTeX عند بناء الموقع. آخر تحديث: 2026-11-07.