在「github頁面」網站中查看.rst

Question

我正在將一個開源項目的文檔轉移到Github Pages上，但我堅持移動.rst文件。

我們有一個ReadMe.rst，您可以在代碼中看到here。我想從我們的main documentation page鏈接到該頁面，但GitHub不會將.rst作爲HTML呈現，因此當您單擊the link時，瀏覽器只是下載.rst文件的文本）。

當然有一些工具可以將.rst作爲HTML呈現，但這是一個嚴重的額外步驟。我們開始使用.rst的全部原因完全是因爲GitHub在代碼頁中自動呈現它。你會認爲有一些方法可以讓GhoBub Pages發生這種自動呈現...

Answer 1

GitHub Pages不支持.rst/RestructuredText。它只支持Markdown和Textile轉換爲HTML。