Documentación de estructuración al utilizar Doxygen

Question

Estoy empezando a documentar mi estructura PHP5 utilizando Doxygen. Estoy intentando utilizar la documentación en línea del marco de CodeIgniter como referencia. Sin embargo, su documentación está escrita usando la sintaxis phpDocumentor. A continuación se muestra un ejemplo de descripción de la clase cargador de CodeIgniter:

/** 
* Loader Class 
* 
* Loads views and files 
* 
* @package   CodeIgniter 
* @subpackage  Libraries 
* @author   ExpressionEngine Dev Team 
* @category   Loader 
* @link    http://codeigniter.com/user_guide/libraries/loader.html 
*/ 
class CI_Loader { 
... 
} 

¿Cómo puedo aplicar la misma estructura (Paquete-> Subpackage-> Category-> Clase) usando Doxygen? Me gustaría tener una página de descripción correspondiente para cada elemento de la estructura.

Otra pregunta es ¿cómo se estructura la documentación de su proyecto?

Answer 1

Si está ejecutando PHP 5.3, Doxygen admite espacios de nombres. Si los coloca, su documentación se estructurará en un estilo similar al de los paquetes de phpDocumentor. Echar un vistazo a los siguientes enlaces para obtener más información acerca de los espacios de nombres de PHP:

http://php.net/manual/en/language.namespaces.php

http://www.sitepoint.com/php-53-namespaces-basics/