Continuiamo con la serie “Mai più senza” e per farmi perdonare i 10 giorni di assenza, faccio una “doppietta” (dopo il post di ieri) parlandovi di un altro plugin per Eclipse (disponibile però anche come programma standalone): Java2HTML.
Questo programma è disponibile a http://www.java2html.de/ (e come plugin a http://www.java2html.de/eclipse.html) e permette una facile esportazione di programmi Java, ben formattati in HTML (con vari standard), LaTeX e RTF. Il funzionamento e la qualità dell’output sono davvero buoni e si dimostra uno strumento utile per chi deve documentare codice Java per qualsiasi motivo, e su diverse piattaforme.
La installazione del plugin è “old-style”: basta scompattare il plugin nella directory plugins di Eclipse e riavviare Eclipse. Da questo momento, facendo right-click su un file Java appare anche la voce Java2HTML. A dispetto del nome, il plugin permette la esportazione in diversi standard. Tra questi particolarmente utili sono LaTeX e RTF. E’ possibile esportare in un file oppure in una clipboard.
Per quanto riguarda LaTeX, la esportazione in un file (o nella clipboard) permette la creazione di un file stand-alone che quindi contiene un \begin{document} etc. Se, come di solito è il caso, si intende usare il documento all’interno di un altro, sarà necessario commentare le prime righe e l’ultima del documento .tex che si crea.
La stessa attenzione deve essere realizzata con RTF: facendo copy-and-paste dalla clipboard su Word, comporta l’inserimento del “sorgente” di RTF, non esattamente quello che si vuole. Per bypassare il problema, salvate in un file RTF, apritelo con Word ed a questo punto fate copy-and-paste e funziona bene.
Una caratteristica utile è inserire automaticamente il numero di linea per il codice, che può essere settato nella configurazione di Java2HTML, che si trova (forse poco intuitivamente) nella categoria “Java” delle Preferences.
L’output è davvero interessante, ed ottenuto con minimo sforzo. Un esempio in HTML è il seguente (l’output viene leggermente alterato dagli stylesheets di WordPress.. per vedere altri esempi vedete anche http://www.java2html.de/docs/styles.html):
* This is about <code>ClassName</code>. * {@link com.yourCompany.aPackage.SuperClass} * @author author */ public class ClassName extends SuperClass { /* This comment may span multiple lines. */ private int integer = 0; public final static char character = ‘A’; // This comment may span only this line private String string = “zero”; } |
La conclusione… inaspettata? “Mai più senza… Java2HTML!”
