Tampilan Dokumentasi API Javadoc Java SE 7 Baru

Di posting terakhir saya, saya secara singkat mereferensikan posting Jonathan Gibbons What's Up, JavaDoc? yang menjelaskan beberapa perubahan terbaru pada Javadoc, termasuk perubahan yang memungkinkan penerapan lembar gaya CSS ke dokumentasi. Posting Mark Reinhold JDK 7: Apakah kita sudah sampai? berbicara tentang perubahan pada gaya tampilan default Java SE 7 API. Dalam posting ini, saya secara singkat melihat perubahan ini.

Dua cuplikan layar berikutnya mendemonstrasikan tampilan default tradisional dari dokumentasi Javadoc yang telah kita lihat selama bertahun-tahun dan kemudian mendemonstrasikan tampilan default baru.

Gaya default ini tidak terbatas pada dokumentasi API SDK standar. Ini juga digunakan untuk membuat Javadoc kustom untuk aplikasi Java lainnya. Cuplikan layar berikutnya menunjukkan Javadoc sedang dipanggil melalui Ant menggunakan JDK 7 build 146 (build yang mendukung gaya baru). Contoh yang dibangun dalam hal ini adalah kode dari posting saya Bagaimana Saya Belajar untuk Berhenti Khawatir dan Mencintai Operator Ternary Java.

Seperti yang ditunjukkan oleh cuplikan layar, saya tidak melakukan sesuatu yang khusus untuk menerapkan gaya baru. Namun, hasilnya baru (dan menurut saya lebih baik) seperti yang ditunjukkan pada beberapa foto berikutnya.

Direktori Javadoc yang dihasilkan menyertakan file bernama stylesheet.css. File teks ini dapat diubah untuk mengubah tampilan dengan mudah. Layar berikutnya snapshot menunjukkan bagaimana tampilannya ketika saya mengubah .rowColor, .altColordan background-colordari body.

Saya tidak merekomendasikan warna pada snapshot layar di atas; mereka hanya dimaksudkan untuk menunjukkan betapa mudahnya mengubah tampilan presentasi.

Kesimpulan

Saya suka gaya default baru dan datang "di luar kotak" tanpa upaya baru sejak JDK 7 build 146. Ini hanya perbaikan kecil dan sebagian besar kosmetik, namun tetap diterima.

Pengeposan asli tersedia di //marxsoftware.blogspot.com/ (Terinspirasi oleh Acara Aktual)

Cerita ini, "Tampilan Dokumentasi API Javadoc Java SE 7 Baru" awalnya diterbitkan oleh JavaWorld.