当 cross-referencing 方程式时,RStudio rticles 编织成 pdf 书失败

RStudio rticles knit to pdf book fails when cross-referencing equations

准备发表一篇新的会议文章,我想使用文章并利用 bookdown 的 cross-referencing 功能。 这最初在使用标准方程和 cross-referencing 示例时失败(例如比较 https://bookdown.org/yihui/bookdown/cross-references.html)。

原始错误信息如下:

! Undefined control sequence.
l.430 See equation \eqref
                         {eq:linear} for more insights. 

消除 cross-reference 指针 \@ref(eq:linear) 编织完成。 但是,我 - 显然 - 失去了等式的 cross-reference 。

在更新所有 R 包之后,Rmd 被编织而没有抛出错误。但是,不会自动插入 cross-reference,而是打印 \@ref(eq:linear)

我假设问题与编织过程中如何处理此类引用(又名控制序列)有关。 :( 我不知道如何处理这个。

此 SO-question 提供指向从中接管示例的官方文档的指针。

感谢您告诉我如何格式化方程参考。

---
title: "rticles fails knitting equation references"
keywords: ["keyword 1", "keyword 2"]
abstract: |
  The abstract goes here.
  On multiple lines eventually.
## hook up rticles as base format with bookdown for referencing, etc
output:
  bookdown::pdf_book:
    base_format: rticles::ieee_article
---

Introduction
=============

To add math, I do the following

See equation \@ref(eq:linear) for more insights.

\begin{equation}
a + bx = c  (\#eq:linear)
\end{equation}

More cool text.

\eqref 引用方程需要 amsmath Tex 包。

对于这种特定格式 ieee_articleamsmath 的使用以 pandoc 变量为条件。您需要将此添加到您的 yaml header

with_amsmath: true

您可以使用格式输出中的 extra_dependencies 参数为任何 rmarkdown 格式添加任何 Tex 包。

这里也可以这样

output:
  bookdown::pdf_book:
    base_format: rticles::ieee_article
    extra_dependencies: amsmath

(但这里不建议符合IEEE要求,因为模板包含了amsmath的配置)