He documentado mi código doxygen, pero no quiero el HTML predeterminado que proporciona. Sé que puedo personalizarlo al proporcionar CSS personalizado, encabezados, pies de página, etc. (como lo hace GNOME), y cómo puedo agregar código PHP común a los archivos y decirle que guarde como .php, pero eso no es realmente lo que quiero .
Lo que quiero es una salida como MSDN. No puedo describirlo realmente. Mi pregunta es, ¿es posible usar doxygen con algo como plantillas, o tengo que generar XML y analizarlo con otro programa (que no me importaría escribir)?
documentation
templates
documentation-generation
Cole Johnson
fuente
fuente
Respuestas:
Doxygen no admite algo como plantillas HTML listas para usar, por lo que sé. Puede consultar la imagen a continuación (desde la página de inicio oficial de doxygen ). Muestra los archivos de entrada y salida relacionados con todo el flujo de trabajo de creación de documentación.
Como puede ver, doxygen lee un llamado "archivo de diseño". Este archivo puede ser personalizado ! Sin embargo, de alguna manera está restringido a la estructura de la página, doxygen crea.
Si necesita más flexibilidad, debería preferir XSLT transformar la salida XML . También hay una muestra que le muestra cómo hacer esto.
fuente