doxygen markdown 페이지의 헤더 레이블이 헤더 제목을 사라지게합니다.

Question

doxygen 1.8.2에 이상한 문제가 있습니다. 머리글 레이블을 포함 시키면 머리글 제목이 출력 html에서 사라집니다. 내가 경우, 섹션 1

에 대한

텍스트

제목하지만 다음 가격 인하 파일로

:

Title   {#title} 
===== 

Section 1  {#section1} 
--------- 
Text for section 1 

나는 같은 출력을 얻을삭제 Markdown을 파일에서라벨, I는 정확한 출력을 얻을 :

제목을

제 1

실수는 무엇인가 섹션 1

의 텍스트 I 여기 만들고 있니? 일부 조사 후

warning: found subsection command outside of section context! 

Answer 1

, 내가 이을 표시이 있지만 약간의 직관에만 있기 때문에, 버그가 수 있도록 결정했다 : 나는 섹션에 레이블을 때

편집 나는 다음과 같은 경고를 관찰 .

는 다음과 같은 고려 :

는

The Main Section {#the_main_section} 
================ 

Subsection One {#first} 
-------------- 

Something highly interesting... 

문서는 (here을 설명) 레벨 1 헤더로 시작하고 그래서 Doxygen을 이름과 페이지의 제목으로 "메인 섹션"을 구문 분석합니다. 머리글과 레이블 {#the_main_section}은 헤더가 페이지 이름으로 변환되면 무시됩니다.

그런 다음 처리가 나머지 문서로 이동하고 "하위 섹션 1"에 도달하면 "하위 섹션"에 부모 "섹션"이 없다고 생각합니다 ("섹션"이 페이지로 변환됨에 따라) 이름) 그리고 이것은 그것이 질식하는 곳입니다.

더 구체적으로, 부모 "섹션"이 없다고 생각하면 하위 섹션 (헤더)을 버립니다. 다른 모든 텍스트는 그대로 유지되지만 섹션 부모가없는 "페이지"의 일부로 취급됩니다.

"수정"은 초기 "레벨 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! 

Answer 2

버전 1.8.9.1에서 같은 문제가 발생합니다. --- 대신 --- 태그를 사용하여 피할 수 있습니다. 예를 들어

:

[TOC] 

Page Title {#pageTitle} 
========== 
Lorem ipsum dolor sit amet 

# section 1 {#section1} 
Lorem ipsum dolor sit amet 

## Section 1.1 {#section1-1} 
Lorem ipsum dolor sit amet 

# section 2 {#section2} 
Lorem ipsum dolor sit amet 

# section 3 {#section3} 
Lorem ipsum dolor sit amet 

## section 3.1 {#section3-1} 
Lorem ipsum dolor sit amet 

# section 4 {#section4} 
Lorem ipsum dolor sit amet 

가 작동합니다.[TOC] 태그를 페이지 제목 정의 아래에 두어 내용 표에서 태그를 제거 할 수도 있습니다.