¸ñÂ÷(TOC)

ID: org.eclipse.help.toc

¼³¸í: °³º° Ç÷¯±×ÀÎÀÇ ¿Â¶óÀÎ µµ¿ò¸» Á¦°ø µî·Ï

µµ¿ò¸» ÆÄÀÏÀ» Á¦°øÇÏ´Â Ç÷¯±×Àο¡¼­´Â ÀϹÝÀûÀ¸·Î ´ÙÀ½°ú °°Àº ÀÛ¾÷À» ¼öÇàÇÕ´Ï´Ù.

toc È®ÀåÁ¡¿¡ ´ëÇÑ ±¸¼º ¸¶Å©¾÷(plugin.xml ÆÄÀÏ·Î À̵¿ÇÏ´Â Ç׸ñ):

    <!ELEMENT toc EMPTY>
    <!ATTLIST toc file CDATA #REQUIRED>
    <!ATTLIST toc primary (true | false) "false">
    <!ATTLIST toc extradir CDATA #IMPLIED>

toc¿¡ ´ëÇÑ ±¸¼º ¸¶Å©¾÷(TOC ÆÄÀÏ¿¡ Æ÷ÇÔµÈ Ç׸ñ):

    <!ELEMENT toc (topic | anchor | link)* >
    <!ATTLIST toc link_to CDATA #IMPLIED >
    <!ATTLIST toc label CDATA #REQUIRED >

    <!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 ¼Ó¼ºÀ» »ç¿ëÇÏ¿© ÀÌ ÆÄÀÏÀÇ toc¸¦ Ž»ö °èÃþ ±¸Á¶¿¡¼­ ´õ »óÀ§¿¡ ÀÖ´Â ´Ù¸¥ toc ÆÄÀÏ¿¡ ¸µÅ©ÇÒ ¼ö ÀÖ½À´Ï´Ù. link_to ¼Ó¼ºÀÇ °ªÀº ´Ù¸¥ toc ÆÄÀÏÀÇ ¾ÞÄ¿¸¦ ÁöÁ¤ÇØ¾ß ÇÕ´Ï´Ù. myapi.xml ÆÄÀÏÀÇ toc¸¦ ´Ù¸¥ Ç÷¯±×Àο¡¼­ ÁöÁ¤µÈ api.xml ÆÄÀÏ¿¡ ¸µÅ©ÇÏ·Á¸é ´ÙÀ½ ±¸¹®À» »ç¿ëÇϽʽÿÀ.

<toc link_to="../anotherPlugin/api.xml#moreapi" label="My Tool API"/>
...
<toc />

# ¹®ÀÚ´Â ¾ÞÄ¿ ID¿¡¼­ toc ÆÄÀÏ À̸§À» ºÐ¸®ÇÕ´Ï´Ù.

¿¹:

´ÙÀ½Àº toc È®ÀåÁ¡À» »ç¿ëÇÏ´Â ¿¹Á¦ÀÔ´Ï´Ù. ID°¡ "org.eclipse.help.examples.ex1"ÀÎ Ç÷¯±×Àο¡ ´ëÇÑ ¿¹¸¦ µé¾î º¸°Ú½À´Ï´Ù. ÀÌ ¿¹Á¦´Â ÀϹÝÀûÀÎ »ùÇÃÀÌ¸ç ´ÙÀ½ ¸ðµç toc ÆÄÀÏÀÇ °á°ú·Î ¹ß»ýÇÏ´Â °°Àº ¹®¼­ °èÃþ ±¸Á¶°¡ ´Ù¸¥ toc ÆÄÀÏÀÇ ´Ù¸¥ Á¶ÇÕÀ¸·Î ÀÛ¼ºµÉ ¼öµµ ÀÖ½À´Ï´Ù.

(plugin.xml ÆÄÀÏÀÇ °æ¿ì)

 <extension point="org.eclipse.help.toc">
  <toc file="maindocs.xml" 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>


±× °á°ú Eclipse Workbench¿¡ ÀÛ¼ºµÈ ¹®¼­ °èÃþ ±¸Á¶´Â ´ÙÀ½°ú °°½À´Ï´Ù.

µµ¿ò¸» »ùÇÃ

"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 IBM Corp. and others 2000, 2002. All Rights Reserved.