asciidoctor - Asciidoctor 嵌套表

Question

我正在尝试在我的 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但无济于事。

Answer 1

请注意，Asciidoc 和 Asciidoctor不是一回事。因此，请确保您正在查看正确的文档。

我还没有尝试过，但是如果嵌套表要工作，则包含它的单元格将必须使用 asciidoc样式。然后，您很可能会将表格放在一个块中并转义所有管道符号（使用 \| 而不是 | 或使用其他分隔符）。

网络搜索在 AsciiDoctor 跟踪器中发现了这个未解决的问题，请求（改进）嵌套表支持。因此，至少在某些后端，这似乎还没有实现。第一条注释包含如何指定嵌套表的示例。

你确定你不能使用嵌套表以外的东西吗？它们通常不是最易读的东西。

Answer 2

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

[宽度="75%",cols="1,2a"]
|================================================
|普通单元格 |带有嵌套表格的单元格

[cols="2,1"]
!===============================================
!嵌套表格单元格 1 !嵌套表格单元格 2
!===============================================

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

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

Asciidoctor.js 来自创建和维护 Asciidoctor 的同一个伟大团队，因此它拥有最新的 Asciidoctor。