警告：点命令 dot 无法运行

Question

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

.. graphviz::
:align: center
 

但是当我跑步时

制作html

即使我的 virtenv (OS - mac) 中安装了 graphviz，我也会收到 dot 命令错误。我已更新 conf.py 以具有扩展名 'sphinx.ext.graphviz'

警告：点命令“dot”无法运行（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
2. 转到控制面板 > 系统和安全 > 系统，然后在右侧导航面板上单击高级系统设置链接。
3. 在高级设置中，会打开一个显示环境变量按钮的对话框。点击按钮。
4. 在系统变量部分选择条目路径，并将 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 可执行文件。确保它在您的路径中。