Asciidoc角色和gitbook

Question

我试图将Gitbook与AsciiDoc一起使用（运行Win10x64，NodeJS 6.9.1和Gitbook v3.2.2） - 我对它们都不熟悉。

The Gitbook documentation says从v2.0.0开始支持AsciiDoc并链接到AsciiDoctor documentation - 我已检查过节点包，gitbook依赖gitbook-asciidoc依次为asciidoctor.js取决于[.text-center]。

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

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

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

我在这里想到的有关AsciiDoctor角色和样式表的内容是什么？

编辑：gitbook是gitbook的devDependency，实际上并未与align="center"一起安装。 frame="none"记录了grid="none"，但其他功能（如表格样式（至少gitbook和{{1}}）似乎不适用于{{1}} }。

如果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主题中使用。