DocBook Doclet

DocBook Doclet crea DocBook XML e diagrammi di classe da commenti Javadoc, converte HTML a DocBook, e transfoms DocBook XML in vari formati di output. Si tratta di una distribuzione DocBook completa che contiene schemi e i fogli di stile XSL DocBook. Si integra inoltre Apache FOP come XSL: FO processore. Un'applicazione Swing è utilizzato per personalizzare i doclet e la maggior parte dei parametri DocBook XSL e per avviare le trasformazioni.

Tag	Sviluppo Software Documentazione Text Processing markup XML DocBook
Licenze	Gratuito
Implementazione	Giava

Sito web

Scarica

Rilascio tag
Tutti i comunicati
Versioni più recenti

6.0.2

31 Ottobre 2011 22:09

Note di rilascio: correzioni e miglioramenti GUI.

6.0.1

18 giu 2011 11:00

Note di rilascio: Generazione di file EPUB è stata fissata, e le immagini possono essere incorporati nell'archivio zip EPUB. Generazione di JavaHelp è stato fissato. Relativo file di immagini di riferimento sono incorporati nella directory di base di HTML, JavaHelp e Guida Eclipse. RTF e pagine man sono ora supportati. Il parametro generate.toc è ora supportato, e la generazione di ToC / lotti è ora configurato utilizzando una finestra di dialogo speciale. I file di personalizzazione sono ora versioni. Un aggiornamento è stato fatto per fop 1.0 e docbook-xsl 1.76.1. Il supporto per Java 5 è stato interrotto.

5.2.6

18 Apr 2011 13:55

Note di rilascio: Il rilevamento automatico dei font di sistema è stata aggiunta per la generazione di via XSL: FO. L'ultimo progetto è automaticamente riaperto durante l'avvio.

5.2.5

2 novembre 2010 15:47

Note di rilascio: generazione Epub è stata migliorata. Un semplice editor è stato aggiunto per i modelli di intestazione e piè di pagina. Un nuovo look and feel è utilizzato per il codice HTML generato. Stato aggiunto il supporto per il XSL-FO attributi text-indent, start-trattino, e fine trattino. Commutazione imperfetta tra i progetti è stato fissato. Errata disattivazione di per gruppi di proprietà è stato fissato. Sbagliato dimensione tabella di default è stata fissata. Il menu di articoli usati di recente è stata migliorata.

5.2.4

19 Lug, 2010 14:54

Note di rilascio: Questa è una release di manutenzione con correzioni minori e un parser HTML migliorato.

Tutti i commenti
Commenti recenti

6 settembre 2002 01:15

xmldoc

Strumento importante con alcune limitazioni di corrente

Si tratta di un'aggiunta importante al DocBook
toolchain - almeno altrettanto importante per la sua capacità di
fare "standalone" HTML-> conversione DocBook come lo è per
la sua capacità di produrre DocBook da sorgente Java
documentazione. E per quanto ne so non ci sono altre
strumenti open-source disponibile per convertire HTML in
DocBook.

A partire dalla versione 0.29, però, penso che non si può ancora
aspettiamo di produrre sempre DocBook valido che non
richiedono un po di pulizia manuale (anche se non sempre genera
pulito ben formato XML - ben rientrato pari).

Le limitazioni di validità che ho visto si riferiscono principalmente a
il fatto che HTML permettono certi tipi di markup
istanze che in realtà non sono complete, anche se sono
valido contro la DTD HTML. Quando questi casi markup ottenere
convertito in DocBook, che richiede più completo
strutture, potrebbero non essere validi.

Per, esempio, in HTML, è valido per una definizione
lista (elemento dl) per contenere solo un termine (dt) senza
descrizione corrispondente (gg). Ma il DocBook Doclet
convertirà, che a variablelist contenente un termine
ma non Listitem associati (l'equivalente di gg). Questo
genera errori di validità perché il variablelist
modello di contenuto richiede un ListItem.

Ma gli errori di validità del genere sono abbastanza facili da
trovare e ripulire manualmente, quindi non è quello grande di un
limitazione. Per le versioni future, sarebbe molto
utile avere una logica in DocBook Doclet per rilevare
e alcuni casi correggere automaticamente così,
in modo che essi non hanno bisogno di essere corretti manualmente.