如何在 GitHub 上的 AsciiDoc 中的 table 上没有框架

How to get no frame on a table in AsciiDoc on GitHub

我想在 GitHub 上的 AsciiDoc 中制作一个没有框架的 table。我对文档的阅读是这应该有效:

[frame="none",options="header"]
|===
| Foo | Bar
| Widget | Gadget
|===

然而它呈现了一个框架:

那个 frame="none" 设置应该可以。但事实并非如此。我尝试不带引号,它是一样的。 options="header" 工作正常,所以我知道解释器看到括号中的行并采取 some 操作。

GitHub 是否可能运行某些功能不完整的 AsciiDoc 版本?如果是这样,是否有一个网站详细说明了哪些有效,哪些无效?

注意——这是在我们 GitHub Enterprise 的内部企业实例上,因此我们可能有些版本已过时,或者没有安装某些插件。是否有一个特殊的插件可以解决这个问题?我不管理该平台,所以作为普通开发人员,有没有办法可以在任何给定的 GitHub 平台中检查版本和插件?

我们普遍使用 AsciiDoc 作为我们的 GitHub Wiki 语言,所以换成另一种 table 更好的语言不是一种选择。

感谢所有帮助!

GitHub 运行 官方 Asciidoctor 提供了一个很好的渲染。但是,它们还通过过滤过程 运行 生成 HTML 和 CSS 以防止安全问题。在此过程中,他们从各种(如果不是全部)元素中剥离自定义 class 名称(我不知道确切的细节)。

运行 示例文档中的 asciidoctor 显示 table 如下所示:

<table class="tableblock frame-none grid-all stretch">

而他们的过程导致 table 看起来像:

<table>

从 GitHub 的角度来看,这些变化意味着 table 网站上的所有内容看起来都一样。

如果您需要无框 table,您可能会发现使用 GitHub 页面要容易得多,因为您可以在 CSS 中使用自定义(或 asciidoctor-provided)那个语境。