asciidoc - 不在标题页之后立即放置目录

标签 asciidoc asciidoctor

使用 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 的原因是因为我正在复制一个模板,该模板在目录之前有一个部分。

最佳答案

有可能,但并非所有后端都支持 .

设置 :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/

    关于asciidoc - 不在标题页之后立即放置目录,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/50031067/

    相关文章:

    spring - 使用 Asciidoctor Maven 插件以 HTML 格式发布 API 文档时出现 Unresolved 指令错误

    asciidoc - 使用 AsciiDoc include 指令按原样包含内容的更好方法

    asciidoc - Antora 中带有 Supplemental-ui 的自定义 css 不起作用

    formatting - 如何在 asciidoc mathjax 方程中获得粗体和斜体文本?

    haskell - 是否可以将 asciidoc 与 hakyll 一起使用?

    asciidoctor:如何通过文档标题取消设置 bool 属性

    asciidoc - 如何查看asciidoc的渲染结果

    asciidoc - AsciiDoc 中的 Shell 命令

    asciidoc - 如何在 .adoc 文件中将标题跨多行?

    asciidoctor - 如何在 Asciidoctor 中隐藏章节标题?