Quarto Book 项目创建与配置完整指南

Quarto Book 项目创建与配置完整指南

一、使用模板创建 Quarto Book 项目（详细步骤）

1. 打开 VS Code，确保已安装官方 Quarto 扩展（发布者：Quarto），并已正确配置 Quarto CLI 路径。

2. 调出命令面板：按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）。
   

3. 执行创建命令：在命令面板中输入 Quarto: Create Project，然后在下拉列表中选中并执行。

4. 选择项目模板：在弹出的选项列表中，选择 Book Project（书籍项目）。

5. 输入项目名称：

   • VS Code 会提示你输入项目名称（如 my-book）。
   • 建议：使用英文小写字母、数字和下划线（如 my_first_book），避免使用中文或空格，以免后续编译路径报错。

6. 选择保存路径：

   • 系统会弹出文件夹选择窗口，请选择一个你希望存放项目的父目录（如 D:/projects/ 或 ~/Documents/）。
   • 选定后，Quarto 会在该目录下自动创建一个以项目名称命名的文件夹（如 my-book/），并将所有模板文件生成在其中。

7. 自动打开项目：创建成功后，VS Code 通常会自动打开新项目文件夹作为工作区。如果没有自动打开，请手动通过「文件」->「打开文件夹」选择该项目目录。

二、Quarto 模板默认生成的文件（不做任何修改时）

执行上述创建步骤后，项目文件夹中会默认生成以下文件：

my-book/                          # 项目根目录
├── _quarto.yml                   # 🔧 核心配置文件（最重要）
├── index.qmd                     # 📄 首页/封面文件
├── chapters/                     # 📁 章节文件夹（默认存在）
│   ├── chapter1.qmd              # 第一章示例
│   ├── chapter2.qmd              # 第二章示例
│   └── ...                       # 更多章节示例
├── references.bib                # 📚 示例参考文献文件（如有）
└── images/                       # 🖼️ 图片