我可以像现在查看markdown文件一样在github上显示asciidoc文件吗?根据这个博客entry,我应该能够做到这一点:
如果您有兴趣使用AsciiDoc,请访问GitHub,并使用文件扩展名.asciidoc或.adoc在您的存储库或要点中创建一个新文件。
但是,我试图这样做,但没有成功。谁能告诉我如何获取asciidoc文档以在Github上显示格式正确的文本?
这是我尝试使用Asciidoc测试的文档。
https://github.com/00krishna/proj_blog/blob/master/test.adoc
最佳答案
您的文件在语法上无效(或者该行被视为纯文本)。
您的原始文件:
==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中记录了此功能的语法“单行标题”。