HTML Help Workshop 으로 도움말 파일 만들기
출처:https://dorongdogfoot.tistory.com/35
마이크로소프트에서 프리웨어로 배포 중인 HTML Help Workshop 을 써서 도움말 만드는 법을 잠시 탐구해봤다.
검색해보니 이 툴이 불편해서 다른 프로그램을 쓴다는 분들이 꽤 많았다.
아마 이 툴에서는 이미 생성된 HTML 파일을 묶어서 chm 파일로 컴파일해주는 기능만 제공하기 때문이 아닐까 싶다....
나도 HTML 파일은 테스트용으로 대충 몇 개 만든 상태에서 도움말 파일을 만들었다.
HTML Help Workshop Ver 1.32 다운로드 링크 → https://www.microsoft.com/en-us/download/details.aspx?id=21138
파일들을 몰아넣을 폴더를 하나 생성해준 뒤, 이미 만들어둔 HTML 파일들을 넣어주고 HTML Help Workshop을 실행한다.
File > New 를 선택하면 아래와 같은 상자가 나온다.
만들어둔 것이 하나도 없으므로 Project 를 선택
그림판으로 대충 그린 것 같은 비주얼의 마법사가 나온다.
역시 만들어둔 것이 없으므로 체크박스에 체크하지 않고 '다음' 버튼을 눌러 진행
으으 마법사 비주얼 실화냐....
못생긴 마법사에게 프로젝트 파일명을 알려줘야 한다.
프로젝트용 폴더 안에는 현재 HTML 파일만 바글바글한데 갑자기 브라우저 버튼이 있고 hhp 파일을 지정하라고 해서 처음엔 좀 당황했다.
아아니 나는 hhp 파일을 만들어둔게 없는데 뭘 선택하라는거지???
메시지를 잘 읽어보니 이미 존재하는 파일을 선택하라는 뜻이 아니었다.
내가 만들고 싶은 위치에 만들고 싶은 파일명.hhp 를 입력해주면 된다.
역시나 아무것도 체크하지 않고 그냥 넘어감
드디어 못생긴 마법사와 작별할 시간이다.
프로젝트 옵션 관리 화면으로 들어가보자.
아래 캡쳐화면에서 표시한 버튼을 누르면 옵션을 관리하는 팝업창이 뜬다.
General 탭의 Title만 입력해놓고 '확인' 버튼을 눌렀다.
이미 만들어둔 HTML 파일을 불러올 수 있다.
처음 해보는거라 아무 생각없이 있는 파일을 다 추가했는데, 기본 화면으로 쓸 html 파일만 추가해도 된다.
다시 옵션 관리창을 열고 Default file : 옆 셀렉트 박스를 눌러보면 방금 추가한 파일 목록이 뜬다.
도움말 파일을 열자마자 보여질 화면을 여기서 설정한다.
설정하지 않으면 chm 파일을 실행하자마자 이 페이지를 실행할 수 없다고 해서 사람을 놀라게 만든다.
Contents 탭을 클릭하면 역시나 아무것도 없는 상태이므로 아래와 같은 대화상자가 뜬다.
새 파일을 만들겠다고 선택하고 OK
여기에서 일반적인 트리 형태의 메뉴를 구성해줄 수 있다.
뭔 말이냐면 일단 폴더처럼 생긴 저 버튼을 클릭
상위 메뉴를 First Index라고 정해봤다.
아래와 같이 페이지 모양 아이콘을 클릭하면 아까 만들어둔 상위 메뉴 아래에 집어넣을 페이지를 선택할 수 있다.
캡쳐하고서 페이지 버튼 표시하는걸 까먹어서 이렇겤ㅋㅋㅋㅋ 암튼
저렇게 대화상자가 나오는데 일단 페이지를 추가한 이후에 트리 메뉴에서의 파일 위치를 조정할 수 있으므로 크게 신경쓰지 않아도 된다.
단, 페이지 추가한 경우에는 단계 낮추기(Move Selection right)를 눌러서 폴더 아래 항목으로 만든다
이 과정을 반복하면 아래와 같이 트리 구조의 메뉴를 만들 수 있습니다 허허
이제 Index 탭을 클릭해보면 또 아래와 같은 대화상자가 등장한다.
마찬가지로 새 파일을 생성하겠다고 하고 넘어간다.
여기서 열쇠 모양의 버튼을 누르고 검색 키워드?를 설정해줄 수 있다.
즉, 검색할 때 1번이라고 입력하면 1번 페이지가, 2번이라고 입력하면 2번 페이지가 뜨는 식으로
특정 페이지에 특정한 검색어를 넣어줄 수 있는 것 같다.
대충 인덱스를 입력한 뒤 다시 Project 탭으로 돌아와서 옵션 관리창을 연다.
Complier 탭에서 아래와 같이 Complie fulltext search information 에 체크하면 나중에 도움말 실행창에서 검색 탭을 열고 검색할 수 있다.
대충 작업이 끝난 것 같으니 컴파일
폴더에 가보면 뭐가 많이 생성되어 있다. chm 파일을 실행해서 테스트
아까 만든 대로 잘 들어가있다....
이래저래 좀 노가다가 많이 필요하긴 하지만 생각했던 것보다는 편하게 chm 파일 생성이 가능하다. 끝
출처: https://dorongdogfoot.tistory.com/35 [도롱 the Dog Foot:티스토리]
|
2010. 11. 26. 18:40 https://blog.naver.com/yalleeya/110098006792 |
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) 등록
- 좌측 두 번째 아이콘(Add/Remove topic files) 클릭 > Add 버튼 클릭
- Html 관련 파일(이미지 파일, css 파일, html 파일)이 위치한 폴더로 이동>확장자가 html이 아닌 파일들도 표시되도록 파일 이름에 "*.*" 입력 후 엔터 >파일들을 선택> 열기 버튼 클릭
- 여러 폴더에 파일이 들어있는 경우에는 폴더마다 들어가서 2번 과정 반복
- 파일이 전부 추가됐으면 OK 버튼 클릭
4. 목차 만들기
- "Contents" 탭 선택> OK 버튼 클릭>저장 버튼 클릭
- 목차 구성에 따라 왼쪽 두 번째 아이콘(폴더) 혹은 세 번째 아이콘(페이지)을 클릭.
- "Entry title"에 목차에 표시될 제목명 입력>Add 버튼 클릭>해당 제목을 클릭했을 경우 표시될 Html 파일을 HTML titles 목록에서 선택(아무거나 선택한 후 화살표키를 이용해서 이동해보면 File or URL 부분에 파일명이 보임, 그거보고 원하는 파일을 잘 찾아야 함.)> OK 버튼 클릭> 확인 버튼 클릭
5. chm 파일 만들기
- Project 탭으로 이동 왼쪽 제일 아래 save all files and compile 아이콘 클릭
주의:생성된 chm 파일 처음 실행해서 도움말 파일 확인하면, 실행 시 첫 페이지는 "작업취소" 혹은 "페이지가 존재하지 않습니다"라고 표시되고, 목차의 제목 중 아무거나 클릭하며 해당 페이지는 제대로 표시됨. 도움말 창 제목은 "HTML Help"로 표시됨. 놀랍게도 이게 정상임.
- 두 번째 이후 부터는 save all files and compile 아이콘을 클릭하면 로그 저장 상자가 나타나는데, 취소를 클릭하면 됨.
- 그리고 chm 파일이 열려 있으며, 컴파일이 안 됨. chm 파일을 닫고 다시 컴파일 하면 됨.
6. 첫 페이지 제대로 표시하기
- Project 탭의 왼쪽 첫 번째 아이콘(Change project options) 클릭
- Title에 chm 실행 시 창 제목(title)에 표시될 텍스트 입력
- Default file에서 chm 파일 실행 시 표시될 첫 html 파일 선택
- 확인 버튼 클릭 후 5.chm 파일 만들기과정을 반복 (로그 저장 상자가 나타나면 취소 버튼 클릭, chm 파일이 열려 있으면 chm 파일을 닫고 해야 함.)
7. 검색 기능 넣기
- Project 탭의 왼쪽 첫 번째 아이콘(Change project options) 클릭
- Compiler 탭 클릭> Complie full-text search information 선택 > 확인 버튼 클릭
- Project 탭의 왼쪽 세 번째 아이콘(add/modify window definitions) 클릭> 창 이름 아무거나 입력(예. search1) > Navigation Pane 탭 클릭> 아래 쪽에 있는 "Search tab"과 "Advanced" 선택해서 둘 다 체크 표시> 확인 버튼 클릭
- 5. chm 파일 만들기 과정 반복
주의: html help workshop은 utf-8을 지원하지 않음. html 페이지의 인코딩이 utf-8일 경우, 목차나 기타 기능에는 문제가 되지 않으나, 검색 기능은 전혀 되지 않음.
8. chm 도움말 창 크기 및 위치 설정
- Project 탭의 왼쪽 세 번째 아이콘(add/modify window definitions) 클릭 > Position 탭 클릭> Auto Sizer 버튼 클릭
- chm 파일 실행 시 원하는 창의 위치와 크기로 조정한 다음 OK 버튼 클릭> 확인 버튼 클릭
- 5. chm 파일 만들기 과정 반복
9. 목차의 그림을 폴더 대신 책으로 표시하기
- contents 탭의 외쪽 첫번 째 아이콘(contents properties) 클릭> "user folders instead of books"에 체크표시 되어 있는 것 지움 >확인 버튼 클릭
- 5. chm 파일 만들기 과정 반복
10. chm 도움말 창 상단 버튼 변경
chm 도움말의 상단 옵션 버튼의 "시작" 메뉴 클릭 시 '페이지를 찾을 수 없습니다.'라는 오류가 남. 해결책을 찾는 게 귀찮아서 표시되는 버튼을 아예 변경하기로 함. 당연히 옵션 버튼은 표시 안 함.
- Project 탭의 왼쪽 세 번째 아이콘(add/modify window definitions) 클릭 >Buttons 탭 클릭
- Hide/Show, Back, Foward, Print는 선택하고 나머지는 선택 안 함.> 확인 버튼 클릭
- 5. chm 파일 만들기 과정 반복
HHC6003: Error: The file Itircl.dll has not been registered correctly.
현상:컴파일 시에 위 에러 메시지가 발생하고, 만들어진 help 파일에서 7. 검색 기능이 동작하지 않을 경우(항시 검색 결과가 없다고 표시되면서 아무것도 검색이 안 됨. 최신버전(4.0)사용 시 주로 발생. 삭제한 이후 3.0버전으로 재설치 해도 계속 발생함.
해결방법
- 시작>실행>cmd
- "cd.." 이나 "cd 폴더명" 을 사용해서 c:windows>system32로 이동
- "regsvr32 Itircl.dll" 입력
4. 조금 있다가 "DllRegisterServer 성공" 이라는 Alert 창이 뜨면 등록이 완료된 것임.