如何将github wiki转换为github页面



我希望我现有的github wiki用作github页面。

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

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

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

您需要创建到每个页面的手动标记链接。

[[documentation]][[Help|get help]]样式链接是Wikilinks,通常仅在WikiS中使用。它们不是标准标记语法的一部分,也不是Jekyll的支持(Github页面在引擎盖下使用)。请注意,GitHub Wiki支持两种样式,因此您可以在导入之前编辑链接。

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

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

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

刚从github收到此直接。


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

我们确实只添加了相对链接到github页面:

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

至少应该使事情变得更容易,因为您不需要充分限定所有URL。

因此您可以更改:

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

to

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

另外,您也许可以使用pandoc和下面的脚本为您进行转换:

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

,但我自己还没有测试过,所以我不能保证它会起作用。

这可能是有用的功能,因此我将与团队分享,希望将来有一个简单的转换器

有工具可以自动进行。看看github-wikito-converter。

生成html&GitHub Wiki或任何其他基于Markdown的Wiki的PDF文档。

或limedocs-wiki-converter。

最新更新