Doxygen HTML-tag nach einem @ - snippets Befehl

Ich habe einen ALIAS angelegt, um embedd ein \snippet in einem HTML - <div></div>

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

Dann habe ich den alias verwenden, wie diese:

@snippetLang{CS,ExampleForm.cs OnShow example}

Die Parameter erweitert, in Ordnung, aber seit snippet zweiten parameter spands an das Ende der Zeile, die </div> - tag enthalten sein.

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

Die \snippet - Befehl werden jetzt nach die Referenz "OnShow example </div>" anstelle des "OnShow example"

Gibt es eine Möglichkeit, um doxygen erweitern Sie den Befehl, wo die \snippet \1 auf einer eigenen Zeile, wie diese?

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

Die Doxygen-version 1.8.14

1 Antworten

  • albert
    4. Mai 2019

    Aus der doxygen-Dokumentation:

    ALIASES Dieser tag kann verwendet werden, um anzugeben, eine Anzahl von Aliasnamen, die handeln als Befehle in der Dokumentation. Analias hat die form: name=Wert Für Beispiel für das hinzufügen einer "Nebenwirkung=@par Nebenwirkungen:\n" erlaubt es Ihnen sich zu setzen der Befehl \Nebenwirkung (oder @Nebeneffekt) in der Dokumentation, die wird in Folge einer Benutzer-definierten Absatz mit der überschrift "Nebenwirkungen:". Sie können \n ' s im value-Teil ein alias zum einfügen von Zeilenumbrüchen (in die resultierende Ausgabe). Sie können setzen ^^ im value-Teil ein alias zu eine neue Zeile zu beginnen, als ob eine physische newline war in der ursprünglichen Datei. Wenn Sie einen literalen { oder } oder , im value-Teil ein alias, den Sie haben, Ihnen zu entkommen durch einen umgekehrten Schrägstrich (), kann dies dazu führen, Konflikte mit den Befehlen{ und } für diese ist es ratsam, zu verwenden die version @{ und @} oder verwenden Sie eine doppelte Escapezeichen (\{ und \})

    Die version:

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

    die Arbeit wird für die version 1.8.14 und bis

    die version

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

    die Arbeit wird für te-Versionen von vor 1.8.14