HTML 도움말용 문서 게시(Windows에만 해당)

필수 구성 요소: Arbortext Publishing Engine, Arbortext Styler 또는 Web/Wireless Composer 옵션 및 HTML Help Workshop

Arbortext Editor를 사용하여 XML 문서를 HTML 도움말로 변환할 수 있습니다. 파일 > 게시 > HTML 도움말 옵션을 선택하면 문서가 HTML 항목별로 분리된 후 하나의 .chm 파일로 결합됩니다. 기본적으로 Arbortext Editor는 Arbortext XML DocBook(axdocbook.dtd) 문서 유형을 기반으로 문서에 대한 HTML 도움말을 만들도록 구성됩니다. 다른 DTD를 기반으로 하는 HTML 도움말에 문서를 게시하려면 컨설팅 서비스에 문의하십시오.

HTML 도움말 옵션은 게시 메뉴에 표시되지만 Microsoft의 HTML Help Workshop을 설치해야 사용할 수 있습니다. Microsoft의 웹 사이트 http://www.microsoft.com에서 최신 버전을 다운로드할 수 있습니다. 이 다운로드가 표준 다운로드 옵션으로 나열되지 않은 경우 MSDN Library에서 다운로드를 검색하여 뷰어가 아닌 전체 버전의 Workshop을 설치합니다.

HTML Help Workshop을 시작했다가 닫아야만 파일 > 게시 > HTML 도움말을 선택할 수 있습니다.

문서에 그래픽이 포함된 경우 그래픽의 너비와 높이 속성을 HTML 출력에 설정하려면 이러한 속성을 픽셀 단위로 지정해야 합니다. 그래픽의 너비와 높이 속성을 픽셀 이외의 단위로 지정하면 웹 브라우저에서 이러한 속성을 해석하지 못합니다.

TeX 입력을 사용한 방정식은 HTML 출력에 빈 상자로 표시됩니다.

1. CJK 언어로 HTML 도움말을 게시하려면 먼저 Windows 로캘 및 기본 언어 설정을 원하는 언어로 설정해야 합니다. 로캘 및 언어 변경에 대한 자세한 내용은 Windows 운영 체제 설명서를 참조하십시오.

2. 파일 > 게시 > HTML 도움말을 선택합니다. HTML 도움말용으로 게시 대화 상자가 열립니다.

3. HTML 도움말 파일을 저장할 경로 및 파일 이름을 다른 이름으로 저장 필드에 지정합니다. 찾아보기를 클릭하여 기존 파일을 찾습니다.

4. 문서가 게시된 후 HTML 도움말 뷰어에 문서를 표시하려면 도움말 파일 보기 옵션을 선택합니다.

도움말 파일 보기 옵션을 선택한 경우 문서 파일 이름에 앰퍼샌드(& 기호)가 포함되어 있으면 Arbortext Editor에서 HTML 도움말 뷰어를 시작할 수 없다는 메시지가 표시됩니다. 예를 선택하여 뷰어를 비활성화한 상태로 게시하거나 아니요를 선택하여 게시 프로세스를 취소합니다.

5. 스타일시트 목록에서 해당 스타일시트를 선택합니다. 웹 게시를 지원하는 스타일시트도 HTML 도움말에 사용할 수 있습니다. 목록에 나타나지 않은 기존 스타일시트를 찾으려면 찾아보기를 클릭합니다.

Arbortext Publishing Engine을 사용하여 문서 게시하는 경우 Arbortext Publishing Engine 서버에서 사용할 수 있는 스타일시트가 목록에 표시됩니다. 스타일시트 이름에 (pe) 표시가 나타납니다. 로컬 스타일시트는 무시되므로 서버에 문서와 함께 보낼 수 없습니다.

6. 연관된 DITAVAL 파일이 있는 DITA 문서를 게시할 경우 DITAVAL 파일 목록에서 해당 파일을 선택합니다. 목록에 없는 기존 DITAVAL 파일을 찾으려면 찾아보기를 클릭합니다.

7. 문서에 변경 내용 추적이 있는 경우 모든 변경 내용 추적 상태에서 문서를 게시할 수 있습니다. DITA 맵에서 게시하는 경우를 제외하고 기본적으로 편집 창의 변경 내용 추적 보기가 선택됩니다.

DITA 맵을 게시하는 경우 기본적으로 변경 내용 적용이 선택됩니다. DITA 맵에서 게시하는 경우 선택된 변경 내용 추적 보기가 DITA 맵에서 참조하는 항목에만 적용됩니다. 다른 참조 맵뿐 아니라 DITA 맵 자체도 변경 내용 추적 보기가 선택되었는지 여부에 관계없이(맵에 변경 내용 추적 마크업이 있는 경우 포함) 항상 변경 내용 적용이 설정된 상태로 게시됩니다.

◦ 변경 내용 강조 표시 - 제안된 모든 변경 내용을 개정 내용 표시와 함께 강조 표시된 상태로 표시합니다.

◦ 변경 내용 적용 - 문서에 통합된 제안된 모든 변경 내용을 개정 내용 표시 없이 표시합니다.

8. 트랜잭션 대기열 생성을 선택하면 도구 메뉴의 대기열에 추가된 트랜잭션 목록에서 결과를 검색할 때 다른 이름으로 저장에 사용할 파일 이름과 도움말 파일 보기 사용 여부를 묻는 메시지가 표시됩니다. 트랜잭션 대기열 생성을 선택하면 대화 상자에서 다른 이름으로 저장 및 도움말 파일 보기 값이 지워집니다. 이러한 필드에 값을 입력한 경우 트랜잭션 대기열 생성 확인란을 지우면 값이 다시 표시됩니다.

9. 트랜잭션 이름을 입력할지 여부를 선택합니다. 도구 메뉴에서 사용할 수 있는 대기열에 추가된 트랜잭션 목록에서 결과를 읽어들이면 트랜잭션 이름이 표시됩니다.

대기열에 있는 트랜잭션 이름 대화 상자에 값을 입력하여 기본적으로 사용할 트랜잭션 이름을 입력이나 특정 출력 유형에 사용할 트랜잭션 이름을 입력할 수 있습니다.

10. 문서에 프로파일링을 적용하려면 프로파일 설정을 클릭하여 프로파일 설정 대화 상자에 액세스합니다. 확인 또는 취소를 클릭하여 프로파일 설정 대화 상자를 닫습니다. 프로파일 설정 버튼은 선택한 문서 유형의 프로파일이 구성되어 있는 경우에만 사용할 수 있습니다.

11. 게시 규칙을 만들려는 경우 규칙 만들기를 클릭하여 새 게시 규칙 만들기를 열고 HTML 도움말 게시에 대한 새 게시 규칙이나 규칙 세트를 만들 수 있습니다.

12. HTML 도움말용으로 게시 대화 상자에서 확인을 클릭합니다.

• Arbortext Publishing Engine을 사용하여 문서 게시하는 경우 HTML Help Workshop이 Arbortext Publishing Engine 서버에 설치되어 있어야 합니다. 게시된 HTML 도움말 파일이 반환될 때 도움말 파일 보기가 선택되어 있으면 Arbortext Editor에서 로컬 HTML 도움말 뷰어에 파일을 표시합니다.

• Arbortext Editor는 게시 프로세스 도중 올바로 표시되지 않은 일부 문자 엔티티를 바꿉니다. 대체 문자 엔티티는 Arbortext-path\composer\htmlHelpNavEntSub.xml에 정의되어 있습니다. 이 파일은 HTML 도움말 탐색 창에 대한 엔티티 대체만을 제어하고 HTML 도움말 콘텐츠 창에 대한 엔티티 대체를 지원하지 않습니다.

• Arbortext Styler에서는 세 가지 방법으로 HTML 출력에 CSS 정보를 포함할 수 있습니다. 자세한 내용은 CSS files in HTML output을 참조하십시오.

• Microsoft HTML 도움말 컴파일러(hhc.exe)에서는 폴더 이름이 마침표로 시작하는 경로가 디렉토리에 있으면 이 디렉토리에 .chm 파일을 만들 수 없습니다. APTCACHE 환경 변수를 통해 이러한 폴더가 있는 디렉토리를 지정하면 도움말 컴파일러에서 .chm 파일을 만들 때 실패합니다. 이 문제는 APTCACHE 환경 변수를 사용하여 마침표로 시작하는 폴더 이름이 없도록 디렉토리를 지정하여 임시로 해결할 수 있습니다.