我可以在github中显示asciidoc文件吗？

Question

我能否以与目前查看降价文件相同的方式在github上显示asciidoc文件？根据这篇博客entry，我应该可以这样做：

  

如果您对使用AsciiDoc感兴趣，请转到GitHub并使用文件扩展名.asciidoc或.adoc在您的某个存储库或列表中创建一个新文件。

但是我尝试这样做但它没有用。谁能告诉我如何获得asciidoc文档在Github上显示格式正确的文本？

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

Answer 1

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

您的原始文件：

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

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

正确显示的修改版本：

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

请参阅this Gist中的test.adoc和test2.adoc。

此功能的语法“单行标题”记录在Asciidoc user guide，section 11.2中。

Answer 2

作为已接受答案的补充，Github（或至少Github的Wiki部分）仅接受.asciidoc后缀。 .adoc和.ad似乎无效。我之所以遇到这种情况，是因为我试图将Wiki中的页面从.md手动更改为.ad，但这些页面无法显示，因此如果问题仍然存在，请进行检查。