在标题页

Question

使用 asciidoc ，我想在第三页上放置目录。充其量，我只能设法把它放在第2页;在标题页之后。

我的期望是这样的事情应该有效：

= My book
A book to enjoy

== Preface
Enjoy my book

== Table of contents
:toc:

== Chapter One
It was the best of times ...

...但目录仍然在第2页结束。

是否可以选择放置目录的位置？

修改

我希望TOC在不同页面上的原因是因为我正在复制一个在目录之前有一个部分的模板。

Answer 1

http://www.methods.co.nz/asciidoc/userguide.html#_page_breaks

  

三个或更多小于（＆lt;＆lt;＆lt;＆lt;＆lt;）字符的行将在DocBook和打印的HTML输出中生成硬分页符

这至少应该让你在正确的页面上。没有双关语。

Answer 2

可能，但并非所有后端都支持。

设置:toc: macro可让您在文档的任何位置使用toc::[]宏。

因为在你的例子中你似乎想要一个自定义的TOC标题，所以我使用:toc-title:来删除默认的TOC标题。

:toc: macro
:toc-title:
= My book
A book to enjoy

== Preface
Enjoy my book

== Table of contents
toc::[]

== Chapter One
It was the best of times ...

有关详细信息，请参阅：

• https://asciidoctor.org/docs/user-manual/#manual-placement
• https://asciidoctor.org/docs/user-manual/#table-of-contents-summary

您可以在此处测试代码：https://asciidoclive.com/