使用 bookdown，必须在 _output.yml 中为交叉引用部分设置 number_sections: true 吗？

Question

我可以使用 Bookdown 呈现 HTML 书籍，但交叉引用部分失败。

不过，我可以让它工作。首先，我会让交叉引用工作。

编辑 9/20/20 太平洋标准时间 12:15 以响应更多重复的请求

我的章节标题如下所示：

# Getting Articles {#getArt} 

不同章节中的交叉引用是这样的，一段文字摘录：

您需要完成获取文章部分中的步骤 \@ref(getArt) )

此引用在 _output.yml 的 number_sections: true 时有效，但在 number_sections: false 时无效

结束编辑

在我的 _output.yml 我有以下代码；最后一行的评论是我的问题：

bookdown::gitbook:
 css: style.css
 toc_depth: 4
 number_sections: true    # if true, cross reference section labels render correctly

如果我设置了number_sections true，那么我可能会正确地交叉引用各个部分，例如“...在获取文章第 2 部分中”：

Jay Efran (2007)（要获得这篇文章，您需要完成获取文章第 2 部分中的步骤）

但如果我的 _output.yml 看起来像这样：

bookdown::gitbook:
 css: style.css
 toc_depth: 4
 number_sections: false   

我得到以下信息（注意“??”）：

Jay Efran (2007)（要获得这篇文章，您需要完成获取文章部分中的步骤??）

根据Yuhui's bookdown text, section 2.6，它声明了以下关于交叉引用和“??”的内容：

当找不到引用的标签时，您将看到两个问号，如??，以及在渲染图书时在 R 控制台中显示警告消息。

但我不知道该怎么办。显然，交叉引用存在并且可以正常工作，但仅在 _output.yml 条件下 number_sections: 设置为 true。

有解决办法吗？

Answer 1

这不起作用的原因是 bookdown 将 \@ref(getArt)（其中 getArt 是您的部分的 ID）转换为指向该部分的链接，并将部分编号设置为链接文本。对于 HTML 输出，大致如下所示：

<a href="chapter_title.html#getArt">2</a>

（参见 GitHub 上的source）

如果您设置number_sections: false，则没有章节编号，因此链接文本为“??”。在这方面，文档有些不准确（因为参考存在并且链接确实有效）。

解决方法是手动为节标题分配一个 ID 并像这样引用它：

You'll need to walk through the steps found in the 
[Getting Articles section](#getArt).
    
# Getting Articles {#getArt}