강좌/Help File 제작2010. 3. 23. 10:49

지난 강좌까지는 대표적인 온라인 기술 문서인 HTML Help를 만드는 방법과 이를 보다 편리하게 사용할 수 있도록 여러가지 기능을 추가하는 방법에 대해서 알아보았다. 이제 이미 만들어 놓은 HTML Help를 바탕으로 Single Sourcing 방법을 이용해서 다양한 형태의 기술 문서를 만드는 방법에 대해서 알아보기로 하자.


Single Sourcing
Single Sourcing은 하나의 컨텐츠 세트에서 다양한 형태의 정보를 개발해 내는 것을 말한다. 즉 필요한 모든 정보를 모아 만들어 놓고 이 중에 필요한 내용만을 뽑아 조합하여 다양한 형식으로 변환하여 제공하는 것이다. Single Sourcing의 목표는 효율적으로 정보를 재사용한다는 것이다. 서로 다른 매체와 형식에 맞춰 매번 비슷한 내용의 정보를 새로 만들어내지 않고 하나의 정보 창고를 만들어 놓고 형식을 달리하여 재사용하는 것이다. 이러한 정보 창고 안의 정보들을 효율적으로 관리하기 위해서는 정보들을 구조적으로 데이스터베이스화해서 인쇄용 매뉴얼, PDF 파일, 컴파일된 온라인 도움말, 웹 사이트 문서, 브로셔 등, 그 목적에 맞게 사용할 수 있도록 해야 한다. Single Sourcing 시스템을 제대로 갖추려면 플랜 단계에서 많은 시간과 노력이 필요하지만 일단 한번 만들어 놓게 되면 그 이후에는 시간과 노력이 절감되는 효과를 얻을 수 있게 된다.

여기에서는 Single Sourcing을 위한 플랜, 준비 단계 등에 대해서는 다루지 않고 Single Sourcing 개념만을 빌려와 간단하게 앞에서 만들었던 HTML Help를 바탕으로 인쇄용 매뉴얼, PDF 파일을 만드는 방법에 대해서 살펴보기로 한다.

Single Sourcing을 위한 툴
먼저 작업에 들어가기 전에 보다 편리한 작업을 도와 주는 관련 툴에 대해 잠깐 살펴보기로 하자. Single Sourcing을 위한 툴 중, 널리 사용되는 툴로는 RoboHelp, Help & Manual, Doc-to-Help 등이 있다.

  • RoboHelpRoboHelp 는 WYSIWYG HTML 편집 기능, 컴파일된 HTML Help 생성 기능, WebHelp 생성 기능, 인쇄용 매뉴얼 변환 기능 및 프로젝트 관리를 위한 다양한 기능을 제공한다. 자세한 정보를 확인하려면 www.ehelp.com을 참고하기 바란다.
  • Doc-To-HelpDoc- To-Help는 Microsoft Word 문서를 Help 시스템으로 변환시켜 주는 프로그램이다. 이 툴을 사용하면 하나의 Word 문서를 가지고 HTML Help 형식의 온라인 도움말, HTML 4.0 형태의 도움말, JavaHelp 1.1 및 인쇄용 매뉴얼을 만들 수 있다. 자세한 정보를 확인하려면 www.componentone.com을 참고하기 바란다.
  • Help & ManualHelp & Manual은 도움말 시스템을 만들 수 있고 이를 바탕으로 인쇄용 매뉴얼과 e-book을 만들 있는 툴이다. 자세한 정보를 확인하려면 www.ec-software.com을 참고하기 바란다.
툴을 선정하기 전에는 어떤 형식의 도움말을 제공할지를 결정하고 그에 가장 적합한 툴을 선택하도록 한다. 여기에서는 이 중 RoboHelp를 사용하여 인쇄용 매뉴얼을 만드는 과정을 살펴볼 것이다.

인쇄용 매뉴얼 만들기
전문적인  매뉴얼 편집 작업에서 워드 프로세서를 사용하는 일은 드물지만 여기에서는 가장 널리 쓰이는 워드 프로세서 중 하나인 Microsoft Word를 사용하여 인쇄용 매뉴얼을 만들어 보기로 하겠다. Microsoft Word는 대부분의 사람이 쉽게 사용할 수 있어 따로 사용법을 익히지 않아도 된다는 장점이 있고 추가로 툴을 구입하는데 드는 비용과 학습에 필요한 시간을 단축시킬 수 있다. 하지만 전문 편집 툴이 아니기 때문에 작업에 불편함이 따르는 것은 감수해야 할 것이다.

먼저 별도의 Single Sourcing 툴이 없다고 가정했을 때에는 단순하게 HTML 문서를 Word에서 열어 편집하는 방법을 생각해 볼 수 있다. 하지만 프로젝트가 큰 경우에는 이러한 방법을 사용하기 어렵다. 따라서 프로젝트가 큰 경우 보다 쉽게 HTML 문서를 Word 파일로 변환하려면 RoboHelp와 같은 툴을 사용하는 것이 좋다.

RoboHelp를 사용해 Word 문서를 만드는 방법은 다음과 같다. 참고로 RoboHelp의 최신 버전은 RoboHelp X5이나 한글이 지원되는 RoboHelp 최신 버전은 RoboHelp X3이다. 여기에서는 한글을 지원하는 RoboHelp X3 트라이얼을 사용하여 설명하도록 하겠다.

  1. 먼저 RoboHelp X3 Korean 트라이얼을 다운로드 받는다.
  2. RoboHelp 를 열고 메뉴에서 File > Open을 선택한다. 파일 형식 목록에서 ‘RoboHELP HTML Project (*.mpj)로 되어 있는 것을 ‘HTML Help Project (*.hhp)로 바꾼 뒤 앞에서 만들었던 프로젝트 파일(여기에서는 NamoGIFAni.hhp)을 선택하고 [열기]를 누른다.
  3. *.hhp 형식의 프로젝트 파일이 RoboHelp 프로젝트 파일 형식인 *.mpj 파일로 변환되면서 RoboHelp HTML에 파일 목록이 나타난다. 왼쪽 영역에는 프로젝트 관리를 위한 목록이 나타나고 오른쪽 영역에는 프로젝트에 포함된 파일 목록이 나타난다. 각 영역 아래 있는 탭을 누르면 영역의 내용이 바뀌게 된다.


  4. 왼쪽 영역의 목록에서 Single Source Layouts 폴더를 연 뒤 Printed Documentation을 선택한다. 마우스 오른쪽 버튼을 눌러 바로가기 메뉴에서 Generate을 누른다.
  5. Print Document General 대화 상자에서 파일 저장 위치, 그림 삽입 옵션 등을 선택하고 [다음]을 누른다. Images 아래 그림 삽입 옵션에서 Link to documents 옵션은 문서 안에 그림을 직접 삽입하지 않고 연결 정보만을 갖도록 하는 것이다. 그림을 직접 문서에 삽입하면 파일 크기가 커지고 관리가 쉽지 않기 때문에 Embed in documents 옵션 대신 Link to documents 옵션을 선택하는 것이 좋다.


  6. 이제 HTML Help 프로젝트에 포함된 모든 토픽 파일(*.htm)을 Word 문서로 변환할 것인지 또는 그 중 일부 토픽 파일(*.htm)만을 Word 문서로 변환할 것인지를 선택하고 [다음]을 누른다.



  7. 스타일을 지정하고 마침을 누르면 Word 형식의 인쇄용 매뉴얼 파일이 생성된다. Veiw Result를 누르면 결과 파일을 확인할 수 있다.

지 금까지 RoboHelp라는 Single Sourcing 툴을 사용하여 HTML Help의 토픽 파일들을 인쇄용 매뉴얼 Word 파일(*.doc)로 변환하는 과정을 살펴보았다. 다음 시간에는 변환된 Word 파일(*.doc)의 스타일을 편집하고 목차, 색인, 페이지 번호 등을 추가하여 인쇄용 매뉴얼을 완성해 보도록 하겠다.


출처 : 김유진 ( (주)세중 나모 인터랙티브 개발본부 )

Posted by 쿵캉켕