如何将GitHub Wiki转换为GitHub页面?
我希望将我现有的GitHub Wiki作为GitHub页面。如何将GitHub Wiki转换为GitHub页面?
我试图将所有的.md
文件复制到/docs
和setting 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
但我没有自己测试过,所以我不能保证它能正常工作。
这可能是非常有用的功能了,所以我将与球队在一个简单的转换器的希望在未来