我正在PyCharm中构建一个程序包,并希望使用Sphinx和Jupyter Notebooks进行记录。更具体地说,我想在文档中添加一个“教程”页面,其中展示了一个导入包,对其进行一些处理并包含用户将获得的输出的示例。
我现在为此设置的设置似乎非常复杂,难以管理且麻烦。我想知道是否有人尝试过类似的设置,并且找到了一种更好的方法。
目前,我在PyCharm中拥有一间venv,在那里我可以开发和测试我的包装。
接下来,我使用python setup.py develop
将软件包安装在Anaconda根环境中。现在,我可以使用默认的IPython内核从任何地方运行我创建的任何Jupyter Notebook,然后导入我的包。
最后,我在Anaconda根环境中运行Sphinx,以便在构建HTML时可以毫无问题地包含并执行Notebook。
它可以工作,但是从Anaconda根目录执行所有这些操作感觉很不像Python。理想情况下,我希望有一个单独的环境来构建文档,可以在其中编辑和运行Notebook以及构建文档。
有什么建议吗?