如何指定初始级别以将我的目录扩展到 R bookdown 项目gitbook 输出格式?使用 YAML 设置?

问题描述

我有一个包含目录的大型 bookdown 项目,我已将其设置为使用 4 级标题,它做得很好,但开始时扩展了(请参阅第一次编辑,这不准确) .我希望它崩溃开始。我在 _output.yml 中指定了目录深度:

bookdown::gitbook:
  toc_depth: 4

示例 .Rmd 文件的部分可能具有以下标题。我还包括了我的 YAML 标头,它生成了 gitbook 输出格式):

---
site: bookdown::bookdown_site
output: bookdown::gitbook
---

# Any Given Programming Language
## Overview
### Variables
### Data Types
#### int
#### double
#### String
#### bool
...

我对默认行为的问题是,比如说,我想从上面选择“数据类型”。当我这样做时,它会折叠它包含的列表(int、double 等),我宁愿它默认只显示部分标题。这样我就可以单击标题,将我带到该部分的开头,它可以让我链接到任何子部分(而不必再次单击“数据类型”来打开此列表)。

我不知道这是否是一个选项,但如果不是,它真的应该是。我不喜欢默认设置。

如果我可以指定默认扩展到的级别,也就是 ## 或 ### 而不是 ####(我的示例中的默认设置),那就更好了。但我最初的问题是,目前我的 toc 深度是 4,然后扩展到那个深度,如果它刚开始折叠到深度 1(# My Book Titles),我会很高兴。

编辑:我错了,它开始完全展开,不知道为什么我这么想(也许它已经保存了状态)。它从第 2 级标题 (##) 开始展开,但是当您单击其中一个标题时,它会同时展开第 3 (###) 和第 4 (####) 个标题。当我单击第 3 个标题跳转到该部分的开头时,它会折叠第 4 个标题(请参阅上面单击的数据类型讨论)。我仍然希望它只是向下扩展下一级,以便我可以单击该标题然后查看它包含的内容,或者能够设置要显示的目录的默认级别。 gitbook 输出似乎有点小故障。甚至不要让我开始使用搜索栏...


根据我接受的解决方案,您的 _output.yml 文件应该有:

bookdown::gitbook:
  toc_depth: 4
  config:
    toc:
      collapse: section (or subsection,or subsubsection)

在我看来,toc 的行为仍然很奇怪,但这很有帮助。

另一个编辑:子小节在加载时展开所有级别的标题,但以后单击标题时无法折叠任何级别 - 我喜欢这种行为。

解决方法

使用折叠设置。

toc:
  collapse: section

对于其他级别collapse: subsection,collapse: subsubsection,...

相关问答

依赖报错 idea导入项目后依赖报错,解决方案:https://blog....
错误1:代码生成器依赖和mybatis依赖冲突 启动项目时报错如下...
错误1:gradle项目控制台输出为乱码 # 解决方案:https://bl...
错误还原:在查询的过程中,传入的workType为0时,该条件不起...
报错如下,gcc版本太低 ^ server.c:5346:31: 错误:‘struct...