0

我正在尝试在我们的团队开发环境中自动构建文档,因此我们决定使用 phpDocumentor(2.7.0) 并触发它在 SVN 提交后重建文档。

我做了一个触发器,但我很确定每次执行时都会重新构建所有文档,因为即使我只提交一个修改过的文件,phpdoc 命令的持续时间几乎与文档初始构建时一样。

所以我的想法是只重建那些文件的文档,在提交中更改。有没有可能这样做?我查看了 phpDoc 和 Google 的文档,但没有找到。

4

2 回答 2

2

只要您上次执行 phpDocumentor2 的结果文件位于您将要运行新执行的同一位置,默认情况下,应该只处理新/修改的文件。phpDocumentor2 有一个内置的缓存机制来跟踪“这是我们在上次运行文档时所做的一切”,以便它可以确定您的哪些代码文件已被添加/更改。

当然,如果您的构建每次都运行新鲜,则上次运行的缓存不可用,因此 phpDocumentor2 只知道“这是有史以来的第一次执行”。

于 2014-09-18T16:56:49.200 回答
0

您可以获取受修订影响的文件列表,使用svnlook changed. 如果您可以使用单个文件作为参数,则可以仅将需要的文件通过管道传输到 PHPDoc

于 2014-09-15T16:33:37.263 回答