2012-03-09 15 views
7

Non penso davvero che il tema Doxygen HTML per documentare il codice C sia utile per documentare funzioni e procedure (sebbene sia fantastico per documentare OOP se si usa C++). Quindi, quello che sto chiedendo è che l'output possa essere modificato per assomigliare allo SDL Documentation o GTK Documentation?Cambia il tema del Doxygen?

Oppure esiste un altro sistema di documentazione che produce output simili?

+1

Queste due pagine sembrano molto diverse l'una dall'altra. Probabilmente avrai maggiori probabilità di ottenere risposte utili se potresti modificare la tua domanda per dire quali aspetti di quelle altre pagine vuoi vedere nell'output di Doxygen. –

risposta

23

Per una panoramica completa delle opzioni per personalizzare l'output di doxygen, vedere http://www.stack.nl/~dimitri/doxygen/customize.html.

+1

+1, per curiosità, dato che il tuo nome è 'doxygen' potresti davvero essere uno dei contributori al progetto doxygen? – ApprenticeHacker

+15

@IntermediateHacker: sì, come dice il mio profilo: "Sono il creatore e lo sviluppatore principale dello strumento di documentazione open source Doxygen." ;-) – doxygen

+1

è fantastico! – ApprenticeHacker

2

Doxygen consente di impostare alcune opzioni che controllano l'aspetto dell'output. generalmente iniziano con HTML_. Per la massima flessibilità, puoi fornire l'intestazione personalizzata e il piè di pagina HTML, nonché un foglio di stile CSS personalizzato, tramite le opzioni HTML_HEADER, HTML_FOOTER e HTML_STYLESHEET.

Non si può fare molto per controllare la struttura utilizzata nella parte principale della pagina, ma si può fare un bel po 'con il foglio di stile, e come ultima risorsa si può sempre aggiungere qualche javascript all'intestazione che manipola il DOM per riorganizzare le cose.

È possibile generare file di intestazione, piè di pagina e foglio di stile con l'argomento -w; e tutto ciò è documentato ragionevolmente bene nel file di configurazione del modello generato con l'argomento -g.

Problemi correlati