V svojem zadnjem prispevku sem se na kratko skliceval na prispevek Jonathana Gibbonsa Kaj se dogaja, JavaDoc? ki opisuje nekatere nedavne spremembe Javadoca, vključno s spremembami, ki omogočajo uporabo slogovnega lista CSS v dokumentaciji. Prispevek Marka Reinholda JDK 7: Smo že tam? govori o spremembah privzetega sloga prikaza Java API 7 API. V tej objavi na kratko pogledam to spremembo.
Naslednja dva posnetka zaslona prikažeta tradicionalni privzeti videz dokumentacije Javadoc, ki smo ga videli že leta, nato pa nov privzeti videz.
Ta privzeti slog ni omejen na standardno dokumentacijo SDK API. Uporablja se tudi za ustvarjanje Javadoc po meri za druge Java programe. Naslednji posnetek zaslona prikazuje, kako Javadoc prikliče prek Ant s pomočjo JDK 7 build 146 (gradnja, ki podpira novo oblikovanje). Primer, zgrajen v tem primeru, je koda iz mojega prispevka Kako sem se naučil nehati skrbeti in ljubiti Ternarnega operaterja Jave.
Kot kaže posnetek zaslona, nisem naredil nič posebnega, da bi uporabil nov slog. Izhod pa je nov (in mislim, da se je izboljšal), kot je prikazano v naslednjih nekaj posnetkih.
Ustvarjeni imenik Javadoc vključuje datoteko z imenom stylesheet.css. To besedilno datoteko lahko spremenite tako, da enostavno spremenite videz. Naslednji posnetek zaslona prikazuje, kako izgleda, ko spremenim .rowColor, .altColor, in Barva ozadja od telo.
Ne priporočam barv v zgornjem posnetku zaslona; namenjeni so zgolj dokazovanju, kako enostavno je spremeniti videz predstavitve.
Zaključek
Všeč mi je novi privzeti slog in prihaja "iz škatle" brez novih naporov od JDK 7 build 146. To je le manjša in v veliki meri kozmetična izboljšava, vendar je kljub temu dobrodošla.
Izvirna objava je na voljo na //marxsoftware.blogspot.com/ (navdih dejanski dogodki)
To zgodbo, "Izgled nove dokumentacije Java Java 7 API dokumentacije Java", je prvotno objavil JavaWorld.
