企业官网建设流程全解析

HTMLBook 自动索引生成指南：像专业出版社一样快速制作书后索引

【免费下载链接】HTMLBookLet's write books in HTML!项目地址: https://gitcode.com/gh_mirrors/ht/HTMLBook

写书最繁琐的环节之一，就是制作书后索引（Index）——把全书的关键词按字母顺序整理、标注页码、处理"参见"关系，传统上需要大量人工。而HTMLBook 自动索引生成功能，可以让你像专业出版社一样，在几秒钟内完成这项工作。HTMLBook 是一个基于 XHTML5 的开源图书创作标准，主张"用 HTML 写书"（Let's write books in HTML!），它为作者提供了一整套从写作到出版的工具链。本指南将带你从零开始，掌握 HTMLBook 索引生成的核心用法。

什么是 HTMLBook？用 HTML 写书的现代方案 📚

HTMLBook 是 O'Reilly 发起的开放图书创作标准，它的核心思想很简单：书籍是永恒的，HTML 是当下最通用的标记语言。HTMLBook 是 XHTML5 的一个子集，没有引入任何 XHTML5 之外的标签或属性，只是从语义上针对图书结构做了定制——从章节、小节、插图、表格、术语表，到你关心的索引（index），都能用语义化的 HTML 标记来表达。

因为全部是标准 HTML，你可以用任何文本编辑器写作，用浏览器实时预览，还能通过配套的 XSL 样式表一键转换为 EPUB、Mobi、PDF 等出版格式。项目的核心源码就包含这些转换逻辑，其中索引生成的实现位于 indexgen.xsl，入口转换样式表是 htmlbook.xsl，所有可调参数定义在 param.xsl。

书后索引为什么重要？专业出版的"门面工程" 🔍

书后索引（back-of-book index）是专业出版物的标志。读者查找某个概念时，第一反应就是翻到书末看索引；编辑评估一本书的专业度，也常从索引质量入手。一本没有索引的技术书，就像没有目录的字典——内容再好也难以检索。

但在传统工作流里，索引制作是出了名的耗时：作者要手工标注词条，排版人员要逐条核对页码，改一次版式索引就要重做一遍。这就是HTMLBook 自动索引生成的价值所在：你只需要在正文里埋好索引标记，HTMLBook 会自动完成按字母分组、排序、去重、生成页码链接的全部工作，而且每次重新转换都会自动更新，永不错位。

HTMLBook 自动索引生成原理：标记一次，索引自动 🛠️

HTMLBook 的索引机制非常简单：你在正文中用<a>标签标记索引词，然后放一个空的索引章节占位符，转换时 XSLT 就会扫描全书的标记，自动生成完整的索引。

索引标记的核心写法：

<a><section><p>本小节介绍排版规范<a><section><a><a contenteditable="false">【免费下载链接】HTMLBookLet's write books in HTML!项目地址: https://gitcode.com/gh_mirrors/ht/HTMLBook