参考手册

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

资源只有在被 catalog 或多本书实际引用时才进入 shared/。

书内引用使用本书内 anchor：

跨书引用写向 AsciiDoc 源文件：

上面的写法用分段文本展示，避免默认样本之间形成真实链接依赖。实际写作时去掉空格和加号，写成一个完整的 cross reference 宏。

被跨书引用的位置应写显式 anchor。显式 anchor 是维护者可以稳定依赖的目标。

当前模板只把已经服务样本书、公共文档或脚本的目录放入源目录树。

当工作区规模增长时，先记录新的现实约束，再决定是否调整结构。典型触发条件包括：多本书共同维护同一资源、构建步骤需要统一封装、或读者需要更强的导航与版本切换。

这些增长路径应先进入参考手册或设计文档，再进入根目录结构。