quarto-book-template/_quarto.yml at main · Xueheng-Li/quarto-book-template · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
profile:
  default: full

# =============================================================================
# TODO (template users): before publishing, edit the following in this file:
#   - title / subtitle / author / date            (book metadata, below)
#   - website.title                               (browser tab + page title)
#   - website.sidebar.title                       (short label in the sidebar)
#   - website.sidebar.tools[0].href               (your GitHub repo URL)
#   - lang                                        (e.g. "en" for English books)
#   - crossref.{fig,tbl,eq,sec}-prefix            (localize figure/table labels)
# All placeholder values are tagged with their own "# TODO:" comments below.
# =============================================================================

project:
  type: website
  output-dir: _book
  resources:
    - "**/*.mp3"
    - assets/js/ai-ask.js
    - assets/js/vendor/marked.min.js
    - assets/css/ai-ask.css
  # render 和 sidebar.contents 由 profile 文件提供
  # full profile: _quarto-full.yml（默认，渲染全部章节）
  # selection profile: _quarto-selection.yml（仅渲染部分章节，用于预览/试读版）

# TODO: 替换为本书的元信息
title: "Your Book Title"
subtitle: "Your Book Subtitle"
author: "Your Name"
date: today
date-format: iso

website:
  # TODO: 替换为本书的网站标题
  title: "Your Book Title"
  favicon: images/book-logo.png
  reader-mode: true
  search:
    location: sidebar

  page-navigation: true

  sidebar:
    # TODO: 替换为侧边栏简短标题
    title: "Your Book Title"
    logo: images/book-logo.png
    logo-href: ./
    style: floating
    search: true
    collapse-level: 1
    tools:
      - icon: github
        # TODO: 替换为本书的 GitHub 仓库地址
        href: https://github.com/your-org/your-repo
    # contents 由 profile 文件提供

filters:
  - opencode-prompt.lua

format:
  html:
    theme: cosmo
    toc: true
    toc-depth: 3
    number-sections: false
    number-depth: 3
    linestretch: 1.6
    fontsize: 11.5pt
    link-external-newwindow: true
    highlight-style: atom-one
    code-fold: false
    code-tools: true
    code-copy: true
    code-line-numbers: false
    code-overflow: wrap
    css: styles.css
    callout-appearance: default
    mermaid:
      theme: default
    # Optional AI ask widget (bring-your-own-backend).
    # Disabled by default; see docs/ai-ask-widget.md to enable.
    # (Static assets are listed under project.resources above.)
    include-after-body: assets/partials/ai-ask.html

# 代码块配置
execute:
  echo: true
  warning: false
  message: false

# 交叉引用配置（中文前缀）
# TODO: localize prefixes (e.g. "Figure", "Table", "Equation", "Section" for English)
crossref:
  fig-prefix: "图"
  tbl-prefix: "表"
  eq-prefix: "公式"
  sec-prefix: "节"

# 语言配置
# TODO: change to your book's language (e.g. en)
lang: zh