在 Standard Ebooks 项目中,XHTML 文件的命名遵循严格的文件系统布局规范,旨在确保电子书结构的清晰与一致性。所有包含正文的 XHTML 文件均存放于 ./src/epub/text/ 目录下,且必须以.xhtml 结尾。
对于独立作品或单幕剧,文件名直接使用作品的 URL 安全标题(不含副标题),例如《The Variable Man》对应 the-variable-man.xhtml。若作品分为多个部分(如卷、部),则使用 part-N.xhtml 或 book-N.xhtml 命名,其中 N 从 1 开始递增。
章节文件的命名取决于其是否分卷及编号规则:
1. **不分卷的连续章节**:统一命名为 chapter-N.xhtml,N 为全局连续序号(如 chapter-1.xhtml, chapter-2.xhtml)。
2. **分卷且每卷重置编号**:采用 chapter-X-N.xhtml 格式,X 代表卷号(part number),N 代表该卷内的章节号(如 chapter-1-1.xhtml 表示第一卷第一章)。
3. **分卷但不重置编号**:仍使用 chapter-N.xhtml,其中 N 为全局连续序号(如第二卷的第一章若全局是第 4 章,则命名为 chapter-4.xhtml)。
对于极短的作品集合(如诗集),通常将所有内容合并为一个文件,文件名同样基于作品标题。前言、后记等前后置内容按类型命名(如 preface.xhtml),若存在多个同类内容,则在文件名后加序号(preface-1.xhtml, preface-2.xhtml)。
此外,除封面图外的插图文件需命名为 illustration-N,N 为其在书中出现的顺序。所有命名均避免前导零,并严格匹配 URL 安全字符要求,以确保构建与分发的稳定性。