为了记录我的代码,我认为使用 phpDoc 语法是最佳实践,因为那里有几个解析器,并且一些 IDE 会从中创建 IntelliSense。
现在我需要将文档 (API) 放入 word 文件中,但我不知道哪个解析器能够输出 .doc 或类似文件。
我试过 DoxyGen,它输出 .rtf 和 phpDocumentor2,它只能导出到 .html 和 .xml(?)。
有没有办法从 phpDoc 生成 .doc(x) 文件?还是一种简单的方法来获取可以导入到 word 的文档?如果我不必更改 phpDoc 语法,我将不胜感激,因为我的文档很长。
编辑:首选解析器是 phpDocumentor2,因为它支持 PHP 5.3 功能并且比 DoxyGen 更快,但 phpDocumentor2 的功能比不再维护的 phpDocumentor 少,与输出格式相关。
编辑:我试图将 .rtf 文件中的内容复制到 .docx 文件中,但是当我选择“使用目标样式”时,两个 Word 实例都挂起并且不响应。