कुछ जांच के बाद, मैं इस प्रकट होता है एक बग हो सकता है, लेकिन केवल क्योंकि यह थोड़ा जवाबी सहज है का फैसला किया है ।
निम्नलिखित पर विचार करें:
The Main Section {#the_main_section}
================
Subsection One {#first}
--------------
Something highly interesting...
दस्तावेज़ एक स्तर 1 हैडर (वर्णित here के रूप में) के साथ शुरू होता है और इसलिए Doxygen नाम और पृष्ठ के शीर्षक के रूप में पार्स करता है "मुख्य धारा"। हेडर को पेज नाम में परिवर्तित करने के बाद हेडर और लेबल {#the_main_section} को उपेक्षा किया जा सकता है।
प्रसंस्करण तब बाकी दस्तावेज़ पर चलता है और जब यह "सबसेक्शन वन" तक पहुंच जाता है, तो यह मानता है कि "उपधारा" के लिए कोई अभिभावक "खंड" नहीं है (जैसा कि "अनुभाग" को किसी पृष्ठ में परिवर्तित किया गया था नाम) और यह वह जगह है जहां यह चोक करता है।
अधिक विशेष रूप से, यह उपधारा (हेडर) को त्याग देता है क्योंकि ऐसा लगता है कि कोई अभिभावक "खंड" नहीं है। अन्य सभी पाठ बनी हुई है, लेकिन इसे "पृष्ठ" (किसी भी अनुभाग अभिभावक के साथ) के हिस्से के रूप में माना जाता है।
प्रारंभिक "स्तर 1 शीर्षलेख" के बाद "फिक्स" एक और "स्तर 1 शीर्षलेख" जोड़ना है।
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!
स्रोत
2012-12-19 13:36:34
मैं इस व्यवहार को एक साधारण परीक्षण मामले में पुन: पेश करने में असमर्थ था, जो कि डिज़ाइन 1.8.2 के लिए डिफ़ॉल्ट जेनरेट की गई कॉन्फ़िगरेशन फ़ाइल के साथ था। क्या आप इस व्यवहार को अकेले स्टैंड टेस्ट केस में या बड़े दस्तावेज़ सेट के हिस्से के रूप में देखते हैं? कॉन्फ़िगरेशन फ़ाइल सहित, जिन फ़ाइलों के साथ आप काम कर रहे हैं, उनकी सटीक सामग्री पोस्ट करने की आवश्यकता हो सकती है। – DRH
1.8.8 के साथ समान "समस्या"। मेरे पास एक README.md था जो सटीक वही काम करता था, लेकिन शीर्ष शीर्षलेख के लिए लेबल के बिना। –