DITA conref(콘텐츠 참조)를 사용하면 한 DITA 문서의 요소 콘텐츠를 다른 DITA 문서에 포함할 수 있습니다. 콘텐츠 참조를 사용하여 다른 문서의 콘텐츠를 포함하면 참조하는 요소의 모든 콘텐츠가 포함된 콘텐츠로 바뀝니다. 처리된 문서에서 스타일링 및 문서 게시를 위해 지원되는 참조하는 요소와 참조된 요소의 속성을 병합하는 경우는 예외입니다.

콘텐츠 참조는 요소를 기준으로 하므로 참조하는 요소는 콘텐츠 참조를 포함하는 요소와 같아야 합니다. 참조된 콘텐츠는 문서에서 볼 수만 있고 편집할 수는 없습니다. 참조된 콘텐츠를 변경하려면 해당 참조의 원본 소스를 수정해야 합니다. Arbortext Editor에서는 리소스 매니저를 사용하여 문서에서 참조할 콘텐츠를 찾을 수 있습니다. 현재 문서에 유효한 참조 요소가 없으면 리소스 매니저에서 비어 있는 새 요소를 자동으로 문서에 삽입하여 콘텐츠 참조의 대상으로 지정합니다.

콘텐츠 참조는 문서 유형의 속성에 따라 정의됩니다. 이 속성은 문서 유형 구성 파일(.dcf)에 정의됩니다. DITA 문서의 경우 conref 속성을 대부분의 DITA 요소에서 사용할 수 있으며 이 속성은 콘텐츠 참조 속성으로 사용됩니다.

콘텐츠 참조 속성에서 DITA 주제의 요소를 참조하는 문자열의 형식은 다음과 같습니다.

[[path/]filename]은 참조가 들어 있는 파일에 대한 선택적 참조입니다. 이는 절대 또는 상대 파일 이름이 될 수 있으며 경로 컴포넌트를 포함할 수 있습니다. 파일 이름을 지정하지 않으면 참조가 현재 문서에 있는 것으로 간주됩니다. 절대 파일 이름을 지정하지 않으면 DITA 참조 경로를 사용하여 콘텐츠 참조가 결정됩니다.

topic-id/element-id는 문서 내에서 ID 속성의 탐색 경로입니다. topic-id는 참조할 요소가 들어 있는 DITA 주제 요소(또는 개념, 작업, 참조와 같은 주제의 특수화)에 대한 식별자입니다. element-id는 해당 주제에서 단락이나 목록 항목 등 다시 사용할 요소에 대한 식별자입니다. 두 가지 모두 주제 내에서 콘텐츠 참조에 필요합니다. element-id를 생략하면 전체 주제가 참조에 포함됩니다. topic-id와 element-id를 모두 생략하면 파일의 첫 번째 주제가 참조 대상이 됩니다.

콘텐츠 참조 속성에서 DITA 맵의 요소를 참조하는 문자열의 형식은 다음과 같습니다.

DITA 맵의 요소에 대한 참조에는 요소 ID만 있으면 됩니다. mapelement-id를 생략하면 전체 맵이 참조 대상이 됩니다. filename을 생략하면 현재 문서의 요소가 참조 대상이 됩니다.

예를 들어, 다음과 같은 콘텐츠 참조가 포함된 DITA 단락 요소를 생각해 볼 수 있습니다.

conref 속성은 releases.dita 문서에 있고, ID가 product인 주제 요소의 자식 요소이며, ID가 version인 p 요소에서 p 요소 콘텐츠를 포함하도록 지정합니다. 참조할 releases.dita 문서에는 다음 요소가 포함됩니다.