2011-07-04 48 views
9

自從我開始使用Scala玩弄,我有關於Java API的一個大問題:爲什麼甲骨文保持與「框架」標籤頁same old HTML,並在所有沒有搜索功能?看起來他們還沒有到達Web 2.0 ...的Java API接口

另一方面,雖然不是網絡歷史上最好的網站,但它的可用性要好幾個數量級。

不管怎麼說,如果有人知道這是爲什麼,更重要的是,如果存在一個更好的接口Java API文檔,請讓我知道!

+0

[Java 7 API Docs](http://download.java.net/jdk7/docs/api/)看起來有點不同......但我同意有改進的空間。 –

+0

請注意,對Scaladoc 2的第一個版本有強烈的抵制 - 因爲,說實話,它比Javadoc-like Scaladoc差。在它變得可用之前已經進行了很多次迭代,直到最近它纔得到一個體面的CSS。 –

+1

同樣類型的問題被問到這裏:http://stackoverflow.com/questions/1026553/are-there-some-good-and-modern-alternatives-to-javadoc – paradigmatic

回答

3

最近,對於Java 7,JavaDoc得到了改進,因此它可以使用自定義CSS。以下是第一批結果:http://download.java.net/jdk7/docs/api/。工作繼續進行,我想我們會在新的更新出現時看到更多。我確實贊同ScalaDoc的優越性,但他們不必處理15年的遺留問題。

enter image description here

enter image description here

+0

好的,所以他們添加了CSS,這很棒,但它並沒有提高可用性,這是我的觀點中的主要問題 – seb

+0

就像我說的 - 給他們一些時間:) –

+0

總有(至少,自1.2或以上)爲Javadoc使用自定義樣式表的方式(請參閱['-stylesheetfile'選項](http://download.oracle.com/javase/6/docs/technotes/tools/solaris/javadoc.html #stylesheetfile))。不過,也許現在他們改變了HTML輸出的風格。 –

1

Javadoc中提供該格式的輸出,並且其在該地址公佈,我想沒有人真正看到了改進的需要,但是既然你提到它,它使一個有趣的項目。我搜索了一下,看看有沒有更好的界面,但沒有運氣。

您可以運行的javadoc -h,看看有什麼額外的選項可供選擇,如果你想重新生成的javadoc。一些有趣的是提供自定義頁眉/頁腳和鏈接到源,但沒有什麼效果,你問。

1

這些HTML頁面中使用Javadoc工具,在Java構建文檔標準的方式進行。

我不知道是否有更好的API格式的其他網頁,但如果它幫助你做任何事情,並且你正在使用IDE和SDK,你可以看到大部分的源代碼文件在那裏。

0

JavaDoc的被設計成最小公分母。幾乎任何Web瀏覽器都可以顯示它,即使沒有JavaScript支持。

如果您正在尋找更快地訪問和搜索功能,您可以從IDE中訪問的JavaDoc,比如Eclipse。

+1

是的,我認爲它只是**夠好**。我並不需要搜索功能。 –