flexdashboard章节标题为何缺失?如何实现其标签页的bookdown文档结构?
章节标题不显示的根本原因
- 你当前的输出格式指定为
flexdashboard::flex_dashboard,该格式内置了专属的内容识别规则,和普通R Markdown文档的标题渲染逻辑完全不同:#开头的内容会被直接判定为dashboard的顶级标签页,##开头的内容会被判定为标签页下的分栏边界,这类标题压根不会被渲染为普通文档里可见的章节标题,仅作为布局分隔标识存在,不会在页面上展示为可点击定位的章节入口。 - 你当前的配置没有引入bookdown的渲染引擎,就算写了符合bookdown规范的标题语法,flexdashboard的输出流程也不会做对应解析、生成带层级的章节导航结构,自然达不到连续阅读的标准文档效果。
落地适配方案
要实现和官方示例一致的层级化章节展示效果,不要在flexdashboard为主的输出框架里硬嵌bookdown语法,按以下步骤调整即可:
- 修改YAML配置,将主输出引擎切换为
bookdown::html_document2,开启自动目录、章节编号功能,同时保留对flexdashboard组件的依赖支持,避免原有shiny交互功能失效。 - 理顺原有标题层级:把用于内容分区的标题按照bookdown的文档层级规则写在连续的文本流中,不要再用flexdashboard的分栏语法打断连续的文档阅读流。
- 如果需要保留原有多标签dashboard的可视化功能,可以将dashboard模块作为独立的交互块嵌入到对应章节的下方,不要让flexdashboard的布局逻辑抢占标题的渲染权限。
调整后的可运行代码框架
--- title: "未命名文档" output: bookdown::html_document2: toc: true toc_depth: 3 number_sections: true runtime: shiny ---
library(flexdashboard)
联系方式
aaa@abcd.edu
我们要估算的核心内容
这个工具用于测算ABC场景下不同环境条件中,每位乘客可能接触到的病毒载量。
目前针对SARS-CoV-2的标准化剂量反应曲线尚未建立,我们采用与该病毒感染特征相近的HCoV229-E冠状病毒的指数感染模型作为替代,这类同模型被普遍认为具备合理的参考价值。
第二小节内容
对应当前文档中的第二部分正文内容。
内容的提问来源于stack exchange,提问作者HCAI
相关产品推荐
相关产品推荐

