【发布时间】:2014-05-02 09:30:38
【问题描述】:
我刚刚向 Github 存储库添加了一个 .wiki 文件 (foo.wiki)。令我惊讶的是,它被 Github 渲染为 HTML。
Github 使用哪种 wiki 语法?他们的渲染引擎是什么?
【问题讨论】:
标签: github markdown github-flavored-markdown
我刚刚向 Github 存储库添加了一个 .wiki 文件 (foo.wiki)。令我惊讶的是,它被 Github 渲染为 HTML。
Github 使用哪种 wiki 语法?他们的渲染引擎是什么?
【问题讨论】:
标签: github markdown github-flavored-markdown
除了GFM,GitHub 还支持a number of other markup formats,包括 Textile、Perl Plain Old Documentation、Emacs Org-mode 和 ReStructured Text。
虽然没有明确列出对 .wiki 文件的支持,但 支持 .mediawiki 文件中的 Mediawiki 语法。如果我不得不猜测,我猜.wiki 文件也使用Mediawiki syntax。
编辑:
OP 已确认 .wiki 文件使用 Mediawiki 语法。
【讨论】:
直到昨天(2014 年 5 月 1 日),wiki 编辑器更像是一个纯文本编辑器,支持 GFM (GitHub Flavored Markdown) 的子集(如“GitHub wikis and Markdown”中所述,并在“@987654323”中详细说明@"。
现在这种情况正在发生变化,编辑器应该与用于 GitHub 存储库数据的常规 Ace 编辑器更加一致。
wiki 内容与存储库中其他标记的呈现更加一致
【讨论】:
GitHub 在整个站点中使用“GitHub Flavored Markdown”或 GFM,包括问题、cmets 和拉取请求。它与标准 Markdown (SM) 在一些重要方面有所不同,并增加了一些额外的功能。
如果您还不熟悉 Markdown,请查看 Markdown Basics。如果您想了解更多关于问题、cmets 和拉取请求描述(例如任务列表)中可用的功能,请阅读Writing on GitHub。
On GitHub,你可以看到Markdown和GFM之间的区别:那里有很多信息可以用来掌握GFM和Markdown。
Markdown 由 John Gruber 开发:http://daringfireball.net/projects/markdown/
在 wiki 页面中,您可以使用 MediaWiki 语法,但您没有工具也无法预览结果。
【讨论】:
.wiki 的文件的用途,但不幸的是,它不包含在我链接的列表中。最接近的可能是.mediawiki,如果我不得不猜测,我会猜到。