我想将Java/Android项目的文档集成到Trac实例中。由于Trac是用Python编写的,我需要一种方法来从Python中提取JavaDoc注释。用Python解压缩JavaDoc
任何人都可以给我一些提示如何做到这一点?我想到了这两种可能性,但我不知道是否有任何库可以执行此操作:
- 解析整个Java源代码。
- 设的JavaDoc做的工作,并以某种方式提取文档从它的输出
我想将Java/Android项目的文档集成到Trac实例中。由于Trac是用Python编写的,我需要一种方法来从Python中提取JavaDoc注释。用Python解压缩JavaDoc
任何人都可以给我一些提示如何做到这一点?我想到了这两种可能性,但我不知道是否有任何库可以执行此操作:
我想出了以下解决方案:我找到了一种叫做json-doclet的东西,它是一种用于输出JSON的Javadoc插件,应该相当容易处理。
记得接受你的答案! – Taymon 2012-03-26 17:01:16
Doxygen,这是用C++编写,可以解析Javadoc和output it as XML。你可以从Python中调用它,然后将XML转换为你喜欢的任何格式。 (如果你在C++中使用doxmlparser
来做这个,效率会更高,但是你也可以用Python来完成。)
这可能会工作,但令人遗憾的是,Javadoc和Doxygen不能共享完全相同的语法。 – Julian 2012-03-26 12:27:18
为了什么目的,你需要文档的哪些部分?将生成的JavaDoc用作托管服务器上的静态文件可能更容易。 – 2012-03-25 11:11:15
我只是想要一些更紧密的集成到Trac中,例如浏览文档或从wiki /门票等轻松引用它。 – Julian 2012-03-25 11:41:27