适配南佛罗里达大学LaTeX论文类为Rmarkdown模板时\hypertarget报错如何解决

报错成因 #

\hypertarget是LaTeX的hyperref宏包提供的交叉引用专用命令，你使用的南佛罗里达大学非官方LaTeX文档类USFDissertation默认没有加载该宏包。Pandoc将R Markdown内容转换为LaTeX格式时，会自动为各级标题生成带\hypertarget的交叉引用结构，缺少宏包支持就会触发「未定义控制序列」的报错。你没有添加标题时Pandoc不会生成相关命令，所以不会触发报错，添加标题后才会触发该问题。

修复方案 #

推荐优先选择第一种方案，适配模板的通用性：

• 直接将hyperref宏包加载命令写入你的bulldown模板默认的LaTeX导言区，放在导言区末尾、\begin{document}命令之前即可，可额外加参数适配学位论文的格式要求，示例如下：

% 适配学位论文要求禁用彩色链接，避免打印时格式不符合学校规范
\usepackage[unicode,colorlinks=false,linkcolor=black,citecolor=black,urlcolor=black]{hyperref}

• 如果你不需要交叉引用功能，也可以在R Markdown文件的YAML头部添加Pandoc参数，禁止生成\hypertarget相关代码，示例如下：

output:
  bulldown::thesis_pdf:
    pandoc_args: ["--variable", "link-citations=false"]

内容的提问来源于stack exchange，提问作者ailich