DITA 맵 작성
Arbortext Editor에서는 DITA 맵을 작성하는 데 도움이 되는 여러 가지 기능을 제공합니다. DITA 맵은 DITA 주제 및 기타 리소스에 대한 참조를 구성하여 온라인 도움말 같은 특정 산출물을 게시하는 데 사용됩니다. DITA 맵을 사용하면 계층 구조, 정렬 기준 및 피어 그룹 관계를 비롯한 주제 사이의 관계를 정의할 수 있습니다. 이러한 관계를 사용하여 아웃라인, 목차, 빌드 목록 및 기타 유사한 구조를 정의할 수 있습니다. DITA 맵에서는 게시된 DITA 맵에 추가할 관련 주제 섹션에 대해 주제와 기타 리소스 사이의 관계를 표 형식으로 정의할 수 있는 관계 테이블도 제공합니다.
DITA 맵을 작성하는 방법은 DITA 주제를 작성하는 방법과 크게 다릅니다. DITA 맵에는 텍스트 양이 비교적 많지 않은 요소 및 속성 콘텐츠나 기타 인라인 콘텐츠가 주로 포함됩니다. 일반적인 편집 및 문서 맵 보기를 사용할 수도 있지만 Arbortext Editor에서는 DITA 맵을 작성하는 데 도움이 되는 세 가지 새로운 기능을 제공합니다.
우선, 이 응용 프로그램에서는 기존 DITA 주제에 콘텐츠 및 주제 참조를 삽입하고 DITA 맵에 기타 리소스를 삽입하는 데 사용할 수 있는 리소스 매니저라는 대화 상자를 제공합니다. 또한 리소스 매니저를 통해 새 DITA 주제를 생성한 다음 해당 주제에 대한 참조를 DITA 맵에 삽입할 수 있습니다. 리소스 매니저는 DITA 맵을 편집할 때 기본적으로 실행되며 Arbortext Editor 창의 왼쪽에 도킹된 상태로 표시됩니다.
또한, 이 응용 프로그램에서는 DITA 맵에 대한 열 보기를 제공합니다. 이는 주로 요소 및 속성 콘텐츠로 이루어진 문서 유형을 지원하기 위해 특별히 설계된 Arbortext Editor 보기입니다. 열 보기는 스프레드시트와 유사하게 열과 행으로 이루어진 DITA 맵 계층 구조 보기로, 맵 요소의 속성을 확인하고 편집하는 데 사용할 수 있습니다. 첫 번째 열인 Outline 열을 사용하여 DITA 맵의 요소를 정렬할 수 있습니다. 맵에서 별도의 Arbortext Editor 창을 통해 참조 문서를 열고 편집할 수도 있습니다. 열 보기는 DITA 맵을 편집할 때 기본적으로 실행됩니다.
셋째, 이 응용 프로그램에서는 DITA 맵 도구 모음을 제공합니다. 이 도구 모음을 사용하면 DITA 맵에서 요소 재정렬, 수준 올리기 및 수준 내리기를 수행할 수 있습니다. 이 도구 모음은 DITA 맵을 편집할 때 기본적으로 실행되며 Arbortext Editor 창의 오른쪽에 도킹된 상태로 표시됩니다.
DITA 맵을 처음 열면 DITA 맵을 편집하기 위한 기본 Arbortext Editor 구성이 다음과 같이 표시됩니다.
필요에 따라 기본 구성을 변경한 후 변경 내용을 사용자 기본 설정 파일(arbortext.wcf)에 저장할 수 있습니다. DITA 주제 및 DITA 맵을 편집하기 위한 다른 Arbortext Editor 구성을 저장할 수 있습니다.
DITA 맵에 리소스 매니저 사용
DITA 맵을 작성할 때 리소스 매니저에서 제공하는 탭은 다음과 같습니다.
• 주제 탭 - 주제 참조를 DITA 맵에 삽입할 수 있습니다.
주제 탭에는 파일 시스템이나 CMS(콘텐츠 관리 시스템)에서 파일을 찾는 데 사용할 수 있는 파일 브라우저가 포함되어 있습니다. 관련 참조를 만들 파일을 찾은 다음 해당 파일을 선택하고 그 파일에 대한 주제 참조를 맵에 삽입할 수 있습니다. DITA 주제에 대한 참조를 만드는 경우가 대부분이기는 하지만 리소스 매니저를 사용하면 다른 DITA 맵, 이미지, PDF 문서, HTML 문서 및 기타 파일 형식에 대한 참조도 만들 수 있습니다.
삽입 버튼을 사용하여 참조를 삽입하거나 드래그 및 드롭 방식으로 브라우저에서 맵으로 파일을 가져다 놓을 수 있습니다. 여러 파일을 선택한 다음 선택된 파일 전체에 대한 참조를 한꺼번에 삽입할 수 있습니다. 폴더를 선택하고 해당 폴더에 있는 모든 주제에 대한 참조를 한 번에 삽입할 수도 있습니다. 삽입할 폴더에 하위 폴더가 있는 경우 DITA 맵에서 폴더 계층 구조가 유지됩니다. 이 경우에는 폴더는 topichead 요소가 됩니다.
주제 탭을 사용하면 웹 브라우저를 실행한 다음 웹 페이지에 대한 참조를 맵에 삽입할 수도 있습니다.
• 새 주제 탭 - 새 DITA 주제 또는 맵을 만들고 해당 문서에 대한 주제 참조를 DITA 맵에 삽입할 수 있습니다.
새 주제 탭에는 사용자 환경에 정의된 DITA 문서 유형의 목록이 포함됩니다. 만들려는 문서 유형을 선택하고 새 주제 또는 맵의 제목과 파일 이름을 입력한 다음 새 문서를 만들 위치를 표시할 수 있습니다. 이 탭에서는 주제 또는 맵의 ID가 자동으로 지정됩니다. 삽입 버튼을 선택하면 새 문서가 작성되고 주제 또는 맵에 대한 참조가 맵에 삽입됩니다.
• 키 정의 탭 - DITA 맵에 키 정의를 삽입할 수 있습니다.
DITA 표준은 OASIS
DITA Architectural Specification의
Key based (indirect) addressing 섹션에 정의된 키 기반 참조를 지원합니다.
키 정의 탭을 사용하여 맵에서 다른 DITA 맵 및 주제의 키 참조와 함께 참조할 수 있는 키 정의를 정의할 수 있습니다. 키 참조에 대한 자세한 내용은
키 및 키 참조 사용을 참조하십시오.
콘텐츠 참조 탭도 DITA 맵에 사용할 수 있지만 도킹되지 않은 별도의
리소스 매니저 대화 상자에 나타납니다.
DITA 맵에 열 보기 사용
열 보기에는 DITA 맵의 계층 구조가 표시됩니다. 첫 번째 열인
Outline 열을 사용하여 DITA 맵을 전개할 수 있습니다.
리소스 매니저를 사용하여 새 주제와 콘텐츠 참조를 추가할 수 있을 뿐만 아니라
Windows 탐색기에서 드래그 및 드롭 방식으로 주제를 끌어다 놓아 주제 참조를 추가할 수 있습니다. 폴더를 선택하고 해당 폴더에 있는 모든 주제에 대한 참조를 한 번에 삽입할 수도 있습니다. 삽입할 폴더에 하위 폴더가 있는 경우 DITA 맵에서 폴더 계층 구조가 유지됩니다. 이 경우 폴더는 기본적으로
topichead 요소가 됩니다. 드래그 및 드롭이 아닌 삽입 작업의 경우 열 보기 커서(
)의 위치에 따라
Outline 열에서 참조가 삽입되는 위치가 결정됩니다.
드래그 및 드롭 방식을 사용하여 아웃라인에서 계층 구조의 일부 또는 개별 요소를 이동할 수 있습니다. 또는 DITA 맵 도구 모음을 사용하여 맵 계층 구조를 다시 정렬할 수도 있습니다. 이 도구 모음을 사용하면 선택된 요소를 위아래로 이동하고 맵 계층 구조 내에서 요소의 수준을 오르내릴 수 있습니다.
맵 아웃라인 레벨 옆의 더하기 기호(
)를 클릭하여 계층 구조에서 해당 레벨을 확장합니다. 계층 구조 레벨을 축소하려면 빼기 기호(
)를 클릭합니다.
아웃라인에서 요소 아이콘을 클릭하여 해당 요소를 선택합니다. 요소 아이콘을 두 번 클릭하거나 현재 선택한 요소의 아이콘을 클릭하여 해당 요소와 자식 요소를 선택합니다. 선택한 영역의 내부를 클릭하여 선택 영역을 지웁니다.
열 보기 커서의 위치에 따라 아웃라인에서 선택되는 요소도 결정됩니다. 커서 위에 가장 가까이 있는 요소는 DITA 맵 도구 모음 및 유사 작업의 영향을 받습니다.
Ctrl 키를 누른 상태에서 요소 아이콘을 왼쪽 마우스 버튼으로 클릭하여 DITA 맵의 해당 부분에 대한 편집 보기를 엽니다. 요소가 다른 문서를 참조할 경우 아웃라인에서 요소 제목을 두 번 클릭하여 연관된 문서를 새 Arbortext Editor 창에서 열 수도 있습니다.
기본적으로 열 보기
Outline 열만 표시됩니다. 열 보기의 추가 열을 사용하면 주제 참조 및 기타 맵 요소의 속성에 쉽게 액세스할 수 있습니다.
Outline 열의
여러 열 표시 버튼(
)을 선택하면
기본 설정 대화 상자의
열 카테고리에 현재 정의된 열이 표시됩니다.
Outline 열의
단일 열 표시 버튼(
)을 선택하면
Outline 열만 표시됩니다.
열 보기 머리글 바로 가기 메뉴를 사용하여 추가 열을 표시할 수도 있습니다. 열 보기 머리글 바로 가기 메뉴에서는 열을 구성하기 위한 다음과 같은 항목을 선택할 수 있습니다.
• 열 구성 -
기본 설정 대화 상자에
열 카테고리를 표시합니다. 이 카테고리에서는 표시할 열을 선택하고, 열의 순서를 다시 정렬하고, 열 스크롤 경계를 옮기고, 첫 번째 열에 표시할 내용을 지정할 수 있습니다.
• 단일 열 표시 - 열 보기의 Outline 열만 표시합니다.
여러 열이 표시된 상태로 열 보기가 나타나는 방식은 다음과 같습니다.
Outline 열 다음의 첫 번째 열을 사용하여 해당 열의 아이콘을 클릭하고 요소에 대한 기존 속성을 편집할 수 있습니다. 요소의 속성에 대해 열 보기 셀을 두 번 클릭하여 해당 속성에 새 값을 추가하거나 기존 값을 편집할 수도 있습니다. 다른 문서를 참조하는 속성의 경우
Arbortext Editor에서 버튼(
)을 사용하여 도킹되지 않은 버전의
리소스 매니저를 호출하고 참조할 문서를 찾아볼 수 있습니다. 필요에 따라 선택한 요소에 대한
속성 수정 대화 상자를 호출하여 맵 요소의 속성을 수정할 수 있습니다. ID를 수정할 경우
Arbortext Editor에서 버튼(
)과 메뉴 항목( > )을 사용하여 ID 값을 자동으로 생성할 수 있습니다.
관계 테이블 작성
DITA 맵의 또 다른 컴포넌트로는 관계 테이블이 있습니다. 관계 테이블을 사용하면 DITA 맵에 대한 관련 주제 및 리소스를 식별할 수 있습니다. 관계 테이블 열에서 관련 리소스의 유형을 식별하고 관련 리소스를 테이블 셀에 추가합니다.
관계 테이블을 DITA 맵에 삽입할 때는 다음 단계를 따릅니다.
1. 열 보기 커서를 DITA 맵의 맨 아래로 이동합니다.
맵 아웃라인의 어떠한 요소 위에도 커서가 놓여 있지 않아야 합니다.
2. > 을 선택합니다.
3. 관계 테이블 삽입 대화 상자에서 관계 테이블을 정의한 다음 삽입 버튼을 누릅니다.
분할 보기를 사용하여 편집 보기를 표시하지 않았다면 테이블의 편집 보기가 열 보기 아래 표시됩니다.
4. 관계 테이블의 셀에 관련 주제 및 기타 리소스를 추가합니다.
리소스 매니저를 사용하여 관계 테이블에 참조를 추가할 수 있습니다. DITA 맵의 주제 참조나 Windows 탐색기의 주제를 드래그 및 드롭하여 주제 참조를 테이블에 추가할 수도 있습니다.
주제 참조를 관계 테이블에 드래그 및 드롭하면 연관된 주제 유형과 일치하는 테이블 열에 참조가 자동으로 추가됩니다. 일치하는 열이 없는 경우 "기타" 열에 참조를 추가할지 묻는 메시지가 나타납니다. "기타" 열이 없는 경우 드롭한 열에 참조를 추가할지 묻는 메시지가 나타납니다. 주제 유형에 관계없이 항상 "기타" 열에 참조를 드롭할 수 있습니다. 관계 테이블 내에서 무제한으로 참조를 드래그 및 드롭할 수 있습니다.
관계 테이블 작성을 마쳤으면 관계 테이블이 포함된 편집 보기를 마우스 오른쪽 버튼으로 클릭하고 바로 가기 메뉴에서 보기 닫기를 선택하여 편집 보기를 닫은 다음 전체 열 보기 표시로 돌아갈 수 있습니다.
다음은 관계 테이블 편집 보기를 표시한 상태의 Arbortext Editor 창 모습입니다.
처리된 문서 작성
Arbortext Editor에서는 처리된 문서라는 어셈블된 버전의 DITA 맵을 열 수 있습니다. 처리된 문서에는 맵에서 참조하는 모든 콘텐츠가 들어 있습니다. 맵의 일부를 선택할 수도 있습니다. 이렇게 하면 선택한 맵 부분에 대해서만 처리된 문서가 생성됩니다.
> > 메뉴 항목을 선택하여 DITA 맵에 대해 처리된 문서를 생성할 수 있습니다. 이 메뉴 항목을 선택하면 Arbortext Editor에서 DITA 맵의 콘텐츠가 중간 XML 문서로 어셈블되고 처리된 문서가 새 Arbortext Editor 창에서 열립니다.
처리 문서를 사용하면 DITA 맵에 포함된 콘텐츠의 구조와 텍스트를 편집할 수 있습니다. 또한 해당 콘텐츠에 대해 맞춤법 검사나 찾기/바꾸기 작업을 실행할 수 있습니다. 처리된 문서에 대한 변경 내용은 맵에서 참조하는 해당 소스 문서에 저장됩니다. DITA 맵의 구조는 처리된 문서에서 변경할 수 없습니다.
기본적으로 맵에서 참조된 DITA 주제만 처리된 문서에 포함됩니다. ditaincludemapsinrde 기본 설정을 on으로 설정하여 맵에서 참조된 DITA 맵이 처리된 문서에 포함되도록 선택할 수도 있습니다.
다음은 처리된 문서를 편집할 때의 Arbortext Editor 창 모양입니다.
cascade를 사용하여 DITA 맵의 계단식 표시 속성 값 처리
DITA 1.2에서는 이러한 속성이 계단식 표시 및 병합으로 정의됩니다.
• audience, platform, product, otherprops, rev
• props 및 props에서 특수화된 모든 속성
cascade는 다음과 같이 여러 값을 가지도록 허용된 속성을 처리하는 방법에 대한 처리 명령으로 사용하십시오.
• cascade="merge"(기본값) - 속성 값이 추가되는 경우 속성에 DITA 1.2의 일반적인 계단식 표시가 적용됩니다.
• cascade="nomerge" - DITA 1.2 계단식 표시가 속성 값이 추가되지 않은 것처럼 동작합니다.
필요한 경우 맵에서 cascade 속성을 지정하여 다른 계단식 표시 규칙으로 관리되는 다른 섹션을 포함할 수 있습니다. 관련 주제 참조에서 해당 값을 설정하십시오.
