Quarto+Vscode：生成在线电子书

本仓库介绍如何使用 Quarto 和 VScode 创建在线电子书，并将其发布到 GitHub Pages。

Quarto 是一个开源的文档编译工具，支持多种格式的文档（如 Markdown、Jupyter Notebook 等），可以轻松地将它们组织成一本书。

以本项目 (quarto_book) 为例：

• 在你的 github 账号下创建一个名为 quarto_book 的仓库。
  • 我的仓库名为 lianxhcn/quarto_book，完整网址为：https://github.com/lianxhcn/quarto_book
• 使用 git 命令或 GitHub Desktop 将本仓库克隆到本地。
  • 例如，我的本地文件夹为：D:\Github_lianxh\quarto_book
• 创建 quarto book 项目，编写书稿。详情参见 创建流程。
  • 最简单的方法：将 我的 quarto_book 仓库 下载 到本地，解压；把里面的内容复制到你的仓库下。
  • 你可以使用 VScode 编辑器来创建和编辑 Quarto Book 项目。
• 编译书稿：参见 创建流程。
• 发布书稿：参见 使用 GitHub Pages 发布。

最终发布的主页：https://lianxhcn.github.io/quarto_book/

下载本仓库

• 点击绿色 <>Code 按钮，选择 Download ZIP 下载本仓库。
• 解压缩后，使用 VS Code 打开文件夹即可。
• 各章节文档存放在 ./body 文件夹中，文件名与 quarto_book 的网址中的文件名对应。

git 或 github desktop 下载

• 如果你熟悉 git 或者 github desktop，可以直接使用 git 下载本仓库，或 Fork 本仓库后，使用 github desktop 下载。
  • 推荐使用 GitHub Desktop，操作简单直观。
  • 具体操作：GitHub Desktop 教程。
• 遇到问题可以问一下 DeepSeek 或豆包。