欢迎各种形式的贡献,只需遵循指南,可以通过以下方式:
目录
精选(新发布)
- Awesome Quarto扩展列表 - 来自Awesome Quarto的Quarto扩展列表。
- 工作坊:使用Quarto进行参数化报告 - 一个2小时的代码实践工作坊,学习使用
quarto
和purrr
进行参数化报告,生成多种格式输出(材料:https://github.com/jadeynryan/parameterized-quarto-workshop)。 - 6分钟发布Quarto项目 - 一个简短的视频教程,介绍如何使用GitHub Actions将Quarto项目发布到GitHub Pages,无需本地渲染。
官方文档和快速入门
- 文档:Quarto文档 - 官方Quarto文档。
- GitHub:Quarto GitHub仓库 - 官方Quarto GitHub仓库。
- 教程:Hello, Quarto - 官方"Hello, Quarto"教程。
- 教程:计算 - 官方"计算"教程。
- 教程:创作 - 官方"创作"教程。
- 服务:Quarto Pub - 在Quarto中创建文档、网站、演示文稿、图书和博客,然后使用Quarto CLI安全地将它们发布到网络,这是在网络上发布和分享的最简单方式。
教程和工作坊
- 教程:使用Quarto开始博客写作的终极指南 - 关于如何使用Quarto开始博客写作的深入指南。
- 教程:10步创建Quarto博客 - 介绍新的Quarto博客以及如何用Quarto创建自己博客的步骤的博文。
- 教程:使用Quarto制作可分享的文档 - 使用Quarto制作网站的教程。
- 工作坊:从R Markdown到Quarto - 为那些想要将R Markdown技能和专业知识应用到Quarto(R Markdown的下一代)的人准备的工作坊。
- 工作坊:Quarto入门 - rstudio::conf(2022)的"Quarto入门"工作坊材料。
- 工作坊:Quarto,一个运行所有内容的库? - 在RSECon'22上由Carlos Cámara、James Tripp和Cagatay Turkay主持的工作坊(材料:https://github.com/WarwickCIM/quarto-workshop)。
- 教程:使用Quarto创建个人网站 - Samantha Csik编写的使用Quarto设置个人网站的分步指南。
- 教程:自定义Quarto网站 - 使用SASS和CSS让你的网站脱颖而出 - Samantha Csik关于使用SASS和CSS自定义HTM Quarto网站的幻灯片(材料:https://github.com/UCSB-MEDS/customizing-quarto-websites)。
- 工作坊:Quartaki — Quarto 6小时入门 - Athanasia Mo Mowinckel使用R和RStudio讲解,涵盖基本markdown、html报告、引用和交叉引用、pdf和期刊模板以及Reveal.js演示。
- 工作坊:我的第一个Quarto博客 - Pedro J. Pérez用西班牙语主持的创建Quarto博客的工作坊(材料:https://github.com/perezp44/taller.primer.blog)。
- 教程:创建Quarto期刊文章模板 - 详细介绍将期刊LaTeX模板转换为Quarto模板过程的深入博文。
- 教程:使用Jupyter Notebook和Quarto创建个人网站 - 关于如何使用Quarto创建网站的Python导向分步教程。
- 教程:使用Quarto创建你的网站 - Marvin Schmitt编写的如何使用Quarto创建网站的教程。
- 教程:使用Netlify发布Quarto网站 - Jadey Ryan撰写的全面博文,详细介绍如何创建Quarto网站、将其连接到GitHub,并使用Netlify部署和发布。
- 工作坊:使用Quarto进行参数化报告 - 2小时的实践工作坊,学习使用
quarto
和purrr
进行参数化报告,以生成多种格式的输出(材料:https://github.com/jadeynryan/parameterized-quarto-workshop)。
博客文章
- 《我们不谈Quarto》- Alison Presmanes Hill撰写的介绍Quarto出版软件的博客文章。
- 《每日Quarto小贴士》- 一个用Quarto制作的网站,每天以博客形式发布一条Quarto使用技巧。
- 《宣布Quarto:一个新的科技出版系统》- J.J. Allaire发布的博客文章,宣布推出新的开源科技出版系统Quarto。
- 《交互式分子内容》- 一篇博客文章,展示如何使用Bokeh、3DMol.js和NGL在Quarto制作的网页中嵌入交互式内容(如分子可视化)。
- 《幻灯片制作101:色彩与字体》- Emil Hvitfeldt撰写的博客文章,探讨"使用Quarto演示格式制作功能性和美观的幻灯片的艺术"。
- 《用Quarto和Reveal.js制作幻灯片》- Meghan Hall撰写的博客文章,介绍如何用Quarto和Reveal.js制作幻灯片,以及如何使用表情符号或自定义幻灯片。
- 《Quarto中使用Observable JavaScript、R和Python的新手指南》- 本文展示如何设置Quarto文档以使用Observable JavaScript,包括如何将R或Python的数据传递给Observable代码块。
- 《Quarto的六个生产力技巧》- 一篇博客文章,展示了从跨文档重用内容、插入Pandoc分区和跨度到使用GitHub Actions进行持续部署的六个技巧。
- 《如何为你的Quarto博客增添个性》- 一篇博客文章,分享了用户可以在标准博客模板基础上添加的一些功能和调整,以为博客注入个性。
- 《使用R生成Quarto博客文章》- Tom Mock撰写的关于使用R生成Quarto博客文章的博客文章。
- 《为Quarto网站添加订阅功能》- 一篇关于如何为Quarto博客添加订阅表单的博客文章。
- 《作为R用户:Quarto还是R Markdown?》- Jumping Rivers撰写的博客文章,从R用户的角度比较Quarto和R Markdown。
- 《面向Python用户的Quarto》- 一篇向Python用户介绍如何使用Quarto创建报告的博客文章。
- 《如何将你的Quarto文档/书籍/网站发布为Docker容器?》- Mickaël Canouil撰写的博客文章,描述了如何将Quarto文档/书籍/网站发布为Docker容器。
- 《如何为明暗主题准备不同的图片?》- Mickaël Canouil撰写的博客文章,描述了如何为明暗两种主题准备不同的图片。
- 《用Quarto制作精美的PDF》- 一篇博客文章,展示了如何自定义PDF文档的样式,并将样式保存为Quarto扩展,以便更容易重用和分享。
- 《如何使用Quarto在Leanpub和亚马逊上自助出版技术书籍》- 这篇博客文章解释了使用哪些设置来为Leanpub编译Epub,以及为亚马逊的自助出版服务(KDP)编译打印就绪的PDF。
- 《你好,Quarto:将我的网站从Hugo Apéro迁移》- 一篇博客文章,详细介绍了一位用户将blogdown Hugo Apéro网站迁移到Quarto的经历,内容包括设计理念、CSS技巧、HTML部分、设置重定向等。
讲座和视频
- 使用Quarto进行可重复性创作 - 2022年多伦多可重复性研讨会,由Mine Çetinkaya-Rundel主讲(幻灯片:https://mine-cetinkaya-rundel.github.io/2022-repro-toronto/)。
- 使用Julia和Quarto进行可重复性出版 - JuliaCon 2022,由J.J. Allaire主讲(幻灯片:https://jjallaire.github.io/quarto-juliacon-2022)。
- 关于Quarto的对话 - Openscapes社区讲座:你好,Quarto!
- 教程:如何在不太懂HTML/CSS的情况下美化你的Quarto博客 - 这是一个关于如何在不具备扎实HTML/CSS基础的情况下美化Quarto博客的视频教程。
- 研讨会:Quarto两小时入门工作坊 - RStudio线上会议:Tom Mock主讲的Quarto两小时入门工作坊(幻灯片:https://jthomasmock.github.io/quarto-2hr-webinar/)。
- 好奇者的Quarto指南 - Tom Mock在RStudio::conf(2022)上的Quarto概览(材料:https://thomasmock.quarto.pub/quarto-curious/)。
- 你好,Quarto:分享 • 协作 • 教学 • 重新想象 - Mine Çetinkaya-Rundel和Julia Stewart Lowndes在RStudio::conf(2022)上的主题演讲,强调他们如何在开放科学中利用Quarto(材料:https://github.com/mine-cetinkaya-rundel/hello-quarto)。
- 网站、书籍和博客,哦,天哪!使用Quarto创建丰富内容 - Devin Pastoor在RStudio::conf(2022)上的演讲,展示了Quarto中可用的一些格式,以及如何轻松专注于内容而让Quarto处理其余部分。
- 使用Jupyter Notebooks和Quarto进行文学编程 - Hamel Husain在RStudio::conf(2022)上的演讲,描述了Nbdev和Quarto之间的集成(材料:https://github.com/fastai/nbdev-demo)。
- 这些是我最喜欢的东西 - Tracy Teal在RStudio::conf(2022)上的演讲,强调了Quarto演示的一些特性,如多列布局、演讲者注释和模式、转场效果等。
- 使用Quarto构建博客 - RStudio线上会议:Isabella Velásquez主讲的使用Quarto构建博客(材料:https://ivelasq.quarto.pub/building-a-blog-with-quarto/)。
- 使用Quarto制作精美的报告和演示 - RStudio线上会议:Tom Mock主讲的使用Quarto制作精美的报告和演示(材料:https://github.com/jthomasmock/quarto-reporting)。
- Quarto入门 - R-Ladies St. Louis:Isabella Velásquez主讲的Quarto入门(材料:https://github.com/ivelasq/2022-10-27_intro-to-quarto)。
- Quarto YouTube播放列表 - Eli Holmes制作的关于Quarto和Pandoc的YouTube视频播放列表。
- 使用Quarto创建你的数据科学作品集 - 在Deepsha Menghani的这个视频中,学习如何轻松创建数据科学作品集网站并使用Quarto立即部署(材料:https://deepshamenghani.quarto.pub/portfolio-with-quarto-workshop/#/title-slide)。
- 与Quarto和Neovim共进咖啡 - Jannik Buhr制作的YouTube播放列表,向你展示如何在Neovim中使用Quarto。
- 如何在不太懂HTML/CSS的情况下美化你的Quarto博客? - Albert Rapp制作的视频教程,讲解如何在不具备扎实HTML/CSS基础的情况下美化Quarto博客。
- 面向学术界的Quarto - Mine Çetinkaya-Rundel制作的视频,重点介绍了Quarto对学者(作为教育者和研究者)特别有用的一些功能。
- Quarto仪表板 - Charles Teague制作的视频,重点介绍了Quarto 1.4版本中即将推出的新仪表板功能。
- 参数化Quarto报告提高对土壤健康的理解 - Jadey Ryan在posit::conf(2023)上的演讲,提供了一个创建带有HTML和MS Word输出的参数化报告的示例工作流程(材料:https://jadeynryan.github.io/2023_posit-parameterized-quarto/)。
支持的编辑器
- Emacs - 用于Quarto的Emacs模式。
- Neovim - 用于处理Quarto的Neovim工具。
- Sublime Text - 用于处理Quarto的Sublime Text插件。
- Vim - 用于处理Quarto的Vim插件。
- Visual Studio Code - 用于Quarto的Visual Studio Code扩展。
- Scrivener - 通过Scrivener模板为Scrivener提供Quarto支持。
- RStudio - Posit PBC开发的RStudio IDE原生支持Quarto。
库/包/脚本
- Julia - Julia 与 Quarto CLI 的接口包。
- Python - Python 与 Quarto CLI 的接口包。
- R - R 与 Quarto CLI 的接口包。
- ecodown - 将 R 包文档
pkgdown
网站转换为 Quarto 网站。 - 模拟色盲 - 用于模拟整个文档色盲效果的 Observable 小部件。
- quartostamp - 一个 R 包,包含一个 RStudio 插件,用于在 Quarto
revealjs
文档中插入一些有用的 div 和类。 - ohq2quarto - 一个基于 Rust 的命令行工具,用于将任何 ObservableHQ 笔记本转换为 Quarto 项目。
- Quartize - 一个 Chrome 扩展,用于将任何 ObservableHQ 笔记本转换为可下载的
FileAttachment
列表和页内 Quarto 源文档。 - RStudio 和 VSCode 代码片段 - RStudio 和 VSCode 代码片段,用于简化 Quarto 排版。
- matrix BOT - 一个用于 matrix-network 的小机器人,监听一些 Quarto 文件并将 PDF 返回到 matrix 频道。
- babelquarto - R 包,用于帮助设置和渲染多语言 Quarto 书籍(另见 babeldown)。
- quartodoc - 一个 Python 模块,可以使用 Markdown 和 Quarto 快速生成 Python 包 API 参考文档。
持续集成/持续部署
- Quarto GitHub Actions - 官方 Quarto GitHub Actions,允许通过 GitHub Actions 设置、渲染和部署 Quarto 项目。
- 使用 GitHub Actions 的 Quarto 网站 - 每次更新时通过 GitHub Actions 自动发布 Quarto 网站。
- Quarto Devcontainer 功能 - 将 Quarto CLI 作为功能添加到您的 开发容器 中。
- 6分钟发布 Quarto 项目 - 一个简短的视频教程,介绍如何使用 GitHub Actions 将 Quarto 项目发布到 GitHub Pages,无需本地渲染。
扩展
- Quarto.org 扩展列表 - 来自 https://quarto.org 的 Quarto 扩展列表。
- Awesome Quarto 扩展列表 - 来自 Awesome Quarto 的 Quarto 扩展列表。
实际应用示例
演示文稿格式
- R 高级入门(法语) - 查看幻灯片 这里。
- 使用 R 简化流程 - 查看幻灯片 这里。
- 教育者眼中的 tidyverse - 查看幻灯片 这里。
- 实验设计选集 - 查看幻灯片 这里。
- palmerpenguins 的不为人知的故事 - 查看幻灯片 这里。
- 异常高效的探索性数据分析 - 查看幻灯片 这里。
- textrecipes 的改进 - 查看幻灯片 这里。
- Quarto:使用 R、Python、Julia 和 Observable 创建精美文档(Runapp 2022 演讲) - 查看幻灯片 这里。
- Iframes 画廊 - 可用于 Quarto
revealjs
格式的 iframes 画廊。 - 使用澳大利亚生物多样性地图集进行大陆尺度生物多样性数据评估 - "2023年维多利亚生物多样性会议"的幻灯片(查看幻灯片 这里)。
网站格式
- quarto.org - Quarto文档网站。
- rlille.fr - 使用Quarto构建的R Lille(R用户组)网站。
- R-Manuals - 使用Quarto重写的R手册。
- Quarto每日技巧 - 每天突出介绍一个Quarto技巧的网站/博客。
- 从Jupyter Notebook生成的文档网站 - 使用Quarto从包含Python模块文档的Jupyter notebook生成网站。
- 公共服务项目评估(课程) - 使用R进行项目评估和因果推断的研究生课程网站,由Quarto构建。
- Bioconductor社区博客 - Bioconductor社区的Quarto博客。
- 面向社会科学家的R工作坊 - 包含嵌入式Quarto Reveal JS演示的工作坊Quarto网站。
- AffCom实验室网站 - 使用自定义列表页面展示人员和出版物的研究实验室Quarto博客/网站。
- Quantum Jitter - 具有自定义主题(改编自flatly / darkly)、日/夜落地页和新颖404页面的Quarto网站/博客。
- Andrew Heiss的网站 - Andrew Heiss的网站,包含自定义EJS格式、页脚、404页面、(S)CSS和更多定制。
- Ella Kaye的网站 - Ella Kaye的网站,具有Bootstrap网格卡片首页布局、导航栏CSS动画和亮/暗模式。
- 使用PRQL查询 - 使用
Jupyter
和knitr
进行计算并支持多种语言(PRQL、SQL、R、Python等)的Docusaurus网站。 - 真实世界数据科学 - 英国皇家统计学会网站,使用Quarto构建,具有自定义设计(基于Lux Bootswatch主题),定制的导航栏和首页布局。
- Silvia Canelón的网站 - Silvia Canelón的网站,定制风格以匹配Hugo Apéro blogdown主题。
书籍格式
- R for Data Science,第2版 - "R for Data Science"书籍第二版(见https://r4ds.hadley.nz/)。
- R Packages,第2版 - "R Packages"书籍第二版(见https://r-pkgs.org/)。
- mlr3book - 关于
ml3r
包生态系统的书籍(见https://mlr3book.mlr-org.com/)。 - R数据分析入门 - 包含视频和讲义的入门课程,以Quarto书籍格式呈现。
- Python for Data Analysis,第3版 - "Python for Data Analysis"书籍第三版(见https://wesmckinney.com/book/)。
其他格式
关注
官方
- @quarto-dev - 包含Quarto CLI、IDE插件/扩展等的GitHub组织。
- @quarto-ext - 包含由Quarto团队开发/维护的扩展的GitHub组织。
- @quarto-journals - 包含由Quarto团队开发/维护的期刊模板的GitHub组织。
- J.J. Allaire (@jjallaire) - Quarto核心团队成员(Twitter:@fly_upside_down)。
- Christophe Dervieux (@cderv) - Quarto核心团队成员(Twitter:@chrisderv;Mastodon:@cderv@fosstodon.org)。
- Carlos Scheidegger (@cscheid) - Quarto核心团队成员(Twitter:@scheidegger;Mastodon:@scheidegger@mastodon.social)。
- Charles Teague (@dragonstyle) - Quarto核心团队成员(Twitter:@dragonstyle)。
- Yihui Xie (@yihui) - Quarto核心团队成员(Twitter:@xieyihui)。
- Tom Mock (@jthomasmock) - 客户赋能与Quarto产品经理(Twitter:@thomas_mock;Mastodon:@thomas_mock@fosstodon.org)。
社区
- Mickaël Canouil (@mcanouil) - Awesome Quarto列表的维护者(Twitter:@MickaelCanouil;Mastodon:@MickaelCanouil@fosstodon.org)。
我们还应该关注谁?
贡献
感谢这些贡献者!