可以将 RST 文件理解为 Python 使用的 Markup 文件。
- 直接在pycharm里打开文件夹进行阅读,只不过中文可能成为乱码。
- 将文件后缀名改成md,但原有格式可能显示不出来。
- 在github直接预览
- 安装包
pip install sphinx
pip install sphinx_rtd_theme
在父文件路径下执行,doc表示该路径的子文件名,需替换成你需要 打开阅读 的文件名。
sphinx-build -b html doc build
执行成功后会出现一个build文件,里面放着rst文件生成的html,打开即可阅读
本文介绍了如何理解和处理RST(reStructuredText)文件,它常用于Python文档编写。通过更改文件扩展名为.md可能无法保留原始格式。推荐在GitHub上预览或使用Sphinx转换为HTML。安装sphinx和sphinx_rtd_theme后,运行sphinx-build命令生成HTML文档,然后在build文件夹中查看。
1691

被折叠的 条评论
为什么被折叠?



