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

Question

我希望我的现有GitHub Wiki能够作为GitHub页面提供服务。

我尝试将所有的.md文件复制到/docs中，并将其设置为页面的源 - 但这会导致所有内部链接都失效。

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

如何在GitHub页面上托管我的Wiki最简单？

- Terence Eden

Answer 1

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

[[documentation]] 和 [[Help|get help]] 样式的链接是 wikilinks，通常只用于维基。它们不是标准的 Markdown 语法，也不受 Jekyll（GitHub Pages 在幕后使用）支持。请注意，GitHub 维基支持 这两种样式，因此如果您喜欢，可以在导入之前编辑链接。

无论如何，您都需要编辑链接，以使用标准的 Markdown 语法手动指向相应的页面：

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

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

- Waylan

Answer 2

刚从GitHub直接收到了这个消息。

---

恐怕没有简单的答案。您需要编写脚本或手动更改Wiki格式的URL以正确的Markdown格式进行转换。

我们刚刚在GitHub Pages中添加了相对链接：

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

这至少可以使事情变得更容易，因为您不需要完全合格化所有URL。

因此，您可以更改：

阅读[[documentation]]或[[Help|get help]]。

到

阅读[文档](documentation.md)或[帮助](get%20help.md)。

或者，您可以尝试使用Pandoc和下面的脚本进行转换：

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

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

这可能是一个有用的功能，因此我会将其与团队分享，希望未来能够开发出一个简单的转换器。

- Terence Eden

Answer 3

有工具可以自动完成。请看github-wikito-converter。

从Github wiki或任何其他基于markdown的wiki生成HTML和PDF文档。

或者limedocs-wiki-converter。

- vardius