Pular para o conteúdo

cleveref, nameref e varioref no Scissor LaTeX

O pacote cleveref funciona quase todo no Scissor LaTeX: \cref e \Cref funcionam com rótulos únicos, listas e intervalos, assim como \cpageref, \namecref, as opções capitalise, noabbrev e nameinlink, e \crefname; \nameref imprime um número em vez de um título, e \vref não dá indicação de página.

O que os pacotes fazem

O cleveref acrescenta o tipo do objeto a uma referência: \cref{fig:plot} imprime "fig. 1" sem que você digite a palavra, e \cref{a,b} junta vários rótulos em "figs. 1 and 2". O nameref imprime o título de uma seção em vez do número. O varioref acrescenta indicações de página como "on the next page" com \vref.

O que funciona aqui

ComandoNo Scissor LaTeXObservações
\cref{label}Funciona"section 1", "fig. 1", "table 1", "eq. (1)".
\Cref{label}FuncionaCom inicial maiúscula e sem abreviações: "Figure 1", "Equation (1)".
\cref{a,b}, \cref{a,b,c}Funciona"sections 1 and 2".
\crefrange{a}{b}Funciona"eqs. (1) to (2)".
\cpageref{label}Funciona"page 1".
\namecref{label}, \labelcref{label}FuncionaSó o nome ("eq.") ou só o número ("(1)").
\crefname, \CrefnameFuncionaSeus próprios nomes, no preâmbulo.
Opções capitalise, noabbrev, nameinlinkFuncionaAs outras opções são ignoradas.
\nameref{label} (nameref)Em parteImprime o número, não o título.
\vref, \Vref (varioref)Em parteImprime o número, sem indicação de página.

Exemplos

O \cref nomeia o tipo do objeto por você e junta vários rótulos:

\cref e \Cref

LaTeXPreâmbulo: \usepackage{cleveref}Abrir no editor (abre em uma nova aba)
\section{Data}\label{sec:data}
\section{Method}\label{sec:method}
\begin{figure}[h]
  \centering
  \fbox{A plot of the 44 samples}
  \caption{Samples.}\label{fig:samples}
\end{figure}
\begin{table}[h]
  \centering
  \begin{tabular}{lr} Erika & 44 \\ Hans & 38 \\ \end{tabular}
  \caption{Counts.}\label{tab:counts}
\end{table}
As \cref{sec:data,sec:method} explain, \cref{fig:samples} shows
the samples. \Cref{tab:counts} counts them.
Renderizado pelo Scissor LaTeX: \cref e \Cref

Equações, intervalos e referências de página:

Equações, \crefrange e \cpageref

LaTeXPreâmbulo: \usepackage{amsmath,cleveref}Abrir no editor (abre em uma nova aba)
\begin{equation} a + b = 44 \label{eq:sum} \end{equation}
\begin{equation} a - b = 2 \label{eq:diff} \end{equation}
Adding \crefrange{eq:sum}{eq:diff} gives $a = 23$; \Cref{eq:sum}
is on \cpageref{eq:sum}.
Renderizado pelo Scissor LaTeX: Equações, \crefrange e \cpageref

As opções capitalise e noabbrev escrevem nomes completos e com inicial maiúscula em todo lugar, e \crefname define os seus. Com capitalise, o \cref usa a forma com maiúscula do seu nome, então part abaixo sai como "Part":

Opções e \crefname

\documentclass{article}
\usepackage[capitalise,noabbrev]{cleveref}
\crefname{section}{part}{parts}
\begin{document}
\section{Overview}\label{sec:overview}
\begin{figure}[h]
  \centering
  \fbox{Diagram}
  \caption{A diagram.}\label{fig:diagram}
\end{figure}
\cref{fig:diagram} belongs to \cref{sec:overview}.
\end{document}

Aqui o \nameref imprime o número da seção, não o título:

\nameref imprime um número

LaTeXPreâmbulo: \usepackage{nameref}Abrir no editor (abre em uma nova aba)
\section{Related work}\label{sec:related}
John Doe's results are summarised in \nameref{sec:related}.

Compatibilidade

  • De uma instalação do TeX para cá: referências com \cref e companhia ficam como em uma instalação do TeX. O \nameref dá um número em vez de um título, e o \vref não tem a indicação "on the next page".
  • Daqui para uma instalação do TeX: os documentos compilam lá sem mudanças. Carregue o cleveref depois do hyperref, como pede o manual.

Os manuais completos estão no CTAN: ctan.org/pkg/cleveref, ctan.org/pkg/nameref e ctan.org/pkg/varioref. Para um guia, veja Rótulos e referências cruzadas, e para o \autoref, hyperref.

Perguntas e respostas

Qual é a diferença entre \cref e \Cref?

O \cref usa nomes curtos e minúsculos como "fig. 1" ou "eq. (1)". O \Cref os escreve por extenso com inicial maiúscula, para o começo de uma frase. A opção capitalise faz o \cref se comportar como o \Cref em todo lugar.

O \nameref imprime o título da seção?

Ainda não. Ele imprime o número da seção, então a frase continua fazendo sentido, mas de outro jeito. Escreva o título por extenso se ele for importante.

Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.