为了记录我的代码,我认为使用phpDoc语法是最好的做法,因为有几个解析器,一些IDE用它创建IntelliSense。
现在我需要将文档(API)放入一个word文件中,但我不知道哪个解析器能够输出.doc或类似的文件。
我尝试了DoxyGen,它输出.rtf和phpDocumentor2,它们只能导出到.html和.xml(?)。
有没有办法从phpDoc生成.doc(x)文件?或者一种简单的方法来获得一个可以导入word的文档?如果我不必更改phpDoc语法,我将不胜感激,因为我的文档很长。
Edit:首选的解析器是phpDocumentor2,因为它支持PHP 5.3功能,并且比DoxyGen更快,但phpDocumentor1的功能比phpDocumentor少,后者不再维护,与输出格式有关。
编辑:我试图将.rtf文件中的内容复制到.docx文件中,但当我选择"使用目标样式"时,两个Word实例都会挂起且不响应。
假设您想要一个大型Word文档,在一个文档/文件中包含项目的所有信息。。。因此,仅仅将phpDoc2 HTML输出打开到Word中以将其转换为docx将无法满足您的需求,因为这将是每个phpDoc2 HTML页面一个docx。
您可以尝试将搜索更改为一个工具,该工具可以抓取给定的HTML页面,递归地拾取其所有目标页面层次结构,并将其全部转换为单个docx。你可能会更幸运地找到一个能做到这一点但能生成PDF的工具。。。然后你可以使用Word将PDF转换为docx。