[Tex/LaTex] Change \ref text

hyperref

I wonder whether I can change displayed text in \ref globally for a \label referencing a numbered environment. Concretely:

Let's suppose I have a theorem called "Important Proof".

\begin{theorem}[Important Proof]\label{IP}
Trivial.
\end{theorem}

Then \ref{IP} would display something like 1.1.1. I however want to change that text only sporadically, so that this specific proof gets displayed e.g. with Important Proof, but all other proofs stay unaffected.

What did I mean with globally? I saw some workarounds using \hyperref every single time, but this does not seem really convincing; I would like to have some kind of redefinition, so that I can just use something like \ref s.t. I don't have to insert the text every single time manually.

Best Answer

\documentclass{article}
\usepackage{hyperref}
\newtheorem{theorem}{Theorem}
\begin{document}
\begin{theorem}[Important Proof]%
\makeatletter\def\@currentlabel{Important Proof}\makeatother
\label{IP}
Trivial.
\end{theorem}

\ref{IP}
\end{document}

Related Solutions

[Tex/LaTex] Change ref color of on the ‘List of Figures’

This is possible with

\bgroup
\hypersetup{linkcolor = black}
\listoffigures
\egroup

or more compact (but maybe not as obvious) with brackets for grouping

{\hypersetup{linkcolor = black} \listoffigures}

or alternatively without the grouping but an additional \hypersetup{linkcolor = red} after the \listoffigures:

\hypersetup{linkcolor = black}
\listoffigures
\hypersetup{linkcolor = red}

The hyperref package uses either colorlinks=true, i.e. the links are shown in some other colour than black, or colorlinks=false, in which case the text of the links is black (or whatever colour is set e.g. with \color) and there is a coloured rectangle around it. The colorlinks-option cannot be changed with \hypersetup.

Nevertheless it is possible to do this:

\usepackage[colorlinks=false,linkbordercolor=red,...]{hyperref}

to get red rectangles around the links,

\listoffigures

\hypersetup{linkbordercolor = white}

to get rid of the rectangles after the list of figures,

{\color{red}\ref{something}}

to get red links (needed for each & every link!). Probably something like

\newcommand*{\myref}[1]{{\color{red}\ref{#1}}}

in the preamble (after loading the hyperref package) and using \myref instead of \ref would be easier, maybe even re-defining \ref.

You would also need to do this colour-management for the other types of links!

(BTW: For blue rectangles it is linkbordercolor=blue.)

Using the xcolor package it is also possible to use

\colorlet{foo}{red}
\colorlet{red}{blue}

\listoffigures

\colorlet{red}{foo}

The links (either text or rectangle) in the \listoffigures would be printed in blue, and the links afterwards in red again. The question "How do I combine link-colouring and link-borders with the hyperref-package?" is probably best asked as new question in my humble opinion.

[Tex/LaTex] Why doesn’t \renewcommand{\ref}{\autoref} change \ref into \autoref

Ok, figured out a solution:

enter image description here

Notes:

None of the usual tricks of using:
1. \renewcommand{\ref}[1]{\autoref{#1}}
2. \def\ref#1{\autoref{#1}}
3. \let\ref\autoref
4. \LetLtxMacro\ref\autoref
seem to work in this case.

I suspect it is because hyperref does an \AtBeginDocument, so that some things get defined at the the start of the document. So using \AtBeginDocument puts our redefinition at the end of queue of commands that get executed \AtBeginDocument.

And since placing the \AtBeginDocument to be before \usepackage{hyperref} does not work, this confirms that the suspicion was correct.

Code:

\documentclass{article}

\usepackage{hyperref} 


\AtBeginDocument{\renewcommand{\ref}[1]{\autoref{#1}}}

\begin{document}
\section{Section Title} \label{anchor}
Blah Blah Blah.  \autoref{anchor}  \ref{anchor}
\end{document}