phpDocumentor到wiki?

时间:2009-03-17 15:05:46

标签: php wiki

我的公司正在使用mediawiki开发最终用户/开发人员文档。我想采用phpdoc吐出的许多API文档(针对特定的函数/方法)并将其放在wiki标记中以便于传输。

从phpDoc获取wiki标记或wiki输出的任何解决方案?我环顾四周,一无所获。

3 个答案:

答案 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。