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的风格?
答案 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。