po pewnym dochodzenia, postanowiłem to pojawia być błąd, ale tylko dlatego, że jest nieco sprzeczne z intuicją .
Rozważmy następujący:
The Main Section {#the_main_section}
================
Subsection One {#first}
--------------
Something highly interesting...
Dokument rozpoczyna się od poziomu 1 nagłówka (jak opisano here) i tak Doxygen analizuje „głównej sekcji” jako nazwisko i tytuł strony. Nagłówek i etykieta {#the_main_section} wydają się być zignorowane po przekonwertowaniu nagłówka na nazwę strony.
Przetwarzanie następnie przechodzi do reszty dokumentu i Kiedy dotrze do "Podsekcji pierwszej", uważa, że nie ma rodzica "Sekcja" dla "podsekcji" (jak "Przekrój" został przekonwertowany na stronę imię i nazwisko) i tu się dławi.
Dokładniej, odrzuca podsekcji (nagłówek), ponieważ uważa, że nie ma rodzica "sekcji". Cały pozostały tekst pozostaje, ale jest traktowany jako część "strony" (bez rodzica sekcji).
"Poprawka" polega na dodaniu innego "nagłówka poziomu 1" po początkowym nagłówku "pierwszego poziomu", np.
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!
Nie mogłem odtworzyć tego zachowania w prostym przypadku testowym z domyślnym wygenerowanym plikiem konfiguracyjnym dla Doxygen 1.8.2. Czy widzisz to zachowanie w samodzielnym teście lub jako część większego zestawu dokumentów? Może być konieczne opublikowanie dokładnej zawartości plików, z którymi pracujesz, w tym pliku konfiguracyjnego. – DRH
Ten sam "problem" z 1.8.8. Miałem plik README.md, który zrobił dokładnie to samo, ale bez etykiety dla najwyższego nagłówka. –