网页基础

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}
## 图片

![](Attachments/测试选项卡.svg)

## 源码

```{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")
```

如果希望多个选项卡联动,可以设置相同 group :

利用多个选项卡联动

默认情况下是第一个选项卡激活, 通过设置 .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 。

11 链接