You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何使用Asciidoc将目录放置在第三页而非标题页后第二页?

解决Asciidoc自定义目录(TOC)位置的问题

嘿,我来帮你搞定这个目录位置的问题~你之前的尝试没成功,是因为:toc:是全局属性,默认会在文档标题页后自动生成目录,单独加一个「Table of contents」章节再放这个属性是不起作用的。要把目录放到第三页,咱们得用手动插入目录宏结合硬分页符的方法,具体步骤如下:

正确实现步骤

  1. 先去掉文档开头的:toc:属性(避免自动生成默认位置的目录);
  2. 用<<<添加硬分页符,确保前言内容占满第二页;
  3. 在分页符之后,用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.26 08:31:34