Ручная маркировка и перекрестные ссылки в mdframed

Question

Вопрос задан после MWE.

\documentclass[10pt,a4paper]{article}
\usepackage{amsmath,amsfonts}
\usepackage[framemethod=tikz]{mdframed}
\usepackage[colorlinks=true, linktocpage=false]{hyperref}
\hypersetup{
citecolor = {blue}
}
\makeatletter
\newcommand{\manuallabel}[2]{\def\@currentlabel{#2}\label{#1}}
\makeatother

\newenvironment{ProblemSpecBox}[2]
{%
\begin{mdframed}[innerlinewidth=0.5pt,%
innerleftmargin=10pt, innerrightmargin=10pt,%
 innertopmargin = 10pt, innerbottommargin=10pt,%
 skipabove=\dimexpr\topsep+\ht\strutbox\relax,%
 roundcorner=5pt, frametitle={#1},%
 frametitlerule=true, frametitlerulewidth=1pt]
 {#2}
\end{mdframed}
}

\begin{document}
This is a test example
\begin{ProblemSpecBox} \manuallabel{prob:ProblemO}{Problem O} % I think this is where the problem is.
{
    Problem O for $\mathbb{C}$
}
{
    \emph{Given} $a, b \in \mathbb{C}$; \emph{Find} $n \in \mathbb{Z}$ such that 
    \[
        |a|^{n} = |b|
    \]
}
\end{ProblemSpecBox}
\ref{prob:ProblemO} % This must display Problem O i.e., the second argument of \manuallabel which will be linked to it's source by hyperref.
\end{document}

Без команды \manuallabelcommand после ProblemSpecBoxenvironment все работает нормально. Однако если я включу \manuallabelwhich is later, ссылайтесь на него с \ref{ProblemO}ответом в этом вопросеВручную устанавливаемые контрольные значенияЯ получаю следующие ошибки:

! Аргумент \manuallabel имеет дополнительный символ }.

! Абзац закончился до завершения \manuallabel.

Буду признателен, если кто-нибудь поможет мне решить эту проблему.

Answer 1

Вместо определения новой \labelкоманды вы можете просто изменить имя метки в объявлении среды.

Кроме того, вы неправильно используете \newenvironmentкоманду, а также неправильно используете эту новую среду, поскольку вы поместили ее \manuallabelмежду началом среды и ее обязательным аргументом.

Вот код, в котором исправлены эти несколько проблем:

\documentclass[10pt,a4paper]{article}
\usepackage{amsmath,amsfonts}
\usepackage[framemethod=tikz]{mdframed}
\usepackage[colorlinks=true, linktocpage=false]{hyperref}
\hypersetup{
  citecolor = {blue}
}

\makeatletter
\newenvironment{ProblemSpecBox}[1]{
  \protected@edef\@currentlabelname{#1}
  \protected@edef\@currentlabel{#1}
  \begin{mdframed}[
    innerlinewidth=0.5pt,
    innerleftmargin=10pt,
    innerrightmargin=10pt,
    innertopmargin = 10pt,
    innerbottommargin=10pt,
    skipabove=\dimexpr\topsep+\ht\strutbox\relax,
    roundcorner=5pt,
    frametitle={#1},
    frametitlerule=true,
    frametitlerulewidth=1pt]
}{
  \end{mdframed}
}
\makeatother

\begin{document}
This is a test example:
\begin{ProblemSpecBox}{Problem O}
  \label{prob:ProblemO}
  \emph{Given} $a, b \in \mathbb{C}$; \emph{Find} $n \in \mathbb{Z}$ such that 
  \[
    |a|^{n} = |b|
  \]
\end{ProblemSpecBox}

Reference: \ref{prob:ProblemO}
\end{document}

Приложение

По просьбе @evansdoe заголовок и имя ссылки должны отличаться, что не допускается в ответе выше. Следующий код функционирует так же, как и приведенный выше, но он также допускает необязательный аргумент в объявлении среды, который настроит метку ссылки. Если не указана пользовательская метка ссылки, используется заголовок.

\documentclass[10pt,a4paper]{article}
\usepackage{amsmath,amsfonts}
\usepackage[framemethod=tikz]{mdframed}
\usepackage[colorlinks=true, linktocpage=false]{hyperref}
\hypersetup{
  citecolor = {blue}
}

\makeatletter
\def\ProblemSpecBox{
  \@ifnextchar[\ProblemSpecBox@opt{\ProblemSpecBox@noopt}}
\def\ProblemSpecBox@opt[#1]#2{
  \protected@edef\@currentlabelname{#1}
  \protected@edef\@currentlabel{#1}
  \begin{mdframed}[
    innerlinewidth=0.5pt,
    innerleftmargin=10pt,
    innerrightmargin=10pt,
    innertopmargin = 10pt,
    innerbottommargin=10pt,
    skipabove=\dimexpr\topsep+\ht\strutbox\relax,
    roundcorner=5pt,
    frametitle={#2},
    frametitlerule=true,
    frametitlerulewidth=1pt]
}
\def\ProblemSpecBox@noopt#1{
  \ProblemSpecBox@opt[#1]{#1}
}
\def\endProblemSpecBox{
  \end{mdframed}
}
\makeatother

\begin{document}
This is a test example:
\begin{ProblemSpecBox}[Problem 0]{Problem 0 in \(\mathbb{C}\)}
  \label{prob:ProblemO}
  \emph{Given} $a, b \in \mathbb{C}$; \emph{Find} $n \in \mathbb{Z}$ such that 
  \[
    |a|^{n} = |b|
  \]
\end{ProblemSpecBox}

Reference: \ref{prob:ProblemO}
\end{document}

Answer 2

Небольшая модификация ответа @jpellis решает проблему.

\documentclass[10pt,a4paper]{article}
\usepackage{amsmath,amsfonts}
\usepackage[framemethod=tikz]{mdframed}
\usepackage[colorlinks=true, linktocpage=false]{hyperref}
\hypersetup{
citecolor = {blue}
}

\makeatletter
\newenvironment{ProblemSpecBox}[2]{ % Takes two arguments and not one
\protected@edef\@currentlabelname{#2}
\protected@edef\@currentlabel{#2}
\begin{mdframed}[
innerlinewidth=0.5pt,
innerleftmargin=10pt,
innerrightmargin=10pt,
innertopmargin = 10pt,
innerbottommargin=10pt,
skipabove=\dimexpr\topsep+\ht\strutbox\relax,
roundcorner=5pt,
frametitle={#1},
frametitlerule=true,
frametitlerulewidth=1pt]
}{
\end{mdframed}
}
\makeatother

\begin{document}
This is a test example:
\begin{ProblemSpecBox}{Problem O for \mathbb{C}}{Problem O}
\label{prob:ProblemO}
\emph{Given} $a, b \in \mathbb{C}$; \emph{Find} $n \in \mathbb{Z}$ such that 
\[
  |a|^{n} = |b|
\]
\end{ProblemSpecBox}

Reference: \ref{prob:ProblemO}
\end{document}

Обратите внимание, что в ответе @jpellis заголовок и ссылка такие же, как в

Однако правильный ответ, полученный с помощью приведенного выше кода LaTeX, дает

что отвечает на вопрос.