繁体   English   中英

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

[英]How can I specific the initial level to have my table of contents be expanded to in an R bookdown project (gitbook output format)? With YAML setting?

我有一个包含目录的大型 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 的行为仍然很奇怪,但这很有帮助。

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

使用折叠设置。

toc:
  collapse: section

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

暂无
暂无

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM