-1

为了记录我的代码,我认为使用 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 实例都挂起并且不响应。

4

1 回答 1

1

大概您想要一个大型 Word 文档,其中包含一个文档/文件中的项目的所有信息...因此仅将 phpDoc2 HTML 输出打开到 Word 以将其转换为 docx 将无法满足您的需求,因为那将是每个 phpdoc2 HTML 页面一个 docx。

您可能会尝试将您的搜索更改为可以抓取给定 HTML 页面的工具,递归地获取其所有目标页面层次结构,并将其全部转换为单个 docx。您可能会更幸运地找到执行此操作但生成 PDF 的工具......然后您可以使用 Word 将 PDF 转换为 docx。

于 2014-01-03T14:40:47.193 回答