名称: quarto-book description: 生成Quarto书籍项目结构，包含章节、配置和输出设置。当用户想要创建书籍、多章节文档、技术手册或询问Quarto书籍设置时使用。

Quarto书籍生成器

生成完整的Quarto书籍项目结构并进行适当配置。

使用场景

用户想要创建书籍或多章节文档
用户请求设置Quarto书籍项目
用户需要技术手册或文档结构
用户提及“quarto书籍”或“书籍项目”

快速生成

运行生成器脚本，指定书籍名称：

python3 ~/.claude/skills/quarto-book/scripts/generate.py <书籍名称> [--chapters N] [--author "姓名"]

或直接使用Quarto CLI：

quarto create project book <书籍名称>

项目结构

mybook/
├── _quarto.yml      # 书籍配置
├── index.qmd        # 前言/介绍
├── intro.qmd        # 第1章
├── methods.qmd      # 第2章
├── results.qmd      # 第3章
├── summary.qmd      # 总结/结论
├── references.qmd   # 参考文献
├── references.bib   # 参考文献库
└── _book/           # 输出目录（生成）

_quarto.yml模板

project:
  type: book
  output-dir: _book

book:
  title: "书籍标题"
  author: "作者姓名"
  date: today
  chapters:
    - index.qmd
    - intro.qmd
    - methods.qmd
    - results.qmd
    - summary.qmd
    - references.qmd

bibliography: references.bib
csl: apa.csl

format:
  html:
    theme: cosmo
    toc: true
  pdf:
    documentclass: scrbook
    papersize: a4
  epub:
    toc: true

章节模板

# 章节标题 {#sec-章节-id}

## 第1节

内容在这里...

## 第2节

更多内容...

## 参考文献

::: {#refs}
:::

命令

命令	描述
`quarto preview`	浏览器中的实时预览
`quarto render`	渲染所有格式
`quarto render --to html`	仅渲染HTML
`quarto render --to pdf`	仅渲染PDF

多部分结构

对于包含部分的书籍：

book:
  chapters:
    - index.qmd
    - part: "第一部分: 基础"
      chapters:
        - basics.qmd
        - theory.qmd
    - part: "第二部分: 应用"
      chapters:
        - methods.qmd
        - results.qmd
    - references.qmd

输出格式

HTML: 交互式网页书籍，带搜索功能
PDF: 打印就绪文档（需要LaTeX）
EPUB: 电子阅读器格式
MS Word: 可编辑文档