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

Question

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

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

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

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

Answer 1

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

[[documentation]]和[[Help|get help]]风格链接是wikilinks并且通常只用于维基。它们不是标准Markdown语法的一部分，并且不受Jekyll（GitHub Pages在底层使用）的支持。请注意，GitHub Wiki支持both styles，所以如果你喜欢，你可以在导入之前编辑你的链接。

无论任何，你需要编辑您的链接手动指向相应的网页：

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

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

Answer 2

刚刚收到这从GitHub直接。

---

有没有简单的答案我很害怕。您需要脚本或手动将wiki格式URL更改为正确的降价格式。

我们所做的仅仅是添加相对链接到GitHub的页面，但：

https://github.com/blog/2290-relative-links-for-github-pages

这将使事情至少更容易，因为你不会需要完全限定所有的URL。

所以你可以改变：

Read the [[documentation]] or [[Help|get help]].

到

Read the [documentation](documentation.md) or [Help](get%20help.md).

或者，您可以使用pandoc和下面的脚本来执行转换为你：

https://github.com/philipashlock/mediawiki-to-markdown

但我没有自己测试过，所以我不能保证它能正常工作。

这可能是非常有用的功能了，所以我将与球队在一个简单的转换器的希望在未来

分享