在"github pages"网站中查看.rst

Tom*_*rly 8 restructuredtext github github-pages

我正在将一个开源项目的文档移到Github Pages上,但我仍然坚持移动.rst文件.

我们有一个ReadMe.rst,你可以在这里看到代码.我想从我们的主文档页面链接到该页面,但是GitHub不会将.rst呈现为HTML,因此当您单击链接时,浏览器只会下载.rst文件的文本.

当然有工具将.rst呈现为HTML,但这是一个非常重要的步骤.我们开始使用.rst的全部原因完全是因为GitHub在代码页中自动呈现它.您认为有一些方法可以让Github Pages发生这种自动渲染......

小智 5

GitHub Pages 不支持 .rst/RestructuredText。它只支持 Markdown 和 Textile 到 HTML 的转换。