如何使用Asciidoc将目录放置在第三页而非标题页后第二页?
解决Asciidoc自定义目录(TOC)位置的问题
嘿,我来帮你搞定这个目录位置的问题~你之前的尝试没成功,是因为:toc:是全局属性,默认会在文档标题页后自动生成目录,单独加一个「Table of contents」章节再放这个属性是不起作用的。要把目录放到第三页,咱们得用手动插入目录宏结合硬分页符的方法,具体步骤如下:
正确实现步骤
- 先去掉文档开头的
:toc:属性(避免自动生成默认位置的目录); - 用
<<<添加硬分页符,确保前言内容占满第二页; - 在分页符之后,用
toc::[]宏手动插入目录,这样目录就会从第三页开始显示。
示例代码
= My book A book to enjoy == Preface Enjoy my book <<< // 硬分页符:强制前言内容在第二页结束 toc::[] // 手动插入目录,这部分会从第三页开始 <<< // 可选:让目录结束后自动分页,给第一章留新页面 == Chapter One It was the best of times ...
补充细节
<<<是Asciidoc的硬分页指令,能精准控制内容的页面跳转;- 要是你想给目录加明确的标题,可以在
toc::[]上方加== Table of Contents,这样目录顶部会显示对应的标题; - 这个方法在Asciidoctor-PDF等生成工具中完全适用,能稳定控制目录的页面位置。
内容的提问来源于stack exchange,提问作者chriskelly
相关产品推荐
相关产品推荐

