如何从外部文件创建Asciidoc目录?

时间:2017-11-09 15:40:16

标签: asciidoc asciidoctor

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

:toc:

= Part 1

= Part 2

= Part 3

enter image description here

但是我希望我的目录链接到其他文档,而不是从文档本身拉出来:

link:part1.adoc[Part 1]

link:part2.adoc[Part 2]

link:part3.adoc[Part 3]

有没有办法从链接到其他文件创建TOC?如果没有,我可以用什么样式/块/什么来尽可能地模仿TOC的风格?

1 个答案:

答案 0 :(得分:0)

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

= 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