我尝试用sphinx创建一个类图,为此我在Pycharm中创建了一个虚拟环境,并将其添加到conf.py:
extensions = ['sphinx.ext.autodoc','sphinx.ext.inheritance_diagram']
在我的spamfilter.rst文件中,我添加了以下几行:
Diagrams
=================
.. inheritance-diagram:: spamfilter
输出不是图表,看起来像this。
将显示以下警告:
WARNING: dot command 'dot' cannot be run (needed for graphviz output), check the graphviz_dot setting
当我查看文件夹 C:\Users\Name\PycharmProjects\documentation\venv\Lib\site-packages\graphviz 时,有一个 dot.py 文件,所以我不明白是什么问题。Mac OS的一个类似的问题已经被问到here。我尝试了这个解决方案,但似乎它只适用于Mac,因为当我将export PATH=$PATH:~/opt/bin
粘贴到Pycharm终端时,它告诉我命令export
无法找到。老实说,我很难理解为什么有时你可以只使用包,而有时即使安装了它们也找不到,我是自学成才的初学者。
2条答案
按热度按时间1qczuiv01#
“pip install graphviz”命令安装了一个Python包,它提供了一个到Graphviz(https://pypi.org/project/graphviz)的接口。这个包不是Sphinx所必需的。
为了用Sphinx创建继承图,必须安装Graphviz工具包(包括dot.exe)。参见https://www.graphviz.org。
如果dot.exe不在PATH中,则可以使用
graphviz_dot
配置选项。qyyhg6bp2#
我遇到了同样的问题,在更新的M1 MacOS Monterey上,用PlantUML渲染C4模型在IDE(PyCharm 2022.2.1 Pro)中不起作用。在升级之前,我让它在Big Sur intel Mac上工作,没有额外的努力,所以芯片的变化导致我在Rosetta等上走了很多路,都不成功。
错误为:
点可执行文件:/opt/本地/二进制/点
文件不存在
找不到Graphviz。
Graphviz * 是 * 正确安装的,并且
dot
在我的路径中,但是它不在/opt/local/bin/dot
中。由于它在/opt/homebrew/bin/dot
中,我所需要做的就是将实际文件与它正在搜索的路径链接起来: