Quarto
Quarto 是一个基于 Pandoc 的开源科学和技术出版系统。Quarto 文档使用 markdown 编写,这是一种易于书写的纯文本格式。
除了 Pandoc 的核心功能外,Quarto 还包括:
-
通过与 Jupyter、Knitr 和 Observable 集成,嵌入 Python、R、Julia 和 JavaScript 的代码和输出。
-
对 Pandoc markdown 的多种扩展,适用于技术写作,包括交叉引用、子图、布局面板、可悬停的引用和脚注、标注等。
-
支持使用多种编辑器和笔记本进行创作,包括 JupyterLab、RStudio 和 VS Code。
-
一个可视化 markdown 编辑器,为撰写长篇文档提供高效的写作界面。
在 https://quarto.org 了解更多关于 Quarto 的信息。
开发版本
要安装 Quarto CLI 的开发版本,请克隆 quarto-cli 仓库,然后运行适用于你平台的配置脚本(Linux/macOS 使用 configure.sh
,Windows 使用 configure.cmd
)。例如:
git clone https://github.com/quarto-dev/quarto-cli
cd quarto-cli
./configure.sh
./configure.sh
脚本应该会在你的路径中添加一个指向 quarto
的符号链接。你也可以通过运行 package/dist/bin/quarto
来运行 quarto。
要更新到最新的开发版本,请在本地仓库目录中运行 git pull
:
cd quarto-cli
git pull
运行测试
要运行所有单元测试,请执行测试目录中的脚本。
cd tests
./run-tests.sh
要运行特定的单元测试,请指定脚本名称。
cd tests
./run-tests.sh smoke/extensions/extension-render-doc.test.ts
./run-tests.sh smoke/extensions/
许可证
Quarto 是根据 MIT 许可证(https://opensource.org/license/mit/)提供的开源软件。