python - rst file to html

概述

开源工程中有一个.rst文件，是工程的说明。
用记事本打开，能看，但是不好看。洁癖患者很难受。
查了一下，.rst文件怎么看？好像都说要转成html来看。
去找开源的工具，有rst 转 html的工程，都不好使，报错，估计是python版本的问题。
资料上说VSCODE中有插件可以预览，安装了也不好使。
再查资料，看到可以用python的库docutils将.rst转成html
python新手，咋弄?
只能装了一个PyCharm，搭建了一个虚拟环境为Conda的工程，添加了docutils库，再按照资料上说的，加了几句话搞定。
记录一下。

笔记

下载安装PyCharm最新的学习版

下载官方最新试用版pycharm-professional-2024.1.1.exe，安装。
网上有学习版的补丁，将补丁安装上。

新建虚拟环境为Conda的工程

第一次运行，因为没有Conda, 界面上有提示，点击安装miniConda

添加docutils库

新建python文件，添加转换代码

import docutils.core

docutils.core.publish_file(
    source_path="D:\\3rd_prj\\Dll\\MemoryModule\\doc\\readme.rst",
    destination_path="D:\\3rd_prj\\Dll\\MemoryModule\\doc\\Output.html",
    writer_name="html")

运行自己写的python文件，执行转换

转换结果

END