markdown - plantilla - readme md style
Utilice el archivo README.md como página principal en Doxygen (2)
La documentación de los estados de Doxygen, que puedo usar el etiquetado de título PHP Markdown Extra en un archivo de reducción, pero ninguno
# Main Page # {#mainpage}
ni
# Main Page # {#index}
funciona, pero la etiqueta tampoco está presente en el resultado como texto sin formato. Esta es la primera línea por cierto.
Tampoco puedo hacer referencia a esa página ni con las etiquetas anteriores, ni con el nombre del archivo.
También tengo un archivo main.dox que contiene un comando especial /mainpage , pero también intenté todo lo anterior con quitar una barra antes de ellos (para hacer solo dos).
Estoy usando Doxygen 1.8.2 (descargado) y 1.8.1.1 (desde MacPorts) para la tarea.
¿Cómo puedo lograr esto entonces?
Además, ¿cómo puedo marcar un archivo de marcado como parte de un idioma específico?
EDITAR: he habilitado el soporte de marcado, y el archivo aparece en las páginas referenciadas.
En la próxima versión de doxygen (1.8.3) planeo introducir una nueva opción de configuración USE_MDFILE_AS_MAINPAGE que se puede utilizar para especificar una página de USE_MDFILE_AS_MAINPAGE que se utilizará como página principal. Luego puede configurar doxygen de la siguiente manera:
INPUT = README.md other_sources
USE_MDFILE_AS_MAINPAGE = README.md
y funcionará independientemente de los títulos de la página.
Intente lo siguiente para marcar el título como un encabezado de nivel 1:
Main Page {#mainpage}
=========
Con doxygen 1.8.2, esto hace que la página sea la página index.html para mí.
El documento doxygen dice que al comenzar una línea con un único # declara un encabezado de nivel 1, pero parece que tampoco funciona para mí.