Comment référencer des environnements flottants tels que des listes ou des chiffres là où ils sont mentionnés?
Je veux mettre quelques entrées de code source et quelques figures / images dans mon annexe pour plus de détails voir cette question ), et donc je trouverais très utile d'avoir un backlink là-bas (tout comme vous pouvez avoir dans la bibliographie ou l'acronyme TOC avec acroenviron), car la pièce où elle est référencée est très éloignée de l'endroit où elle est imprimée (c'est-à-dire en annexe).
En bref, cette question suppose essentiellement le "contraire" de la question "Garder les tableaux / figures près de l'endroit où ils sont mentionnés" , c'est-à-dire que mes images / listes sont loin de l'endroit où elles sont mentionnées et donc j'aimerais une référence pour elles , afin que les gens puissent trouver l'explication d'un extrait de code ou d'une image que je cite lorsqu'ils regardent simplement l'annexe.
J'ai utilisé hyperrefles commandes de pour référencer la figure ou la liste créée via frappé, par exemple \autoref, \namerefou \fullref.
Ainsi, est-il possible d'une manière ou d'une autre d'ajouter une référence arrière (backref / backlink) à la légende - ou en gardant à l'esprit mon autre idée d'utiliser des titres au lieu de légendes ailleurs dans le texte?
Je veux par exemple une légende comme celle-ci:
Extrait de code source montrant comment A fait B. (mentionné aux pages 5, 7-8.)
Le style exact, c'est-à-dire s'il est compact et saute des pages ou quelle intro il utilise ("mentionné sur les pages" pourrait aussi simplement être remplacé par "pp." Ou une autre abréviation qui est probablement déjà définie dans une macro biblatex ou acro) donc, n'a pas d'importance, mais j'aime par exemple le style acroutilisé.)
Edit: Comme cela ne semble toujours pas clair, je veux quelque chose comme l'acro:
Je veux ces backlinks "S. 10, 14, 27" etc. vers la page. La réponse de @John Kormylo fournit un bel exemple, mais n'est pas complète. Mais je ne pas veux eux pour un acronyme ou d'une liste de référence (biblatex peut aussi le faire, je sais que), mais pour certains chiffres / listes / sous - titres en annexe .
BTW, il suffit que ce soit des liens vers la page , il n'est pas nécessaire que ce soit la position exacte.
Il n'y a pas de MWE que je puisse donner, car cela ne fonctionne pas ici.
Remarque: pour des raisons évidentes, backref devrait éventuellement exclure un lien dans une table des matières comme \listoflistingsou \listoffigures.
Réponses
Voici un petit quelque chose basé sur l biblatex'approche backref de.
A chaque appel de \ref/ \autorefnous envoyons un marqueur au .auxfichier que l'étiquette a été référencée sur cette page particulière. Au début de chaque exécution de LaTeX, nous pouvons lire les combinaisons étiquette-page du .auxfichier et compiler pour chaque étiquette une liste de pages où elle a été référencée. Cette liste peut ensuite être utilisée ultérieurement pour l'impression.
Avec cette approche simple, nous relions uniquement aux pages, pas à l'endroit exact où l'étiquette a été référencée, nous n'émettons pas non plus d'avertissements de réexécution LaTeX automatiquement.
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage{etoolbox}
\usepackage{hyperref}
\makeatletter
% stolen from biblatex
% we need a way to check if printable text is in a list
\newrobustcmd{\rugk@ifprintableinlist}[2]{%
\begingroup
\def\rugk@tempa{\endgroup
\@secondoftwo}%
\renewcommand*{\do}[1]{%
\ifstrequal{##1}{#1}
{\def\rugk@tempa{\endgroup
\@firstoftwo}%
\listbreak}
{}}%
\dolistloop{#2}%
\expandafter\rugk@tempa}
\newrobustcmd{\rugk@ifprintableinlistcs}[2]{%
\expandafter\rugk@ifprintableinlistcs@i\csname #2\endcsname{#1}}
\long\def\rugk@ifprintableinlistcs@i#1#2{\rugk@ifprintableinlist{#2}{#1}}
% add <page> to the list of pages where <label> was referenced
% {<label>}{<page>}{<page int>}
\protected\def\rugk@ref@backref#1#2#3{%
\ifcsundef{rugk@ref@backreflist@\detokenize{#1}}
{\global\cslet{rugk@ref@backreflist@\detokenize{#1}}\@empty}
{}%
\rugk@ifprintableinlistcs{#2}{rugk@ref@backreflist@\detokenize{#1}}
{}
{\listcsgadd{rugk@ref@backreflist@\detokenize{#1}}{#2}}}
% write label backref to aux file
% {<label>}
\def\rugk@write@ref@backref#1{%
\if@filesw
\protected@write\@mainaux{}{\string\rugk@ref@backref
{#1}{\thepage}{\noexpand\the\c@page}}%
\fi}
\newcommand{\backref}[1]{%
\rugk@write@ref@backref{#1}%
\ref{#1}%
}
\newcommand{\autobackref}[1]{%
\rugk@write@ref@backref{#1}%
\autoref{#1}%
}
\newcounter{backrefpages}
\newcounter{totalbackrefpages}
\newcommand*{\printbackrefpage}[1]{%
\stepcounter{backrefpages}%
\hyperlink{page.#1}{#1}%
\ifnumless{\value{backrefpages}}{\value{totalbackrefpages}}
{, }
{}}
\newrobustcmd*{\printlabelbackrefs}[1]{%
\setcounter{backrefpages}{0}%
\setcounter{totalbackrefpages}{0}%
\ifcsundef{rugk@ref@backreflist@\detokenize{#1}}
{Not referenced}
{\def\do##1{\stepcounter{backrefpages}}%
\dolistcsloop{rugk@ref@backreflist@\detokenize{#1}}%
\setcounter{totalbackrefpages}{\value{backrefpages}}%
\setcounter{backrefpages}{0}%
\ifnumgreater{\value{totalbackrefpages}}{1}
{pp.}
{p.}~%
\forlistcsloop{\printbackrefpage}{rugk@ref@backreflist@\detokenize{#1}}}}
\makeatother
\newrobustcmd{\backcaption}[3][]{%
\if\relax\detokenize{#1}\relax
\def\rugk@tmpcapt{\caption[#2]}%
\else
\def\rugk@tmpcapt{\caption[#1]}%
\fi
\rugk@tmpcapt{#2 (see \printlabelbackrefs{#3})}%
\label{#3}}
\begin{document}
\section{Introduction}
\listoffigures
Here is a reference to \backref{test} and \autobackref{test}
\clearpage
And here we talk about it again: \autobackref{test}
\clearpage
\begin{figure}[p]
\backcaption{This is a test.}{test}
\end{figure}
\end{document}
Une alternative basée sur des étiquettes avec un compteur courant. La sortie backref ne renverra qu'à une seule étiquette de backref par page et étiquette, mais cela pourrait être changé si vous le souhaitez (cela peut paraître bizarre car vous obtiendrez quelque chose comme "pp. 1, 1").
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage{etoolbox}
\usepackage{hyperref}
\makeatletter
\newcounter{backrefinst}
% stolen from biblatex
% we need a way to check if printable text is in a list
\newrobustcmd{\rugk@ifprintableinlist}[2]{%
\begingroup
\def\rugk@tempa{\endgroup
\@secondoftwo}%
\renewcommand*{\do}[1]{%
\ifstrequal{##1}{#1}
{\def\rugk@tempa{\endgroup
\@firstoftwo}%
\listbreak}
{}}%
\dolistloop{#2}%
\expandafter\rugk@tempa}
\newrobustcmd{\rugk@ifprintableinlistcs}[2]{%
\expandafter\rugk@ifprintableinlistcs@i\csname #2\endcsname{#1}}
\long\def\rugk@ifprintableinlistcs@i#1#2{\rugk@ifprintableinlist{#2}{#1}}
% add <page> to the list of pages where <label> was referenced
% remember the first instance counter for each label/page combination
% {<label>}{<backref instance counter>}{<page>}{<page int>}
\protected\def\rugk@ref@backref#1#2#3#4{%
\ifcsundef{rugk@ref@backreflist@\detokenize{#1}}
{\global\cslet{rugk@ref@backreflist@\detokenize{#1}}\@empty}
{}%
\rugk@ifprintableinlistcs{#3}{rugk@ref@backreflist@\detokenize{#1}}
{}
{\listcsgadd{rugk@ref@backreflist@\detokenize{#1}}{#3}%
\csgdef{rugk@ref@backrefinst@\detokenize{#1}@\detokenize{#3}}{#2}}}
% write label backref to aux file
% {<label>}
\def\rugk@write@ref@backref#1{%
\if@filesw
\protected@write\@mainaux{}{\string\rugk@ref@backref
{#1}{\the\value{backrefinst}}{\thepage}{\noexpand\the\c@page}}%
\fi}
\newcommand*{\rugk@create@backref@label}[1]{%
\begingroup
\refstepcounter{backrefinst}%
\label{backref.\the\value{backrefinst}}%
\rugk@write@ref@backref{#1}%
\endgroup
}
\newcommand{\backref}[1]{%
\ref{#1}%
\rugk@create@backref@label{#1}%
}
\newcommand{\autobackref}[1]{%
\autoref{#1}%
\rugk@create@backref@label{#1}%
}
\newcounter{backrefpages}
\newcounter{totalbackrefpages}
% {<label>}{<page>}
\newcommand*{\printbackrefpage}[2]{%
\stepcounter{backrefpages}%
\pageref{backref.\csuse{rugk@ref@backrefinst@\detokenize{#1}@\detokenize{#2}}}%
\ifnumless{\value{backrefpages}}{\value{totalbackrefpages}}
{, }
{}}
\newrobustcmd*{\printlabelbackrefs}[1]{%
\setcounter{backrefpages}{0}%
\setcounter{totalbackrefpages}{0}%
\ifcsundef{rugk@ref@backreflist@\detokenize{#1}}
{Not referenced}
{\def\do##1{\stepcounter{backrefpages}}%
\dolistcsloop{rugk@ref@backreflist@\detokenize{#1}}%
\setcounter{totalbackrefpages}{\value{backrefpages}}%
\setcounter{backrefpages}{0}%
\ifnumgreater{\value{totalbackrefpages}}{1}
{pp.}
{p.}~%
\forlistcsloop{\printbackrefpage{#1}}{rugk@ref@backreflist@\detokenize{#1}}}}
\makeatother
\newrobustcmd{\backcaption}[3][]{%
\if\relax\detokenize{#1}\relax
\def\rugk@tmpcapt{\caption[#2]}%
\else
\def\rugk@tmpcapt{\caption[#1]}%
\fi
\rugk@tmpcapt{#2 (see \printlabelbackrefs{#3})}%
\label{#3}}
\begin{document}
\section{Introduction}
\listoffigures
Here is a reference to \backref{test} and \autobackref{test}
\clearpage
And here we talk about it again: \autobackref{test}
\clearpage
\begin{figure}[p]
\backcaption{This is a test.}{test}
\end{figure}
\end{document}
Si vous vouliez imprimer toutes les occasions de backref, ce code pourrait être un peu simplifié: il suffirait de se souvenir d'une liste de décomptes d'instances de backref pour chaque étiquette et non d'une liste de pages pour chaque étiquette.
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage{etoolbox}
\usepackage{hyperref}
\makeatletter
\newcounter{backrefinst}
% add <page> to the list of pages where <label> was referenced
% remember the first instance counter for each label/page combination
% {<label>}{<backref instance counter>}
\protected\def\rugk@ref@backref#1#2{%
\ifcsundef{rugk@ref@backreflist@\detokenize{#1}}
{\global\cslet{rugk@ref@backreflist@\detokenize{#1}}\@empty}
{}%
\ifinlistcs{#2}{rugk@ref@backreflist@\detokenize{#1}}
{}
{\listcsgadd{rugk@ref@backreflist@\detokenize{#1}}{#2}}}
% write label backref to aux file
% {<label>}
\def\rugk@write@ref@backref#1{%
\if@filesw
\protected@write\@mainaux{}{\string\rugk@ref@backref
{#1}{\the\value{backrefinst}}}%
\fi}
\newcommand*{\rugk@create@backref@label}[1]{%
\begingroup
\refstepcounter{backrefinst}%
\label{backref.\the\value{backrefinst}}%
\rugk@write@ref@backref{#1}%
\endgroup
}
\newcommand{\backref}[1]{%
\ref{#1}%
\rugk@create@backref@label{#1}%
}
\newcommand{\autobackref}[1]{%
\autoref{#1}%
\rugk@create@backref@label{#1}%
}
\newcounter{backrefpages}
\newcounter{totalbackrefpages}
% {<label>}{<page>}
\newcommand*{\printbackrefpage}[1]{%
\stepcounter{backrefpages}%
\pageref{backref.#1}%
\ifnumless{\value{backrefpages}}{\value{totalbackrefpages}}
{, }
{}}
\newrobustcmd*{\printlabelbackrefs}[1]{%
\setcounter{backrefpages}{0}%
\setcounter{totalbackrefpages}{0}%
\ifcsundef{rugk@ref@backreflist@\detokenize{#1}}
{Not referenced}
{\def\do##1{\stepcounter{backrefpages}}%
\dolistcsloop{rugk@ref@backreflist@\detokenize{#1}}%
\setcounter{totalbackrefpages}{\value{backrefpages}}%
\setcounter{backrefpages}{0}%
\ifnumgreater{\value{totalbackrefpages}}{1}
{pp.}
{p.}~%
\forlistcsloop{\printbackrefpage}{rugk@ref@backreflist@\detokenize{#1}}}}
\makeatother
\newrobustcmd{\backcaption}[3][]{%
\if\relax\detokenize{#1}\relax
\def\rugk@tmpcapt{\caption[#2]}%
\else
\def\rugk@tmpcapt{\caption[#1]}%
\fi
\rugk@tmpcapt{#2 (see \printlabelbackrefs{#3})}%
\label{#3}}
\begin{document}
\section{Introduction}
\listoffigures
Here is a reference to \backref{test} and \autobackref{test}
\clearpage
And here we talk about it again: \autobackref{test}
\clearpage
\begin{figure}[p]
\backcaption{This is a test.}{test}
\end{figure}
\end{document}
Cette solution utilise \backcaptionet \backrefau lieu de \caption\labelet \ref.
\documentclass{article}
\usepackage{hyperref}
\newcommand{\backref}[1]% #1 = label name
{\raisebox{\baselineskip}[\ht\strutbox]{\hypertarget{#1.back}{}}\ref{#1}}
\newcommand{\backcaption}[2]% #1 = caption, #2= label
{\caption[#1]{\hyperlink{#2.back}{#1}}\label{#2}}
\begin{document}
\listoffigures
\vspace{2in}
Here is a reference to \backref{test}.
\begin{figure}[p]
\backcaption{This is a test.}{test}
\end{figure}
\end{document}
D'accord, grâce à la réponse de @John Kormylo, j'ai obtenu une solution partielle, c'est-à-dire que si nous utilisons un habituel, \labelnous pouvons bien sûr utiliser \pagerefpour renvoyer à la page.
Le seul problème est que cela ne fonctionne également que si nous n'avons qu'une seule référence .
Voici un code:
\documentclass{article}
\usepackage[utf8]{inputenc}
\title{test-backref}
\date{August 2020}
\usepackage{hyperref}
% thanks https://tex.stackexchange.com/a/559834/98645
\newcommand{\backref}[1]% #1 = label name
{
\raisebox{\baselineskip}[\ht\strutbox]{\label{#1.back}{}}%
\ref{#1}
}
\newcommand{\autobackref}[1]% #1 = label name
{
\raisebox{\baselineskip}[\ht\strutbox]{\label{#1.back}{}}%
\autoref{#1}
}
\newcommand{\backcaption}[2]% #1 = caption, #2= label
{\caption[#1]{#1 (see p.~\pageref{#2.back})}\label{#2}}
\newcommand{\backcaptionoptional}[3]% #1 optional label, 2 = caption, #3= label
{\caption[#1]{#2 (see p.~\pageref{#3.back})}\label{#3}}
\begin{document}
\maketitle
\section{Introduction}
\listoffigures
\vspace{2in}
Here is a reference to \backref{test} and \autobackref{test}….
\newpage
And here we talk about it again: \autobackref{test}
\newpage
\begin{figure}[p]
\backcaption{This is a test.}{test}
\end{figure}
\end{document}
Notez qu'il illustre également le problème. LaTeX se plaint (à juste titre):
Vous avez utilisé la même étiquette plus d'une fois. Vérifiez que chaque \ label {...} étiquette un seul élément.
Cela se produit, car j'ai fait référence à ce chiffre à plusieurs reprises. En fin de compte, la sortie utilise simplement la dernière étiquette comme référence.
Ce n'est donc pas tout à fait fini, mais je suppose que nous aurions besoin d'utiliser des compteurs ou plus pour compter les étiquettes pour une solution complète? Ne le ferions-nous pas? (Si vous avez une idée, n'hésitez pas à la soumettre et à l'utiliser comme base.)