1

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

Gitbook 文档说从 v2.0.0 开始支持 AsciiDoc，并链接到AsciiDoctor 文档——我检查了节点包，gitbook取决于gitbook-asciidoc哪个又依赖于asciidoctor.js.

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

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

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

关于 AsciiDoctor 角色和样式表，我在这里缺少什么？

编辑：asciidoctor.js是 devDependencygitbook并且实际上没有与gitbook. AsciiDoc文档align="center"中记录了 ，但表格样式（至少and ）等其他功能似乎不适用于.frame="none"grid="none"gitbook

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

4

1 回答 1

3

在 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 主题中工作。

于 2017-08-09T15:17:03.543 回答