我希望我现有的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。