Asciidoc 角色和 gitbook

Question

我正在尝试将 Gitbook 与 AsciiDoc 一起使用（运行 Win10x64、NodeJS 6.9.1 和 Gitbook v3.2.2）——我对它们都是新手。

The Gitbook documentation says AsciiDoc 从 v2.0.0 开始支持并链接到 AsciiDoctor documentation — 我检查了节点包，gitbook 依赖于 gitbook-asciidoc，而 asciidoctor.js 又依赖于 asciidoctor.js。

根据文档，AsciiDoc 角色可用于设置图像和表格的样式。它们指的是应用于 HTML 元素的类，这些类在默认 AsciiDoctor 样式表中定义。

但无论我如何尝试应用角色，例如图像（[.text-center] 速记或[role="text-center"]，我都没有得到预期的输出（即图像水平居中）。我唯一的方法是可以通过设置属性 align="center" 使其适用于图像，这甚至没有记录。

通过在我的浏览器中检查输出，我可以看到类已应用于 HTML 元素，但没有匹配的 CSS 规则 — 就我尝试过的表格样式而言也是如此。

关于 AsciiDoctor 角色和样式表，我在这里遗漏了什么？

编辑：asciidoctor.js 是 gitbook 的 devDependency，实际上并没有与 gitbook 一起安装。 align="center" 记录在 AsciiDoc documentation 中，但表格样式等其他功能（至少 frame="none" 和 grid="none"）似乎不适用于 gitbook。

如果 Gitbook 文档不受支持，我仍然不明白为什么它会链接回 AsciiDoctor 的文档……

Answer 1

在 GitBook 中使用 AsciiDoc 语法时，AsciiDoctor 用于将 AsciiDoc 语法转换为 HTML。 HTML 然后使用 GitBook CSS，因为您使用的是 GitBook 主题而不是 AsciiDoctor 主题。这意味着您不会获得默认的 AsciiDoctor 样式。

在 GitBook 中添加自己的样式很容易。在您的 book.json 中，指定一个额外的样式表：

"styles": {
  "website": "styles/mystyles.css"
},

然后，创建 styles/mystyles.css 以便它包含您要使用的 CSS 样式：

.text-center {
  text-align: center;
}

您可以将样式从 AsciiDoctor 样式表复制到 styles/mystyles.css，但要准备好调整样式和类以在您正在使用的 GitBook 主题中工作。