¼³¸í: °³º° Ç÷¯±×ÀÎÀÇ ¿Â¶óÀÎ µµ¿ò¸» Á¦°ø µî·Ï
µµ¿ò¸» ÆÄÀÏÀ» Á¦°øÇÏ´Â Ç÷¯±×Àο¡¼´Â ÀϹÝÀûÀ¸·Î ´ÙÀ½°ú °°Àº ÀÛ¾÷À» ¼öÇàÇÕ´Ï´Ù.
±¸¼º ¸¶Å©¾÷:
<!ELEMENT extension (toc*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA
#IMPLIED
>
<!ELEMENT toc EMPTY>
<!ATTLIST toc
file CDATA #REQUIRED
primary
(true | false) "false"
extradir CDATA #IMPLIED
>
toc ÆÄÀÏÀÇ ±¸¼º ¸¶Å©¾÷:
<!ELEMENT toc (topic | anchor | link)* >
<!ATTLIST toc link_to CDATA #IMPLIED >
<!ATTLIST toc label CDATA #REQUIRED >
<!ATTLIST toc topic CDATA #IMPLIED >
<!ELEMENT topic (topic | anchor | link )*
>
<!ATTLIST topic label CDATA #REQUIRED >
<!ATTLIST topic href CDATA #IMPLIED >
<!ELEMENT anchor EMPTY >
<!ATTLIST anchor id ID #REQUIRED >
<!ELEMENT link EMPTY >
<!ATTLIST link toc CDATA #REQUIRED >
ÀϹÝÀûÀ¸·Î ¿Â¶óÀÎ µµ¿ò¸»À» Á¦°øÇØ¾ß ÇÏ´Â Ç÷¯±×ÀÎÀº ÀÚü TOC ÆÄÀÏÀ» Á¤ÀÇÇÕ´Ï´Ù. °á±¹ µµ¿ò¸» ½Ã½ºÅÛÀº ÀϺΠÁ¶Ä¡·Î ½ÇÇàÇϵµ·Ï ±¸¼ºµÇ¸ç À̸¦ À§ÇØ TOC ÆÄÀÏÀÇ °æ·Î¸¦ »ç¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù.
ÁÖÁ¦ ¿ä¼Ò
¸ðµç µµ¿ò¸» Ç׸ñ ¿ä¼Ò´Â toc ÄÁÅ×ÀÌ³Ê ¿ä¼ÒÀÇ ÀϺηΠÁ¦°øµË´Ï´Ù. ¸ðµç ÁÖÁ¦°¡ °èÃþ ±¸Á¶¸¦ °®°Å³ª Ç÷§ ¸ñ·ÏÀ¸·Î ³ª¿ÇÒ ¼ö ÀÖ½À´Ï´Ù.
ÁÖÁ¦ ¿ä¼Ò´Â ¸ñÂ÷ ±¸Á¶ÀÇ Áß¿ä Ç׸ñÀÔ´Ï´Ù. ÁÖÁ¦ ¿ä¼Ò¿¡ ´ëÇÑ µÎ °¡Áö ÀϹÝÀûÀÎ ¿ëµµ´Â ´ÙÀ½°ú °°½À´Ï´Ù.
1. ´ë°³ HTML ÆÄÀÏÀÎ ¹®¼ ÆÄÀÏ¿¡ ¸µÅ© Á¦°ø
2. °°Àº Manifest ¶Ç´Â ´Ù¸¥ Manifest¿¡¼ ´Ù¸¥ toc¿¡ ´ëÇÑ ÄÁÅ×ÀÌ³Ê ¿ªÇÒ
1. ¸µÅ©·Î¼ÀÇ ÁÖÁ¦
¹®¼ ÆÄÀÏ ¸µÅ©´Â ÁÖÁ¦¸¦ °¡Àå °£´ÜÈ÷ »ç¿ëÇÑ ¿¹ÀÔ´Ï´Ù.
<topic label="Some concept file" href="concepts/some_file.html" />
href ¼Ó¼ºÀº Manifest ÆÄÀÏÀÌ ¼ÓÇÏ´Â Ç÷¯±×Àο¡ °ü·ÃµÈ °ÍÀÔ´Ï´Ù. ´Ù¸¥ Ç÷¯±×Àο¡¼ ÆÄÀÏÀ» ¾×¼¼½ºÇØ¾ß ÇÒ °æ¿ì ´ÙÀ½ ±¸¹®À» »ç¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù.
<topic label="topic in another plug-in" href="../other.plugin.id/concepts/some_other_file.html" />
2. ÄÁÅ×À̳ʷμÀÇ ÁÖÁ¦
ÁÖÁ¦ÀÇ °¡Àå ÀϹÝÀûÀÎ µÎ ¹øÂ° ¿ëµµ´Â ´Ù¸¥ tocÀÇ ÄÁÅ×À̳ʷΠ»ç¿ëÇÏ´Â °ÍÀÔ´Ï´Ù.
ÄÁÅ×ÀÌ³Ê ÁÖÁ¦´Â Ç×»ó Æ¯Á¤ ÆÄÀϵµ ÂüÁ¶ÇÒ ¼ö ÀÖ½À´Ï´Ù.
<topic label="Integrated Development Environment" href="concepts/ciover.htm"
>
<topic label="Starting the IDE" href="concepts/blah.htm"
/>
...
</topic>
¸µÅ© ¿ä¼Ò
¸µÅ© ¿ä¼Ò¸¦ »ç¿ëÇÏ¿© ´Ù¸¥ toc ÆÄÀÏ¿¡ Á¤ÀÇµÈ ¸ñÂ÷¿¡ ¿¬°áÇÒ ¼ö ÀÖ½À´Ï´Ù. toc ¼Ó¼º¿¡ ÁöÁ¤µÈ toc ÆÄÀÏÀÇ ¸ðµç ÁÖÁ¦´Â ¸µÅ© ¿ä¼Ò ´ë½Å Á÷Á¢ Á¤ÀÇµÈ °Íó·³ ¸ñÂ÷¿¡ ³ªÅ¸³³´Ï´Ù. api.xml ÆÄÀÏ¿¡¼ toc¸¦ Æ÷ÇÔÇÏ·Á¸é ´ÙÀ½À» ÀÛ¼ºÇϽʽÿÀ.
<topic label="References" >
...
<link toc="api.xml" />
...
</topic>
¾ÞÄ¿ ¿ä¼Ò
¾ÞÄ¿ ¿ä¼Ò´Â ´Ù¸¥ toc ÆÄÀÏÀ» ÀÌ Å½»ö¿¡ ¸µÅ©ÇÏ°í ¸µÅ© ¿ä¼Ò¸¦ »ç¿ëÇϰųª ¿©±â¼ ´Ù¸¥ toc ÆÄÀÏÀ» ÂüÁ¶ÇÏÁö ¾Ê°í È®ÀåÇÒ ¼ö ÀÖ´Â ÁöÁ¡À» Á¤ÀÇÇÕ´Ï´Ù. "ZZZ" ¹®¼ µÚ¿¡ ´õ ¸¹Àº ÁÖÁ¦¸¦ °¡Áø ¸ñÂ÷¸¦ »ðÀÔÇÏ·Á¸é ´ÙÀ½°ú °°ÀÌ ¾ÞÄ¿¸¦ Á¤ÀÇÇϽʽÿÀ.
...
<topic label="zzz" href="zzz.html" />
<anchor id="moreapi" />
...
toc ¿ä¼Ò
toc ¿ä¼Ò´Â ÀÌ ÆÄÀÏ¿¡ Á¤ÀÇµÈ ÁÖÁ¦ ¹× ±âŸ ¿ä¼Ò¸¦ ±×·ìÈÇÏ´Â ¸ñÂ÷ÀÔ´Ï´Ù. ·¹À̺íÀº ¸ñÂ÷°¡ »ç¿ëÀÚ¿¡°Ô Ç¥½ÃµÉ ¶§ »ç¿ëÀÚ¿¡°Ô ¸ñÂ÷¸¦ ½Äº°ÇØ ÁÝ´Ï´Ù. ¼±ÅÃÀû ÁÖÁ¦ ¼Ó¼ºÀº ¸ñÂ÷¸¦ ¼³¸íÇÏ´Â ÁÖÁ¦ ÆÄÀÏÀÇ °æ·ÎÀÔ´Ï´Ù. ¼±ÅÃÀû link_to ¼Ó¼ºÀº Ž»ö °èÃþ ±¸Á¶¿¡¼ ÀÌ ÆÄÀÏÀÇ ¸ñÂ÷¸¦ »óÀ§ÀÇ ¸ñÂ÷ ÆÄÀÏ¿¡ ¸µÅ©Çϵµ·Ï Çã¿ëÇÕ´Ï´Ù. link_to ¼Ó¼ºÀÇ °ªÀº ´Ù¸¥ ¸ñÂ÷ ÆÄÀÏÀÇ ¾ÞÄ¿¸¦ ÁöÁ¤ÇØ¾ß ÇÕ´Ï´Ù. myapi.xml ÆÄÀÏÀÇ toc¸¦ ´Ù¸¥ Ç÷¯±×Àο¡¼ ÁöÁ¤µÈ api.xml ÆÄÀÏ¿¡ ¸µÅ©ÇÏ·Á¸é ´ÙÀ½ ±¸¹®À» »ç¿ëÇϽʽÿÀ.
<toc link_to="../anotherPlugin/api.xml#moreapi" label="My Tool
API"/>
...
<toc />
# ¹®ÀÚ´Â ¾ÞÄ¿ ID¿¡¼ toc ÆÄÀÏ À̸§À» ºÐ¸®ÇÕ´Ï´Ù.
(in file plugin.xml)
<extension point="org.eclipse.help.toc"> <toc file="maindocs.html" primary="true"/> <toc file="task.xml"/> <toc file="sample.xml" extradir="samples"/> </extension>
(maindocs.xml ÆÄÀÏÀÇ °æ¿ì)
<toc label="Help System Example">
<topic label="Introduction" href="intro.html"/>
<topic label="Tasks">
<topic label="Creating a Project" href="tasks/task1.html">
<topic label="Creating a Web Project" href="tasks/task11.html"/>
<topic label="Creating a Java Project" href="tasks/task12.html"/>
</topic>
<link toc="task.xml" />
<topic label="Testing a Project" href="tasks/taskn.html"/>
</topic>
<topic label="Samples">
<topic label="Creating Java Project" href="samples/sample1.html">
<topic label="Launch a Wizard" href="samples/sample11.html"/>
<topic label="Set Options" href="samples/sample12.html"/>
<topic label="Finish Creating Project" href="samples/sample13.html"/>
</topic>
<anchor id="samples" />
</topic>
</toc>
(tasks.xml ÆÄÀÏÀÇ °æ¿ì)
<toc label="Building a Project">
<topic label="Building a Project" href="build/building.html">
<topic label="Building a Web Project" href="build/web.html"/>
<topic label="Building a Java Project" href="build/java.html"/>
</topic>
</toc>
(samples.xml ÆÄÀÏÀÇ °æ¿ì)
<toc link_to="maindocs.xml#samples" label="Using The Compile Tool">
<topic label="The Compile Tool Sample" href="compilesample/example.html">
<topic label="Step 1" href="compilesample/step1.html"/>
<topic label="Step 2" href="compilesample/step2.html"/>
<topic label="Step 3" href="compilesample/step3.html"/>
<topic label="Step 4" href="compilesample/step4.html"/>
</topic>
</toc>
"samples"·Î ½ÃÀÛÇÏ´Â °æ·Î¸¦ »ç¿ëÇÏ´Â ´Ù¸¥ ¹®¼°¡ ÀÖÀ» °æ¿ì Ž»ö Æ®¸®¿¡´Â Ç¥½ÃµÇÁö ¾ÊÁö¸¸ °Ë»öÀ» »ç¿ëÇÏ¿© ¾×¼¼½ºÇÒ ¼ö ÀÖ½À´Ï´Ù. ÀÌ´Â plugin.xml ÆÄÀÏÀÇ <toc file="sample.xml" extradir="samples" /> ¿ä¼Ò¿¡ "extradir" ¼Ó¼ºÀÌ Àֱ⠶§¹®ÀÔ´Ï´Ù.¿¹¸¦ µé¾î "Creating Java Project"¸¦ °Ë»öÇÒ °æ¿ì °æ·Î°¡ samples/sample2.htmlÀÎ "Other Ways of Creating Java Project" ¹®¼¸¦ ¸®ÅÏÇÒ ¼ö ÀÖ½À´Ï´Ù.
±¹Á¦È TOC XML ÆÄÀÏÀ» º¯È¯ÇÒ ¼ö ÀÖ°í °á°ú »çº»(º¯È¯µÈ ·¹À̺íÀÌ ÀÖ´Â)Àº nl/<language>/<country> ¶Ç´Â nl/<language> µð·ºÅ丮¿¡ ÀÖ¾î¾ß ÇÕ´Ï´Ù. <language> ¹× <country>´Â ·ÎÄÉÀÏ Äڵ忡¼ »ç¿ëµÈ µÎ ¹®ÀÚÀÇ ¾ð¾î ¹× ±¹°¡ Äڵ带 ³ªÅ¸³À´Ï´Ù. ¿¹¸¦ µé¾î ´ë¸¸¾î º¯È¯Àº nl/zh/TW µð·ºÅ丮¿¡ ÀúÀåµÇ¾î¾ß ÇÕ´Ï´Ù. nl/<language>/<country> µð·ºÅ丮°¡ nl/<language> º¸´Ù ¿ì¼±¼øÀ§°¡ ³ô½À´Ï´Ù. nl/<language>/<country>¿¡ ÆÄÀÏÀÌ ¾ø´Â °æ¿ì¿¡¸¸ nl/<language>¿¡ ÀÖ´Â ÆÄÀÏÀÌ »ç¿ëµË´Ï´Ù. Ç÷¯±×ÀÎÀÇ ·çÆ® µð·ºÅ丮´Â ¸Ç ¸¶Áö¸·¿¡ °Ë»öµË´Ï´Ù.
doc.zip¿¡ Æ÷ÇÔµÈ ¹®¼´Â º¯È¯µÈ ¹öÀüÀÇ ¹®¼¿Í ÇÔ²² doc.zip ÆÄÀÏÀ»
ÀÛ¼ºÇϰí doc.zipÀ»
nl/<language>/<country> ¶Ç´Â nl/<language>
µð·ºÅ丮¿¡ ÀúÀåÇÏ¿© Áö¿ªÈÇÒ ¼ö ÀÖ½À´Ï´Ù. µµ¿ò¸» ½Ã½ºÅÛÀº ÀÌ µð·ºÅ丮¿¡¼
ÆÄÀÏÀ» ãÀº ÈÄ Ç÷¯±×ÀÎ µð·ºÅ丮¸¦ ±âº» µð·ºÅ丮·Î ÁöÁ¤ÇÕ´Ï´Ù.
API Á¤º¸: ÀÌ È®ÀåÁ¡À» »ç¿ëÇϱâ À§ÇÑ ÄÚµå´Â ÇÊ¿äÇÏÁö ¾Ê½À´Ï´Ù. plugin.xml ÆÄÀÏ¿¡¼ ¾ð±ÞÇÑ ÇØ´ç Manifest ÆÄÀÏÀ» Á¦°øÇϱ⸸ ÇÏ¸é µË´Ï´Ù.
Á¦°øµÇ´Â ±¸Çö: Eclipse Ç÷§Æû°ú ÇÔ²² Á¦°øµÈ µµ¿ò¸» ½Ã½ºÅÛ UIÀÇ ±âº» ±¸Çö¿¡¼´Â toc È®ÀåÁ¡À» ¿Ïº®ÇÏ°Ô Áö¿øÇÕ´Ï´Ù.
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. º» ÇÁ·Î±×·¥ ¹× º» ÇÁ·Î±×·¥¿¡ µ¿ºÀµÇ´Â ÀÚ·á´Â º» ¹èÆ÷¹°¿¡ µ¿ºÀµÇ¸ç
http://www.eclipse.org/legal/cpl-v10.html¿¡¼
º¼ ¼ö ÀÖ´Â ÀÏ¹Ý °ø¿ë ¶óÀ̼¾½º v1.0ÀÇ Á¶Ç׿¡ ÀǰÅÇÏ¿© »ç¿ëÇØ¾ß ÇÕ´Ï´Ù.