رفتن به محتوا

ارجاع درون‌متنی در 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}.
حروف‌چینی با Scissor LaTeX: ارجاع به یک بخش و یک شکل

~ میان کلمه و ارجاع فاصله‌ای است که هرگز شکسته نمی‌شود، پس «Figure» و شماره‌اش روی یک خط می‌مانند.

برچسب را کجا بگذاریم

برچسب شمارهٔ نزدیک‌ترین چیز شماره‌دارِ پیش از خود را می‌گیرد:

ارجاع به\label را بگذارید\ref چاپ می‌کند
یک بخشدرست پس از \section{...} (یا \subsection، \chapter)2، 2.1
یک شکل یا جدولپس از \caption{...}، درون شناور1
یک معادلهدرون equation یا یک align شماره‌دار1
یک مورد فهرستپس از \item در یک enumerate2، 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

LaTeXمقدمهٔ سند: \usepackage{amsmath,hyperref,cleveref}باز کردن در ویرایشگر (در زبانه‌ای تازه باز می‌شود)
\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.
حروف‌چینی با Scissor LaTeX: \autoref، \cref و \Cref

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: گزینه‌های cleveref و \crefname
فرماندر 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.