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