如何將GitHub Wiki轉換爲GitHub頁面？

Question

我希望將我現有的GitHub Wiki作爲GitHub頁面。

我試圖將所有的.md文件複製到/docs和setting that as the source for pages - 但它打破了所有的內部鏈接。

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

在GitHub頁面上託管我的wiki最簡單的方法是什麼？

Answer 1

您需要爲每個頁面創建手動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，它可以爲您提供一個快捷方式來標識特定頁面，而無需指定完整路徑。

Answer 2

剛剛收到這從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

但我沒有自己測試過，所以我不能保證它能正常工作。

這可能是非常有用的功能了，所以我將與球隊在一個簡單的轉換器的希望在未來

分享