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

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

问题描述:

我希望将我现有的GitHub Wiki作为GitHub页面。如何将GitHub Wiki转换为GitHub页面?

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

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

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

您需要为每个页面创建手动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,它可以为您提供一个快捷方式来标识特定页面,而无需指定完整路径。

刚刚收到这从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

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

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

分享