create-asciidoc-multi-book-workspace 0.1.0

package/templates/default-workspace/books/00-book-anatomy/parts/01-front-structure/_partintro.adoc

@@ -0,0 +1 @@
+本部展示一本书进入正文之前的结构位置。摘要、版本说明、献辞、前言和致谢都属于书籍前置内容。

package/templates/default-workspace/books/00-book-anatomy/parts/02-body-structure/01-body-map.adoc

@@ -0,0 +1,13 @@
+[#body-map]
+== 正文结构地图
+
+part 是 book doctype 中的 level 0 section。chapter 是 part 下的 level 1 section，也就是 `==` 标题。
+
+=== 小节层级
+
+小节用于组织 chapter 内部内容。(((section)))
+
+[discrete]
+=== 离散标题
+
+离散标题提供视觉分隔，但不进入书籍目录层级。(((discrete heading)))

package/templates/default-workspace/books/00-book-anatomy/parts/02-body-structure/_partintro.adoc

@@ -0,0 +1 @@
+本部展示正文中的 part、chapter、section 和离散标题。part 组织同一本书内部的大分部。

package/templates/default-workspace/books/01-starter-book/assets/images/starter-map.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="220" viewBox="0 0 720 220" role="img" aria-labelledby="title desc">
+  <title id="title">日常单书结构图</title>
+  <desc id="desc">book.adoc include 前言、章节、附录和参考资料。</desc>
+  <rect width="720" height="220" fill="#f8fafc"/>
+  <g fill="#ffffff" stroke="#334155" stroke-width="2">
+    <rect x="40" y="70" width="130" height="70" rx="6"/>
+    <rect x="220" y="30" width="130" height="55" rx="6"/>
+    <rect x="220" y="100" width="130" height="55" rx="6"/>
+    <rect x="400" y="70" width="130" height="70" rx="6"/>
+    <rect x="580" y="70" width="100" height="70" rx="6"/>
+  </g>
+  <g fill="#0f172a" font-family="sans-serif" font-size="16" text-anchor="middle">
+    <text x="105" y="112">book.adoc</text>
+    <text x="285" y="63">frontmatter</text>
+    <text x="285" y="133">chapters</text>
+    <text x="465" y="112">backmatter</text>
+    <text x="630" y="112">assets</text>
+  </g>
+  <g stroke="#0f766e" stroke-width="2" fill="none" marker-end="url(#arrow)">
+    <path d="M170 96 L220 58"/>
+    <path d="M170 116 L220 128"/>
+    <path d="M350 128 L400 112"/>
+    <path d="M530 105 L580 105"/>
+  </g>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto">
+      <path d="M0,0 L0,6 L9,3 z" fill="#0f766e"/>
+    </marker>
+  </defs>
+</svg>

package/templates/default-workspace/books/01-starter-book/backmatter/appendix-a.adoc

@@ -0,0 +1,9 @@
+== 附录 A：最小文件清单
+
+普通新书通常需要：
+
+* `book.adoc`
+* `frontmatter/preface.adoc`
+* `chapters/`
+* `backmatter/`
+* `assets/images/`

package/templates/default-workspace/books/01-starter-book/backmatter/bibliography.adoc

@@ -0,0 +1,3 @@
+== 参考资料
+
+* [[[starter-anatomy]]] 样本 `00-book-anatomy` 展示完整 book 结构位置。

package/templates/default-workspace/books/01-starter-book/book.adoc

@@ -0,0 +1,26 @@
+= 日常独立单书
+作者 <author@example.com>
+v0.1, 2026-05
+:doctype: book
+:toc: left
+:toclevels: 3
+:sectnums:
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+
+include::../../shared/attributes.adoc[]
+
+[preface]
+include::frontmatter/preface.adoc[]
+
+include::chapters/01-opening.adoc[]
+
+include::chapters/02-main-flow.adoc[]
+
+[appendix]
+include::backmatter/appendix-a.adoc[]
+
+[bibliography]
+include::backmatter/bibliography.adoc[]

package/templates/default-workspace/books/01-starter-book/chapters/01-opening.adoc

@@ -0,0 +1,6 @@
+[#starter-book-boundary]
+== 单书边界
+
+一本普通书由自己的 `book.adoc` 定义边界。入口文件负责书名、属性、章节顺序、前置内容和后置内容。
+
+image::assets/images/starter-map.svg[日常单书结构图]

package/templates/default-workspace/books/01-starter-book/chapters/02-main-flow.adoc

@@ -0,0 +1,5 @@
+== 章节顺序
+
+普通章节放在 `chapters/` 下。`book.adoc` 通过 include 顺序决定阅读顺序。
+
+新增章节时，先创建章节文件，再把 include 放到合适位置。

package/templates/default-workspace/books/01-starter-book/frontmatter/preface.adoc

@@ -0,0 +1,3 @@
+== 前言
+
+本书是新增普通 book 时的复制起点。它只保留日常写作最常见的结构：前言、章节、附录、参考资料和本书图片。

package/templates/default-workspace/books/02-multipart-monograph/backmatter/appendix-a.adoc

@@ -0,0 +1,5 @@
+= 附录 A：part 速查
+
+* `= 第一部`：同一本 book 内部的 part。
+* `[partintro]`：part 开头的说明块。
+* `== 章标题`：part 下的 chapter。

package/templates/default-workspace/books/02-multipart-monograph/backmatter/bibliography.adoc

@@ -0,0 +1,3 @@
+= 参考资料
+
+* [[[asciidoctor-parts]]] Asciidoctor Docs, Book Parts, https://docs.asciidoctor.org/asciidoc/latest/sections/parts/

package/templates/default-workspace/books/02-multipart-monograph/book.adoc

@@ -0,0 +1,37 @@
+= 长书分部样本
+作者 <author@example.com>
+v0.1, 2026-05
+:doctype: book
+:toc: left
+:toclevels: 3
+:sectnums:
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+
+include::../../shared/attributes.adoc[]
+
+= 第一部：问题世界
+
+[partintro]
+include::parts/01-domain/_partintro.adoc[]
+
+include::parts/01-domain/01-problem-world.adoc[]
+
+include::parts/01-domain/02-boundary.adoc[]
+
+= 第二部：书籍规约
+
+[partintro]
+include::parts/02-specification/_partintro.adoc[]
+
+include::parts/02-specification/01-book-contract.adoc[]
+
+include::parts/02-specification/02-verification.adoc[]
+
+[appendix]
+include::backmatter/appendix-a.adoc[]
+
+[bibliography]
+include::backmatter/bibliography.adoc[]

package/templates/default-workspace/books/02-multipart-monograph/parts/01-domain/01-problem-world.adoc

@@ -0,0 +1,6 @@
+[#multipart-book-boundary]
+== 长书的问题世界
+
+长书仍然只有一个书名、一个入口和一个连续的阅读产物。第一部、第二部只是同一本书内部的大分部。
+
+当读者需要一次性阅读整本书时，part 比拆成多本 book 更合适。

package/templates/default-workspace/books/02-multipart-monograph/parts/01-domain/02-boundary.adoc

@@ -0,0 +1,5 @@
+== part 的边界
+
+part 不拥有独立 `book.adoc`。它由同一本 `book.adoc` 中的 level 0 标题声明。
+
+part 下的 chapter 仍属于同一本书。

package/templates/default-workspace/books/02-multipart-monograph/parts/01-domain/_partintro.adoc

@@ -0,0 +1,2 @@
+[#partintro-example]
+本部说明为什么同一本长书需要 part。part intro 为该部提供进入正文之前的过渡说明。

package/templates/default-workspace/books/02-multipart-monograph/parts/02-specification/01-book-contract.adoc

@@ -0,0 +1,5 @@
+== `book.adoc` 的职责
+
+`book.adoc` 声明整本书的标题、属性、part 顺序和后置章节。
+
+同一本长书内部的 part 不应复制根级依赖或构建脚本。

package/templates/default-workspace/books/02-multipart-monograph/parts/02-specification/02-verification.adoc

@@ -0,0 +1,5 @@
+== 分部结构的验证
+
+验证长书分部时，重点检查 `book.adoc` 中是否存在多个 level 0 part，以及每个 part 下是否有 chapter。
+
+分卷发布可以参考样本 `05-upper-volume` 和 `06-lower-volume` 的目录组织。

package/templates/default-workspace/books/02-multipart-monograph/parts/02-specification/_partintro.adoc

@@ -0,0 +1 @@
+本部说明 part 对 `book.adoc` 的结构要求。part、chapter 和后置章节共同组成同一本 book。

package/templates/default-workspace/books/03-technical-book-workflow/assets/images/technical-flow.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="760" height="240" viewBox="0 0 760 240" role="img" aria-labelledby="title desc">
+  <title id="title">技术书流程图</title>
+  <desc id="desc">技术书从章节引用书内代码、书内图片和共享图片。</desc>
+  <rect width="760" height="240" fill="#f8fafc"/>
+  <g fill="#ffffff" stroke="#334155" stroke-width="2">
+    <rect x="40" y="85" width="140" height="70" rx="6"/>
+    <rect x="250" y="85" width="140" height="70" rx="6"/>
+    <rect x="470" y="30" width="140" height="55" rx="6"/>
+    <rect x="470" y="105" width="140" height="55" rx="6"/>
+    <rect x="470" y="180" width="140" height="40" rx="6"/>
+  </g>
+  <g fill="#0f172a" font-family="sans-serif" font-size="15" text-anchor="middle">
+    <text x="110" y="126">book.adoc</text>
+    <text x="320" y="126">chapters</text>
+    <text x="540" y="63">examples</text>
+    <text x="540" y="138">assets</text>
+    <text x="540" y="205">shared</text>
+  </g>
+  <g stroke="#2563eb" stroke-width="2" fill="none" marker-end="url(#arrow)">
+    <path d="M180 120 L250 120"/>
+    <path d="M390 105 L470 58"/>
+    <path d="M390 125 L470 132"/>
+    <path d="M390 145 L470 198"/>
+  </g>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto">
+      <path d="M0,0 L0,6 L9,3 z" fill="#2563eb"/>
+    </marker>
+  </defs>
+</svg>

package/templates/default-workspace/books/03-technical-book-workflow/backmatter/bibliography.adoc

@@ -0,0 +1,3 @@
+== 参考资料
+
+* [[[asciidoctor-include]]] Asciidoctor Docs, Include Directive, https://docs.asciidoctor.org/asciidoc/latest/directives/include/

package/templates/default-workspace/books/03-technical-book-workflow/book.adoc

@@ -0,0 +1,25 @@
+= 技术书工作流
+作者 <author@example.com>
+v0.1, 2026-05
+:doctype: book
+:toc: left
+:toclevels: 3
+:sectnums:
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+
+include::../../shared/attributes.adoc[]
+
+[preface]
+include::frontmatter/preface.adoc[]
+
+include::chapters/01-build-flow.adoc[]
+
+include::chapters/02-diagrams.adoc[]
+
+include::chapters/03-code-includes.adoc[]
+
+[bibliography]
+include::backmatter/bibliography.adoc[]

package/templates/default-workspace/books/03-technical-book-workflow/chapters/01-build-flow.adoc

@@ -0,0 +1,12 @@
+[#technical-build-flow]
+== 构建流程
+
+技术书仍然是一本文档边界独立的 book。它可以使用共享属性和共享图片，但自己的示例代码保留在书内。
+
+共享工作区图来自 `shared/images/`：
+
+image::../../shared/images/workspace-map.svg[工作区共享结构图]
+
+本书自己的流程图来自书内资源：
+
+image::assets/images/technical-flow.svg[技术书流程图]

package/templates/default-workspace/books/03-technical-book-workflow/chapters/02-diagrams.adoc

@@ -0,0 +1,19 @@
+== 图表块
+
+图表块让技术书把结构图保留为可维护文本。
+
+.Mermaid：技术书资源边界
+[mermaid,technical-resource-flow,svg]
+....
+flowchart LR
+    book["book.adoc"]
+    chapter["chapters/*.adoc"]
+    examples["examples/minimal-tool.mjs"]
+    assets["assets/images"]
+    shared["../../shared/images"]
+
+    book --> chapter
+    chapter --> examples
+    chapter --> assets
+    chapter --> shared
+....

package/templates/default-workspace/books/03-technical-book-workflow/chapters/03-code-includes.adoc

@@ -0,0 +1,8 @@
+== 代码片段
+
+代码片段属于本书内部资源。章节通过 include tag 引入需要进入书稿的片段。
+
+[source,js]
+----
+include::../examples/minimal-tool.mjs[tag=main]
+----

package/templates/default-workspace/books/03-technical-book-workflow/examples/minimal-tool.mjs

@@ -0,0 +1,5 @@
+// tag::main[]
+export function describeBook(id) {
+  return `book:${id}`;
+}
+// end::main[]

package/templates/default-workspace/books/03-technical-book-workflow/frontmatter/preface.adoc

@@ -0,0 +1,3 @@
+== 前言
+
+本书展示技术书常见的工程化写法：共享属性、共享图片、本书图片、图表块和书内代码片段。

package/templates/default-workspace/books/04-reference-manual/backmatter/bibliography.adoc

@@ -0,0 +1,4 @@
+== 参考资料
+
+* [[[asciidoctor-xref]]] Asciidoctor Docs, Document to Document Cross References, https://docs.asciidoctor.org/asciidoc/latest/macros/inter-document-xref/
+* [[[antora-xref]]] Antora Docs, Page Xrefs and Resource IDs, https://docs.antora.org/antora/latest/page/xref/

package/templates/default-workspace/books/04-reference-manual/backmatter/glossary.adoc

@@ -0,0 +1,8 @@
+== 术语表
+
+book:: 具有独立 `book.adoc` 和构建产物的书籍单位。
+part:: 同一本 book 内部的 level 0 大分部。
+catalog:: 多书工作区的读者导航入口。
+shared resource:: 被 catalog 或多本书共同引用的资源。
+explicit anchor:: 使用 `[#id]` 写出的稳定引用目标。
+contract check:: 对工作区源文件约定进行静态检查的脚本行为。

package/templates/default-workspace/books/04-reference-manual/book.adoc

@@ -0,0 +1,30 @@
+= 参考手册
+作者 <author@example.com>
+v0.1, 2026-05
+:doctype: book
+:toc: left
+:toclevels: 3
+:sectnums:
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+
+include::../../shared/attributes.adoc[]
+
+[preface]
+include::frontmatter/preface.adoc[]
+
+include::chapters/01-decision-table.adoc[]
+
+include::chapters/02-path-rules.adoc[]
+
+include::chapters/03-xref-patterns.adoc[]
+
+include::chapters/04-growth-paths.adoc[]
+
+[glossary]
+include::backmatter/glossary.adoc[]
+
+[bibliography]
+include::backmatter/bibliography.adoc[]

package/templates/default-workspace/books/04-reference-manual/chapters/01-decision-table.adoc

@@ -0,0 +1,27 @@
+[#decision-table]
+== 结构选择表
+
+[cols="1,2,2", options="header"]
+|===
+|场景 |推荐样本 |判断标准
+
+|学习完整 book 结构
+|`00-book-anatomy`
+|需要看到前置、正文、分部和后置结构的位置。
+
+|新增普通书
+|`01-starter-book`
+|需要低负担复制起点。
+
+|同一本书内部有第一部、第二部
+|`02-multipart-monograph`
+|仍然是一个入口和一个连续 book。
+
+|技术书包含图表和代码片段
+|`03-technical-book-workflow`
+|需要资源边界、图表和代码 include。
+
+|上册下册独立发布
+|`05-upper-volume` 与 `06-lower-volume`
+|每册有自己的入口、前言、参考资料和构建产物。
+|===

package/templates/default-workspace/books/04-reference-manual/chapters/02-path-rules.adoc

@@ -0,0 +1,14 @@
+[#path-rules]
+== 路径规则
+
+Book directory:: `books/<book-id>/`，一本独立 book 的边界。
+Book entry:: `books/<book-id>/book.adoc`，该书唯一入口。
+Book assets:: `books/<book-id>/assets/images/`，只属于该书的图片。
+Shared images:: `shared/images/`，被 catalog 或多本书引用的图片。
+Book examples:: `books/<book-id>/examples/`，只属于该书的代码片段。
+Build output:: `build/`，由脚本生成，不作为源文件编辑。
+
+[discrete]
+=== 共享资源准入
+
+资源只有在被 catalog 或多本书实际引用时才进入 `shared/`。

package/templates/default-workspace/books/04-reference-manual/chapters/03-xref-patterns.adoc

@@ -0,0 +1,20 @@
+[#xref-patterns]
+== 引用模式
+
+书内引用使用本书内 anchor：
+
+[source,asciidoc]
+----
+xref:#decision-table[结构选择表]
+----
+
+跨书引用写向 AsciiDoc 源文件：
+
+[source,asciidoc]
+----
+xref + : + ../other-book/book.adoc#stable-anchor[目标章节]
+----
+
+上面的写法用分段文本展示，避免默认样本之间形成真实链接依赖。实际写作时去掉空格和加号，写成一个完整的 cross reference 宏。
+
+被跨书引用的位置应写显式 anchor。显式 anchor 是维护者可以稳定依赖的目标。

package/templates/default-workspace/books/04-reference-manual/chapters/04-growth-paths.adoc

@@ -0,0 +1,8 @@
+[#growth-paths]
+== 工作区增长路径
+
+当前模板只把已经服务样本书、公共文档或脚本的目录放入源目录树。
+
+当工作区规模增长时，先记录新的现实约束，再决定是否调整结构。典型触发条件包括：多本书共同维护同一资源、构建步骤需要统一封装、或读者需要更强的导航与版本切换。
+
+这些增长路径应先进入参考手册或设计文档，再进入根目录结构。

package/templates/default-workspace/books/04-reference-manual/frontmatter/preface.adoc

@@ -0,0 +1,3 @@
+== 前言
+
+本书是查阅型参考手册。它用表格、定义列表和模式说明帮助维护者判断书籍边界、路径归属和引用写法。

package/templates/default-workspace/books/05-upper-volume/backmatter/bibliography.adoc

@@ -0,0 +1,3 @@
+== 参考资料
+
+* [[[upper-volume]]] 《示例长书：上册》, 本工作区内部书稿。

package/templates/default-workspace/books/05-upper-volume/book.adoc

@@ -0,0 +1,23 @@
+= 示例长书：上册
+作者 <author@example.com>
+v0.1, 2026-05
+:doctype: book
+:toc: left
+:toclevels: 3
+:sectnums:
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+
+include::../../shared/attributes.adoc[]
+
+[preface]
+include::frontmatter/preface.adoc[]
+
+include::chapters/01-upper-opening.adoc[]
+
+include::chapters/02-upper-core-model.adoc[]
+
+[bibliography]
+include::backmatter/bibliography.adoc[]

package/templates/default-workspace/books/05-upper-volume/chapters/01-upper-opening.adoc

@@ -0,0 +1,4 @@
+[#upper-opening]
+== 上册开篇
+
+上册负责建立分卷系列的基础讨论。它不是下册的 part，而是一本文档边界独立的 book。

package/templates/default-workspace/books/05-upper-volume/chapters/02-upper-core-model.adoc

@@ -0,0 +1,4 @@
+[#upper-core-model]
+== 上册核心模型
+
+本章提供下册可以稳定引用的核心模型。跨卷引用应指向显式 anchor。

package/templates/default-workspace/books/05-upper-volume/frontmatter/preface.adoc

@@ -0,0 +1,3 @@
+== 前言
+
+本书是独立分卷的上册样本。它有自己的入口、前言、章节和参考资料。

package/templates/default-workspace/books/06-lower-volume/backmatter/bibliography.adoc

@@ -0,0 +1,3 @@
+== 参考资料
+
+* [[[upper-volume]]] 样本 `05-upper-volume` 展示上册入口和核心模型 anchor。

package/templates/default-workspace/books/06-lower-volume/book.adoc

@@ -0,0 +1,24 @@
+= 示例长书：下册
+作者 <author@example.com>
+v0.1, 2026-05
+:doctype: book
+:toc: left
+:toclevels: 3
+:sectnums:
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+:upper-book: ../05-upper-volume/book.adoc
+
+include::../../shared/attributes.adoc[]
+
+[preface]
+include::frontmatter/preface.adoc[]
+
+include::chapters/01-lower-opening.adoc[]
+
+include::chapters/02-cross-volume-practice.adoc[]
+
+[bibliography]
+include::backmatter/bibliography.adoc[]

package/templates/default-workspace/books/06-lower-volume/chapters/01-lower-opening.adoc

@@ -0,0 +1,4 @@
+[#lower-opening]
+== 下册开篇
+
+下册可以延续上册中的核心模型，并进入实践讨论。默认样本只说明跨卷关系，不对上册建立真实链接依赖。

package/templates/default-workspace/books/06-lower-volume/chapters/02-cross-volume-practice.adoc

@@ -0,0 +1,11 @@
+== 跨卷实践
+
+下册通过属性保存上册入口路径。这样引用目标集中在 `book.adoc` 中维护，章节正文只表达语义关系。
+
+[source,asciidoc]
+----
+:upper-book: ../05-upper-volume/book.adoc
+xref + : + {upper-book}#upper-core-model[上册核心模型]
+----
+
+实际写作时去掉 `xref` 后面的空格和加号，写成一个完整的 cross reference 宏。

package/templates/default-workspace/books/06-lower-volume/frontmatter/preface.adoc

@@ -0,0 +1,3 @@
+== 前言
+
+本书是独立分卷的下册样本。它引用上册，同时保留自己的入口、章节和参考资料。

package/templates/default-workspace/catalog.adoc

@@ -0,0 +1,68 @@
+= AsciiDoc 多书工作区
+作者 <author@example.com>
+v0.1, 2026-05
+:toc: left
+:toclevels: 2
+:icons: font
+:experimental:
+:idprefix:
+:idseparator: -
+
+本页是样本书导航。每本书代表一种常见书籍组织场景。
+
+== 按目标选择
+
+[cols="1,2,3", options="header"]
+|===
+|如果你想... |先看 |原因
+
+|认识一本完整 AsciiDoc book 的结构位置
+|xref:books/00-book-anatomy/book.adoc[00 完整书籍结构标本]
+|它集中展示前置、正文、分部和后置结构。
+
+|复制一个普通单书起点
+|xref:books/01-starter-book/book.adoc[01 日常独立单书]
+|它保持最常用、最少负担的 book 结构。
+
+|在同一本书里组织第一部、第二部
+|xref:books/02-multipart-monograph/book.adoc[02 长书分部]
+|它展示 book doctype 下的 part 与 partintro。
+
+|写带代码、图表、共享资源的技术书
+|xref:books/03-technical-book-workflow/book.adoc[03 技术书工作流]
+|它展示资源边界、图表和构建检查。
+
+|查结构选择、术语和写法模式
+|xref:books/04-reference-manual/book.adoc[04 参考手册]
+|它是查阅型书，而不是线性教程。
+
+|组织可独立发布的上册
+|xref:books/05-upper-volume/book.adoc[05 上册]
+|它展示分卷上册作为独立 book 的入口。
+
+|组织可独立发布的下册
+|xref:books/06-lower-volume/book.adoc[06 下册]
+|它用文本示例说明跨卷引用写法，但不真实依赖上册。
+|===
+
+== 样本书
+
+* xref:books/00-book-anatomy/book.adoc[00 完整书籍结构标本]：覆盖 book 的前置、正文、分部和后置结构。
+* xref:books/01-starter-book/book.adoc[01 日常独立单书]：新增普通 book 的复制起点。
+* xref:books/02-multipart-monograph/book.adoc[02 长书分部]：同一本 book 内部的 part 结构。
+* xref:books/03-technical-book-workflow/book.adoc[03 技术书工作流]：图表、代码片段和资源边界。
+* xref:books/04-reference-manual/book.adoc[04 参考手册]：结构选择、路径规则和引用模式。
+* xref:books/05-upper-volume/book.adoc[05 上册]：独立分卷的上册。
+* xref:books/06-lower-volume/book.adoc[06 下册]：独立分卷的下册，并用示例说明跨卷引用写法。
+
+== 工作区地图
+
+image::shared/images/workspace-map.svg[多书工作区结构]
+
+== 书籍边界速判
+
+* 只是同一本书内部的第一部、第二部：看 xref:books/02-multipart-monograph/book.adoc[02 长书分部]。
+* 上册需要独立入口和独立构建：看 xref:books/05-upper-volume/book.adoc[05 上册]。
+* 下册需要说明跨卷引用写法但不制造默认依赖：看 xref:books/06-lower-volume/book.adoc[06 下册]。
+* 新增一本普通书：从 xref:books/01-starter-book/book.adoc[01 日常独立单书] 开始。
+* 查路径、引用和增长规则：看 xref:books/04-reference-manual/book.adoc[04 参考手册]。

package/templates/default-workspace/gitignore.template

@@ -0,0 +1,8 @@
+node_modules/
+build/
+coverage/
+dist/
+playwright-report/
+test-results/
+tmp/
+*.log