rmarkdown
与 Quartormarkdown
与 QuartoYour data has a story.
Your data has a story.
Yes!
Your data has a story.
Yes!
Tell it with R markdown / Quarto.
Your data has a story.
Yes!
Tell it with R markdown / Quarto.
🤔 Why?
rmarkdown
2.16Dynamic Documents for R
R Markdown 为数据科学提供了一种统一的写作框架,可以集成代码、输出结果和文本说明
R Markdown 文档是可复现的(reproducible)
R Markdown 主体使用 Markdown 撰写,并利用 {{Pandoc}} 将 knitr
后的 文档转换为目标输出格式并进行样式渲染,支持包括 html、PDF、Word、幻灯片、仪表盘图表、shiny 应用、期刊论文、书籍、网站等静态或动态的展示
rmarkdown
2.16Dynamic Documents for R
R Markdown 为数据科学提供了一种统一的写作框架,可以集成代码、输出结果和文本说明
R Markdown 文档是可复现的(reproducible)
R Markdown 主体使用 Markdown 撰写,并利用 {{Pandoc}} 将 knitr
后的 文档转换为目标输出格式并进行样式渲染,支持包括 html、PDF、Word、幻灯片、仪表盘图表、shiny 应用、期刊论文、书籍、网站等静态或动态的展示
Open source tools for scientific and technical publishing
Create dynamic content with Python, R, Julia, and Observable.
Author documents as plain text markdown or Jupyter notebooks.
Publish high-quality articles, reports, presentations, websites, blogs, and books in HTML, PDF, MS Word, ePub, and more.
Author with scientific markdown, including equations, citations, crossrefs, figure panels, callouts, advanced layout, and more.
---
之间---
之间---title: "Penguins, meet Quarto!"subtitle: 企鹅遇上Quarto!💘author: "曾永艺"date: todayformat: html: toc: true code-fold: trueeditor: visual---
---
之间---title: "Penguins, meet Quarto!"subtitle: 企鹅遇上Quarto!💘author: "曾永艺"date: todayformat: html: toc: true code-fold: trueeditor: visual---
---title: "量化金融与金融编程"subtitle: "L03 `rmarkdown` 与 Quarto"author: "<br>曾永艺"institute: "厦门大学管理学院"date: "<br>2022-09-30"output: xaringan::moon_reader: css: [../libs/zen-styles-v2.2.css] lib_dir: libs chakra: ../libs/remark-latest.min.js nature: ratio: '16:9' highlightLines: true countIncrementalSlides: false---
?xaringan::moon_reader
```{r}
和```
| Ctrl+Alt+Iknitr::opts_chunk$set()
或者 YAML 文件头设置全局选项——同个选项多处设置时,局部设置优先),RStudio有智能补全功能```{r}
和```
| Ctrl+Alt+Iknitr::opts_chunk$set()
或者 YAML 文件头设置全局选项——同个选项多处设置时,局部设置优先),RStudio有智能补全功能```{r}
和```
| Ctrl+Alt+Iknitr::opts_chunk$set()
或者 YAML 文件头设置全局选项——同个选项多处设置时,局部设置优先),RStudio有智能补全功能 这份数据中包含了`r nrow(diamonds)`颗钻石的信息。其中只有`r nrow(diamonds) - nrow(smaller)`颗钻石大于2.5克拉。其余钻石的分布如下图所示。
[0. 创建项目文件夹]
打开新的 .Qmd 文档:File > New File > Quarto Document ...
Document | Presentation | Interactive
适当设置,如 Title、Author、输出格式等
存盘 ↔ 根据需要编辑修改模板文档
Render
.Qmd 文档,生成目标输出文档
在 RStudio 窗口中预览结果
在 Background Jobs 窗口中检查文档创建过程记录
使用和 .Qmd 文档一并存储的目标输出文档
将报告发布到网络服务器(可选步骤)
10:00
在 RStudio IDE 中完成:
1) 新建项目文件夹,如 L03_class
2) 将下载的 hello.qmd
放入 L03_class 根目录
3) 在 L03_class 根目录下新建文件夹 imgs,将下载的 penguins.png
放入其中
在 RStudio 中打开 hello.qmd 文档,并完成如下操作:
和队友(或身边的同学)一起找出 qmd 文档的三个组成构件,并讨论各个要素和 Render后的 HTML 文档是如何一一对应的。
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
\4. 代码块 load-packages
输出大量提示信息,怎么关了它?两行 library()
有无必要显示?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
\4. 代码块 load-packages
输出大量提示信息,怎么关了它?两行 library()
有无必要显示?
\5. 代码块 plot-penguins
有 Warning,怎么关了它?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
\4. 代码块 load-packages
输出大量提示信息,怎么关了它?两行 library()
有无必要显示?
\5. 代码块 plot-penguins
有 Warning,怎么关了它?
\6. 代码块 plot-penguins
占用篇幅有点大,现在我已经知道不让代码显示很容易,但——万一读者/老板一时兴起又想看到代码呢!怎么办?
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
\3. 嗯~~ 成功自动生成了图表标题,但怎么就没有自动生成“图#:”的标识呢?
提示:试着将代码块标签修改为
fig-penguins
试试?
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
\3. 嗯~~ 成功自动生成了图表标题,但怎么就没有自动生成“图#:”的标识呢?
提示:试着将代码块标签修改为
fig-penguins
试试?
\4. 可以顺带将前一段落中的“下图”修改为交叉引用啦——手动输入?还是?
提示:不想再用 Quarto官网 全局搜索?那就切换为 Visual 编辑方式,找看看应该是 Insert 什么呢?
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
\3. 嗯~~ 成功自动生成了图表标题,但怎么就没有自动生成“图#:”的标识呢?
提示:试着将代码块标签修改为
fig-penguins
试试?
\4. 可以顺带将前一段落中的“下图”修改为交叉引用啦——手动输入?还是?
提示:不想再用 Quarto官网 全局搜索?那就切换为 Visual 编辑方式,找看看应该是 Insert 什么呢?
\5. 目前 paper 只有两段,怎么也得有三段!给加上“## 结论”吧,随便写点什么都行——譬如“总之,个人认为南极企鹅碰上 Quarto 标示着一场令人期待的梦幻数据科学探险之旅的开始!🌈”
99:00
最后的最后,假如还有时间的话~~:
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
\2. 可尝试给 format:
增加一个文档输出类型选项:docx: default
,然后展开 Render 按键右侧的下箭头 -> Render MS Word,看看结果如何。
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
\2. 可尝试给 format:
增加一个文档输出类型选项:docx: default
,然后展开 Render 按键右侧的下箭头 -> Render MS Word,看看结果如何。
\3. 还想尝试将文档输出为 PDF 格式?中文文档,那还是别太为难 Quarto 和 Pandoc (以及折腾你自己啦)——个人感觉将生成的 HTML 文档在浏览器中打开然后打印为 PDF 格式可能是最直接且最美观的方式啦。
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
\2. 可尝试给 format:
增加一个文档输出类型选项:docx: default
,然后展开 Render 按键右侧的下箭头 -> Render MS Word,看看结果如何。
\3. 还想尝试将文档输出为 PDF 格式?中文文档,那还是别太为难 Quarto 和 Pandoc (以及折腾你自己啦)——个人感觉将生成的 HTML 文档在浏览器中打开然后打印为 PDF 格式可能是最直接且最美观的方式啦。
\4. 同学们还应该进一步了解下代码块的knitr 选项、 LaTex公式、标签页、页面布局……以及不同的输出格式,如幻灯片、网站、图书……等等。
相信同学们现在对 rmarkdown
和 Quarto
有了初步的认识,下面列出一些学习资料,感兴趣的同学们可进一步学习精进 🏆
📖 {{R for Data Science}} 一书关于 rmarkdown
的第27、29、30章
📝 RStudio IDE's Help >
自由组队,两人一组,共同完成以下课后作业:
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
🕑 记得多尝试各种选项设置,同时在文档内加上相应的说明性文字(如解释代码或输出图形,其余内容可自由发挥,丰俭由人啦,😁)
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
🕑 记得多尝试各种选项设置,同时在文档内加上相应的说明性文字(如解释代码或输出图形,其余内容可自由发挥,丰俭由人啦,😁)
🕒 作业共同署名(姓名 + 姓名)
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
🕑 记得多尝试各种选项设置,同时在文档内加上相应的说明性文字(如解释代码或输出图形,其余内容可自由发挥,丰俭由人啦,😁)
🕒 作业共同署名(姓名 + 姓名)
🕓 确认两份文档运行无误后将文件夹📂 L03_HW 打包为 .zip 格式压缩文档,由其中一位同学于2022年10月5日22:00前将压缩包提交至 {{坚果云链接}}
prettydoc
0.4.1}}tufte
0.12}}xaringanthemer
0.4.2}} 和 {{xaringanExtra
0.7.0}}# install.packages("xaringanthemer")
---output: xaringan::moon_reader: css: xaringan-themer.css---
```{r xaringan-themer, include=FALSE, warning=FALSE}library(xaringanthemer)style_duo_accent( primary_color = "#1381B0", secondary_color = "#FF961C", inverse_header_color = "#FFFFFF", header_font_google = google_font("Josefin Sans"), text_font_google = google_font("Montserrat", "300", "300i"), code_font_google = google_font("Fira Mono"))```
xaringanthemer
0.4.2}} 和 {{xaringanExtra
0.7.0}}# install.packages("xaringanthemer")
---output: xaringan::moon_reader: css: xaringan-themer.css---
```{r xaringan-themer, include=FALSE, warning=FALSE}library(xaringanthemer)style_duo_accent( primary_color = "#1381B0", secondary_color = "#FF961C", inverse_header_color = "#FFFFFF", header_font_google = google_font("Josefin Sans"), text_font_google = google_font("Montserrat", "300", "300i"), code_font_google = google_font("Fira Mono"))```
xaringanExtra
: A playground of enhancements and extensions forxaringan
rmarkdown
与 QuartoKeyboard shortcuts
↑, ←, Pg Up, k | Go to previous slide |
↓, →, Pg Dn, Space, j | Go to next slide |
Home | Go to first slide |
End | Go to last slide |
Number + Return | Go to specific slide |
b / m / f | Toggle blackout / mirrored / fullscreen mode |
c | Clone slideshow |
p | Toggle presenter mode |
t | Restart the presentation timer |
?, h | Toggle this help |
o | Tile View: Overview of Slides |
Esc | Back to slideshow |
rmarkdown
与 Quartormarkdown
与 QuartoYour data has a story.
Your data has a story.
Yes!
Your data has a story.
Yes!
Tell it with R markdown / Quarto.
Your data has a story.
Yes!
Tell it with R markdown / Quarto.
🤔 Why?
rmarkdown
2.16Dynamic Documents for R
R Markdown 为数据科学提供了一种统一的写作框架,可以集成代码、输出结果和文本说明
R Markdown 文档是可复现的(reproducible)
R Markdown 主体使用 Markdown 撰写,并利用 {{Pandoc}} 将 knitr
后的 文档转换为目标输出格式并进行样式渲染,支持包括 html、PDF、Word、幻灯片、仪表盘图表、shiny 应用、期刊论文、书籍、网站等静态或动态的展示
rmarkdown
2.16Dynamic Documents for R
R Markdown 为数据科学提供了一种统一的写作框架,可以集成代码、输出结果和文本说明
R Markdown 文档是可复现的(reproducible)
R Markdown 主体使用 Markdown 撰写,并利用 {{Pandoc}} 将 knitr
后的 文档转换为目标输出格式并进行样式渲染,支持包括 html、PDF、Word、幻灯片、仪表盘图表、shiny 应用、期刊论文、书籍、网站等静态或动态的展示
Open source tools for scientific and technical publishing
Create dynamic content with Python, R, Julia, and Observable.
Author documents as plain text markdown or Jupyter notebooks.
Publish high-quality articles, reports, presentations, websites, blogs, and books in HTML, PDF, MS Word, ePub, and more.
Author with scientific markdown, including equations, citations, crossrefs, figure panels, callouts, advanced layout, and more.
---
之间---
之间---title: "Penguins, meet Quarto!"subtitle: 企鹅遇上Quarto!💘author: "曾永艺"date: todayformat: html: toc: true code-fold: trueeditor: visual---
---
之间---title: "Penguins, meet Quarto!"subtitle: 企鹅遇上Quarto!💘author: "曾永艺"date: todayformat: html: toc: true code-fold: trueeditor: visual---
---title: "量化金融与金融编程"subtitle: "L03 `rmarkdown` 与 Quarto"author: "<br>曾永艺"institute: "厦门大学管理学院"date: "<br>2022-09-30"output: xaringan::moon_reader: css: [../libs/zen-styles-v2.2.css] lib_dir: libs chakra: ../libs/remark-latest.min.js nature: ratio: '16:9' highlightLines: true countIncrementalSlides: false---
?xaringan::moon_reader
```{r}
和```
| Ctrl+Alt+Iknitr::opts_chunk$set()
或者 YAML 文件头设置全局选项——同个选项多处设置时,局部设置优先),RStudio有智能补全功能```{r}
和```
| Ctrl+Alt+Iknitr::opts_chunk$set()
或者 YAML 文件头设置全局选项——同个选项多处设置时,局部设置优先),RStudio有智能补全功能```{r}
和```
| Ctrl+Alt+Iknitr::opts_chunk$set()
或者 YAML 文件头设置全局选项——同个选项多处设置时,局部设置优先),RStudio有智能补全功能 这份数据中包含了`r nrow(diamonds)`颗钻石的信息。其中只有`r nrow(diamonds) - nrow(smaller)`颗钻石大于2.5克拉。其余钻石的分布如下图所示。
[0. 创建项目文件夹]
打开新的 .Qmd 文档:File > New File > Quarto Document ...
Document | Presentation | Interactive
适当设置,如 Title、Author、输出格式等
存盘 ↔ 根据需要编辑修改模板文档
Render
.Qmd 文档,生成目标输出文档
在 RStudio 窗口中预览结果
在 Background Jobs 窗口中检查文档创建过程记录
使用和 .Qmd 文档一并存储的目标输出文档
将报告发布到网络服务器(可选步骤)
10:00
在 RStudio IDE 中完成:
1) 新建项目文件夹,如 L03_class
2) 将下载的 hello.qmd
放入 L03_class 根目录
3) 在 L03_class 根目录下新建文件夹 imgs,将下载的 penguins.png
放入其中
在 RStudio 中打开 hello.qmd 文档,并完成如下操作:
和队友(或身边的同学)一起找出 qmd 文档的三个组成构件,并讨论各个要素和 Render后的 HTML 文档是如何一一对应的。
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
\4. 代码块 load-packages
输出大量提示信息,怎么关了它?两行 library()
有无必要显示?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
\4. 代码块 load-packages
输出大量提示信息,怎么关了它?两行 library()
有无必要显示?
\5. 代码块 plot-penguins
有 Warning,怎么关了它?
20:00
感觉渲染后的文档中存在几个明显的问题啊(自上而下列示)!
请同学们探索下相应的解决方法(修订后记得 Ctrl + S 存盘 ->
文档会自动重新 Render):
\1. 渲染文档中免费赠送的 AUTHOR
和 PUBLISHED
能否改为中文?
可以!提示:语言?language?-> {{Quarto 官网}} 全局搜索之。
\2. 日期变了(本来是September 30, 2022
),但能否是更简洁的 2022-09-30
?
\3. 已设置 toc: true
,但怎么就看不到目录呢?难道需要设置 toc-location
?
\4. 代码块 load-packages
输出大量提示信息,怎么关了它?两行 library()
有无必要显示?
\5. 代码块 plot-penguins
有 Warning,怎么关了它?
\6. 代码块 plot-penguins
占用篇幅有点大,现在我已经知道不让代码显示很容易,但——万一读者/老板一时兴起又想看到代码呢!怎么办?
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
\3. 嗯~~ 成功自动生成了图表标题,但怎么就没有自动生成“图#:”的标识呢?
提示:试着将代码块标签修改为
fig-penguins
试试?
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
\3. 嗯~~ 成功自动生成了图表标题,但怎么就没有自动生成“图#:”的标识呢?
提示:试着将代码块标签修改为
fig-penguins
试试?
\4. 可以顺带将前一段落中的“下图”修改为交叉引用啦——手动输入?还是?
提示:不想再用 Quarto官网 全局搜索?那就切换为 Visual 编辑方式,找看看应该是 Insert 什么呢?
10:00
这下好多啦,但还是得再东调调,西补补——可千万别辜负我们
厦大人“止于至善”的校训 😁:
\1. 代码块 plot-penguins
输出的图表并未居中对齐,看起来不太舒服。改了!
\2. 代码块 plot-penguins
输出的图表竟然没有标题,不满足学术规范。加上!
\3. 嗯~~ 成功自动生成了图表标题,但怎么就没有自动生成“图#:”的标识呢?
提示:试着将代码块标签修改为
fig-penguins
试试?
\4. 可以顺带将前一段落中的“下图”修改为交叉引用啦——手动输入?还是?
提示:不想再用 Quarto官网 全局搜索?那就切换为 Visual 编辑方式,找看看应该是 Insert 什么呢?
\5. 目前 paper 只有两段,怎么也得有三段!给加上“## 结论”吧,随便写点什么都行——譬如“总之,个人认为南极企鹅碰上 Quarto 标示着一场令人期待的梦幻数据科学探险之旅的开始!🌈”
99:00
最后的最后,假如还有时间的话~~:
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
\2. 可尝试给 format:
增加一个文档输出类型选项:docx: default
,然后展开 Render 按键右侧的下箭头 -> Render MS Word,看看结果如何。
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
\2. 可尝试给 format:
增加一个文档输出类型选项:docx: default
,然后展开 Render 按键右侧的下箭头 -> Render MS Word,看看结果如何。
\3. 还想尝试将文档输出为 PDF 格式?中文文档,那还是别太为难 Quarto 和 Pandoc (以及折腾你自己啦)——个人感觉将生成的 HTML 文档在浏览器中打开然后打印为 PDF 格式可能是最直接且最美观的方式啦。
99:00
最后的最后,假如还有时间的话~~:
\1. 可尝试着设置 HTML文档的 主题(theme)——轻松一个参数就能带给你焕然一新的感觉。
\2. 可尝试给 format:
增加一个文档输出类型选项:docx: default
,然后展开 Render 按键右侧的下箭头 -> Render MS Word,看看结果如何。
\3. 还想尝试将文档输出为 PDF 格式?中文文档,那还是别太为难 Quarto 和 Pandoc (以及折腾你自己啦)——个人感觉将生成的 HTML 文档在浏览器中打开然后打印为 PDF 格式可能是最直接且最美观的方式啦。
\4. 同学们还应该进一步了解下代码块的knitr 选项、 LaTex公式、标签页、页面布局……以及不同的输出格式,如幻灯片、网站、图书……等等。
相信同学们现在对 rmarkdown
和 Quarto
有了初步的认识,下面列出一些学习资料,感兴趣的同学们可进一步学习精进 🏆
📖 {{R for Data Science}} 一书关于 rmarkdown
的第27、29、30章
📝 RStudio IDE's Help >
自由组队,两人一组,共同完成以下课后作业:
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
🕑 记得多尝试各种选项设置,同时在文档内加上相应的说明性文字(如解释代码或输出图形,其余内容可自由发挥,丰俭由人啦,😁)
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
🕑 记得多尝试各种选项设置,同时在文档内加上相应的说明性文字(如解释代码或输出图形,其余内容可自由发挥,丰俭由人啦,😁)
🕒 作业共同署名(姓名 + 姓名)
自由组队,两人一组,共同完成以下课后作业:
🕐 从 L02 课件中挑出 3 ~ 4 个你们感兴趣的数据可视化代码段,就其制作两种类型的展示文档:
{{Quarto|HTML
}} 或 {{prettydoc
}} -> 📂 L03_HW/docs/
{{Quarto|Revealjs
}} 或 {{xaringan
}} -> 📂 L03_HW/slides/
🕑 记得多尝试各种选项设置,同时在文档内加上相应的说明性文字(如解释代码或输出图形,其余内容可自由发挥,丰俭由人啦,😁)
🕒 作业共同署名(姓名 + 姓名)
🕓 确认两份文档运行无误后将文件夹📂 L03_HW 打包为 .zip 格式压缩文档,由其中一位同学于2022年10月5日22:00前将压缩包提交至 {{坚果云链接}}
prettydoc
0.4.1}}tufte
0.12}}xaringanthemer
0.4.2}} 和 {{xaringanExtra
0.7.0}}# install.packages("xaringanthemer")
---output: xaringan::moon_reader: css: xaringan-themer.css---
```{r xaringan-themer, include=FALSE, warning=FALSE}library(xaringanthemer)style_duo_accent( primary_color = "#1381B0", secondary_color = "#FF961C", inverse_header_color = "#FFFFFF", header_font_google = google_font("Josefin Sans"), text_font_google = google_font("Montserrat", "300", "300i"), code_font_google = google_font("Fira Mono"))```
xaringanthemer
0.4.2}} 和 {{xaringanExtra
0.7.0}}# install.packages("xaringanthemer")
---output: xaringan::moon_reader: css: xaringan-themer.css---
```{r xaringan-themer, include=FALSE, warning=FALSE}library(xaringanthemer)style_duo_accent( primary_color = "#1381B0", secondary_color = "#FF961C", inverse_header_color = "#FFFFFF", header_font_google = google_font("Josefin Sans"), text_font_google = google_font("Montserrat", "300", "300i"), code_font_google = google_font("Fira Mono"))```
xaringanExtra
: A playground of enhancements and extensions forxaringan