github - 如何将 GitHub Wiki 转换为 GitHub 页面？

Question

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

我尝试将所有 .md 文件复制到 /docs 和 setting that as the source for pages 中- 但它破坏了所有内部链接。

所以我看到阅读[[文档]]或[[帮助|获取帮助]]。而不是链接。

在 GitHub 页面上托管 wiki 的最简单方法是什么？

Answer 1

您需要为每个页面创建手动 Markdown 链接。

[[documentation]] 和 [[Help|get help]] 样式链接为 wikilinks通常只在 wiki 中使用。它们不是标准 Markdown 语法的一部分，并且不受 Jekyll 支持。 (GitHub Pages 在后台使用)。请注意，GitHub Wiki 支持 both styles ，因此您可以根据需要在导入之前编辑链接。

无论哪种方式，您都需要编辑链接以使用标准 Markdown 语法手动指向适当的页面:

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

当然，您需要调整上述路径以指向正确的位置。作为替代方案，您可以使用 Jekyll permalinks ，它可以为您提供识别特定页面的快捷方式，而无需指定完整路径。