Viimeisessä viestissä viittasin lyhyesti Jonathan Gibbonsin viestiin Mitä tapahtuu, JavaDoc? joka kuvaa joitain viimeaikaisia muutoksia Javadociin, mukaan lukien muutokset, jotka sallivat CSS-tyylitaulukon soveltamisen dokumentaatioon. Mark Reinholdin viesti JDK 7: Olemmeko vielä siellä? puhuu Java SE 7 -sovellusliittymän oletusnäyttötyylin muutoksista. Tässä viestissä tarkastelen lyhyesti tätä muutosta.
Seuraavat kaksi näytön tilannekuvaa osoittavat perinteisen Javadoc-dokumentaation oletusnäkymän, jota olemme nähneet vuosia, ja sitten uuden oletusnäkymän.
Tämä oletustyyli ei rajoitu SDK: n tavalliseen sovellusliittymädokumentaatioon. Sitä käytetään myös muokatun Javadocin luomiseen muille Java-sovelluksille. Seuraava näytön tilannekuva näyttää Javadocin kutsuneen Antin kautta JDK 7 -rakennuksella 146 (rakennetta, joka tukee uutta muotoilua). Tässä tapauksessa rakennettu esimerkki on koodi viestistäni Kuinka opin oppimaan lopettamaan huolestumisen ja rakastamaan Javan kolmikantaisen operaattorin.
Kuten näytön tilannekuva osoittaa, en tehnyt mitään erityistä uuden tyylin soveltamiseksi. Tulos on kuitenkin uusi (ja mielestäni parantunut), kuten seuraavissa parissa otoksissa näkyy.
Luodussa Javadoc-hakemistossa on tiedosto nimeltä stylesheet.css. Tätä tekstitiedostoa voidaan muuttaa ulkoasun muuttamiseksi helposti. Seuraava näytön tilannekuva näyttää miltä se näyttää, kun vaihdan .rowColor, .altColor, ja taustaväri n runko.
En suosittele yllä olevan kuvakaappauksen värejä; niiden tarkoituksena on vain osoittaa, kuinka helppoa on muuttaa esityksen ulkonäköä.
Johtopäätös
Pidän uudesta oletustyylistä, ja se tulee "laatikosta" ilman uusia ponnistuksia JDK 7: n rakennuksen 146. jälkeen. Tämä on vain vähäinen ja suurelta osin kosmeettinen parannus, mutta se on kuitenkin tervetullut.
Alkuperäinen julkaisu on saatavana osoitteessa //marxsoftware.blogspot.com/ (Innoittamana Todelliset tapahtumat)
Tämän tarinan "Uusi Java SE 7 Javadoc API -dokumentaation ulkonäkö" julkaisi alun perin JavaWorld.
