【发布时间】:2014-01-02 19:32:53
【问题描述】:
为了记录我的代码,我认为使用 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 实例都挂起并且没有响应。
【问题讨论】:
-
.rtf 可以在 Word 中打开。
-
您可以尝试解析phpDoc标签并使用PHPWord编写.docx文件
-
@Jessica 我没有提到这会起作用,但我无法编辑格式。我已经有一个包含多种标题样式的 word 文件。所以我必须重新定义 RTF 文件中的所有标题。
-
@MarkBaker 我不想在我的代码中创建 PHP 文档。我代码中的cmets应该处理成word文件。
-
你认为 PHPWord 实际上做了什么?它不创建 PHP 文档,它创建 OfficeOpenXML MS Word 文档!
标签: php ms-word doxygen phpdoc phpdocumentor2