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

Question

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

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

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

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

Answer 1

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

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

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

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

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