{iframe:src=http://update.sonarsource.org/plugins/doxygen-confluence.html|width=700|height=220|frameborder=0}
Your browser does not support iframes.
{iframe}

Description / Features

This plugin generates the documentation of the application using Doxygen and Graphviz. To generate graphs, Graphviz must be installed.

This generated documentation can be browse through the Documentation item on the left menu or from the Documentation tab at file level.

 

 

As the documentation is generated in HTML, it is necessary to make it accessible from an URL.

SonarQube server can be used but it is not recommended as it may affect SonarQube performances. To configure it that way, set Web Server Deployment URL to http://localhost:9000 (may be different according to your configuration) and Documentation Path Generation to <sonar.install.dir>/war/sonar-server.

As said before, it is recommended to deploy documentation on another web server. Apache could be used. In this way, set Server Deployment URL to http://localhost:80 (may be different according to your configuration) and Documentation Path Generation to <apache.install.dir>/www.

Global Properties

 Property NameMandatoryComments
sonar.doxygen.deploymentPathDocumentation Path GenerationYESDirectory path where the documentation will be generated.
If SonarQube server is used to access the documentation, the path should be set to: <sonar.install.dir>/war/sonar-server.
sonar.doxygen.deploymentUrlWeb Server Deployment URLYES

URL to display the generated documentation.
SonarQube server can be used to access the documentation.

sonar.doxygen.customPathDirectory Path containing header.html, footer.html and doxygen.css NOIn order to customize HTML documentation.

Project Properties

 Property NameMandatoryComments Default Value
sonar.doxygen.generateDocumentationGenerate Doxygen DocumentationNO

Possible values:

  • disable: do not generate documentation and delete existing documentation.
  • keep: do not generate documentation but keep previous documentation if existing.
  • enable: generate or regenerate documentation
disable 
sonar.doxygen.excludeFiles

Excludes Specific Files

NOComa separated list 
sonar.doxygen.generateClassGraphs

Generates Class Graphs

NO

If the property is set to true, graphviz must be installed.

false
sonar.doxygen.generateCallGraphsGenerates Call GraphsNO

If the property is set to true, graphviz must be installed.

false
sonar.doxygen.generateCallerGraphsGenerates Caller GraphsNO

If the property is set to true, graphviz must be installed.

false

Requirements

Plugin

0.1

Doxygen

 1.7.5

Graphviz

 2.28

Usage & Installation

  1. Install the following tools (standard installation):

    SoftwareDownload URL
    Doxygenhttp://www.stack.nl/~dimitri/doxygen/download.html
    Graphviz http://www.graphviz.org/Download.php
  2. Add the directories <doxygen.install.dir>/bin and <graphviz.install.dir>/bin as Path Environment Variables. Commands doxygen, dot, etc... must be recognized by the system.
  3. Stop SonarQube server.
  4. Copy the JAR file to the <sonar.install.dir>/extensions/plugins/ directory.
  5. Restart SonarQube server.
  6. Configure the plugin at global level and for each project.

Known Limitations

This first version is limited to Java.

Change Log