Formātā APT uzrakstītu dokumentāciju var konvertēt uz dažādiem formātiem. T.sk. uz HTML lapām, uz PDF dokumentiem, uz DocBook utml. Zemāk izklāstīsim dažus tipiskus dokumentācijas iegūšanas gadījumus.
Savākt programmu aptconvert mājaslapā. Atarhivēt to, teiksim, zem c:\tools\aptconvert-050713. Var pievienot direktoriju C:\tools\aptconvert-050713\distrib sistēmas vides mainīgajam "Path", lai gan "aptconvert" vēlamāk izsaukt ar Ant skripta palīdzību (sk. zemāk), nevis no komandrindas - programmai ir daudz parametru.
Izčeko projektu "java-eim-parent" un izpilda komandu:
mvn -N clean site
Karodziņš "-N" ir nepieciešams, lai vietnes veidošana nenotiktu rekursīvi (projektam "java-eim-parent" ir daudzi apakšprojekti, kas atrodas blakus direktorijās, un kuru nosaukumi sākas ar "java-eim-"). Rekursīvas "site" izpildes gadījumā katram no apakšprojektiem arī tiktu veidota "noklusētā" dokumentācija - ikreiz rastos daudz nevajadzīgu failu.
Ir vairākas iespējas, kā iegūt PDF dokumentus. Viena ir APT failus pārveidot par LaTeX, tālāk par DVI, un visbeidzot par PDF. Vai arī APT pārveido par DocBook, pēc tam par FO (Formatted Objects) un visbeidzot par PDF. Aprakstām pieeju, ja lieto LaTeX/DVI starpformātus.
Šo risinājumu var izmantot tad, ja dokumentācijai izstrādātājs pievieno jaunus attēlus, un rodas nepieciešamība no jauna gjenerēt PDF.
bmeps kde_start_button.png kde_start_button.eps