我的公司正在使用mediawiki开发最终用户/开发人员文档。我想采用phpdoc吐出的许多API文档(针对特定的函数/方法)并将其放在wiki标记中以便于传输。
从phpDoc获取wiki标记或wiki输出的任何解决方案?我环顾四周,一无所获。
答案 0 :(得分:2)
在寻找从phpDoc生成Twiki输出的方法时遇到了这个问题。我还没有找到一个很好的解决方案,并在这里启动了一个项目:http://step2.co.in/content/phpdoc-twiki以便开始工作。如果有人有兴趣帮忙,请联系。
答案 1 :(得分:1)
根据PHPDocumentor网站,他们的documentation HTML和XML输出是可能的。然后,您可以使用MediaWiki的内置import功能导入XML,但您可能希望先导出以查看XML的格式。他们还提到使用XML导入大量数据可能会导致超时,并且有一个替代方法可以让您创建SQL查询来插入数据。此外,您可能需要MediaWiki的扩展来显示代码(类似SyntaxHighlight GeSHi)。
所有这些并没有真正解释如何将PHPDocumentor的输出转换为可与MediaWiki一起使用的东西(即使用Wiki语法)。您很可能会使用脚本将一种语法转换为另一种语法。看起来像通过PHPDocumentor创建自己的输出格式是最简单的方法(尽管输出为XML:DocBook可能有效)。
答案 2 :(得分:0)
一个选项(在我的脑海中)是使用API构建到MediaWiki,并自己发布数据。 (当然是通过脚本)。
唯一的另一种方法就是破解phpDoc,即使这样,你也必须以某种方式将它发布到MediaWiki。