使用Doxygen时构建文档

Question

我开始使用Doxygen记录我的PHP5框架.我正在尝试使用CodeIgniter框架的内联文档作为参考.但是,它的文档是使用phpDocumentor语法编写的.下面是CodeIgniter的Loader类描述的示例:

/**
 * 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 {
...
}

如何使用Doxygen实现相同的结构(Package-> Subpackage-> Category-> Class)？我想为结构的每个元素都有一个相应的描述页面.

另一个问题是如何构建项目的文档？

Answer 1

如果您运行的是 PHP 5.3，则 Doxygen 支持命名空间。如果您将它们放入，那么您的文档将以与 phpDocumentor 包类似的风格构建。有关 PHP 命名空间的更多信息，请查看以下链接：

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

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