警告:在toc的后端epub3中缺少转换

Question

我正在使用asciidoctor来创建一个PDF，它运行得很好。但是，当我使用asciidoctor- epub 3将其转换为epub时，它会显示一条警告消息：

asciidoctor:警告:在toc的后端epub3中缺少转换

但是，toc被添加到生成的epub中，我不知道为什么会看到这个警告。

这是再现问题的最小.adoc文件。

= Book title
:doctype: book
:toc: macro

toc::[]

Answer 1

Asciidoctor epub3 3 增加了对内联TOC的支持在v1.5.0中，尊重:toc:属性。

如果您使用set :toc:属性，您的epub将有一个内联目录，内容表就在“封面”/“前沿”页面之后。

但是，对自定义放置的TOC 仍在进行中的支持。因此，如果您设置了:toc: macro，然后与toc::[]一起使用它将您的TOC放在一个自定义位置，它将被忽略，并在编译期间显示警告消息。

asciidoctor:警告:在toc的后端epub3中缺少转换

因此，尽管有这样的警告，你的TOC仍然在你的酒吧，但在一个固定的位置。

为了避免此警告，可以使用条件包装toc代码：

= Book title
:doctype: book
:toc: macro

//...

ifdef::backend-pdf[]
// add custom placed toc only in pdf
toc::[]
endif::[]