手把手教你使用 Quarto 构建文档 (1)

简介: 手把手教你使用 Quarto 构建文档 (1)

简介

Quarto[1] 是一个建立在 Pandoc 上的开源科技出版系统。

  • 可以基于 Python、R、Julia 和 Observable 创建动态内容。
  • 以纯文本 markdown 或 Jupyter 笔记本的形式编写文档。
  • 以 HTML、PDF、MS Word、ePub 等格式发布高质量的文章、报告、简报、网站、博客和书籍。
  • 用科学的 markdown 进行创作,包括方程、引文、交叉引用、图板、呼号、高级布局等等。

基于四种不同语言构建的文档,案例如下(左边为源码,右边为输出结果):



基于 Python 创建文档



基于 R 创建文档



基于 Julia 创建文档



基于 Observable 创建文档

类型与 R Markdwon 比较类似。第一部分是 YAML,后面是正文内容(包含:文字,代码等)。

小编认为如果你会了 R Markdown 制作各类文档,你再来看这些内容,难度应该都不大。两者其实非常相似。如果你有这样的担心:是否需要转战 Quarto 构建文档?,或许你可以看看谢益辉写的博客[2]

它是如何工作的?

在渲染 Quarto 文档时,首先执行所有代码块,并创建一个新的 markdown (.md) 文档,内部包括代码及其输出。然后由 pandoc 处理创建最终的格式(PDF、Word 等)。而这整个步骤都封装到了 Render 按钮中,读者只需要点击 Render 按钮即可编译得到对应的输出文档(各类文档,下一节讲给出)。



工作流程



RStudio 中的 Render 按钮

可创建的文档类型

官网给出了很多很创建的文档类型,并开源了对应的代码。读者可以尝试下载,并读懂,并将其为己所用。这里小编将其简单罗列了下:

文章和报告

具体模板可见:https://quarto.org/docs/gallery/#articles-reports



文章和报告

幻灯片

具体模板可见:https://quarto.org/docs/gallery/#presentations


幻灯片

交互式文档

具体模板可见:https://quarto.org/docs/gallery/#interactive-docs



交互式文档

网站

具体模板可见:https://quarto.org/docs/gallery/#websites



网站

书籍

具体模板可见:https://quarto.org/docs/gallery/#books



书籍

资源分享

本文主要分享基于 R 语言创建 Quarto 文档。

  1. 官网的基于 R 语言的 Quarto 文档教程[3]

825fd557ddbdbe89b3fadb7b3d4a6eae.png


  1. RStudio 举办的 R 会议等给出了一些视频教程。小编将一些最新的教程搬运到了 B 站,供大家学习:


哔哩哔哩

基于 Quarto 创建文档



小程序

  1. 其他相关的博客1[4]2[5] 等。

小编有话说

小编有打算制作一个简短的教程(或者是免费的直播),简单介绍下 Quarto 的使用方式。现在这挖个坑,准备好了再通知大家。

参考资料

[1]

Quarto: https://quarto.org/

[2]

博客: https://yihui.org/en/2022/04/quarto-r-markdown/

[3]

基于 R 语言的 Quarto 文档教程: https://quarto.org/docs/get-started/hello/rstudio.html

[4]

1: https://www.rstudio.com/blog/announcing-quarto-a-new-scientific-and-technical-publishing-system/

[5]

2: https://medium.com/appsilon-data-science/r-quarto-tutorial-how-to-create-interactive-markdown-documents-9e6c35983fe6

目录
相关文章
|
Web App开发 域名解析 缓存
如何在 Ubuntu 20.04 上安装 Node.js 和 npm
本文我们主要为大家介绍在 Ubuntu 20.04 上安装 Node.js 和 npm 的三种不同的方式。
163488 7
如何在 Ubuntu 20.04 上安装 Node.js 和 npm
|
6月前
|
机器学习/深度学习 人工智能 算法
PaperCoder:一种利用大型语言模型自动生成机器学习论文代码的框架
PaperCoder是一种基于多智能体LLM框架的工具,可自动将机器学习研究论文转化为代码库。它通过规划、分析和生成三个阶段,系统性地实现从论文到代码的转化,解决当前研究中代码缺失导致的可复现性问题。实验表明,PaperCoder在自动生成高质量代码方面显著优于基线方法,并获得专家高度认可。这一工具降低了验证研究成果的门槛,推动科研透明与高效。
439 19
PaperCoder:一种利用大型语言模型自动生成机器学习论文代码的框架
|
缓存
Quarto 入门教程 (3):细节设置
Quarto 入门教程 (3):细节设置
476 1
|
jenkins 应用服务中间件 持续交付
如何配置 Nginx 作为 Jenkins 的反向代理并启用 SSL 加密
如何配置 Nginx 作为 Jenkins 的反向代理并启用 SSL 加密
732 8
|
数据可视化
手把手教你使用 Quarto 构建文档 (2)
手把手教你使用 Quarto 构建文档 (2)
555 0
|
缓存 数据可视化
Quarto 入门教程 (4):添加内容,公式,引用
Quarto 入门教程 (4):添加内容,公式,引用
527 0
|
JavaScript 前端开发 测试技术
动态组件化的优缺点是什么
【9月更文挑战第2天】动态组件化的优缺点是什么
236 5
|
中间件 测试技术 持续交付
FastAPI测试秘籍:如何通过细致的测试策略确保你的代码在真实世界的挑战面前保持正确和稳定?
【8月更文挑战第31天】在软件开发中,测试至关重要,尤其在动态语言如Python中。FastAPI不仅简化了Web应用开发,还提供了强大的测试工具。通过`unittest`框架和Starlette测试客户端,开发者可以轻松编写和执行测试用例,确保每个功能按预期工作。本文将详细介绍如何设置测试环境、编写基础和高级测试用例,并探讨中间件和依赖项测试。此外,还将介绍如何在持续集成环境中自动化测试,确保代码质量和稳定性。利用FastAPI的测试工具,你可以构建出高效可靠的Web应用。
240 0
|
机器学习/深度学习 人工智能 前端开发
未来趋势下的前端开发:可视化编程的崛起
随着人工智能和机器学习技术的不断发展,前端开发领域也在逐渐迎来变革。本文探讨了未来趋势下前端开发的发展方向,重点介绍了可视化编程在前端开发中的应用和优势,以及对传统前端开发方式的影响。
|
安全 网络安全 数据安全/隐私保护