网页基础
1 概述
每个页面都可以使用 format.html 控制 HTML 输出, 例如 :
---
title: "My document"
format:
html:
toc: true
html-math-method: katex
css: styles.css
---2 目录
页面右侧显示的就是目录, 它在 _quarto.yml 中进行设置 :
还可以将目录放置在不同位置 left左、left-body左和正文、right-body右和正文。如果关闭标准 HTML 主题(例如设置 theme: none 或 theme: pandoc),则 toc‑location 选项将无法使用 :
3 章节编号
如果要给章节进行编号, 需要在 .qmd文件 中进行设置 :
有时候编号过深, 看起来也未必美观, 可以进行调整 :
还可以给个别章节设置不编号 :
4 Tabsets 选项卡组件
可以使用 panel‑tabset 选项卡组件展示不同内容,每个 标题## 会产生一个卡片 :
::: {.panel-tabset}
## 图片

## 源码
```{r}
#| echo: false
#| column: screen-inset-right
library(leaflet)
leaflet() %>%
addTiles() %>% # Add default OpenStreetMap map tiles
addMarkers(lng=174.768, lat=-36.852, popup="The birthplace of R")
```
:::```{r}
#| echo: false
#| column: screen-inset-right
library(leaflet)
leaflet() %>%
addTiles() %>% # Add default OpenStreetMap map tiles
addMarkers(lng=174.768, lat=-36.852, popup="The birthplace of R")
```默认情况下是第一个选项卡激活, 通过设置 .active 改变默认 :
鲁
豫
晋
::: {.panel-tabset}
## 山东
鲁
## 河南 {.active}
豫
## 山西
晋
:::5 单一HTML
HTML 页面会有不少外部文件依赖(例如图片、CSS 样式表、JavaScript 脚本等)。 默认情况下,这些依赖文件会被放在页面同级的文件夹中。只拷贝页面给其他用户是无法正常渲染 :
上面设置生成一个独立的 HTML 文件,不依赖任何外部资源,并使用 data: URI 来嵌入链接的脚本、样式表、图像和视频等内容。 生成的文件应该是完全自包含的,也就是说,它不需要任何外部文件或网络访问即可被浏览器正确显示
6 章节锚点图标
当鼠标触控到章节标题以后, 会有方便复制章节链接的图标 :
7 平滑滚动
当点击一个位置以后, 默认是直接跳转过去, 非常突兀。 设置了平滑滚动以后将有动画展示滚动效果 :
8 外部链接
一个超链接如果跳出了本网站旁边加一个箭头, 用来提醒用户要跳出去了 :
注意 : 一个链接是内部还是外部, 通过参数 link-external-filter 进行筛选
9 引用弹窗
对于 citation文献、footnote脚注、cross交叉引用 这些轻量级的内容,只要把鼠标放上去,不用点击就会自动弹窗显示内容。可以关闭这个功能 :
10 Includes 包含
如果希望页面额外包含一些内容, 偏 HTML 底层的操作, 可以使用选项 include-in-header、include-before-body、include-after-body 。