温馨提示:本文翻译自stackoverflow.com,查看原文请点击:markdown - How to convert GitHub Wiki into GitHub pages?
github Markdown wiki

markdown - 如何将GitHub Wiki转换为GitHub页面?

发布于 2020-04-16 12:36:24

我希望将现有的GitHub Wiki用作GitHub页面。

我尝试将所有.md文件复制到其中/docs并将其设置为页面的来源 -但它破坏了所有内部链接。

所以我看到的Read the [[documentation]] or [[Help|get help]].不是链接。

将Wiki托管在GitHub页面上的最简单方法是什么?

查看更多

提问者
Terence Eden
被浏览
85
Waylan 2016-12-16 22:32

您需要创建指向每个页面的手动Markdown链接。

[[documentation]][[Help|get help]]链接样式是wikilinks一般只有在维基使用。它们不是标准Markdown语法的一部分,并且不受Jekyll支持(GitHub Pages在后台使用)。请注意,GitHub Wiki支持这两种样式,因此您可以根据需要在导入之前编辑链接。

无论哪种方式,您都需要编辑链接以手动指向相应的页面:

Read the [documentation](path/to/documentation/) or [Help](path/to/get_help.html]

当然,您将需要调整以上路径以指向正确的位置。或者,您可以使用Jekyll 永久链接,这可以为您提供无需指定完整路径即可识别特定页面的快捷方式。