중첩된 문서 구조 빌드

플러그인에서 플랫폼에 기능을 제공하기 때문에 새 기능을 설명하는 문서를 추가하는 것이 일반적입니다. 사용자가 다수의 개별적인 컨트리뷰션 대신 완전하게 결합된 문서 세트를 볼 수 있게 이 문서를 어떻게 구조화할 수 있습니까? 목차 정의에서 하향식 방식 및 상향식 방식으로 모두 문서를 빌드하기 위한 메커니즘을 제공합니다.

하향식 중첩

하향식 중첩은 포함된 다른 모든 목차를 참조하는 마스터 목차를 정의하는 방법을 가리킵니다. 하향식 중첩은 알려진 컨텐츠를 더 작은 조각으로 세분하는 편리한 방법입니다. 하향식 중첩을 사용하면 link 속성을 목차 정의에 사용하여 href를 제공하는 대신 링크된 목차를 참조합니다. 

<toc label="Online Help Sample" topic="html/book.html">
	<topic label="Concepts">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="Tasks">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="Reference">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

기본 구조는 동일하게 유지되지만(개념, 타스크, 참조) 개별 목차는 자유롭게 배치할 수 있습니다. 그런 다음 다른 부속 목차로 링크할 수 있습니다.

상향식 작성

상향식 작성은 새 플러그인에서 문서가 목차 구조에 있어야 할 곳을 결정할 수 있다는 점에서 더 유연성이 있습니다. anchor 속성을 사용하여 상향식 작성을 수행합니다. 목차는 다른 플러그인에서 문서를 제공할 수 있는 이름이 지정된 앵커 지점을 정의합니다. 이 예제에서는 개념, 타스크 및 참조 섹션 사이에서 플러그인이 다른 자료를 제공할 수 있도록 앵커를 추가할 수 있습니다.

<toc label="Online Help Sample" topic="html/book.html">
	<topic label="Concepts">
		<link toc="toc_Concepts.xml" />
		<anchor id="postConcepts" />
	</topic>
	<topic label="Tasks">
		<link toc="toc_Tasks.xml" />
		<anchor id="postTasks" />
	</topic>
	<topic label="Reference">
		<link toc="toc_Ref.xml" />		
		<anchor id="postReference" />
	</topic>
</toc>

다른 플러그인이 자신의 플러그인에서 앵커에 제공할 수 있습니다. 목차를 정의할 때 link_to 속성을 사용하여 이를 수행합니다.

<toc link_to="../com.example.helpexample/toc.xml#postConcepts" label="Late breaking info about concepts">
	<topic>
		...
	</topic>
</toc>