由于我们需要在我们的项目根上集成Zend框架,并且生成该文档将是无用的并且需要很长时间,我想仅为应用程序文件夹内的所有文件生成文档。
有谁知道我如何为特定的项目文件夹生成文档,通过Netbeans 7.0接口?
更新:到目前为止,我找到的最好的方法是:
从netbeans打开终端窗口,输入:
sudo phpdoc -d public_html/yoursite.dev/application/ -t public_html/yoursite.dev/docs/
更新2 让我们假设我们的Zend库在projectrootname/library/Zend
中,我们也可以尝试,通过转到:Tools > Options > Php > PhpDoc
并放置以下内容:
/usr/bin/phpdoc -i library/Zend/ -o HTML:frames:earthli
至少对我来说,这似乎不起作用,因为,当我试图生成文档时,我得到了显示在输出窗口上的权限错误问题。
谢谢
-d/——directory选项[1]应该用于突出显示您希望phpDocumentor开始读取的最高级代码目录。如果您的Zend文件夹在应用程序目录的级别或更高级别,那么仅使用--directory /path/to/application
应该可以帮助您仅记录应用程序代码。
如果你的Zend文件夹在你的应用程序的某个地方(例如在你的应用程序的。/lib文件夹),那么你可以使用-i/——ignore选项[2]告诉phpDocumentor关于任何目录,它会看到,但应该忽略,--ignore *zend*
。请注意,对ignore值进行格式化可能会很棘手,因此请参阅手册中的示例。另外,请注意,当phpDocumentor运行时,您将看到这些被忽略的文件夹和文件在输出中列出…phpDocumentor通过不为这些文件生成文档来"忽略"它们。但是,它仍然需要解析它们,以防这些对象在文档化的文件中被引用。
[1]—http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#using.command-line.directory
[2]—http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#using.command-line.ignore