HTMLBook 参数大全20 个 XSLT 参数深度定制你的出版流水线【免费下载链接】HTMLBookLets write books in HTML!项目地址: https://gitcode.com/gh_mirrors/ht/HTMLBookHTMLBook 参数是 HTMLBook 开源项目中威力最大的部分——它让你在不改动任何 XSLT 模板的前提下仅靠一行参数配置就能控制目录、索引、交叉引用、脚注和 EPUB 输出的方方面面。HTMLBook 是一个基于 XHTML5 的开放出版标准核心哲学是用 HTML 写书而 htmlbook-xsl 就是它的官方 XSLT 出版流水线。本文整理了一份 HTMLBook 参数大全覆盖 20 个高频 XSLT 参数帮你把这条出版流水线调教成自己的专属工具。HTMLBook 是什么用 HTML 写书的开源出版流水线HTMLBook 是 XHTML5 的一个子集不引入任何 HTML5 规范之外的标签却通过data-type属性为书籍语义章节、前言、附录、索引等提供了完整的表达方式。你写好的 HTML 书稿经过 htmlbook.xsl 这个主模板处理就能自动生成目录TOC、索引Index和交叉引用XREF再叠加 epub.xsl 还能直接产出 EPUB 电子书。所有 XSLT 参数的总开关都集中在 param.xsl 这一个文件里每个参数都带注释和默认值阅读体验非常友好。项目还附带了完整的 HTMLBook 示例书稿 和 XML Schema 校验文件上手门槛很低。快速上手XSLT 参数在哪里配置想立刻动手实验先拿到项目源码git clone https://gitcode.com/gh_mirrors/ht/HTMLBook传参方式很简单在命令行调用 XSLT 处理器时用param参数覆盖默认值即可例如把chunk.level设为 1。所有参数都在 param.xsl 中声明并给出默认值本文表格中标注的默认值就是它第 8 行注释所说的all htmlbook-xsl params, and their default values。主流水线的协作关系是htmlbook.xsl通过xsl:include引入param.xsl、tocgen.xsl、indexgen.xsl、xrefgen.xsl 四个子模块分别负责目录、索引和交叉引用的自动生成分工非常清晰。目录自动生成参数定制你的专属 TOC目录是书的门面HTMLBook 的目录参数主要控制要不要生成、生成多深、是否带编号XSLT 参数默认值作用autogenerate-toc1是否自动生成目录toc.section.depth2目录包含到第几级章节0 表示只到章级toc-include-title0自动生成的目录是否带标题toc-include-labels0目录条目是否带章节编号toc-placeholder-overwrite-contents0是否覆盖目录占位元素中的现有内容inline.markup.in.toc1目录中是否保留行内标记如code实践中最常用的是toc.section.depth技术手册通常设 2~3 级小说只要 1 级一行参数就能切换目录详略。交叉引用参数让书内链接自动编号写书时最痛苦的就是见第 3 章这种手动编号——章节一调整全要改。HTMLBook 用xref参数把这件事变成了全自动XSLT 参数默认值作用autogenerate-xrefs1是否自动生成交叉引用xref.type.for.section.by.data-type章节用编号各类型章节的引用样式编号 / 编号标题 / 仅标题autogenerate.xref.pagenum.style1是否为分页输出自动生成页码样式属性xref.pagenum.style.for.section.by.data-type章节用 decimal各类型章节的页码样式罗马/阿拉伯数字等url.in.parens1外部链接在印刷输出时是否在括号中显示 URL比如想把附录引用改成附录 A 完整指南的样式只需在xref.type.for.section.by.data-type中把appendix一行的值改为xref-number-and-title。索引参数自动生成专业书籍索引出版级图书必备的索引HTMLBook 也能自动生成。默认开启但细节可调XSLT 参数默认值作用autogenerate-index1是否自动生成索引index.on.role0是否按role属性维度生成索引index.on.type0是否按type属性维度生成索引index.links.to.section0索引条目是否链接到章节而非具体位置index-placeholder-overwrite-contents0是否覆盖索引占位元素中的内容搭配index.term.separator、index.number.separator、index.range.separator三个分隔符参数还能精确控制索引条目中页码的分隔样式。章节编号与标签参数控制编号格式书籍的编号体系是出版格式的重头戏HTMLBook 用一组参数就能定义第几章、第几节的显示规则XSLT 参数默认值作用autogenerate.labels0HTML 输出是否自动生成章节标签label.numeration.by.data-typechapter:1 等各类型章节的编号格式A/I/1 等label.section.with.ancestors0节级编号是否带上祖先编号如 3.1label.formal.with.ancestor1图/表/示例编号是否带章号如 3-1label.and.title.separator. 标签与标题之间的分隔符intralabel.separator.标签内部各段之间的分隔符autogenerate.pdf.bookmark.labels1PDF 书签是否自动生成标签脚注参数脚注处理全自动脚注在图书中非常常见HTMLBook 默认不处理开启后会自动把脚注内容移到章节末尾并生成上标链接XSLT 参数默认值作用process.footnotes0是否处理脚注拆分标记并移到节末process.footnote.callouts.only0是否只生成上标脚注标记footnote.numeration.format1普通脚注的编号格式table.footnote.numeration.formata表格脚注的编号格式字母footnote.reset.numbering.at.chapter.level1是否在章级重置脚注编号分块输出参数一键拆分多文件 HTML一本书动辄几十章全塞进一个 HTML 文件会卡到爆。chunk模块chunk.xsl负责把书稿拆分成多个 HTML 文件是 EPUB 和网页在线阅读的基础XSLT 参数默认值作用chunk.level0拆分粒度0 表示按 part/chapter/appendix 拆分1-5 对应到各级节generate.root.chunk0是否生成根入口文件root.chunk.filenameindex.html根入口文件名output.filename.prefix.by.data-typechapter:ch 等各类型章节的输出文件前缀如ch01.htmlEPUB 电子书出版参数从 HTML 直达电子书epub.xsl 是 EPUB 生成的核心它内部引入了 ncx.xsl导航文件和 opf.xsl元数据文件并通过opf.namespace参数默认http://www.idpf.org/2007/opf控制 OPF 命名空间。配合 stylesheets/epub/epub.css 排版样式以及 mobi.css、pdf.css 等配套样式同一份 HTML 书稿可以轻松输出 EPUB、Mobi 和 PDF 三种形态。本地化参数让书说 60 种语言HTMLBook 内置了惊人的本地化支持localizations/ 目录下躺着 60 多个语言的 XML 文件含 zh.xml、zh_cn.xml 等中文资源XSLT 参数默认值作用book-language自动检测lang书籍语言用于选择本地化文件localizations-dirlocalizations/本地化文件所在目录book-language会优先从书稿html或body的lang属性自动推断找不到时才回退到英文非常贴心。其他实用参数速查表还有一批小而美的参数值得收藏XSLT 参数默认值作用number.code.lines0代码清单是否全局加行号add.title.heading.for.admonitions0为提示框note/tip/warning自动加标题html4.structural.elements0是否把section/figure降级为div兼容老设备figure.border.div0是否在figure内包一层div方便样式化css.filename空输出 HTML 头部链接的 CSS 文件名verbose0是否输出详细日志show-comments0是否在书稿中显示批注内容总结开始你的 HTMLBook 出版流水线从目录、索引、交叉引用到脚注、分块、EPUB 输出HTMLBook 参数几乎覆盖了出版流程的每个环节。这些参数全部集中在 param.xsl 中改一行、看一次效果很快就能摸清规律。建议从autogenerate-toc、toc.section.depth和chunk.level三个参数入手配合项目自带的 示例书稿 体验改参数→重新转换→看输出的完整循环。掌握了这份 HTMLBook 参数大全你的 HTML 写书之旅就已经赢在起跑线上了 【免费下载链接】HTMLBookLets write books in HTML!项目地址: https://gitcode.com/gh_mirrors/ht/HTMLBook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考