asciidoc - 如何从外部文件创建 Asciidoc 目录？

Question

Asciidoc :toc:命令从文档中的标题创建一个格式良好的目录:

:toc:

= Part 1

= Part 2

= Part 3

但我希望我的目录链接到其他文档，而不是从文档本身中提取:

link:part1.adoc[Part 1]

link:part2.adoc[Part 2]

link:part3.adoc[Part 3]

有没有办法从链接到其他文件创建目录？如果不是，我可以使用什么样式/块/什么来尽可能地模仿 TOC 的样式？

Answer 1

是的，但是，它可能不会按照您的预期运行。

= Document
:toc:

== link:part1.adoc[Part 1]

== link:part2.adoc[Part 2]

== link:part3.adoc[Part 3]

这会生成一个目录，但它的链接指向同一文件中的标题:这就是 :toc:是为了。标题本身是指向其他文档的链接。

您可以创建自己的列表，但为了近似页面 TOC 的样式，您需要创建一个 docinfo.html包含您要使用的 CSS 的文件:

<style>
.mytoc ul {
  list-style-type: none;
  margin-left: 0;
  font-family: sans-serif;
}

.mytoc li {
  margin: 0;
  padding: 0;
}
</style>

并指定您要使用 docinfo文件:

= Document
:docinfo: shared

[.mytoc]
== Table of Contents

* link:part1.adoc[Part 1]

* link:part2.adoc[Part 2]

* link:part3.adoc[Part 3]

请注意，我包含的样式并不是对页面 TOC 样式的全面再现，但希望它们足以向您展示方法。

见 https://asciidoctor.org/docs/user-manual/#docinfo-file有关 docinfo 的更多信息文件。