플러그인에서 플랫폼에 기능을 제공하기 때문에 새 기능을 설명하는 문서를 추가하는 것이 일반적입니다. 사용자가 다수의 개별적인 컨트리뷰션 대신 완전하게 결합된 문서 세트를 볼 수 있게 이 문서를 어떻게 구조화할 수 있습니까? 목차 정의에서 하향식 방식 및 상향식 방식으로 모두 문서를 빌드하기 위한 메커니즘을 제공합니다.
하향식 중첩은 포함된 다른 모든 목차를 참조하는 마스터 목차를 정의하는 방법을 가리킵니다. 하향식 중첩은 알려진 컨텐츠를 더 작은 조각으로 세분하는 편리한 방법입니다. 하향식 중첩을 사용하면 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>