R bookdown HTML输出中定理能否按小节而非章节进行编号设置

方法1：官方配置法（优先推荐） #

适用于bookdown 0.24及以上版本，操作最简便稳定：

• 先在R环境中运行packageVersion("bookdown")确认版本，版本过低可运行install.packages("bookdown")更新
• 打开项目根目录下的_output.yml文件，在bookdown::html_document2输出配置项下添加参数，参考配置如下：

output:
  bookdown::html_document2:
    number_sections: 3 # 开启三级标题编号，和定理编号层级对齐
    theorem:
      number_depth: 3 # 指定定理编号深度为3级，即生成「章节.二级标题.三级序号」格式

• 若需要在编号末尾增加圆点，可添加自定义CSS规则，在项目中新建custom.css写入如下内容：

span.theorem-number:after {
  content: ".";
  margin-right: 0.5em;
}

• 在_output.yml的配置中追加CSS引用即可：

output:
  bookdown::html_document2:
    css: "custom.css"

重新渲染项目即可生效。

方法2：JS兼容法（适用于旧版本bookdown） #

如果无法升级bookdown版本，可通过前端脚本动态修改编号：

• 在项目根目录新建custom.js文件，写入如下代码：

document.addEventListener('DOMContentLoaded', function() {
  // 匹配所有定理、引理、命题等环境的编号元素，可按需增减类名
  const numSelectors = '.theorem-number, .lemma-number, .proposition-number, .definition-number';
  document.querySelectorAll(numSelectors).forEach(function(numEl) {
    // 获取当前定理所属的最近三级标题的编号
    const parentBlock = numEl.closest('div[class*="theorem"], div[class*="lemma"], div[class*="proposition"]');
    const closestH3 = numEl.closest('div.main-content').querySelector(`h3[id]:has(~ ${parentBlock.tagName} ${parentBlock.className ? '.' + parentBlock.className.replace(/\s+/g, '.') : ''})`);
    if (!closestH3) return;
    const h3Num = closestH3.querySelector('.header-section-number').textContent.trim();
    // 提取原有编号的最后一位计数
    const originCount = numEl.textContent.trim().split('.').pop();
    // 替换为三级编号格式
    numEl.textContent = `${h3Num}.${originCount}`;
  })
})

• 新建header.html文件，写入JS和CSS引用：

<link rel="stylesheet" href="custom.css">
<script src="custom.js"></script>

• 在_output.yml中追加引入配置：

output:
  bookdown::html_document2:
    number_sections: 3
    includes:
      in_header: header.html

重新渲染项目即可生效。

内容的提问来源于stack exchange，提问作者J. Joe