zend-framework - 如何在 Netbeans IDE 中为特定文件夹生成 phpDoc 文档？

Question

由于我们需要在我们的项目根目录下集成 Zend Framework，并且生成该文档将无用且需要很长时间，我想为 application 仅限文件夹。

有谁知道如何通过 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

至少对我来说，这似乎行不通，因为当我尝试生成文档时，我在输出窗口中显示权限错误问题。

谢谢

Answer 1

-d/--directory 选项 [1] 应该用于突出显示您希望 phpDocumentor 开始读取的最高级别代码目录。如果您的 Zend 文件夹位于或高于您的应用程序目录级别，那么仅使用 --directory/path/to/application 应该可以帮助您仅记录您的应用程序代码。

如果你的 Zend 文件夹在你的应用程序中的某个地方(例如在你的应用程序的 ./lib 文件夹中)，那么你可以使用 -i/--ignore 选项 [2] 告诉 phpDocumentor 它会看到但应该看到的任何目录ignore, --忽略*zend*。请注意，格式化您的忽略值可能很棘手，因此请参阅手册中的示例。另外，请注意，在 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