도움말 > 작성 > 마크업 사용 > 완결성 확인 및 컨텍스트 확인 > 완결성 확인
  
완결성 확인
문서 및 선택적으로 문서의 모든 하위 컴포넌트(예: 파일 엔티티)에 대해 완결성 확인을 수행할 수 있습니다. Arbortext Editor에서 해당 문서 유형에 필요한 모든 컴포넌트가 있는지 확인합니다. 문서를 만들고 편집할 때 Arbortext Editor에서는 의도한 변경 내용이나 추가 사항의 컨텍스트를 일관되게 확인하고 피드백을 제공하여 유효한 SGML 또는 XML 문서를 만들고 있는지 확인합니다. 그러나 Arbortext Editor에서는 완전한 문서를 요구하지 않기 때문에 문서를 저장하고 종료할 때 특정 필수 요소가 여전히 누락될 수 있습니다. 필수 요소가 누락되면 문제 목록이 보고됩니다.
또한 Arbortext Editor에서는 완결성 확인을 수행하는 동안 ID 참조, 상호 참조, 빈 요소 및 필수 속성 누락과 관련된 여러 가지 문제를 검색하고 그래픽 엔티티의 유효성을 검사합니다. DITA 문서의 경우 Arbortext Editor에서 정규 완결성 확인이 완료된 후 추가 고급 완결성 확인을 수행합니다. 이 고급 완결성 확인은 특정 DITA 문서와 관련된 몇 가지 추가 영역에 적용됩니다. 자세한 내용은 DITA 문서에서 완결성 확인 사용을 참조하십시오.
완결성 확인
문서에서 완결성 오류 찾기
1. 전체 메뉴를 켠 상태에서 도구 > 완결성 확인을 선택합니다.
-full 옵션과 함께 check_completeness 명령을 사용하여 엔티티를 포함합니다.
문서가 완전하면 오류가 발견되지 않았음을 확인하는 메시지가 상태 표시줄에 표시됩니다. 편집 창의 맨 아래에 있는 상태 표시줄에 INC가 강조 표시되어 있으면 문서가 불완전한 것이며 완결성 확인 로그 창이 열리고 오류가 표시됩니다.
2. 완결성 확인 로그 창에 표시된 첫 번째 오류 옆에 있는 링크를 두 번 클릭합니다.
그러면 커서가 문서에서 오류가 있는 위치로 이동합니다.
3. 필요한 경우 오류를 수정합니다.
4. 창에서 각 오류에 대해 반복합니다.
완결성 확인 로그 창
완결성 확인 메시지가 완결성 확인 로그 창에 표시됩니다. 메시지는 다음과 같은 카테고리로 나뉩니다.
• 완결성 오류 - 컨텍스트에 맞지 않는 요소, 필요한 요소 누락 등 컨텍스트 확인 오류
• 마크업 오류 - 선언되지 않은 태그 또는 속성, 중복 속성, 잘못된 속성 값, 누락된 필수 속성, 잘못된 PI 이름, 확인되지 않은 파일 엔티티, 빈 요소 등 마크업이 잘못된 다양한 오류
• 엔티티 참조 오류 - 선언되지 않은 엔티티 및 표시에 대한 참조
• ID 및 ID 참조 오류 — 누락된 ID 참조 및 여러 번 정의된 ID 수 보고
이 카테고리의 오류에 포함된 링크를 사용하면 ID 및 ID 참조 대화 상자를 호출할 수 있습니다.
• 빈 요소 - 텍스트를 포함할 수 있지만 비어 있는 요소입니다. 이 카테고리의 경고에 포함된 링크를 사용하면 빈 요소 대화 상자를 호출할 수 있습니다. 빈 요소에 대한 경고는 문서 유형 구성 파일에서 비활성화할 수 있습니다.
• 스키마 오류 - XML 스키마 문서 유형에 대한 모든 ID 제약 조건
• 테이블 마크업 오류 - Arbortext Editor에서 마크업을 테이블로 인식할 수 없도록 하는 잘못된 테이블 마크업(예: 셀 태그가 없는 행)
• 테이블 마크업 경고 - 테이블 관련 문제를 발생시킬 수 있으며 Arbortext Editor에서 마크업을 테이블로 인식할 수 있는 잘못된 테이블 마크업
• Schematron 경고 - 문서 유형의 기본 schematron에서 보고된 경고
DITA 문서에는 추가 카테고리가 있습니다.
완결성 확인 로그 창에는 두 개의 메뉴와 바로 가기 메뉴가 표시됩니다.
파일 메뉴에는 다음 옵션이 있습니다.
• 저장 - 메시지 창의 콘텐츠를 .xml 파일에 저장합니다. 창이 표시된 후 처음으로 저장하는 경우 출력 파일 이름을 선택해야 합니다.
• 다른 이름으로 저장 - 콘텐츠를 다른 이름의 출력으로 저장합니다.
• HTML로 저장 - 콘텐츠를 .htm 파일에 저장합니다.
• 인쇄 - 메시지 창의 게시된 버전을 인쇄합니다. 이 인쇄물에는 보기 메뉴를 선택했을 때 표시되도록 현재 설정된 정보가 표시됩니다.
• 닫기 - 메시지 창을 닫습니다.
보기 메뉴에는 다음 옵션이 있습니다.
• 표시 - 메시지 창에 표시할 다음과 같은 콘텐츠 유형을 결정합니다.
◦ 메시지 - 모든 정보(메시지, 경고 및 오류)를 표시합니다.
◦ 경고 - 경고 및 오류만을 표시합니다. 이것이 기본 설정입니다.
◦ 오류 - 오류만을 표시합니다.
• 글꼴 크기 - 메시지 창의 글꼴 크기를 변경할 수 있는 다음과 같은 두 가지 옵션을 제공합니다.
◦ 크게 - 표시 글꼴 크기를 늘립니다.
◦ 작게 - 표시 글꼴 크기를 줄입니다.
바로 가기 메뉴는 메시지 창 내에서 마우스 오른쪽 버튼을 클릭할 때 표시됩니다. 다음과 같은 옵션이 있습니다.
• 복사 - 선택한 영역을 클립보드로 복사합니다. 이 옵션은 선택한 영역 내에서 클릭한 경우에만 사용할 수 있습니다.
• 링크로 이동 - 메시지 창에서 마우스 오른쪽 버튼으로 링크를 클릭하고 이 옵션을 선택하면 연결된 문서가 표시되면서 소스 문서의 해당 위치에 커서가 위치하게 됩니다. 이 옵션은 메시지 창에 링크가 없는 경우에는 적용되지 않습니다.
• 축소/확장 - 현재 엔트리를 축소하거나 확장합니다.
발생 가능한 완결성 확인 문제
완결성 확인 기능을 사용할 때는 다음과 같은 잠재적 문제에 주의해야 합니다.
• 문서 유형 구성(.dcf) 파일)에서 그래픽 지원에 대해 선택적 파일 이름 속성을 정의한 경우 Arbortext Editor에서는 해당 속성에 값이 없을 경우 완결성 오류를 보고합니다.
• 문서에 별칭 맵을 적용한 경우 패널의 요소 이름이 별칭이 됩니다.
• 올바른 것으로 표시되는 방정식에 Equation Editor를 사용하면 구문 분석 오류가 나타날 수 있습니다. 수학 문서 유형 조각이 다른 문서 유형과 통합된 경우 대상 문서 유형에 빈 콘텐츠를 허용하는 콘텐츠 모델이 있을 수 있기 때문에 이런 오류가 발생할 수 있습니다. 자세한 내용은 Integrating the Equation Editor in a Document Type을 참조하십시오.
• Arbortext Editor에서 만들지 않은 파일 엔티티나 다른 위치에서 편집된 엔티티가 SGML 문서에 있는 경우 이러한 엔티티는 문서 저장 시 정규화되지 않습니다. 정규화하면 생략된 태그를 추가하여 태그 쌍이 완전해집니다. 파일 엔티티를 정규화하지 못하면 문서에서 파일 엔티티를 편집하려 할 때 컨텍스트나 완결성 오류가 발생할 수 있습니다. 문서가 정규화되었으며 완전한지 확인하려면 열기 대화 상자에서 문서를 열 때 읽기 방식 옵션인 SGML 가져오기를 선택합니다.