Asciidoctor嵌套表

时间:2017-02-26 19:29:31

标签: asciidoctor asciidoctor-pdf

我正在尝试在我的Asciidoctor pdf输出中创建嵌套表,但我找不到语法。

如果我理解正确,从1.5.0开始,Asciidoctor应该支持嵌套表。我正在运行一个具有1.5.5(https://github.com/asciidoctor/docker-asciidoctor)的Docker容器。

我在表11中尝试过这样的示例:http://www.methods.co.nz/asciidoc/newtables.html但无济于事。

2 个答案:

答案 0 :(得分:1)

请注意,Asciidoc和Asciidoctor是not the same thing。 因此,请确保您正在查看correct documentation

我没有尝试过,但是如果嵌套表能够正常工作,那么包含它的单元格必须使用asciidoc style。然后,您很可能将表放在block中并转义所有管道符号(使用\ |而不是|或使用其他分隔符)。

在AsciiDoctor跟踪器中,Web搜索出现了this open issue,请求(改进)嵌套表支持。所以至少在一些后端中似乎还没有实现。第一个注释包含如何指定嵌套表的示例。

您确定不能使用嵌套表格以外的其他内容吗?它们通常不是最易读的东西。

答案 1 :(得分:0)

为了使其正常工作,您需要删除两个意外的换行符。这是修改后的内容。

[width="75%",cols="1,2a"]
|==============================================
|Normal cell  |Cell with nested table

[cols="2,1"]
!==============================================
!Nested table cell 1 !Nested table cell 2
!==============================================

|==============================================

我必须说我是第一次使用asciidoctor-pdf,尽管docker镜像已尽可能简化了该过程,但是有一种更快的方法来获取呈现的反馈:Asciidoctor.js-Chrome扩展程序将您的.adoc文件转换为HTML,并在保存文件时重新加载。

Asciidoctor.js来自创建和维护Asciidoctor的同一支优秀团队,因此它拥有最新的Asciidoctor。