文档生成被禁用

Question

我完成了教程- DO2插件中指定的所有内容。

下面是sonarqube-4.5.1/conf/sonar.propeties文件doxygen条目：

# Doxygen
sonar.doxygen.generateDocumentation=enable
sonar.doxygen.deploymentPath=D:\Downloads\sonarqube-4.5.1\web
sonar.doxygen.deploymentUrl=http://localhost:9000/sonar/documentation

声纳转轮的输出：

16:07:16.265 INFO  - ANALYSIS SUCCESSFUL
16:07:16.266 DEBUG - Post-jobs : org.sonar.plugins.doxygen.DoxygenPostJob@28bda649
16:07:16.266 INFO  - Executing post-job class org.sonar.plugins.doxygen.DoxygenPostJob
16:07:16.271 INFO  - === SUPPRESS PREVIOUS GENERATION ===
16:07:16.395 INFO  - === DOXYGEN EXECUTION ===
16:07:16.396 INFO  - ### Generating configuration ###
16:07:16.427 INFO  - ### Generating documentation ###

另外，在指定的\web文件夹中有一个documentation文件夹，它似乎包含正确的doxygen文档输出。

然而，我仍然在Documentation Generation is disabled. web界面中获取这条SonarQube消息：

​

​

更新

这就是我的sonar-project.properties文件现在包含的内容--使用unix样式的路径：

#Doxygen
sonar.doxygen.generateDocumentation=enable
sonar.doxygen.deploymentPath=/Downloads/sonarqube-4.5.1/web
sonar.doxygen.deploymentUrl=http://localhost:9000/sonar/documentation

输出保持不变，相同的问题。

为了查看web服务器接口中的文档，我需要做什么？

这似乎是一个服务器链接问题，因为文档是在这个位置( /Downloads/sonarqube-4.5.1/web/documentation )正确生成的。

我还发现了以下内容：

core,true,sonar-core-plugin-4.5.1.jar|9289fc1067c31372c0b020aa01163087
emailnotifications,true,sonar-email-notifications-plugin-4.5.1.jar|bb35818e4a655a3ba2cff2afc65a296b
findbugs,false,sonar-findbugs-plugin-2.4.jar|bb0bf263ef1e0d56f569878732060cc9
java,false,sonar-java-plugin-2.4.jar|a105d018165ddeb2c0f5074100768660
cpd,true,sonar-cpd-plugin-4.5.1.jar|e11ff5066c9e2308036838510d87a6fe
dbcleaner,true,sonar-dbcleaner-plugin-4.5.1.jar|a444b3b4571791e1cde146ffa5132ee4
design,true,sonar-design-plugin-4.5.1.jar|0c6476994a44904307cfa8b8a08bbddd
doxygen,false,sonar-doxygen-plugin-0.1.jar|d86e1ab81c3ac34e6b31aa1da28d7f72
l10nen,true,sonar-l10n-en-plugin-4.5.1.jar|c21d53f67901cf6df3da1b4dd48a441b

在sonarqube-4.5.1\web\deploy\plugins\index.txt中。看起来doxygen有一个与它相关的false。如果我尝试编辑它(到true)并重新启动服务器，没有什么改变。该文件被声纳跑步者覆盖.

Answer 1

我就是这样解决这个问题的：

1. 停止了sonar-qube服务器。
2. 用更新的doxygen插件替换了来自/Downloads/sonarqube-4.5.1/extensions/plugins的旧的https://github.com/SonarCommunity/sonar-doxygen/releases/download/1.0/sonar-doxygen-plugin-1.0-SNAPSHOT.jar插件。
3. 从项目sonar-project.properties文件中注释掉doxygen的旧配置条目。代之以折页的词条： sonar.doxygen.url=http://localhost:8000/ sonar.doxygen.enable=true
4. 使用一个简单的python脚本在该服务器(http://localhost:8000/)上发布文档html。
5. 重新启动sonar-qube服务器。
6. 再次运行sonar-runner.bat。
7. 文件现在已经到位了。

Answer 2

sonar.doxygen.generateDocumentation是项目属性，而不是服务器属性。如果使用SonarQube运行分析，则必须在"sonar-project.properties“文件中设置它，如果使用Maven运行分析，则必须在pom.xml文件中设置它。