Programavimas

Nauja „Java SE 7 Javadoc“ API dokumentacijos išvaizda

Paskutiniame įraše trumpai nurodžiau Jonathano Gibbonso įrašą „Kas vyksta,„ JavaDoc “? jame aprašomi kai kurie naujausi „Javadoc“ pakeitimai, įskaitant pakeitimus, leidžiančius CSS stiliaus lentelę pritaikyti dokumentacijai. Marko Reinholdo pranešimas JDK 7: Ar mes jau ten? kalbama apie „Java SE 7“ API numatytojo rodymo stiliaus pakeitimus. Šiame įraše trumpai apžvelgiu šį pokytį.

Kiti du ekrano momentiniai vaizdai rodo tradicinę numatytą „Javadoc“ dokumento išvaizdą, kurią matėme daugelį metų, ir tada demonstruoja naują numatytąją išvaizdą.

Šis numatytasis stilius neapsiriboja standartine SDK API dokumentacija. Jis taip pat naudojamas kuriant pritaikytą „Javadoc“ kitoms „Java“ programoms. Kitame ekrano momentiniame vaizde matoma, kaip „Javadoc“ yra iškviečiamas per „Ant“ naudojant JDK 7 146 (naująjį stilių palaikantį) kūrimą. Šiuo atveju sukurtas pavyzdys yra kodas iš mano įrašo „Kaip aš išmokau nustoti jaudintis ir mylėti„ Java “trijų komponentų operatorių“.

Kaip rodo ekrano momentinė nuotrauka, aš nepadariau nieko ypatingo, kad pritaikyčiau naują stilių. Tačiau išvestis yra nauja (ir manau, kad patobulinta), kaip parodyta kitose poroje nuotraukų.

Sukurtame „Javadoc“ kataloge yra failas, vadinamas stylesheet.css. Šį tekstinį failą galima pakeisti, kad būtų lengva pakeisti išvaizdą. Kitas ekrano momentinis vaizdas rodo, kaip jis atrodo, kai pakeisiu .rowColor, .altColor, ir fono spalvakūnas.

Nerekomenduoju spalvų, pateiktų pirmiau pateiktoje ekrano nuotraukoje; jie tik skirti parodyti, kaip lengva pakeisti pristatymo išvaizdą.

Išvada

Man patinka naujas numatytasis stilius ir jis „iš dėžutės“ atsiranda be jokių naujų pastangų, nes JDK 7 pastatytas 146. Tai tik nedidelis ir daugiausia kosmetinis patobulinimas, tačiau vis dėlto tai sveikintina.

Originalų skelbimą galima rasti adresu //marxsoftware.blogspot.com/ (įkvėpta faktinių įvykių)

Šią istoriją „Naujas„ Java SE 7 Javadoc API “dokumentacijos išvaizda“ iš pradžių paskelbė „JavaWorld“.