我正在寻找正确的方法来使用项目中的 phpDoc-comments 在我的 Confluence 4.1.4 中生成开发人员的文档。
问问题
1798 次
3 回答
6
我一直在研究的一种方法是将我的 HTML 输出（类似于 phpDoc）部署为 Confluence 的 Tomcat 实例上的第二个 Web 应用程序，然后将该文档的 iFrame 部署到 Confluence 页面中。它没有与 Confluence 的搜索/索引或标签集成，但它应该可以很好地与我们设置的 Crowd 身份验证方案配合使用。我想我可以使用联合搜索工具来搜索这两个网络应用程序。
于 2012-11-20T16:27:16.450 回答
2
我正在寻找相同的解决方案。我最接近的是使用具有 Confluence 方言的 html2wiki。我创建了一个 PHP 脚本，它通过我的 api 目录递归并使用这个 html2wiki 程序处理每个 html 页面。不幸的是，它不能完美地格式化标记并留下不需要的 html 工件。
我的下一个方法是尝试自己调整方言以尝试解决不良的格式。
http://search.cpan.org/~diberri/HTML-WikiConverter-0.51/bin/html2wiki
于 2012-11-09T19:38:00.093 回答
1
您可以使用文档插件：https ://marketplace.atlassian.com/plugins/net.meixxi.confluence.docs.docs-plugin 。这个插件使您能够在 Confluence 中上传和发布您的 PHPDocs 和其他基于 HTML 和 JavaScript 的内容。
Docs 还提供了一个 REST 接口以自动化发布过程。因此，PHPDocs 的发布可以成为持续集成过程的一部分。您可以在此处找到技术文档和示例代码：https ://bitbucket.org/meixxi/docs-plugin/wiki/Home
于 2015-06-01T05:59:54.067 回答