키 및 키 참조 대화 상자

이 대화 상자를 사용하여 DITA 맵의 키 정의와 키 참조에 대한 정보 및 참조를 매핑하는 주제나 맵에 대한 정보를 볼 수 있습니다. 현재 맵에 대한 키 컨텍스트가 다른 DITA 맵으로 설정될 경우 대화 상자의 정보는 현재 맵이 아니라 키 컨텍스트인 맵에 대한 것입니다. DITA 주제에서도 이 대화 상자를 열 수 있지만 이 경우 해당 주제에 포함된 키 참조에 대한 정보와, 현재 키 컨텍스트인 맵에 정의된 대로 그러한 참조와 연관된 정의에 대한 정보만 표시됩니다. 대화 상자에서 키 정보를 수집하여 표시하는 데 몇 초 이상 걸리는 경우 진행률 표시줄이 표시됩니다.

해당 키 정의에 대한 정보를 포함하는 키 참조의 경우 활성 키 컨텍스트가 있어야 하며 연관된 키가 이 컨텍스트에 정의되어야 합니다. 키 컨텍스트는 키 정의가 들어 있는 DITA 맵입니다. ditakeycontext set 옵션에 지정된 값은 문서의 키 컨텍스트를 결정합니다. 이 옵션은 사용자가 명시적으로 설정하거나 경우에 따라 Arbortext Editor에서 자동으로 설정합니다. 예를 들어 키 정의가 들어 있는 맵에서 참조된 주제를 열 경우 해당 맵이 키 컨텍스트가 됩니다.

이 대화 상자는 도구 > 키 및 키 참조 메뉴 항목을 선택하여 열 수 있습니다. 또한 도구 메뉴와 바로 가기 메뉴에서 키 참조 찾기 메뉴 항목을 사용하여 DITA 맵에서 커서를 포함하는 태그에 정의된 키에 대해서만 이 대화 상자를 열 수도 있습니다.

키 및 키 참조 대화 상자에는 다음 옵션이 포함되어 있습니다.

대화 상자의 이 영역에는 맵에 정의된 키 정의와, 맵에서 참조된 문서에서 해당 키가 사용되는 위치가 나열됩니다. 또한 현재 맵에서 참조된 문서에 정의되었으며 현재 키 컨텍스트에 연관된 키 정의가 없는 키 참조도 표시됩니다. 정의 및 키 참조를 갖는 키의 경우 트리에서 해당 정의나 참조를 클릭하여 선택한 후 이동 버튼을 사용하여 해당 키 정의나 참조를 포함하는 문서를 열 수 있습니다.

정의를 포함하는 키는 키 이름 및 정의된 href 속성 값 앞에 키 아이콘

이 나타납니다. 맵 또는 맵에서 참조된 문서에 이 키에 대한 참조가 있을 경우 그러한 참조는 키 정의 아래에 중첩됩니다. 키 아래의 참조 목록을 축소하거나 확장할 수 있습니다. 나열된 키 참조를 포함하는 요소는 다음 아이콘으로 표시됩니다.

이 주제 참조 및 keyref 속성의 다른 키 참조는 아이콘 뒤에 해당 키 참조를 포함하는 요소 이름이 표시되고 그 뒤에 참조를 포함하는 문서의 파일 이름이 표시됩니다. 참조를 포함하는 문서가 파일 시스템이 아니라 콘텐츠 관리 시스템(CMS)에 있을 경우 이름은 CMS 객체 이름 또는 논리 ID입니다.

conkeyref 속성의 콘텐츠 키 참조의 경우 아이콘 뒤에 콘텐츠 참조 대상 문서의 요소 이름과 참조를 포함하는 문서의 파일 이름이 표시되고 그 뒤에 (conkeyref)라고 표시됩니다.

연관된 키 정의가 없는 키 참조의 경우 키 아이콘에 빨간색 x 표시

가 나타나고 그 뒤에 키 참조의 키 이름이 표시되며 그 뒤에 (정의가 없음)이라고 표시됩니다. 이 아래에는 현재 맵에서 참조된 문서에 있는, 정의되지 않은 참조가 나타납니다.