Nach einigen Untersuchungen, ich habe diese scheint entschieden ein Fehler zu sein, aber nur, weil es leicht kontraintuitiv ist .
Beachten Sie Folgendes:
The Main Section {#the_main_section}
================
Subsection One {#first}
--------------
Something highly interesting...
Das Dokument beginnt mit einem Level 1-Header (wie here beschrieben) und so Doxygen parst „Der Hauptteil“ als Namen und Titel der Seite. Der Header und das Label {#the_main_section} scheinen ignoriert zu werden, sobald der Header in einen Seitennamen konvertiert wurde.
Die Verarbeitung geht dann zum Rest des Dokuments über und wenn es "Unterabschnitt Eins" erreicht, glaubt es, dass es keinen übergeordneten "Abschnitt" für den "Unterabschnitt" gibt (da der "Abschnitt" in eine Seite konvertiert wurde) Name) und das ist, wo es würgt.
Genauer gesagt, verwirft es den Unterabschnitt (Header), da es glaubt, dass es keinen übergeordneten "Abschnitt" gibt. Der gesamte übrige Text bleibt bestehen, wird aber als Teil der "Seite" behandelt (ohne übergeordneten Abschnitt).
Die "Lösung" ist, einen weiteren "Level 1 Header" nach dem anfänglichen "Level 1 Header" hinzuzufügen, z.
My Great Documentation (Which Becomes the Page Name)
====================================================
The First Section
=================
Q. What? I already created a level 1 heading?
A. Yup, but that was converted to a page name/title and discarded, so now
we have to create another level 1 heading for my first section. Don't
be fooled into thinking that the opening heading in this document is
still treated as an opening heading by Doxygen - it's not!
Ich konnte dieses Verhalten in einem einfachen Testfall mit einer standardmäßig generierten Konfigurationsdatei für Doxygen 1.8.2 nicht reproduzieren. Sehen Sie dieses Verhalten in einem eigenständigen Testfall oder als Teil eines größeren Dokumentsatzes? Möglicherweise müssen Sie den genauen Inhalt der Dateien, mit denen Sie arbeiten, einschließlich der Konfigurationsdatei, posten. – DRH
Gleiches "Problem" mit 1.8.8. Ich hatte eine README.md, die genau dasselbe tat, aber ohne die Beschriftung für den obersten Header. –