키 참조 삽입 대화 상자
이 대화 상자를 사용하여 DITA 주제나 맵에 키 참조를 삽입할 수 있습니다. 이 대화 상자는 > 메뉴 항목 또는 해당 도구 모음 버튼을 사용하여 열 수 있으며, 원하는 경우 Arbortext Editor 창에 이 대화 상자를 도킹할 수 있습니다.
이 대화 상자에 포함되는 키는 ditakeybaselist 고급 기본 설정에 포함된 DITA 맵에서 파생됩니다. 추가/제거 버튼을 사용하여 현재 세션의 목록에 맵을 추가할 수도 있습니다. 또한 키 정의를 포함하는 맵 컨텍스트에서 주제를 열 경우 이 맵은 해당 주제에 대해 이 대화 상자를 열 때 키 컨텍스트에 포함됩니다. 키 정의를 포함하는 맵이 DITA 키 정의 맵일 경우 해당 정의에 대해 추가 정보를 사용할 수 있습니다.
키 참조 삽입 대화 상자에는 다음과 같은 옵션이 있습니다.
• 검색 - 사용 가능한 키 정의 목록을 필터링할 수 있습니다.
이 옵션에 내용을 입력하면 입력한 내용과 일치하도록 키 정의 테이블의 콘텐츠가 자동으로 필터링됩니다. 검색은 테이블의 키 이름, 제목/설명 및 참조 열에 대해 수행됩니다. 리소스 열의 모든 텍스트(마크업 포함)에 대해서도 설명합니다.
• 대/소문자 구분 - 검색 옵션에서 수행하는 검색이 대소문자를 구분할지 여부를 결정합니다.
• 시작 문자 - 검색 옵션에서 검색을 수행할 때 검색 대상 열 콘텐츠의 시작 문자와 일치하는 항목만 검색할지 여부를 결정합니다.
• 맵 - 키 정의 테이블의 키 정의에 사용되는 맵을 결정합니다.
기본값은 모두이며 이는 현재 키 컨텍스트의 모든 키 정의를 사용함을 의미합니다. 드롭다운 목록에서 특정 맵을 선택할 경우 해당 맵의 키 정의만 키 정의 목록에 나타납니다.
이 대화 상자를 사용하여 현재 키 컨텍스트에서 맵을 추가하거나 제거할 수 있습니다. 이러한 변경은 현재 세션의 키 컨텍스트에만 적용됩니다. 키 컨텍스트를 영구적으로 변경하려면 ditakeybaselist 고급 기본 설정을 수정해야 합니다.
• 키 정의 테이블 – 문서에 참조로 삽입할 수 있는 키 정의를 나열합니다.
키 정의를 포함하는 맵이 DITA 키 정의 맵일 경우 정의에 추가 정보를 사용할 수 있습니다. 키가 두 번 이상 정의된 경우 각 정의는 개별 행에 표시됩니다. 하나의 키 정의에 여러 키가 정의된 경우 각 키는 개별 행에 각각 나열됩니다.
이 테이블에는 다음 열이 있습니다.
◦ 키 이름 - 키 이름을 제공합니다.
일반 키에는 아이콘이 없습니다. 콘텐츠 참조 키는

아이콘으로 표시됩니다. DITA 키 정의 맵에 키가 정의되어 있고
keysubelementid 요소가 지정되면 키 이름 뒤에
/가 오고 해당 ID 값이 추가됩니다.
◦ 유형 - 이 키를 참조하는 데 사용할 수 있는 요소 목록을 제공합니다.
DITA 키 정의 맵에 키가 정의되어 있고 keyreftags 요소가 지정되면 해당 요소에서 키 목록이 파생됩니다. 그렇지 않을 경우 값은 모두이며 이는 keyref 요소를 갖는 모든 요소가 키를 참조할 수 있음을 의미합니다. 키가 콘텐츠 키 참조(conkeyref)용일 경우 값은 콘텐츠 참조에 사용될 요소의 이름이며 이름 뒤에 (conref)가 옵니다.
◦ 제목/설명 - 키 설명을 제공합니다.
DITA 키 정의 맵에 키가 정의되어 있고 keydescription 요소가 지정되면 해당 요소에서 설명이 파생됩니다. 그렇지 않을 경우에는 navtitle 요소, navtitle 속성 또는 linktext 요소의 콘텐츠에서 순서대로 설명이 파생됩니다. DITA 2.0 문서의 경우, keydescription 요소가 지정되지 않았으면 설명은 titlehint, navtitle 또는 linktitle 요소의 콘텐츠에서 순서대로 제공됩니다.
◦ 리소스 - 키 정의에 href 값이 제공되지 않은 경우 키 정의의 href 속성 값이나 키 정의의 텍스트(마크업 포함)를 제공합니다.
키 정의에 href 값이 제공되지 않은 경우 키 정의에 대체할 텍스트 내용이 포함된 것으로 간주됩니다.
◦ 맵 이름 - 키 정의를 포함하는 맵 이름을 제공합니다.
테이블에는 맵의 베이스 이름만 나타납니다. 키 정의가 다른 맵에서 참조된 맵에서 파생될 경우 부모 맵의 베이스 이름만 표시되며 참조된 맵의 베이스 이름이 그 뒤의 괄호 안에 표시됩니다.
• 삽입 드롭다운 목록 - 현재 커서 위치에 삽입할 유효한 키 참조 요소 목록을 제공합니다.
텍스트 대체를 위한 키 참조가 아닌 경우 이 목록의 콘텐츠는 커서가 위치한 요소의 유형에 따라 결정됩니다. 또한 유형 열에 허용되는 일련의 태그가 있는지 여부 및 smartinsert 고급 기본 설정의 값에 따라서도 이 목록의 콘텐츠가 달라집니다.
텍스트 대체를 위한 키 참조인 경우 목록에 표시되는 요소는 ditatextkeyrefs 고급 기본 설정의 값에 따라 결정됩니다. 기본적으로 이 기본 설정은 off로 설정되므로, 키 참조를 허용하는 연결 요소만 목록에 표시됩니다. 기본 설정을 on으로 설정하면 키 참조를 허용하는 비연결 요소도 목록에 표시됩니다. 그러면 해당 유형의 요소에 텍스트 대체를 위한 키 참조를 삽입할 수 있습니다.
• 삽입 버튼 - 선택한 요소를 사용하여 선택한 키 참조를 문서에 삽입합니다.
삽입된 참조에는 href, scope, type 및 format 속성 값과 키 정의의 링크 텍스트가 사용됩니다.