도움말 파일 만들기 가이드

1. POWERCHM 으로 먼저 대충 만든뒤
2. HTML Help Workshop 사용

----------------------------------------------------------------------------------
<출처 : 미자의 연습장 http://meeja96.springnote.com/pages/303264>

html help workshop은 실제 도움말 내용을 담은 html 페이지를 이용해서 .chm 파일을 만드는 프로그램이다.

아래 내용은 html 페이지를 만드는 방법은 생략되어 있으므로, html 페이지들은 미리 만들어져 있어야 한다.

MS HTML Help Workshop은 utf-8을 지원하지 않는다. 검색 기능을 포함한 전체 기능을 원할히 사용하려면 html 페이지의 인코딩을 euc-kr로 지정하는 것이 좋다.

1. 다운로드 및 설치

 

http://www.bomul.com/view.html?id=3487 에서 HTML Help Workshop을 다운로드 받아서 실행.

2007년 6월 11일 기준, HTML Help Workshop 최신버전 4.0은 오류가 나서 사용이 힘드므로, HTML Help Workshop 3.1을 다운로드 받음.(2001년 9월 25일 등록된 파일, 버전은 표시되어 있지 않음.)

 

2. 프로젝트 파일 만들기

File>New>Project 선택>OK 버튼 클릭>다음(Next) 클릭> Browse 클릭> 프로젝트파일(pph)을 저장할 폴더를 선택> 원하는 프로젝트명(파일명)을 입력> 열기 버튼 클릭(버튼 이름이 저장이 아니라 열기로 되어 있음.) > 다음(Next) 클릭 > 마침 클릭

 

3. chm 파일로 만들 Html 도움말 문서(topic files) 등록

1. 좌측 두 번째 아이콘(Add/Remove topic files) 클릭 > Add 버튼 클릭
2. Html 관련 파일(이미지 파일, css 파일, html 파일)이 위치한 폴더로 이동>확장자가 html이 아닌 파일들도 표시되도록 파일 이름에 "*.*" 입력 후 엔터 >파일들을 선택> 열기 버튼 클릭
3. 여러 폴더에 파일이 들어있는 경우에는 폴더마다 들어가서 2번 과정 반복
4. 파일이 전부 추가됐으면 OK 버튼 클릭

 

4. 목차 만들기

1. "Contents" 탭 선택> OK 버튼 클릭>저장 버튼 클릭
2. 목차 구성에 따라 왼쪽 두 번째 아이콘(폴더) 혹은 세 번째 아이콘(페이지)을 클릭.
3. "Entry title"에 목차에 표시될 제목명 입력>Add 버튼 클릭>해당 제목을 클릭했을 경우 표시될 Html 파일을 HTML titles 목록에서 선택(아무거나 선택한 후 화살표키를 이용해서 이동해보면 File or URL 부분에 파일명이 보임, 그거보고 원하는 파일을 잘 찾아야 함.)> OK 버튼 클릭> 확인 버튼 클릭

 

5. chm 파일 만들기

1. Project 탭으로 이동 왼쪽 제일 아래 save all files and compile 아이콘 클릭

 

주의: 생성된 chm 파일 처음 실행해서 도움말 파일 확인하면, 실행 시 첫 페이지는 "작업취소" 혹은 "페이지가 존재하지 않습니다"라고 표시되고, 목차의 제목 중 아무거나 클릭하며 해당 페이지는 제대로 표시됨. 도움말 창 제목은 "HTML Help"로 표시됨. 놀랍게도 이게 정상임.

 

1. 두 번째 이후 부터는 save all files and compile 아이콘을 클릭하면 로그 저장 상자가 나타나는데, 취소를 클릭하면 됨.
2. 그리고 chm 파일이 열려 있으며, 컴파일이 안 됨. chm 파일을 닫고 다시 컴파일 하면 됨.

 

6. 첫 페이지 제대로 표시하기

1. Project 탭의 왼쪽 첫 번째 아이콘(Change project options) 클릭
2. Title에 chm 실행 시 창 제목(title)에 표시될 텍스트 입력
3. Default file에서 chm 파일 실행 시 표시될 첫 html 파일 선택
4. 확인 버튼 클릭 후 5.chm 파일 만들기 과정을 반복 (로그 저장 상자가 나타나면 취소 버튼 클릭, chm 파일이 열려 있으면 chm 파일을 닫고 해야 함.)

 

7. 검색 기능 넣기

1. Project 탭의 왼쪽 첫 번째 아이콘(Change project options) 클릭
2. Compiler 탭 클릭> Complie full-text search information 선택 > 확인 버튼 클릭
3. Project 탭의 왼쪽 세 번째 아이콘(add/modify window definitions) 클릭> 창 이름 아무거나 입력(예. search1) > Navigation Pane 탭 클릭> 아래 쪽에 있는 "Search tab"과 "Advanced" 선택해서 둘 다 체크 표시> 확인 버튼 클릭
4. 5. chm 파일 만들기 과정 반복

 

주의: html help workshop은 utf-8을 지원하지 않음. html 페이지의 인코딩이 utf-8일 경우, 목차나 기타 기능에는 문제가 되지 않으나, 검색 기능은 전혀 되지 않음.

8. chm 도움말 창 크기 및 위치 설정

1. Project 탭의 왼쪽 세 번째 아이콘(add/modify window definitions) 클릭 > Position 탭 클릭> Auto Sizer 버튼 클릭
2. chm 파일 실행 시 원하는 창의 위치와 크기로 조정한 다음 OK 버튼 클릭> 확인 버튼 클릭
3. 5. chm 파일 만들기 과정 반복

 

9. 목차의 그림을 폴더 대신 책으로 표시하기

1. contents 탭의 외쪽 첫번 째 아이콘(contents properties) 클릭> "user folders instead of books"에 체크표시 되어 있는 것 지움 >확인 버튼 클릭
2. 5. chm 파일 만들기 과정 반복

 

10. chm 도움말 창 상단 버튼 변경

chm 도움말의 상단 옵션 버튼의 "시작" 메뉴 클릭 시 '페이지를 찾을 수 없습니다.'라는 오류가 남. 해결책을 찾는 게 귀찮아서 표시되는 버튼을 아예 변경하기로 함. 당연히 옵션 버튼은 표시 안 함.

1. Project 탭의 왼쪽 세 번째 아이콘(add/modify window definitions) 클릭 >Buttons 탭 클릭
2. Hide/Show, Back, Foward, Print는 선택하고 나머지는 선택 안 함.> 확인 버튼 클릭
3. 5. chm 파일 만들기 과정 반복 

 

HHC6003: Error: The file Itircl.dll has not been registered correctly.

현상: 컴파일 시에 위 에러 메시지가 발생하고, 만들어진 help 파일에서 7. 검색 기능이 동작하지 않을 경우(항시 검색 결과가 없다고 표시되면서 아무것도 검색이 안 됨. 최신버전(4.0)사용 시 주로 발생. 삭제한 이후 3.0버전으로 재설치 해도 계속 발생함.

 

해결방법

1. 시작>실행>cmd
2. "cd.." 이나 "cd 폴더명" 을 사용해서 c:windows>system32로 이동
3. "regsvr32 Itircl.dll" 입력 

 4.  조금 있다가 "DllRegisterServer 성공" 이라는 Alert 창이 뜨면 등록이 완료된 것임.

<출처 : 미자의 연습장 http://meeja96.springnote.com/pages/303264>