6 users Sign-in to change your status

sfDoxygenPlugin provides you with tasks to generate your sourcecode documentation via Doxygen. Development

• Homepage
• Repository
• Report a bug
• Download package
• Browse source

The sfDoxygenPlugin is a symfony plugin that provides tasks to generate your sourcecode documentation via Doxygen.

Read more about development plugins at symfony developer's blog

Developers

Name	Status	Email
Tomasz Ducin	lead	moc.liamg <<ta>> nicud.zsamot

License

Copyright (c) 2009 Tomasz Ducin

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Releases for sf 1.4

Releases for sf 1.3

Releases for sf 1.2

Join this plugin team

Other releases

Release 1.1.0 - 21/12/2009

Release 1.0.5 - 21/12/2009

sfDoxygenPlugin

The sfDoxygenPlugin is a symfony plugin that provides tasks to generate your sourcecode documentation via doxygen tool.

Installation

Install the plugin via the subversion repository by executing the following command from the project root directory (branch 1.4 of the plugin works for both 1.3 and 1.4 symfony versions):

$ svn co http://svn.symfony-project.com/plugins/sfDoxygenPlugin/branches/1.4 plugins/sfDoxygenPlugin

or by using the default symfony plugin install command:

$ ./symfony plugin:install sfDoxygenPlugin

Configuration files

Below there is a list of files that are created after running doxygen-init task under

• doxygen.cfg - the main doxygen config file

• doxygen.ini - file used to store your custom doxygen docs configuration options. All the options defined here will be applied to doxygen.cfg when doxygen:update task will be performed (and therefore applied while generating the docs during execution of doxygen:generate).

• exclude.txt - file containing all paths that should be excluded from generating the documentation. Paths existent in this file are concatenated and put into the EXCLUDE option of doxygen. Similar to _ config/rsync_exclude.txt_.

• exclude_patterns.txt - similar to exclude.txt with the difference that it supports the EXCLUDE_PATTERNS option.

• doxygen.xml - specifying the layout. Used within doxygen version 1.5.7 or above.

All files contain default values which are sufficient to perform code documentation generation.

Usage

• Execute the tasks bundled with the plugin in the order specified below. The first command creates file structure in config/doxygen directory and copies modified version of module skeleton into base data directory. (use this task only once otherwise the changes you made will be lost):

  $ ./symfony doxygen:init
  

• Next step is to make your custom changes to the doxygen.ini file. You may specify all options that would be used by the doxygen tool (few important ones are already defined there, such as PROJECT_NAME). After editing doxygen.ini, run the following command to update the doxygen.cfg file. Take a look at official doxygen documentation for more details:

  $ ./symfony doxygen:update
  

• And finally, the last step. It will generate the whole documentation in the doc/doxygen directory (of course you can change it). The doc directory was removed from symfony 1.3, but the plugin creates it on it own:

  $ ./symfony doxygen:generate
  

• Additionally you may check the version of doxygen installed using command:

  $ ./symfony doxygen:version
  

Module skeleton

Running command doxygen:init creates a subdirectory containing alternative skeleton for module generation. The skeleton is stored in data/skeleton/module directory. The changes are only about the documentation code syntax, which should be configured specially for doxygen (there are tiny differences between PHPDoc and Doxygen). When a new module is generated within command:

    $ ./symfony generate:module app mod

the framework already uses the new skeleton. This means that if you install the plugin and run doxygen:init command before generating any modules, all generated modules will have doxygen-documentation-like comments without any manual modifications.

By default the @subpackage option is out and it is replaced with @class. Of course, the best solution is to define your own skeleton (if you have any suggestions, don't hesitate to mail me).

Documentation

By default, the documentation should include all lib class files created by the developer, that is: all non-base model classes (excluding base classes, migration classes, vendor). Moreover, action classes should be included (but their templates are set to be excluded).

Notes

• You need to install doxygen before you can use following plugin. More information can be found at the documentation(http://www.stack.nl/~dimitri/doxygen/install.html)

• Remember to add a line to the config/rsync_exclude.txt file to exclude the generated documentation from being sent to the production server.

• You may configure your vhost to show the doxygen documentation by adding the following code:

  Alias /dox /path_to_my_project/doc/doxygen/html