Конфликт между списками и гиперссылкой: ссылка на "lstnumber.-14.11" есть, но она не существует

Question 1

Вот пример того, как это следует делать, по моему мнению:

В \codeblockкоманда \labelприменяется до \lstinputlistingиспользования макроса, т. е. до того, как счетчик listingsбыл увеличен для возможности ссылки с \refstepcounter-- использование \labelbefore \refstepcounterявляется очень распространенной ошибкой, и, как таковая, информация перекрестной ссылки, записанная с помощью, \labelиспользуется из потенциально \refstepcounterиспользуемого before, который может быть связан с sectionetc. counter, поэтому информация неверна, и координаты гиперякоря берутся из более старого экземпляра якоря before. Таким образом, ссылки указывают обратно на неправильную позицию.

На самом деле, \lstinputlistingесть label=возможность указать имя метки.

Ниже приведена очень сокращенная форма, предложенная не-MWE, но она работает.

\documentclass[ebook,10pt,oneside,final]{memoir}
\usepackage{microtype}

% support for code listings

\begin{filecontents}{examplehelloworld.c}
#include<stdio.h>

int main(int argc,char **argv)
{
  printf("Hello World!\n");
  return(0);
}
\end{filecontents}

\usepackage[final]{listings}
%\include{autodedent}
\lstset{
  basicstyle=\ttfamily\footnotesize,
  numberstyle=\footnotesize,
  breaklines=true,
  numbers=left,
  firstnumber=1,
  rangeprefix=//,
  includerangemarker=false
}

% support for indexing
\usepackage{makeidx}
\makeindex

% make _ a non-special character
\usepackage{underscore}

% support for cross-references
\usepackage{hyperref}
% \newcommand{\href}[2]{#2}

% fix spacing in \tableofcontents
\renewcommand\partnumberline[1]{#1\hspace{1em}}

% custom commands for use in the text of the book itself
\newcommand{\newterm}[1]{\textit{#1}}
\newcommand{\code}[1]{\mbox{\lstinline[basicstyle=\ttfamily]$#1$}}
\newcommand{\slurl}[1]{\href{https://#1}{\textsl{#1}}}
\newcommand{\codeblock}[2]{\hspace{1em}\lstinputlisting[language={C},label={lst:#1-#2}]{examplehelloworld.c}}
\newcommand{\codeblockref}[2]{\pageref{lst:#1-#2}}
\newcommand{\Csharp}{C\#}


\usepackage{blindtext}

\begin{document}

\frontmatter
%\include{preface}
\tableofcontents

\mainmatter


\blindtext[3]


Reference: \codeblockref{1}{4}

\blindtext[5]


\codeblock{1}{4}



\end{document}

Answer

Вот пример того, как это следует делать, по моему мнению:

В \codeblockкоманда \labelприменяется до \lstinputlistingиспользования макроса, т. е. до того, как счетчик listingsбыл увеличен для возможности ссылки с \refstepcounter-- использование \labelbefore \refstepcounterявляется очень распространенной ошибкой, и, как таковая, информация перекрестной ссылки, записанная с помощью, \labelиспользуется из потенциально \refstepcounterиспользуемого before, который может быть связан с sectionetc. counter, поэтому информация неверна, и координаты гиперякоря берутся из более старого экземпляра якоря before. Таким образом, ссылки указывают обратно на неправильную позицию.

На самом деле, \lstinputlistingесть label=возможность указать имя метки.

Ниже приведена очень сокращенная форма, предложенная не-MWE, но она работает.

\documentclass[ebook,10pt,oneside,final]{memoir}
\usepackage{microtype}

% support for code listings

\begin{filecontents}{examplehelloworld.c}
#include<stdio.h>

int main(int argc,char **argv)
{
  printf("Hello World!\n");
  return(0);
}
\end{filecontents}

\usepackage[final]{listings}
%\include{autodedent}
\lstset{
  basicstyle=\ttfamily\footnotesize,
  numberstyle=\footnotesize,
  breaklines=true,
  numbers=left,
  firstnumber=1,
  rangeprefix=//,
  includerangemarker=false
}

% support for indexing
\usepackage{makeidx}
\makeindex

% make _ a non-special character
\usepackage{underscore}

% support for cross-references
\usepackage{hyperref}
% \newcommand{\href}[2]{#2}

% fix spacing in \tableofcontents
\renewcommand\partnumberline[1]{#1\hspace{1em}}

% custom commands for use in the text of the book itself
\newcommand{\newterm}[1]{\textit{#1}}
\newcommand{\code}[1]{\mbox{\lstinline[basicstyle=\ttfamily]$#1$}}
\newcommand{\slurl}[1]{\href{https://#1}{\textsl{#1}}}
\newcommand{\codeblock}[2]{\hspace{1em}\lstinputlisting[language={C},label={lst:#1-#2}]{examplehelloworld.c}}
\newcommand{\codeblockref}[2]{\pageref{lst:#1-#2}}
\newcommand{\Csharp}{C\#}


\usepackage{blindtext}

\begin{document}

\frontmatter
%\include{preface}
\tableofcontents

\mainmatter


\blindtext[3]


Reference: \codeblockref{1}{4}

\blindtext[5]


\codeblock{1}{4}



\end{document}

Question 2

В процессе публикации этого вопроса я наткнулся на ответ! (Не то чтобы я его понял)почемуоно работает...)

Если вы соберете только эти фрагменты в тестовом файле и запустите pdflatex test.tex; pdflatex test.tex— все будет работать отлично! (За исключением того, что гиперссылка под номером «1» на самом деле ведет в оглавление, а не на страницу 1.)

Когда он выдавал ошибки, я не был удивлен, что hyperref попал не туда. Однако с сокращенным тестовым случаем я был озадачен. Поэтому я пошел читать очтопроблема, и обнаружил, что то, что я хотел, было \phantomsection, например, таким:

\newcommand{\codeblock}[2]{\phantomsection\label{lst:#1-#2}\lstinputlisting[linerange=ex#2-dex#2,autodedent]{examples-ch#1.cc}}
\newcommand{\codeblockref}[2]{\pageref{lst:#1-#2}}

Обратите внимание, что мой карго-культ \hspace{1em}больше не нужен (насколько мне известно); и я смог вернуть специальные символы, lst:#1-#2которые заменил, foo#1#2пытаясь сократить тестовый пример.

...И по волшебству мой гигантский проект внезапно компилируется отлично! Больше никаких загадочных сообщений об ошибках. Все гиперссылки ведут на нужные страницы и показывают правильный основной текст.

Понятия не имею, почему пропуск \phantomsectionвызвал такой хаос, но после его добавления все исправилось!

Answer