2011-07-04 5 views
9

私はスカラ座で遊んで開始して以来、私は、Java APIに関する一つの大きな疑問を持っていた:なぜオラクルは、すべての「フレームセット」タグなしの検索機能をsame old HTMLページを維持していますか?それは彼らがWeb 2.0にそれを作っていないように見える...のJava APIインタフェース

Scala API documentation一方、ウェブの歴史の中で最高のウェブサイトではありませんが、いくつかの桁がより有効です。つまり、なぜ誰もが知っていればより良いインターフェースを持つJava APIのドキュメントが存在する場合

とにかく、そして、もっと重要なのは、私に知らせてください!

+0

[Java 7 API Docs](http://download.java.net/jdk7/docs/api/)は少し違って見えます...しかし、私は改善の余地があることに同意します。 –

+0

Scaladoc 2の最初のバージョンには強い抵抗があったことに注意してください。正直なところ、Javadocのような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を再生成する場合は、javadoc -hを実行して、使用可能な追加オプションを確認することができます。興味深いのはカスタムヘッダー/フッターとソースへのリンクを提供することですが、あなたが求めているものは何もありません。

1

これらのHTMLページはJavadocツール、Javaでドキュメントをビルドするための標準的な方法を用いて作製しました。

APIのフォーマットが整っている他のWebページがあるかどうかはわかりませんが、IDEとSDKを使用している場合は、ほとんどのソースコードを見ることができますそこにファイル。

0

のJavaDocは、最小公分母であるように設計されました。 JavaScriptをサポートしていなくても、ほとんどのWebブラウザで表示できます。

より迅速なアクセスと検索機能をお探しの場合は、EclipseなどのIDE内からJavaDocにアクセスできます。

+1

はい、私はそれが単に**十分に**だったと思います。私は本当に検索機能は必要ありません。 –

関連する問題