Doxygen poner etiqueta HTML después de un @fragmentos de comando

He creado un ALIAS para embedd un \snippet en un HTML <div></div>

ALIASES += "snippetLang{2}=<div id='\1' class='snippetcontent'> \snippet \2 </div>"

Entonces yo uso el alias como este:

@snippetLang{CS,ExampleForm.cs OnShow example}

Los parámetros se expande bien, pero desde fragmento de segundo parámetro de spands para el final de la línea, el </div> etiqueta será incluido.

<div id='CS' class='snippetcontent'> \snippet ExampleForm.cs OnShow example </div>

El \snippet ahora el comando de buscar la referencia "OnShow example </div>" en lugar de sólo el "OnShow example"

Hay alguna forma de hacer doxygen ampliar el comando donde el \snippet \1 está en su propia línea, como esta?

<div id='CS' class='snippetcontent'>
\snippet ExampleForm.cs OnShow example
</div>

El Doxygen versión es 1.8.14

1 Respuestas

  • albert
    4 de mayo de 2019

    A partir de la documentación doxygen:

    Los ALIAS de Esta etiqueta se puede utilizar para especificar un número de alias que actuar como los comandos en la documentación. Analias tiene la forma: nombre=valor De ejemplo la adición de "efecto secundario=@par Efectos Secundarios:\n" le permitirá poner el comando \efecto secundario (o @efecto secundario) en la documentación, que el resultado será un usuario definido en el párrafo con el título "Efectos Secundarios:". Usted puede poner \n en el valor de la parte de un alias para insertar saltos de línea (en la salida resultante). Usted puede poner ^^ en el valor de la parte de un alias para insertar un salto de línea como si un físico newline estaba en el archivo original. Cuando usted necesita un literal { o } o , en el valor de la parte de un alias tienes que escapar de ellos, por medio de una barra diagonal inversa (), esto puede conducir a la los conflictos con los comandos de{ y } para que estos se aconseja la utilización de la versión @ y { @ } o el uso de una doble escape (\{ y \})

    La versión de:

    ALIASES += "snippetLang{2}=<div id='\1' class='snippetcontent'> \snippet \2 ^^</div>"

    va a funcionar para la versión 1.8.14 y hasta

    la versión

    ALIASES += "snippetLang{2}=<div id='\1' class='snippetcontent'> \snippet \2 \n</div>"

    trabajará para que te versiones desde antes de 1.8.14