Programmēšana

Jauna Java SE 7 Javadoc API dokumentācijas izskats

Savā pēdējā ierakstā es īsumā atsaucos uz Džonatana Gibonsa ierakstu Kas notiek, JavaDoc? kas apraksta dažas nesenās izmaiņas Javadoc, tostarp izmaiņas, kas ļauj CSS stila lapu izmantot dokumentācijā. Marka Reinholda ziņojums JDK 7: Vai mēs jau esam tur? runā par izmaiņām Java SE 7 API noklusējuma displeja stilā. Šajā amatā es īsi aplūkoju šīs izmaiņas.

Nākamie divi ekrāna momentuzņēmumi parāda tradicionālo Javadoc dokumentācijas noklusējuma izskatu, kuru esam redzējuši gadiem ilgi, un pēc tam demonstrē jauno noklusējuma izskatu.

Šis noklusējuma stils neaprobežojas ar standarta SDK API dokumentāciju. To izmanto arī, lai ģenerētu pielāgotu Javadoc citām Java lietojumprogrammām. Nākamajā ekrāna momentuzņēmumā ir redzams, ka Javadoc tiek izsaukts caur Ant, izmantojot JDK 7 146. versiju (jauno veidojumu atbalstošā konstrukcija). Šajā gadījumā izveidotais piemērs ir kods no manas ziņas Kā es iemācījos pārtraukt uztraukties un mīlēt Java trīsdaļīgo operatoru.

Kā norāda ekrāna momentuzņēmums, es nedarīju neko īpašu, lai piemērotu jauno stilu. Tomēr rezultāts ir jauns (un es domāju, ka uzlabots), kā parādīts nākamo pāris momentuzņēmumos.

Ģenerētajā Javadoc direktorijā ir fails ar nosaukumu stylesheet.css. Šo teksta failu var mainīt, lai viegli mainītu izskatu. Nākamais ekrāna momentuzņēmums parāda, kā tas izskatās, kad mainu .rowColor, .altColorun fona krāsa no ķermeņa.

Es neiesaku iepriekšminētā ekrāna momentuzņēmuma krāsas; tie ir tikai domāti, lai parādītu, cik viegli ir mainīt prezentācijas izskatu.

Secinājums

Man patīk jaunais noklusējuma stils, un tas nāk no „kastes” bez jaunām pūlēm, sākot ar JDK 7 146. versiju. Tas ir tikai neliels un galvenokārt kosmētisks uzlabojums, taču tas tomēr ir apsveicami.

Sākotnējā izlikšana pieejama vietnē //marxsoftware.blogspot.com/ (iedvesmojoties no faktiskajiem notikumiem)

Šo stāstu "Jauna Java SE 7 Javadoc API dokumentācijas izskats" sākotnēji publicēja JavaWorld.

$config[zx-auto] not found$config[zx-overlay] not found