警告：点命令点不能运行

Question

我正在编写软件文档。而且我在休息文件中使用了graphviz指令。

.. graphviz::
:align: center
 

但是我跑步时

制作html

即使在我的virtenv（OS-mac）中安装了graphviz，我也收到点命令错误。我已经更新了conf.py，使其具有扩展名'sphinx.ext.graphviz'

警告：无法运行点命令“点”（需要graphviz输出），请检查graphviz_dot设置

Answer 1

该问题可能是由于 GraphViz PATH 中的“dot”可执行文件配置不正确。

见：https://github.com/IQSS/dataverse/pull/7230

在我的 Windows 机器上，我按照以下步骤解决了这个问题：

1. 检查点安装是否已经执行，进入安装路径（默认安装路径为：C:\Program Files (x86)\GraphvizX.XX\bin），在此处运行命令dot.exe< /li>
2. 转到控制面板 > 系统和安全 > 系统，然后在右侧导航面板上，单击高级系统设置链接。
3. 在高级设置中，会打开一个显示环境变量按钮的对话框。点击按钮。
4. 在系统变量部分选择条目 Path 并将 C:\Program Files (x86)\GraphvizX.XX\bin 添加到现有路径。

我认为只需使用 export 命令添加 PATH 即可在您的操作系统机器上解决该问题，例如： export PATH=$PATH:~/opt/bin

参考：https://bobswift.atlassian.net/wiki/spaces/GVIZ/pages/20971549/How+to+install+Graphviz+software https://osxdaily.com/2014/08/14/add-new-path-to-path-command-line/

Answer 2

Sphinx似乎找不到dot可执行文件。确保它在您的路径中。