[Java lista] Word dokumentáció Doclet-tel

[istvan.ketler at lhsystems.com]

Sziasztok,
 
hát, van egy DocFlex/Doclet freeware, illetve fizetős (többet tudó) bátyuskája, a DocFlex/Javadoc. Nem tudom, mennyire jó, de szerintük a generált template "looking almost identical to the HTML produced by the default doclet". 
 
Egyebekben wordről fogalmam sincs, de cocoon + POI, meg néhány xslt egész használható excel sheetet generál nekem (gnumerics formátum a végcél, azt teljesen jól konvertálja a POI). A doclet meg ugye lehet jól formázott. Viszont irdatlan genyó meló összerakni egy táblázatot, és az xslt sem az a kimondottan jól használható valami, ha dinamikus az adatszerkezet. Mondjuk ha ügyfélnél akarod összerakni, akkor ez így eléggé ágyúval verébre, de ha nincs más... Persze az xslt engine jávából is közvetlenül használható, de ilyet meg aztán végképp nem csináltam. A CSS kezelése viszont már más káposzta, ha táblázatról táblázatra változhat. Ha nem, akkor azt külön kell értelmezni, és a végén kell formázni. A gnumericsnek egy régebbi változatát eszi meg jelenleg a poi, így a képek beszúrását, illetve html formázott szöveg cellába való beszúrását nem tudja alapból, viszont az open forráskód miatt ezen a problémán is úrrá lehet lenni. A táblázatod viszont valszeg elég jó lesz, hiszen az excel ugye egy tábla... A wordbe meg már elég jól át lehet másolni, azt a microfost belül egész jól megcsinálta. Ja, és xalan helyett xerces, az tudja az xslt 2.0-t is. Mindenesetre szerintem csak akkor érdemes nekivágni, ha az igény "no go otherwise", és kicsit sem "urgent". Különösen a css jó kezelése gond lehet.
 
Másik mód lehet, hogy generálsz egy olyan word doksit, amilyet szeretnél kapni a doclet-ből, és elmented html formátumban. Ezzel megvan a forrás formátum, és a cél formátum. Némi xslt köztes transzformációval valszeg lehet doclet html-ből word html-t gyártani. A word 2003 html kódja például jól formázott(nak tűnik), és látszólag valójában xhtml. Na persze valszeg a doclet is generálhat ilyen formátumot, de szerintem könnyebb utólag konvertálni.
 
Üdvözlettel,
 
Iván
 

________________________________

From: javalist-bounces at javagrund.hu [mailto:javalist-bounces at javagrund.hu] On Behalf Of Zsombor
Sent: Sunday, June 21, 2009 1:30 PM
To: javalist at javagrund.hu
Subject: Re: [Java lista] Word dokumentáció Doclet-tel


Az Apache POI-val volt egy próbálkozásom két éve, akkor a beolvasott word doksit nem tudta jól visszairni ... szerencsére rá lehetett beszélni a klienst a PDF használatára.

Zs


2009/6/21 Kristof Jozsa <kristof.jozsa at gmail.com>


	szerintem egyedül az új wordok xml alapú formátumával juthatsz bármi komolyabb eredményre de kegyetlen meló azt kézzel templatelni :(
	
	K
	
	
	2009/6/21 István Viczián <viczian.istvan at gmail.com> 


		Sziasztok,
		
		Próbálok Word dokumentációt generálni Doclet-tel, de nem sikerül.
		Kezdtem az egyszerű iránnyal, nagyon egyszerű HTML-ből copy-paste, nem
		jött össze, a táblázatok kerete rettentő csúnyán néz ki, a CSS-sel nem
		foglalkozik a Word.
		Utána nekimentem nehéztüzérséggel, Doclet + Velocity -> DocBook -> FOP
		-> RTF, nohát az eredmény komikus lett, táblázat megjelenítése
		minősíthetetlen, írják is a weben, hogy ez a formátum nem jó erre.
		Próbáltam PDF-be, de ott is a táblázaton belül a hosszú szavak
		összelógnak, és a klasszikus probléma, nincs ő, ű. Nem is lenne baj,
		gondolom ezeket ki lehet kerülni, de PDF-ből sem lehet normálisan
		Word-be copy-paste-elni, a konvertálók meg használhatatlan eredményt
		hoztak.
		
		Úgy érzem, hogy egyedül a Word saját csoda XML állománya lenne a
		nyerő, template-elve, de az meg nem tetszik.
		
		Kerestem létező Doclet-et rá, de személyre szeretném szabni, ezt vagy
		nem lehet, vagy megszűntek, vagy használhatatlanok.
		
		Ti hogyan csináljátok?
		
		Ilyen "felejtsem el a Word-öt", meg "használjak PDF-et, OpenOffice-t"
		tanácsokkal nem tudok mit kezdeni, mert nem opció. Amúgy ez az XML,
		DocBook, XSLT, FOP, Xalan világ ugyanolyan gáz, mint pár éve volt,
		folyamatosan 2005-2008-ban jelentett issue-kba futottam bele,
		tizedverziókat pászítottam össze, stb. Kerüljétek! A honlapokon
		szereplő példa generált PDF dokumentumok is nevetségesek egy Word-höz
		képest is, ne is beszéljünk egy kiadványtervező végtermékével képesti
		különbségekről. Összelógnak a képek, össze-vissza vannak az
		oldaltörések, tipográfiailag minősíthetetlenek. Persze lehet
		ugyanabból az XML-bl man page-t, meg Windows Help-et is generálni, de
		minek.
		
		Viczi
		_______________________________________________
		Javalist mailing list
		Javalist at javagrund.hu
		http://javagrund.hu/mailman/listinfo/javalist
		



	_______________________________________________
	Javalist mailing list
	Javalist at javagrund.hu
	http://javagrund.hu/mailman/listinfo/javalist
	
	



 
Sitz der Gesellschaft / Corporate Headquarters: Lufthansa Systems Hungaria Kft, Budapest, Fövarosi Birosag 01-09-463417
Geschaeftsfuehrung / Management Board: Monika Houck


--------- következő rész ---------
Egy csatolt HTML állomány át lett konvertálva...
URL: http://javagrund.hu/pipermail/javalist/attachments/20090622/c3c79252/attachment.html