2012-03-09 12 views
7

Realmente no creo que el tema Doxygen HTML para documentar el código C sea bueno para documentar funciones y procedimientos (aunque es asombroso documentar OOP si usa C++). Entonces, ¿qué puedo preguntar si la salida puede cambiarse para parecerse a SDL Documentation o GTK Documentation?¿Cambiar el tema de Doxygen?

¿O existe otro sistema de documentación que produzca resultados similares?

+1

Esas dos páginas se ven muy diferentes entre sí. Probablemente tengas más posibilidades de obtener respuestas útiles si pudieras editar tu pregunta para decir qué aspectos de esas otras páginas quieres ver en tu salida de Doxygen. –

Respuesta

23

Para obtener una descripción completa de las opciones para personalizar la salida de doxígeno, consulte http://www.stack.nl/~dimitri/doxygen/customize.html.

+1

+1, por curiosidad, dado que su nombre es 'doxygen', ¿podría usted en realidad ser uno de los contribuyentes al proyecto doxygen? – ApprenticeHacker

+15

@IntermediateHacker: sí, como dice mi perfil: "Soy el creador y principal desarrollador de la herramienta de documentación de código abierto Doxygen". ;-) – doxygen

+1

¡eso es asombroso! – ApprenticeHacker

2

Doxygen le permite establecer algunas opciones que controlan el aspecto de la salida. en general, comienzan con HTML_. Para una flexibilidad máxima, puede proporcionar HTML personalizado de encabezado y pie de página, así como una hoja de estilo CSS personalizada, a través de las opciones HTML_HEADER, HTML_FOOTER y HTML_STYLESHEET.

No puede hacer mucho para controlar la estructura utilizada en la parte principal de la página, pero puede hacer un poco con la hoja de estilo, y como último recurso, siempre puede agregar algo de javascript al encabezado que manipula el DOM para reorganizar las cosas.

Puede generar encabezado de plantilla, pie de página y archivos de hoja de estilo con el argumento -w; y todo esto está documentado razonablemente bien en el archivo de configuración de plantilla generado con el argumento -g.

Cuestiones relacionadas