2012-03-25 125 views
3

我想將Java/Android項目的文檔集成到Trac實例中。由於Trac是用Python編寫的,我需要一種方法來從Python中提取JavaDoc註釋。用Python解壓縮JavaDoc

任何人都可以給我一些提示如何做到這一點?我想到了這兩種可能性,但我不知道是否有任何庫可以執行此操作:

  • 解析整個Java源代碼。
  • 設的JavaDoc做的工作,並以某種方式提取文檔從它的輸出
+0

爲了什麼目的,你需要文檔的哪些部分?將生成的JavaDoc用作託管服務器上的靜態文件可能更容易。 – 2012-03-25 11:11:15

+0

我只是想要一些更緊密的集成到Trac中,例如瀏覽文檔或從wiki /門票等輕鬆引用它。 – Julian 2012-03-25 11:41:27

回答

2

我想出了以下解決方案:我找到了一種叫做json-doclet的東西,它是一種用於輸出JSON的Javadoc插件,應該相當容易處理。

+0

記得接受你的答案! – Taymon 2012-03-26 17:01:16

0

Doxygen,這是用C++編寫,可以解析Javadoc和output it as XML。你可以從Python中調用它,然後將XML轉換爲你喜歡的任何格式。 (如果你在C++中使用doxmlparser來做這個,效率會更高,但是你也可以用Python來完成。)

+0

這可能會工作,但令人遺憾的是,Javadoc和Doxygen不能共享完全相同的語法。 – Julian 2012-03-26 12:27:18