Настраиваемый вывод при ссылке на автоматически пронумерованный абзац

Question

У меня есть настроенный параграф, который я использую для определения навыков и их автоматической нумерации. При ссылке на параграфы вывод должен быть настроенным текстом плюс номер счетчика (например, S1, S2 и т. д.). Но в настоящее время печатается только номер.

Что я делаю неправильно в своем подходе?

\documentclass{article}

\usepackage[utf8]{inputenc}
\usepackage{hyperref}
\usepackage[english]{babel}

\newcounter{skillCounter}
\newcommand{\skillParagraph}[2]{%
    \refstepcounter{skillCounter}%
    \paragraph*{#1 (S\arabic{skillCounter})}%
    \label{#2}%
    \expandafter\def\csname customlabel@#2\endcsname{#1 (S\theskillCounter)}%
}

% Custom command to reference custom labels
\newcommand{\cparref}[1]{%
    \hyperref[#1]{\csname customlabel@#1\endcsname}%
}

\begin{document}
\section*{Skills}

\skillParagraph{Maths}{skill:maths} You should know maths.
\skillParagraph{Latex}{skill:latex} You should know \LaTeX.

You need skills \ref{skill:maths} and \ref{skill:latex}.

\skillParagraph{Word}{skill:word} You should know Word.

You need skills \ref{skill:maths}, \ref{skill:latex}, and \ref{skill:word}.

\end{document}

Answer 1

Вам следует определить представление для счетчика. И лучше поместить \refstepcounter внутри абзаца, чтобы якорь нельзя было отделить от заголовка.

\documentclass{article}
\usepackage{hyperref}
\usepackage[english]{babel}

\newcounter{skillCounter}
\renewcommand\theskillCounter{S\arabic{skillCounter}}
\makeatletter
\newcommand{\skillParagraph}[2]{%%
    \paragraph*{%
      \refstepcounter{skillCounter}%
      \protected@edef\@currentlabelname{#1 (\theskillCounter)}%
      \label{#2}%
      #1 (\theskillCounter)}%%
}
\makeatother
% Custom command to reference custom labels
\newcommand{\cparref}[1]{\nameref{#1}}

\begin{document}
\section*{Skills}

\skillParagraph{Maths}{skill:maths} You should know maths.
\skillParagraph{Latex}{skill:latex} You should know \LaTeX.

You need skills \ref{skill:maths} and \ref{skill:latex}.

\skillParagraph{Word}{skill:word} You should know Word.

You need skills \ref{skill:maths}, \ref{skill:latex}, and \ref{skill:word}.

\nameref{skill:maths}
\end{document}

Answer 2

Что я делаю неправильно в своем подходе?

Я бы сказал две вещи. Во-первых, то, что вы описываете как ожидаемые результаты, по-видимому, должно быть результатом вашей пользовательской команды reference \cparref, но затем вы ссылаетесь на все с помощью standard \ref, который, конечно, просто ссылается на число, как и ожидалось. Во-вторых, и более фундаментально, \cparrefопределено таким образом, что может использоваться толькопослекоторый \skillParagraphсоздает метку, и это не совсем то, что перекрестная ссылка (обычно) должна делать. Кроме того, вы, \cparrefкажется, просто изобретаете велосипед nameref, так почему бы просто не использовать то, что у вас уже есть?

\documentclass{article}

% utf8 has been the default inputenc for some years now
% \usepackage[utf8]{inputenc}
\usepackage{hyperref}
\usepackage[english]{babel}
\GetTitleStringSetup{expand}

\newcounter{skillCounter}
% You could instead hard-code the S into \skillParagraph, as you've been
% doing, or define an \autoref prefix, etc.  This just seems to get a
% reasonable default value for \ref (affects any cross-reference to the
% counter though).
\renewcommand{\theskillCounter}{S\arabic{skillCounter}}
\newcommand{\skillParagraph}[2]{%
    \refstepcounter{skillCounter}%
    \paragraph*{#1 (\theskillCounter)}%
    \label{#2}%
}

\begin{document}
\section*{Skills}

\skillParagraph{Maths}{skill:maths} You should know maths.
\skillParagraph{Latex}{skill:latex} You should know \LaTeX.

You need skills \ref{skill:maths} and \ref{skill:latex}.

Note that \ref{skill:word} and \nameref{skill:word} work before the
corresponding skill paragraph.

\skillParagraph{Word}{skill:word} You should know Word.

You need skills \ref{skill:maths}, \ref{skill:latex}, and \ref{skill:word}.

And, for whatever you wanted \texttt{\textbackslash{}cparref} to do, just use
\texttt{\textbackslash{}nameref}: \nameref{skill:maths},
\nameref{skill:latex}, and \nameref{skill:word}.


\end{document}