10

我是否能够以与当前查看降价文件相同的方式在 github 上显示 asciidoc 文件?根据这个博客条目,我应该能够做到这一点:

如果您对使用 AsciiDoc 感兴趣,请前往 GitHub 并使用文件扩展名 .asciidoc 或 .adoc 在您的存储库或 gist 中创建一个新文件。

但是我试图这样做,但没有奏效。谁能告诉我如何获取 asciidoc 文档以在 Github 上显示格式良好的文本?

这是我试图用 Asciidoc 测试的文档。 https://github.com/00krishna/proj_blog/blob/master/test.adoc

4

2 回答 2

11

您的文件在语法上无效(或者该行被视为纯文本)。

您的原始文件:

==This is a test
this is a test of using asciidoc

==;后面没有空格 我相信这是必需的。

正确显示的修改版本:

== This is a test
this is a test of using asciidoc

请参阅test.adoctest2.adoc此要点中。

此功能的语法“单行标题”记录在Asciidoc 用户指南11.2 节中。

于 2015-06-17T21:40:52.530 回答
1

作为已接受答案的补充,Github(或至少 Github 的 Wiki 部分)仅接受.asciidoc后缀。.adoc并且.ad似乎不起作用。我之所以遇到此问题,是因为我尝试手动将 wiki 中的页面从.mdto更改为.ad,但它们不会呈现,因此如果您的问题仍然存在,请检查此问题。

于 2019-01-14T23:42:03.007 回答