我正试图用sphinx创建一个类图。为此,我在Pycharm中创建了一个虚拟环境,并将其添加到conf.py:
extensions = ['sphinx.ext.autodoc','sphinx.ext.inheritance_diagram']
在我的spamfilter.rst文件中,我添加了以下行:
Diagrams
=================
.. inheritance-diagram:: spamfilter
输出不是一个图表,看起来是这样的。
显示以下警告:
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操作系统也有类似的问题。我尝试了这个解决方案,但它似乎只适用于Mac,因为当我将export PATH=$PATH:~/opt/bin
粘贴到Pycharm终端时,它会"告诉"我找不到命令export
。老实说,我很难理解为什么有时你只能使用软件包,而有时即使安装了软件包也找不到,我是自学成才的初学者。
;pip-install graphviz";命令安装一个Python包,该包为Graphviz提供了一个接口(https://pypi.org/project/graphviz)。斯芬克斯不需要这个包裹。
为了使用Sphinx创建继承图,必须安装实际的Graphviz工具包(包括dot.exe(。看见https://www.graphviz.org.
如果dot.exe不在PATH中,则可以使用graphviz_dot
配置选项。
我遇到了同样的问题,在更新的M1 MacOS Monterey上,用PlantUML渲染C4模型在IDE(PyCharm 2022.2.1 Pro(中不起作用。在升级之前,我让它在Big Sur intel Mac上工作,没有付出额外的努力,所以芯片的改变让我在罗塞塔等上走了很多路,但都没有成功。
错误是:
点可执行文件:/opt/local/bin/Dot
文件不存在
找不到Graphviz。
Graphviz安装正确,并且dot
在我的路径上,但它不在/opt/local/bin/dot
中。由于它在/opt/homebrew/bin/dot
中,我所需要做的就是将实际文件与它搜索的路径链接起来:
cd /opt
sudo ln -s homebrew local
et voilà,PyCharm现在正在IDE中正确渲染puml。