[Feature Request]: 加入 Cleveref 宏包以支持更好的引用格式

[Aaron-Gp]

发生了什么？

autoref 不能定义多个引用的格式

你期望的结果

如：式（4）、（8）、（9）和（11）

问题复现的步骤（或者截图）

提供一个解决示例：

需要在 hyperref 后引入 cleveref：

\usepackage{cleveref}
\crefmultiformat{equation}{式（#2#1#3）}{和（#2#1#3）}{、（#2#1#3）}{和（#2#1#3）}
% ...
\cref{eq:lsym,eq:ldep,eq:luc,eq:lpc}

[YDX-2147483647]

挺好的；有下面两种选择。

法一：像\autoref中文引用名称一样加个 FAQ

简单，写 markdown 就行。具体见目录页下方“增添全新页面”。

法二：加入模板类里，如果检测到最终作者\usepackage{cleveref}了，就自动设置\crefmultiformat

需要编辑bithesis.dtx，相对困难。检测可利用\IfPackageLoadedTF之类的（详见texdoc source2e或 LLM），参考 longtable、algorithm2e 等的适配代码，比如

BIThesis/bithesis.dtx

Lines 1666 to 1669 in e485b46

	\@ifpackageloaded{longtable}{
	\setlength{\LTpre}{0.60\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip}
	\setlength{\LTpost}{1.60\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip}
	}{}

我反对直接在模板硬性导入 cleveref，因为最终作者还可能导入其它宏包，一旦冲突，LaTeX 这个设计很难搞……

需要在 hyperref 后引入 cleveref

按照这种设计，因为 hyperef 由bithesis.cls导入，而 cleveref 由最终作者导入，故必定能保证符合顺序要求。

补充

不知道 cleveref 有没有办法自动处理\cref前后的空白？例如，……如图 1-2。的2与句号紧贴，但图 1-2 是……的2与是有一点空白。

[YDX-2147483647]

如果引用的若干公式刚刚编号连续，会使用 crefrangeformat。所以 crefmultiformat 必须与 crefrangeformat 一起定义。

Multi-references also require all the other cross-reference formats to be defined (see Sections 8.2.1
and 8.2.2), including the single reference range formats, even if you never use the \crefrange and \Crefrange commands.

下面是个完整例子。

\documentclass{ctexart}

\usepackage{cleveref}
\crefformat{equation}{式（#2#1#3）}
\crefrangeformat{equation}{式（#3#1#4）至（#5#2#6）}
\crefmultiformat{equation}{式（#2#1#3）}{和（#2#1#3）}{、（#2#1#3）}{和（#2#1#3）}

\begin{document}

\cref{eq:1}；% 使用 crefformat
\cref{eq:1,eq:2}；% 使用 crefmultiformat
\cref{eq:1,eq:3}；% 使用 crefmultiformat
\cref{eq:1,eq:2,eq:3}。% 使用 crefrangeformat

\begin{equation} \label{eq:1} 1 \end{equation}
\begin{equation} \label{eq:2} 2 \end{equation}
\begin{equation} \label{eq:3} 3 \end{equation}

\end{document}

我认为还是加到 FAQ 吧，因为有人可能想把式（1-2）改成式~(1-2)。

[YDX-2147483647]

如果引用的若干公式刚刚编号连续，会使用 crefrangeformat。所以 crefmultiformat 必须与 crefrangeformat 一起定义。

Multi-references also require all the other cross-reference formats to be defined (see Sections 8.2.1
and 8.2.2), including the single reference range formats, even if you never use the \crefrange and \Crefrange commands.

下面是个完整例子。

\documentclass{ctexart}

\usepackage{cleveref}
\crefformat{equation}{式（#2#1#3）}
\crefrangeformat{equation}{式（#3#1#4）至（#5#2#6）}
\crefmultiformat{equation}{式（#2#1#3）}{和（#2#1#3）}{、（#2#1#3）}{和（#2#1#3）}

\begin{document}

\cref{eq:1}；% 使用 crefformat
\cref{eq:1,eq:2}；% 使用 crefmultiformat
\cref{eq:1,eq:3}；% 使用 crefmultiformat
\cref{eq:1,eq:2,eq:3}。% 使用 crefrangeformat

\begin{equation} \label{eq:1} 1 \end{equation}
\begin{equation} \label{eq:2} 2 \end{equation}
\begin{equation} \label{eq:3} 3 \end{equation}

\end{document}

我认为还是加到 FAQ 吧，因为有人可能想把式（1-2）改成式~(1-2)。

[YDX-2147483647]

如果引用的若干公式刚好编号连续，会使用 crefrangeformat。所以 crefmultiformat 必须与 crefrangeformat 一起定义。

Multi-references also require all the other cross-reference formats to be defined (see Sections 8.2.1
and 8.2.2), including the single reference range formats, even if you never use the \crefrange and \Crefrange commands.
https://texdoc.org/serve/cleveref/0

下面是个完整例子。

\documentclass{ctexart}

\usepackage{cleveref}
\crefformat{equation}{式（#2#1#3）}
\crefrangeformat{equation}{式（#3#1#4）至（#5#2#6）}
\crefmultiformat{equation}{式（#2#1#3）}{和（#2#1#3）}{、（#2#1#3）}{和（#2#1#3）}

\begin{document}

\cref{eq:1}；% 使用 crefformat
\cref{eq:1,eq:2}；% 使用 crefmultiformat
\cref{eq:1,eq:3}；% 使用 crefmultiformat
\cref{eq:1,eq:2,eq:3}；% 使用 crefrangeformat
\cref{eq:1,eq:3,eq:4}。% 使用 crefmultiformat

\begin{equation} \label{eq:1} 1 \end{equation}
\begin{equation} \label{eq:2} 2 \end{equation}
\begin{equation} \label{eq:3} 3 \end{equation}
\begin{equation} \label{eq:4} 4 \end{equation}

\end{document}

我建议还是加到 FAQ 吧，因为有人可能想把式（1-2）改成式~(1-2)。

[Aaron-Gp]

感觉这是一个常用功能，提供一个示例放到 misc，并 input 到 main.tex 里是否更好呢？

[YDX-2147483647]

感觉这是一个常用功能，提供一个示例放到 misc，并 input 到 main.tex 里是否更好呢？

那要不还是加到bithesis.dtx里，FAQ只说如何改成式~(1-2)？

我个人认为现在放*.tex里的东西太多了，有些人恐怕一打开没仔细看就全清空了。比如生僻字，早就写在*.tex了，但还是时不时有人问。

[Aaron-Gp]

可以，建议在 main.tex 中强调 faq 的存在