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

István Viczián viczian.istvan at gmail.com
2009. Jún. 21., V, 02:01:27 CEST


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


További információk a(z) Javalist levelezőlistáról