Estoy interesado en escribir una "introducción" en la página index.html, en lugar de tener espacio en blanco. ¿Esta es una característica compatible con la herramienta Doxygen, o debo armar un hack?¿Hay alguna forma de personalizar la salida de Doxygen index.html (y el equivalente de látex)?
Esta es contestada por la primera pregunta en el Doxygen FAQ:
1. ¿Cómo obtener información sobre la página de índice en HTML?
Debe utilizar el comando \ MainPage dentro de un bloque de comentarios como éste:
/*! \mainpage My Personal Index Page * * \section intro_sec Introduction * * This is the introduction. * * \section install_sec Installation * * \subsection step1 Step 1: Opening the box * * etc... */
Si usted está buscando las portadas más personalizadas en ambas salidas LaTeX y HTML, también puede que quiera jugar con las etiquetas LATEX_HEADER y HTML_HEADER (y HTML_FOOTER).
Oh, vamos Oli, ¿por qué alguien miraría la primera pregunta de las preguntas frecuentes? :-) (+1 por cierto) – Praetorian
Merece la pena señalar que este comentario (y cualquier otra documentación complementaria) puede existir en un archivo de texto plano que contiene solo el marcado de Doxygen y sin código, independientemente de cualquier archivo de código fuente y agregado a el proyecto Doxygen. – Clifford