사용 방법 Qt Assistant

문서 창에서 문서를 읽을 수 있습니다. 새 탭에서 주제를 열려면 목차 창에서 해당 주제를 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 열고 ‘새 탭에서 링크 열기’를 선택하십시오. 열려 있는 모든 주제는 ‘열린 페이지’ 창에 나열됩니다. 주제를 선택하면 문서 창에서 해당 내용을 볼 수 있습니다.

문서 창을 최대한 넓게 사용하려면 사이드바 창을 쉽게 그룹화하거나, 이동하거나, 숨길 수 있습니다. 창을 그룹화하려면 한 창을 다른 창 위로 드래그한 후 마우스를 놓으세요. 하나 또는 모든 사이드바 창이 표시되지 않는 경우, 키보드 단축키를 사용하여 표시할 수 있습니다. 키보드 단축키는 [ 보기 ] 메뉴에서 확인할 수 있습니다.

사이드바 창은 메인 창에 도킹할 수 있으므로, 메인 창의 상단, 왼쪽, 오른쪽 또는 하단으로 드래그할 수 있으며, ‘ Qt Assistant ’ 밖으로 드래그하여 독립된 창으로 띄울 수도 있습니다.

문서나 애플리케이션 자체를 표시하는 브라우저 창의 글꼴 종류와 크기를 변경하려면 편집 > 환경설정 > 글꼴을 선택하십시오.

문서 창에서 글꼴 크기를 일시적으로 확대하거나 축소하려면 보기 > 확대 또는 축소 를 선택하십시오. 글꼴 크기를 기본값으로 되돌리려면 보기 > 일반 크기 를 선택하십시오.

페이지 간을 이동하려면 이동 > 이전 또는 다음을 선택하십시오. 이렇게 하면 기록에서 이전 또는 다음 페이지로 이동합니다. 홈 페이지로 돌아가려면 이동 > 홈을 선택하십시오. 홈 페이지를 지정하려면 편집 > 환경 설정 > 옵션을 선택하십시오.

목차 창을 문서 창에 현재 표시된 페이지와 동기화하려면 이동 > 목차와 동기화를 선택하십시오.

주소 도구 모음을 사용하면 문서 파일의 특정 URL을 빠르게 입력할 수 있습니다. 주소 도구 모음을 표시하려면 보기 > 도구 모음 > 주소 도구 모음을 선택하십시오.

페이지 내용에서 검색하기

현재 페이지에서 텍스트를 찾으려면 편집 > 텍스트에서 찾기를 선택하십시오. 필드에 검색어를 입력하십시오. 검색은 증분 방식으로 이루어지므로, 필드에 문자를 입력하는 즉시 가장 관련성 높은 결과가 표시됩니다.

'대소문자 구분' 확인란을 선택하면 검색 시 검색어의 대소문자를 구분하여 검색합니다. 예를 들어, 'spin'을 검색하면 'spin'과는 일치하지만 'Spin'과는 일치하지 않습니다.

페이지의 현재 위치에서 앞뒤로 검색하려면 ‘이전 ’ 또는 ‘다음’을 클릭하십시오.

찾기 컨트롤을 숨기려면 [닫기]를 클릭하거나 Esc 키를 누르십시오.

전체 텍스트 검색

Qt Assistant 검색 메뉴의 스크린샷" src="images/assistant-search.png" title="문서를 찾아볼 수 있는 Qt Assistant 검색 메뉴의 스크린샷"/>

Qt Assistant 는 강력한 전체 텍스트 검색 엔진을 제공합니다. ‘검색’ 창에서 특정 단어나 텍스트를 검색할 수 있습니다. 찾고자 하는 텍스트를 입력한 후 Enter 키를 누르거나 ‘검색’을 클릭하십시오. 이 검색은 대소문자를 구분하지 않습니다. 예를 들어, Foo, fOo 및 FOO는 모두 동일한 것으로 처리됩니다.

FTS 쿼리 구문을 사용하여 복잡한 쿼리를 만들 수 있습니다.

다음은 일반적인 검색 패턴의 예입니다:

• deep – 'deep'이라는 단어가 포함된 모든 문서를 나열합니다
• deep* – ‘deep’으로 시작하는 단어가 포함된 모든 문서를 나열합니다
• deep copy – ‘deep’과 ‘copy’가 모두 포함된 모든 문서를 나열합니다
• "deep copy" – 'deep copy'라는 구문이 포함된 모든 문서를 나열합니다

검색 결과로 표시된 문서 목록은 해당 문서에 포함된 검색어의 등장 횟수 순으로 정렬되며, 등장 횟수가 가장 많은 문서가 맨 위에 표시됩니다. 목록에서 원하는 문서를 클릭하기만 하면 ‘문서’ 창에 해당 문서가 표시됩니다.

문서 내용이 변경된 경우(예: 문서가 추가되거나 삭제된 경우) ‘ Qt Assistant ’가 해당 문서를 다시 색인화합니다.

도움말 내용 필터링

Qt Assistant Qt 압축 도움말 파일(*.qch) 형식으로 구성되어 있는 한, 어떤 종류의 문서라도 설치할 수 있습니다. 예를 들어, 여러 Qt 버전에 대한 Qt 참조 문서를 동시에 볼 수 있습니다. 여러 면에서 이는 Qt Assistant 의 단일 버전만 있으면 되므로 매우 편리합니다. 하지만 동시에, 대부분의 키워드가 하나 이상의 Qt 버전에서 정의되어 있기 때문에 색인 검색과 같은 작업을 수행할 때 상황이 더 복잡해집니다. 즉, Qt Assistant 는 항상 사용자에게 어떤 버전을 표시할지 선택하도록 요청하게 됩니다.

우리는 이 문제를 해결하기 위해 문서 필터를 사용합니다. 필터는 이름으로 식별되며, 필터 속성 목록을 포함합니다. 속성은 단순히 문자열이며 자유롭게 선택할 수 있습니다. 속성은 문서 자체에 의해 정의되므로, 일반적으로 모든 문서 세트에는 하나 이상의 속성이 있습니다.

예를 들어, Qt Assistant 문서는 assistant 및 tools 속성을 정의하는 반면, Qt Widgets Designer 문서는 designer 및 tools 속성을 정의합니다. 따라서 모든 도구를 표시하는 필터는 tools 속성만 정의하면 되는데, 이는 이 속성이 두 문서 세트 모두에 포함되어 있기 때문입니다. 필터에 assistant 속성을 추가하면, Qt Widgets Designer 문서는 이 속성을 포함하지 않으므로 Qt Assistant 문서만 표시됩니다. 필터에 속성 목록을 비워두면 모든 문서가 일치합니다. 즉, 필터링되지 않은 문서를 요청하는 것과 동일합니다.

문서 필터를 생성하거나 제거하려면 편집 > 환경 설정 > 필터를 선택하십시오.

새 필터를 추가하려면 [ 추가]를 클릭하고 필터 이름을 지정한 다음 [ 확인]을 클릭하십시오. 그런 다음 [ 속성 ] 필드에서 필터 속성을 선택하십시오.

필터를 삭제하려면 해당 필터를 선택한 후 ‘제거’를 클릭하십시오.

필터 도구 모음을 사용하면 현재 설치된 문서에 필터를 적용할 수 있습니다. 필터 도구 모음을 표시하려면 보기 > 도구 모음 > 필터 도구 모음을 선택하십시오.

문서 추가

압축된 도움말 파일을 설치하거나 제거하려면 편집 > 환경 설정 > 문서를 선택하십시오.

'설치' 버튼을 클릭하고 설치할 압축된 도움말 파일(*.qch)의 경로를 선택하십시오. 도움말 파일을 삭제하려면 목록에서 문서 세트를 선택하고 '제거'를 클릭하십시오.

홈 페이지 지정

'홈' 버튼을 클릭했을 때 Qt Assistant 에 표시될 홈페이지를 지정하려면 편집 > 환경 설정 > 옵션을 선택하십시오.

홈페이지의 URL을 입력하거나 ‘현재 페이지’를 선택하여 현재 표시된 페이지를 홈페이지로 설정하십시오. 홈페이지를 비워 두려면 ‘빈 페이지’를 선택하십시오. 홈페이지를 기본값으로 재설정하려면 ‘기본값으로 복원’을 선택하십시오.

명령줄 옵션 사용

Qt Assistant 다음과 같은 명령줄 옵션을 지원합니다: