第 3 周
rmarkdown与Quarto
在上一讲课后作业中同学们通过代码脚本文档 L02_coding_practice.R
完成编程作业并直接提交,但如果不运行同学们的代码,我将很难得知代码能否正常运行及其运行结果;同时通过注释方式添加说明性文字或文档逻辑分节也显得笨拙和不够美观。那么,有没有更好的解决方案呢?答案就是本讲将要介绍的“动态文档”(dynamic documents)——它允许你将代码、代码输出、文字等有机地组合在一起,并可方便地转化为多种类型的输出格式(如网页、PDF、docx、幻灯片等)。
本讲主要涵盖以下几方面的内容:
R Markdown 与 Quarto 简介
Quarto 动态文档组成
- YAML 文件头
- Markdown 文本
- 代码块
Quarto 工作流与随堂练习
1. 课前准备
📖 阅读 Markdown基础 一文。
此文主要翻译自 Quarto 官方文档 Markdown Basics 并经小幅改写。
📖 阅读 R for Data Science 一书第27章和第30章关于如何使用 R Markdown 文档来记录数据科学研究过程并展示与沟通研究结果的内容。
此书的中文翻译版 《R数据科学》 发行有官方pdf电子版,对应章节为“第21章 R Markdown”和“第23章 R Markdown工作流”。若觉得英文阅读有点吃力的同学,可找来参阅。
💻 根据自己电脑操作系统的类型从 Quarto 官网 下载相应版本的 Quarto CLI 安装程序并完成安装(无需自定义,默认安装即可)。
2. 课堂讲义
课堂讲义 PDF 版和腾讯会议云录制链接将分别于课前和课后发布在 QQ 课程群内,请有需要的同学自行下载或观看。
3. 随堂练习
⌨️ 本讲将有比较长时间的随堂编程练习,请同学们带上自己的笔记本电脑 (也可找上编程小伙伴,坐在一起结队练习效果可能更佳,😁)。
4. 课后作业
✍️ 课后作业