如何从外部文件创建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？如果没有，我可以用什么样式/块/什么来尽可能地模仿TOC的风格？

Answer 1

是的，但是它可能无法达到您的预期目的。

= Document
:toc:

== link:part1.adoc[Part 1]

== link:part2.adoc[Part 2]

== link:part3.adoc[Part 3]

这将产生一个目录，但是其链接指向同一文件中的标题：这就是: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样式的全面再现，但希望它们足以向您展示方法。

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