Asciidoc角色和手册

Question

我正在尝试在AsciiDoc中使用Gitbook (运行Win10x64，NodeJS 6.9.1和Gitbook v3.2.2) --我对这两个版本都很陌生。

自从v2.0.0和链接到Gitbook文档上说，AsciiDoc就被支持了--我检查了节点包，gitbook依赖于gitbook-asciidoc，而gitbook-asciidoc又依赖于asciidoctor.js。

根据文档，可以使用AsciiDoc角色对图像和表进行样式化。它们引用应用于HTML元素的类，这些类是在默认的AsciiDoctor系统样式表中定义的。

但是，无论我如何尝试应用角色，例如对图像( [.text-center]速记或[role="text-center"] )，我都得不到预期的输出(即以水平为中心的图像)。我唯一能让它为图像工作的方法是设置一个属性align="center"，这一点甚至没有文档化。

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

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

编辑：asciidoctor.js是gitbook的devDependency，实际上没有与gitbook一起安装。align="center"在AsciiDoc文档中有记录，但其他特性，比如表样式(至少frame="none"和grid="none")，似乎不适用于gitbook。

如果不支持…，我仍然不明白为什么Gitbook文档链接回助理医生的文档

Answer 1

在AsciiDoc中使用GitBook语法时，AsciiDoctor用于将AsciiDoc语法转换为AsciiDoc。然后，HTML使用GitBook，因为您使用的是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主题中工作的准备。