Windows Doxygen 中 DOT 路径的环境变量

Question

我的团队有使用 Windows 和 Linux 的开发人员。我们将 Doxyfiles 存储在我们的版本控制系统中。因此，我们将 DOT_PATH 留空，当我从 repo 中提取代码进行代码审查时，我总是需要在本地修改 DOT_PATH。我能否以某种方式修改 windows 中的 PATH 环境变量，以便在 DOT_PATH 为空时 Doxygen 总能找到 Dot？文档听起来我应该能够：

# The DOT_PATH tag can be used to specify the path where the dot tool can be
# found. If left blank, it is assumed the dot tool can be found in the path.
# This tag requires that the tag HAVE_DOT is set to YES.

DOT_PATH               =

我为我的 windows 帐户编辑了 PATH 变量并输入了我的点路径 C:\Program Files (x86)\Graphviz2.30\bin\，当我在命令 [=25= 中键入 path 时我看到了该路径], 但是Doxygen好像没看到

Answer 1

我们最近遇到了 PLANTUML 和 doxygen 的类似问题，请参阅下面的解决方案。

在签入的配置文件（Doxyfile）中，使用一个环境变量，如：

PLANTUML_JAR_PATH      = $(PLANTUML_JAR_PATH)

在每个开发人员环境中，根据平台和特定机器，使用正确的路径定义变量。

以我为例 linux，例如：

malff@linux-8edv:GIT_TRUNK> uname -a
Linux linux-8edv 4.1.39-53-default #1 SMP PREEMPT Thu Mar 30 06:44:23 UTC 2017 (56cc5a0) x86_64 x86_64 x86_64 GNU/Linux
malff@linux-8edv:GIT_TRUNK> env | grep PLANTUML_JAR_PATH
PLANTUML_JAR_PATH=/home/malff/plantuml/plantuml.8053.jar

未测试，但我认为类似的东西应该适用于 DOT_PATH。

Answer 2

您可以尝试在short name notation（也称为8.3 或DOS）中使用完整路径。它看起来像这样：

C:\PROGRA~1\COMMON~1\graphviz\bin\

您可以使用此 shell 脚本找出路径中的所有短名称（您可以将其命名为 shortpath.cmd）：

@echo %~s1

该脚本接受一个参数，该参数将被翻译成短符号，所以运行它像这样：

shortpath.cmd "C:\Program Files\Common Files\graphviz\bin"

将参数替换为您的 graphviz 副本的实际位置。致谢此 answer.

Windows Doxygen 中 DOT 路径的环境变量

Environment Variable for DOT path in Doxygen for Windows

environment-variables

doxygen

dot