我可以在 github 中显示 asciidoc 文档吗?
Can I display asciidoc document in github?
我能否在 github 上以与当前查看 markdown 文件相同的方式显示 asciidoc 文件?根据这个博客entry,我应该可以做到:
If you’re interested in using AsciiDoc, head over to GitHub and create a new file in one of your repositories or gists using the file extension .asciidoc or .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
==
后面没有space;我认为这是必需的。
正确显示的修改版本:
== This is a test
this is a test of using asciidoc
参见 this Gist 中的 test.adoc
和 test2.adoc
。
此功能的语法 "One line titles" 记录在 Asciidoc user guide, section 11.2。
作为已接受答案的补充,Github(或至少 Github 的 Wiki 部分)仅接受 .asciidoc
后缀。 .adoc
和 .ad
似乎不起作用。我之所以遇到这个,是因为我试图手动将 wiki 中的页面从 .md
更改为 .ad
,但它们不会呈现,所以如果您的问题仍然存在,请检查此内容。
我能否在 github 上以与当前查看 markdown 文件相同的方式显示 asciidoc 文件?根据这个博客entry,我应该可以做到:
If you’re interested in using AsciiDoc, head over to GitHub and create a new file in one of your repositories or gists using the file extension .asciidoc or .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
==
后面没有space;我认为这是必需的。
正确显示的修改版本:
== This is a test
this is a test of using asciidoc
参见 this Gist 中的 test.adoc
和 test2.adoc
。
此功能的语法 "One line titles" 记录在 Asciidoc user guide, section 11.2。
作为已接受答案的补充,Github(或至少 Github 的 Wiki 部分)仅接受 .asciidoc
后缀。 .adoc
和 .ad
似乎不起作用。我之所以遇到这个,是因为我试图手动将 wiki 中的页面从 .md
更改为 .ad
,但它们不会呈现,所以如果您的问题仍然存在,请检查此内容。