하나의 요리를 완성하기 위해 준비한 식재료들을 한데 모아 조리해야 하는 것처럼 HTML Help 프로젝트를 모두 구성한 다음 완성된 HTML Help를 얻으려면 컴파일 과정을 거쳐야 한다.
컴파일은 작업자가 직접 관여할 수 없는 과정이기 때문에 전문 저작 프로그램을 사용하여 HTML Help를 컴파일해야 한다. 이번 시간에는 HTML Help Workshop을 이용하여 지금까지 작업한 파일들을 컴파일하고 테스트하는 방법에 대해 살펴보겠다.
프로젝트 컴파일하기
이미 토픽 파일들(*.html)과 프로젝트 파일(*.hhp), 목차 파일(*.hhc), 색인 파일(*.hhk) 등이 완성되어 있다면 바로 컴파일하여 HTML Help를 만들 수 있다. 하지만 자신이 원하는 결과물을 얻기 위해서는 컴파일 과정에 앞서 관련 옵션 설정이 제대로 되어 있는지 확인해 두는 것이 좋다. 기본적인 옵션에 대한 설정은 Project 탭에서 Change project options
단추를 누르면 나타나는 Options 대화 상자와 Add/Modify window definitions 
단추를 누르면 나타나는 Window Types 대화 상자에서 확인할 수 있다. - 각 탭에 대한 설정을 확인한다.Options 대화 상자의 Files 탭과 Window Types 대화 상자의 Files 탭에서 HTML Help의 목차 파일과 색인 파일이 제대로 연결되어 있는지 확인한다. 그리고 Window Types 대화 상자의 Navigation Pane 탭에서 검색 탭과 즐겨찾기 탭에 대한 설정을 확인한다. HTML Help에서 검색 기능을 제대로 사용하려면 Options 대화 상자의 Compiler 탭에서 'Compile full-text search infomation'을 선택해야 한다.
- HTML Help가 생성되는 위치와 파일 이름을 확인한다.Options 대화 상자 Files 탭의 'Compiled file'에 지정된 경로와 파일 이름(*.chm)이 올바른지 확인한다.
- 윈도우 설정을 확인한다.Options 대화 상자 Default 탭의 'Default window'에서 HTML Help를 표시할 윈도우 이름을 확인한다. 그리고 Window Types 대화 상자의 General 탭과 Navigation Pane 탭을 열어 'Window Type'에 동일한 윈도우 이름이 지정되어 있는지 확인한다.
- 시작 파일이 제대로 설정되어 있는지 확인한다.시작 파일이란 HTML Help를 실행했을 때 토픽 창에 처음 나타나는 파일을 의미한다. 시작 파일을 별도로 지정하지 않은 경우 Project 탭의 FILES 섹션 가장 위에 있는 파일이 자동으로 지정된다. 시작 파일은 Options 대화 상자 General 탭의 'Default File'과 Window Types 대화 상자 Files 탭의 'Default'에서 확인하거나 변경할 수 있다.
- 토픽 파일이 모두 추가되어 있는지 확인한다.Project 탭의 FILES 섹션에서 파일 목록을 확인하고 문제가 있다면 도구 막대에서 Add/Remove topic files
단추를 눌러 파일을 추가하거나 삭제한다. 토픽 파일(*.html)에 사용한 스타일 시트(*.css)와 스크립트 파일(*.js), 스타일이나 스크립트를 이용하여 삽입한 그림 파일을 HTML Help에서 제대로 확인하려면 이 파일들도 목록에 추가해야 한다.
- HTML Help Workshop에서 컴파일할 프로젝트 파일(*.hhp)을 연다.
- 메뉴에서 File > Compile을 선택하거나 Project 탭의 도구 막대에서 Save all files and compile
단추를 누른다.
- Create compiled file 대화 상자가 나타나면 프로젝트 파일의 경로를 확인하거나 Browse 단추를 눌러 프로젝트 파일을 선택한다. 컴파일하기 전에 파일을 저장하려면 'Save all files before compiling'을 선택한다.
- Compile 단추를 눌러 컴파일을 시작한다. 컴파일 과정 및 결과 메시지가 프로그램 오른쪽 창에 나타난다.
 |
 | |
| <그림 1>정상적으로 컴파일이 진행된 경우 | <그림 2>컴파일 중에 오류가 발생한 경우 |
정상적으로 컴파일된 경우에는 프로그램 오른쪽 창에 <그림 1>과 같이 나타나지만 경우에 따라 <그림 2>와 같이 오류 메시지가 나타나는 경우도 있다. 오류 메시지가 나타나는 경우에는 오류 메시지의 원인을 확인하고 문제를 수정한 뒤 다시 컴파일을 해야 한다. HTML Help Workshop에서 확인할 수 있는 오류 메시지 종류와 원인은 대략 다음과 같다.
| ||||||||||||||
| ||||||||||||||
|
HTML Help 테스트하기
컴파일이 완료되었으면 작업 폴더에서 생성된 HTML Help(*.chm)를 직접 더블 클릭하여 실행하거나 HTML Help Workshop의 도구 막대에서 View compiled file
단추를 눌러 확인한다. 프로젝트가 성공적으로 컴파일되었으면 <그림 3>과 같은 HTML Help가 실행될 것이다.  |
| <그림 3>컴파일된 HTML Help |
실행된 HTML Help에서 모든 기능이 제대로 작동하는지 확인해 본다. 특히 HTML Help를 단순한 자료 백업이나 개인 용도가 아닌 소프트웨어의 도움말로서 제공할 목적이라면 테스트 가이드라인을 구체적으로 정리하여 꼼꼼하게 테스트해야 한다.
- 내비게이션 창에 각 탭이 제대로 나타나는지 확인한다.
- 목차 탭에서 각 목차 항목에 대한 토픽이 토픽 창에 제대로 나타나는지 확인한다.
- 색인 탭에서 선택한 키워드에 대한 토픽이 토픽 창에 나타나는지 확인한다.
- 검색 탭에서 검색이 제대로 되는지 확인한다.
- 도구 모음의 버튼이 제대로 실행되는지 확인한다.
- 각 토픽 파일에 삽입한 하이퍼링크가 제대로 작동하는지 확인한다.
- 토픽 파일에 스타일이나 스크립트, 그림 등이 제대로 나타나는지 확인한다.
- 토픽 파일에서 맞춤법이나 표현이 올바른지 확인한다.
출처 : 김유진 ( (주)세중 나모 인터랙티브 개발본부 )
