포맷별 구성 변수

형식별 구성 변수는 생성된 문서의 스타일을 정의하거나 문서의 바닥글 또는 포스트헤더의 내용을 정의합니다.

일부 구성 값은 HTML 출력 형식에만 관련되며 해당 값에는 원시 HTML이 포함됩니다.

HTML.footer

HTML.footer 변수는 생성된 HTML 문서의 바닥글 내용을 정의합니다.

바닥글은 생성된 문서 페이지의 하단에 렌더링됩니다.

변수 값은 따옴표로 묶인 원시 HTML 코드로 제공됩니다. 값이 여러 줄에 걸쳐 있는 경우 각 줄을 따옴표로 묶어야 합니다.

HTML.footer = "<p /><address><hr /><div align=\"center\">\n" \
              ...
              "</tr></table></div></address>"

<FORMAT>.nosubdirs

true, 단일 디렉토리 출력 모드를 활성화하는 부울 값으로, 생성된 모든 파일이 문서 프로젝트 이름에 따라 하위 디렉터리가 아닌 FORMAT.outputsubdir 디렉터리로 이동합니다.

<FORMAT>.outputsubdir

문서가 생성되는 출력 디렉터리 아래의 하위 디렉터리를 정의합니다.

HTML.nosubdirs = true
HTML.outputsubdir = html

위의 경우 출력은 <outputdir>/html 로 이동합니다.

HTML.postheader

HTML.postheader 변수는 생성된 HTML 문서의 포스트헤더 내용을 정의합니다.

헤더는 생성된 문서 페이지의 상단에 렌더링됩니다.

변수 값은 따옴표로 묶인 원시 HTML로 제공됩니다. 값이 여러 줄에 걸쳐 있는 경우 각 줄을 따옴표로 묶어야 합니다.

HTML.postheader = "<table border=\"0\"..." \
                  ...
                  "<img src=\"images/qt-logo.png\" \
                  "align=\"right\" width=\"203\" height=\"32\""\
                 "border=\"0\" />" \
                  "</td></tr>" \
                  "</table>"

qtgui.qdocconf의 전체 변수 항목은 Qt GUI 설명서의 표준 헤더를 제공합니다.

<FORMAT>.quotinginformation

true, 콘텐츠를 직접 포함하지 않고 인용된 콘텐츠(예: \quotefromfile 및 \스니펫 명령)에 대한 참조를 생성하는 부울 값입니다.

현재 WebXML 출력 형식에 사용됩니다.

WebXML.quotinginformation = true

HTML.style

HTML.style 변수는 생성된 HTML 문서의 스타일을 정의합니다.

변수 값은 따옴표로 묶인 원시 HTML로 제공됩니다. 값이 여러 줄에 걸쳐 있는 경우 각 줄을 따옴표로 묶어야 합니다.

HTML.style = "h3.fn,span.fn" \
             "{ margin-left: 1cm; text-indent: -1cm; }\n" \
             "a:link { color: #004faf; text-decoration: none }\n" \
             "a:visited" \
             "{ color: #672967; text-decoration: none }\n" \
             "td.postheader { font-family: sans-serif }\n" \
             "tr.address { font-family: sans-serif }\n" \
             "body { background: #ffffff; color: black; }"

HTML.스타일시트

HTML.stylesheets 변수는 생성된 HTML 문서에 사용할 스타일시트 목록을 정의합니다.

문서에 별도의 스타일시트를 사용하면 콘텐츠가 생성된 후 사용되는 스타일을 더 쉽게 사용자 지정하고 실험할 수 있습니다. 일반적으로 문서 세트에 대해 하나의 스타일시트만 정의하면 됩니다:

HTML.stylesheets = path/to/classic.css

QDoc은 qtgui.qdocconf 파일이 포함된 디렉터리에서 스타일시트를 찾고 지정된 스타일시트를 HTML 페이지와 함께 출력 디렉터리에 복사합니다.

<FORMAT>.tocdepth

<FORMAT>.tocdepth 변수는 목차에 인쇄되는 문서 섹션의 수를 정의합니다. 0 로 설정하면 목차가 비활성화되고 정의되지 않은 상태로 두면 모든 문서 섹션이 인쇄됩니다.

현재 HTML 형식에만 영향을 미칩니다:

HTML.tocdepth = 3