ارجاع درونمتنی در 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.