키 참조 삽입 대화 상자
이 대화 상자를 사용하여 DITA 주제나 맵에 키 참조를 삽입할 수 있습니다. 이 대화 상자는 > 메뉴 항목 또는 해당 도구 모음 버튼을 사용하여 열 수 있으며, 원하는 경우 Arbortext Editor 창에 이 대화 상자를 도킹할 수 있습니다.
이 대화 상자에 포함되는 키는 ditakeybaselist 고급 기본 설정에 포함된 DITA 맵에서 파생됩니다. 추가/제거 버튼을 사용하여 현재 세션의 목록에 맵을 추가할 수도 있습니다. 또한 키 정의를 포함하는 맵 컨텍스트에서 주제를 열 경우 이 맵은 해당 주제에 대해 이 대화 상자를 열 때 키 컨텍스트에 포함됩니다. 키 정의를 포함하는 맵이 DITA 키 정의 맵일 경우 해당 정의에 대해 추가 정보를 사용할 수 있습니다.
키 참조 삽입 대화 상자에는 다음과 같은 옵션이 있습니다.
• 검색 - 사용 가능한 키 정의 목록을 필터링할 수 있습니다.
이 옵션에 내용을 입력하면 입력한 내용과 일치하도록 키 정의 테이블의 콘텐츠가 자동으로 필터링됩니다. 검색은 테이블의 키 이름, 제목/설명 및 참조 열에 대해 수행됩니다. 리소스 열의 모든 텍스트(마크업 포함)에 대해서도 설명합니다.
• 대/소문자 구분 - 검색 옵션에서 수행하는 검색이 대소문자를 구분할지 여부를 결정합니다.
• 시작 문자 - 검색 옵션에서 검색을 수행할 때 검색 대상 열 콘텐츠의 시작 문자와 일치하는 항목만 검색할지 여부를 결정합니다.
• 맵 - 키 정의 테이블의 키 정의에 사용되는 맵을 결정합니다.
기본값은 모두이며 이는 현재 키 컨텍스트의 모든 키 정의를 사용함을 의미합니다. 드롭다운 목록에서 특정 맵을 선택할 경우 해당 맵의 키 정의만 키 정의 목록에 나타납니다.
이 대화 상자를 사용하여 현재 키 컨텍스트에서 맵을 추가하거나 제거할 수 있습니다. 이러한 변경은 현재 세션의 키 컨텍스트에만 적용됩니다. 키 컨텍스트를 영구적으로 변경하려면 ditakeybaselist 고급 기본 설정을 수정해야 합니다.
• 키 정의 테이블 – 문서에 참조로 삽입할 수 있는 키 정의를 나열합니다.
키 정의를 포함하는 맵이 DITA 키 정의 맵일 경우 정의에 추가 정보를 사용할 수 있습니다. 키가 두 번 이상 정의된 경우 각 정의는 개별 행에 표시됩니다. 하나의 키 정의에 여러 키가 정의된 경우 각 키는 개별 행에 각각 나열됩니다.
이 테이블에는 다음 열이 있습니다.
◦ 키 이름 - 키 이름을 제공합니다.
일반 키에는 아이콘이 없습니다. 콘텐츠 참조 키는
아이콘으로 나타냅니다. DITA 키 정의 맵에 키가 정의되어 있고
keysubelementid 요소가 지정되면 키 이름 뒤에
/가 오고 해당 ID 값이 추가됩니다.
◦ 유형 - 이 키를 참조하는 데 사용할 수 있는 요소 목록을 제공합니다.
DITA 키 정의 맵에 키가 정의되어 있고 keyreftags 요소가 지정되면 해당 요소에서 키 목록이 파생됩니다. 그렇지 않을 경우 값은 모두이며 이는 keyref 요소를 갖는 모든 요소가 키를 참조할 수 있음을 의미합니다. 키가 콘텐츠 키 참조(conkeyref)용일 경우 값은 콘텐츠 참조에 사용될 요소의 이름이며 이름 뒤에 (conref)가 옵니다.
◦ 제목/설명 - 키 설명을 제공합니다.
DITA 키 정의 맵에 키가 정의되어 있고 keydescription 요소가 지정되면 해당 요소에서 설명이 파생됩니다. 그렇지 않을 경우에는 navtitle 요소, navtitle 속성 또는 linktext 요소의 콘텐츠에서 순서대로 설명이 파생됩니다.
◦ 리소스 - 키 정의에 href 값이 제공되지 않은 경우 키 정의의 href 속성 값이나 키 정의의 텍스트(마크업 포함)를 제공합니다.
키 정의에 href 값이 제공되지 않은 경우 키 정의에 대체할 텍스트 내용이 포함된 것으로 간주됩니다.
◦ 맵 이름 - 키 정의를 포함하는 맵 이름을 제공합니다.
테이블에는 맵의 베이스 이름만 나타납니다. 키 정의가 다른 맵에서 참조된 맵에서 파생될 경우 부모 맵의 베이스 이름만 표시되며 참조된 맵의 베이스 이름이 그 뒤의 괄호 안에 표시됩니다.
• 삽입 드롭다운 목록 - 현재 커서 위치에 삽입할 유효한 키 참조 요소 목록을 제공합니다.
텍스트 대체를 위한 키 참조가 아닌 경우 이 목록의 콘텐츠는 커서가 위치한 요소의 유형에 따라 결정됩니다. 또한 유형 열에 허용되는 일련의 태그가 있는지 여부 및 smartinsert 고급 기본 설정의 값에 따라서도 이 목록의 콘텐츠가 달라집니다.
텍스트 대체를 위한 키 참조인 경우 목록에 표시되는 요소는 ditatextkeyrefs 고급 기본 설정의 값에 따라 결정됩니다. 기본적으로 이 기본 설정은 off로 설정되므로, 키 참조를 허용하는 연결 요소만 목록에 표시됩니다. 기본 설정을 on으로 설정하면 키 참조를 허용하는 비연결 요소도 목록에 표시됩니다. 그러면 해당 유형의 요소에 텍스트 대체를 위한 키 참조를 삽입할 수 있습니다.
• 삽입 버튼 - 선택한 요소를 사용하여 선택한 키 참조를 문서에 삽입합니다.
삽입된 참조에는 href, scope, type 및 format 속성 값과 키 정의의 링크 텍스트가 사용됩니다.