blob: a68ab9d03213ed4add9f5f8749ac462f240999be [file] [log] [blame]
<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 151408:1432445 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_imagemap.xml.meta">
<name>mod_imagemap</name>
<description>¼­¹öÃø À̹ÌÁö¸Ê(imagemap) ó¸®</description>
<status>Base</status>
<sourcefile>mod_imagemap.c</sourcefile>
<identifier>imagemap_module</identifier>
<summary>
<p>ÀÌ ¸ðµâÀº <code>imagemap</code> CGI ÇÁ·Î±×·¥À» ´ë½ÅÇÏ¿©
<code>.map</code> ÆÄÀÏÀ» ó¸®ÇÑ´Ù. ÀÌ ¸ðµâÀº (<directive
module="mod_mime">AddHandler</directive>³ª <directive
module="core">SetHandler</directive>¸¦ »ç¿ëÇÏ¿©)
<code>imap-file</code> Çڵ鷯¸¦ »ç¿ëÇϵµ·Ï ¼³Á¤ÇÑ µð·ºÅ丮³ª
¹®¼­¸¦ ó¸®ÇÑ´Ù.</p>
<p>¾Æ·¡ Áö½Ã¾î´Â <code>.map</code>À¸·Î ³¡³ª´Â ÆÄÀÏÀ» À̹ÌÁö¸Ê
ÆÄÀÏ·Î ¼³Á¤ÇÑ´Ù.</p>
<example>AddHandler imap-file map</example>
<p>¾ÆÁ÷µµ ¾Æ·¡¿Í °°Àº ¼³Á¤À» Áö¿øÇÑ´Ù.</p>
<example>AddType application/x-httpd-imap map</example>
<p>±×·¯³ª ¿ì¸®´Â Á¡Â÷ "¼­¹ö¿¡°Ô Ưº°ÇÑ Àǹ̰¡ ÀÖ´Â MIME
type"À» Á¦°ÅÇÏ·Á°í Çϱ⶧¹®¿¡ ÀÌ ¹æ¹ýÀº ¾ø¾îÁú °ÍÀÌ´Ù.</p>
</summary>
<section id="features"><title>»õ·Î¿î ±â´É</title>
<p>À̹ÌÁö¸Ê ¸ðµâ¿¡´Â ÀÌÀü À̹ÌÁö¸Ê ÇÁ·Î±×·¥¿¡´Â ¾ø´Â ¸î°¡Áö
»õ·Î¿î ±â´ÉÀÌ ÀÖ´Ù.</p>
<ul>
<li>Referer: Á¤º¸¿¡ »ó´ëÀûÀÎ URL ÂüÁ¶.</li>
<li>»õ·Î¿î <code>base</code> ¸ÊÁö½Ã¾î¸¦ »ç¿ëÇÏ¿© ±âº»
<code>&lt;base&gt;</code> ÁöÁ¤.</li>
<li><code>imagemap.conf</code> ÆÄÀÏ ÇÊ¿ä¾øÀ½.</li>
<li>Á¡(point) ÂüÁ¶.</li>
<li>À̹ÌÁö¸Ê ¸Þ´º Á¶Á¤ °¡´É.</li>
</ul>
</section>
<section id="imapfile"><title>À̹ÌÁö¸Ê ÆÄÀÏ</title>
<p>À̹ÌÁö¸Ê ÆÄÀÏÀº ¾Æ·¡¿Í °°Àº Çü½ÄÀ¸·Î ÀÛ¼ºÇÑ´Ù.</p>
<example>
directive value [<var>x</var>,<var>y</var> ...]<br />
directive value "<var>Menu text</var>" [<var>x</var>,<var>y</var>
...]<br />
directive value <var>x</var>,<var>y</var> ... "<var>Menu text</var>"
</example>
<p>directive´Â <code>base</code>, <code>default</code>,
<code>poly</code>, <code>circle</code>, <code>rect</code>,
<code>point</code> Áß Çϳª´Ù. value¿¡´Â Àý´ë URLÀ̳ª »ó´ë
URL ȤÀº ¾Æ·¡¿¡¼­ ¿­°ÅÇÒ Æ¯¼ö°ªÀ» »ç¿ëÇÑ´Ù. ÁÂÇ¥´Â °ø¹éÀ¸·Î
±¸ºÐÇÑ <code><var>x</var>,<var>y</var></code> ½ÖÀÌ´Ù. µû¿ÈÇ¥·Î
¹­Àº ¹®±¸´Â À̹ÌÁö¸Ê ¸Þ´º¸¦ ¸¸µé¶§ ¸µÅ© Á¦¸ñÀ¸·Î »ç¿ëÇÑ´Ù.
'#'·Î ½ÃÀÛÇÏ´Â ÁÙÀº ÁÖ¼®ÀÌ´Ù.</p>
<section id="imapfile.directives"><title>À̹ÌÁö¸Ê ÆÄÀÏ Áö½Ã¾î</title>
<p>À̹ÌÁö¸Ê ÆÄÀÏ¿¡¼­ 6°¡Áö Áö½Ã¾î¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Ù. Áö½Ã¾î´Â
Ưº°ÇÑ ¼ø¼­¾øÀÌ »ç¿ëÇÒ ¼ö ÀÖÁö¸¸, À̹ÌÁö¸Ê ÆÄÀÏ¿¡ ³ª¿Â
¼ø¼­´ë·Î ó¸®ÇÑ´Ù.</p>
<dl>
<dt><code>base</code> Áö½Ã¾î</dt>
<dd><p><code>&lt;base href="<var>value</var>"&gt;</code>
±â´ÉÀ» ÇÑ´Ù. ¸ÊÆÄÀÏ¿¡¼­ ³ª¿À´Â URLÀº Àý´ë URLÀÌ ¾Æ´Ï¶ó¸é
ÀÌ °ª¿¡ »ó´ë URL·Î Ãë±ÞÇÑ´Ù. <code>base</code> Áö½Ã¾î´Â
<code>.htaccess</code> ÆÄÀÏÀ̳ª ¼­¹ö¼³Á¤ÆÄÀÏ¿¡¼­ ¼³Á¤ÇÑ
<directive module="mod_imagemap">ImapBase</directive> °ªÀ»
¹«½ÃÇÑ´Ù. <directive>ImapBase</directive> ¼³Á¤Áö½Ã¾î°¡
¾ø´Ù¸é ±âº» <code>base</code> °ªÀº
<code>http://server_name/</code>ÀÌ´Ù.</p>
<p><code>base_uri</code>´Â <code>base</code>¿Í °°´Ù. URL¿¡¼­
¸¶Áö¸· ½½·¡½¬¸¦ ÀØÁö¸¶¶ó.</p></dd>
<dt><code>default</code> Áö½Ã¾î</dt>
<dd>ÇØ´ç ÁÂÇ¥°¡ <code>poly</code>, <code>circle</code>,
<code>rect</code> Áö½Ã¾î¿¡ ÇØ´çÇÏÁö ¾Ê°í <code>point</code>
Áö½Ã¾î¸¦ »ç¿ëÇÏÁö ¾ÊÀº °æ¿ì ÇൿÀ» ÁöÁ¤ÇÑ´Ù. <directive
module="mod_imagemap">ImapDefault</directive> ¼³Á¤ÀÌ ¾ø´Ù¸é
±âº»°ªÀº <code>204 No Content</code> »óÅÂÄڵ带 ¹ÝȯÇÏ´Â
<code>nocontent</code>ÀÌ´Ù. ÀÌ °æ¿ì Ŭ¶óÀ̾ðÆ®´Â µ¿ÀÏÇÑ
ÆäÀÌÁö¸¦ º¸¿©Áà¾ß ÇÑ´Ù.</dd>
<dt><code>poly</code> Áö½Ã¾î</dt>
<dd>Á¡À» ¼¼°³¿¡¼­ ¹é°³±îÁö ÁöÁ¤ÇÒ ¼ö ÀÖ´Ù. »ç¿ëÀÚ°¡ ÀÌ
Á¡µé·Î ÀÌ·ç¾îÁø ´Ù°¢Çü ¾ÈÀÇ ÁÂÇ¥¸¦ ¼±ÅÃÇÑ °æ¿ì¿¡ »ç¿ëÇÑ´Ù.</dd>
<dt><code>circle</code></dt>
<dd>¿øÀÇ Á߽ɰú ¿øÀ§ÀÇ ÇÑ Á¡ÀÇ ÁÂÇ¥¸¦ ¹Þ´Â´Ù. »ç¿ëÀÚ°¡
¿ø ¾ÈÀÇ ÁÂÇ¥¸¦ ¼±ÅÃÇÑ °æ¿ì¿¡ »ç¿ëÇÑ´Ù.</dd>
<dt><code>rect</code> Áö½Ã¾î</dt>
<dd>»ç°¢ÇüÀÇ µÎ ¸ð¼­¸® Á¡ÀÇ ÁÂÇ¥¸¦ ¹Þ´Â´Ù. »ç°¢Çü ¾ÈÀÇ
ÁÂÇ¥¸¦ ¼±ÅÃÇÑ °æ¿ì¿¡ »ç¿ëÇÑ´Ù.</dd>
<dt><code>point</code> Áö½Ã¾î</dt>
<dd>ÇÑ Á¡ÀÇ ÁÂÇ¥¸¦ ¹Þ´Â´Ù. ´Ù¸¥ Áö½Ã¾îµéÀ» ¸¸Á·ÇÏÁö ¾ÊÀº
°æ¿ì »ç¿ëÀÚ°¡ ¼±ÅÃÇÑ ÁÂÇ¥¿¡ °¡Àå °¡±î¿î point Áö½Ã¾î¸¦
»ç¿ëÇÑ´Ù. <code>point</code> Áö½Ã¾î¸¦ »ç¿ëÇÏ°í À¯È¿ÇÑ
ÁÂÇ¥¸¦ ¼±ÅÃÇÑ °æ¿ì <code>default</code>´Â Àý´ë·Î »ç¿ëµÇÁö
¾Ê´Â´Ù.</dd>
</dl>
</section>
<section id="imapfile.values"><title>Áö½Ã¾î¿¡ »ç¿ëÇÒ ¼ö ÀÖ´Â °ªµé</title>
<p>Áö½Ã¾î¿¡ ¾Æ·¡ value¸¦ »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p>
<dl>
<dt>URL</dt>
<dd><p>»ó´ë URLÀ̳ª Àý´ë URLÀ» »ç¿ëÇÒ ¼ö ÀÖ´Ù. »ó´ë URL¿¡
'..'À» »ç¿ëÇÒ ¼ö ÀÖÀ¸¸ç, <code>base</code> °ªÀ» ±âÁØÀ¸·Î
ã´Â´Ù.</p>
<p><code>base</code>¸¦ ¼³Á¤ÇÒ¶§´Â ÇöÀç base°ªÀº ¹«½ÃÇÑ´Ù.
±×·¯³ª, <code>base mailto:</code> ¹®Àº »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p></dd>
<dt><code>map</code></dt>
<dd>À̹ÌÁö¸Ê ÆÄÀÏ ÀÚü URL°ú °°´Ù. ÁÂÇ¥°¡ ¾ø°í <directive
module="mod_imagemap">ImapMenu</directive>°¡ <code>none</code>ÀÌ
¾Æ´Ï¶ó¸é ¸Þ´º¸¦ ¸¸µç´Ù.</dd>
<dt><code>menu</code></dt>
<dd><code>map</code>°ú °°´Ù.</dd>
<dt><code>referer</code></dt>
<dd>ÂüÁ¶(¸µÅ©¸¦ µû¶ó¿À±â Àü) ¹®¼­ URL°ú °°´Ù.
<code>Referer:</code> Çì´õ°¡ ¾ø´Ù¸é ±âº»°ªÀº
<code>http://servername/</code>ÀÌ´Ù.</dd>
<dt><code>nocontent</code></dt>
<dd>Ŭ¶óÀ̾ðÆ®¿¡°Ô µ¿ÀÏÇÑ ÆäÀÌÁö¸¦ ±×´ë·Î º¸¿©ÁÖ¶ó´Â
<code>204 No Content</code> »óÅÂÄڵ带 º¸³½´Ù.
<code>base</code>¸¦ Á¦¿ÜÇÑ ¸ðµç Áö½Ã¾î¿¡¼­ »ç¿ëÇÒ ¼ö ÀÖ´Ù.</dd>
<dt><code>error</code></dt>
<dd>½ÇÆи¦ ³ªÅ¸³»´Â <code>500 Server Error</code>¸¦ º¸³½´Ù.
<code>base</code>¸¦ Á¦¿ÜÇÑ ¸ðµç Áö½Ã¾î¿¡¼­ »ç¿ëÇÒ ¼ö ÀÖÁö¸¸,
<code>default</code> ¿Ü¿¡´Â »ç¿ëÇÒ ÀÏÀÌ ¾ø´Ù.</dd>
</dl>
</section>
<section id="imapfile.coords"><title>ÁÂÇ¥</title>
<dl>
<dt><code>0,0 200,200</code></dt>
<dd>ÁÂÇ¥´Â ½°Ç¥·Î ±¸ºÐÇÑ <var>x</var>¿Í <var>y</var> °ªÀÌ´Ù.
ÁÂÇ¥µéÀº ¼­·Î °ø¹éÀ¸·Î ±¸ºÐÇÑ´Ù. À̹ÌÁö¸ÊÀ» ´Ù·ç´Â ¹æ½Ä»ó
LynxÀÇ ÆíÀǸ¦ À§ÇØ »ç¿ëÀÚ°¡ <code>0,0</code> ÁÂÇ¥¸¦ ¼±ÅÃÇÏ¿´´Ù¸é
ÁÂÇ¥¸¦ ¼±ÅÃÇÏÁö ¾ÊÀº °Íó·³ µ¿ÀÛÇÑ´Ù.</dd>
</dl>
</section>
<section id="imapfile.quotedtext"><title>µû¿ÈÇ¥·Î ¹­Àº ¹®±¸</title>
<dl>
<dt><code>"<var>Menu Text</var>"</code></dt>
<dd><p>value µÚ³ª ÁÂÇ¥ µÚ¿¡ ½Öµû¿ÈÇ¥·Î ¹­Àº ¹®±¸¸¦ ÀûÀ»
¼öµµ ÀÖ´Ù. ÀÌ ¹®ÀÚ¿­Àº ¸Þ´º¸¦ ¸¸µé¶§ ¸µÅ© Á¦¸ñÀ¸·Î »ç¿ëÇÑ´Ù.</p>
<example>
&lt;a href="http://foo.com/"&gt;<var>Menu text</var>&lt;/a&gt;
</example>
<p>µû¿ÈÇ¥·Î ¹­Àº ¹®±¸°¡ ¾ø´Ù¸é ´ÙÀ½°ú °°ÀÌ ¸µÅ©¸¦ ¸µÅ©
Á¦¸ñÀ¸·Î »ç¿ëÇÑ´Ù.</p>
<example>
&lt;a href="http://foo.com/"&gt;http://foo.com&lt;/a&gt;
</example>
<p>¹®±¸¿¡ ½Öµû¿ÈÇ¥¸¦ ¾²·Á¸é <code>&amp;quot;</code>¿Í
°°ÀÌ Àû¾î¾ß ÇÑ´Ù.</p></dd>
</dl>
</section>
</section>
<section id="example"><title>¸ÊÆÄÀÏ ¿¹Á¦</title>
<example>
#'formatted'³ª 'semiformatted' ¸Þ´º´Â ÁÖ¼®À» Ãâ·ÂÇÑ´Ù.<br />
#±×¸®°í ÁÖ¼®¿¡ html ű׸¦ ¾µ ¼ö ÀÖ´Ù. &lt;hr&gt;<br />
base referer<br />
poly map "¸Þ´º¸¦ º¸¿©ÁÖ¼¼¿ä." 0,0 0,10 10,10 10,0<br />
rect .. 0,0 77,27 "ÂüÁ¶ ¹®¼­°¡ ÀÖ´Â µð·ºÅ丮"<br />
circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27<br />
rect another_file "ÂüÁ¶ ¹®¼­¿Í °°Àº µð·ºÅ丮¿¡ ÀÖ´Â" 306,0 419,27<br />
point http://www.zyzzyva.com/ 100,100<br />
point http://www.tripod.com/ 200,200<br />
rect mailto:nate@tripod.com 100,150 200,0 "¹ö±×?"<br />
</example>
</section>
<section id="referencing"><title>¸ÊÆÄÀÏ »ç¿ëÇϱâ</title>
<example><title>HTML ¿¡Á¦</title>
&lt;a href="/maps/imagemap1.map"&gt;<br />
<indent>
&lt;img ismap src="/images/imagemap1.gif"&gt;<br />
</indent>
&lt;/a&gt;
</example>
<example><title>XHTML ¿¹Á¦</title>
&lt;a href="/maps/imagemap1.map"&gt;<br />
<indent>
&lt;img ismap="ismap" src="/images/imagemap1.gif" /&gt;<br />
</indent>
&lt;/a&gt;
</example>
</section>
<directivesynopsis>
<name>ImapMenu</name>
<description>ÁÂÇ¥¾øÀÌ À̹ÌÁö¸Ê ¿äû½Ã ÃëÇÒ Çൿ</description>
<syntax>ImapMenu none|formatted|semiformatted|unformatted</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>
<usage>
<p><directive>ImapMenu</directive> Áö½Ã¾î´Â À̹ÌÁö¸Ê ÆÄÀÏ¿¡
À¯È¿ÇÑ ÁÂÇ¥¸¦ ÁÖÁö ¾ÊÀº °æ¿ì ÃëÇÒ ÇൿÀ» °áÁ¤ÇÑ´Ù.</p>
<dl>
<dt><code>none</code></dt>
<dd>ImapMenu°¡ <code>none</code>À̸é, ¸Þ´º¸¦ ¸¸µéÁö¾Ê°í
<code>default</code> ÇൿÀ» ÃëÇÑ´Ù.</dd>
<dt><code>formatted</code></dt>
<dd><code>formatted</code> ¸Þ´º´Â °¡Àå °£´ÜÇÑ ¸Þ´º´Ù.
À̹ÌÁö¸Ê ÆÄÀÏÀÇ ÁÖ¼®Àº ¹«½ÃÇÑ´Ù. °¡Àå Å« Ç¥Á¦¿Í ¼öÁ÷¼±À»
Ãâ·ÂÇÏ°í, ¸µÅ©¸¦ ÇÑÁÙ¾¿ Ãâ·ÂÇÑ´Ù. ¸Þ´º´Â ÀÏ°üµÇ°í ÆòÀÌÇϸç,
µð·ºÅ丮 ¸ñ·Ï°ú Èí»çÇÏ´Ù.</dd>
<dt><code>semiformatted</code></dt>
<dd><code>semiformatted</code> ¸Þ´º´Â À̹ÌÁö¸Ê ÆÄÀÏ¿¡
³ª¿À´Â ÁÖ¼®À» Ãâ·ÂÇÑ´Ù. ºóÁÙÀº HTML Çà¹Ù²ÞÀ¸·Î º¯È¯ÇÑ´Ù.
Ç¥Á¦³ª ¼öÁ÷¼±À» ±×¸®Áö ¾ÊÁö¸¸, ³ª¸ÓÁö´Â <code>formatted</code>
¸Þ´º¿Í °°´Ù.</dd>
<dt><code>unformatted</code></dt>
<dd>ÁÖ¼®Àº Ãâ·ÂÇÏ°í, ºóÁÙÀº ¹«½ÃÇÑ´Ù. À̹ÌÁö¸Ê ÆÄÀÏ¿¡
ÀÖ´Â ³»¿ë¸¸ Ãâ·ÂÇÑ´Ù. À̹ÌÁö¸Ê ÆÄÀÏÀÇ ÁÖ¼®¿¡ ÇÊ¿äÇÑ ¸ðµç
Çà¹Ù²Þ°ú Ç¥Á¦¸¦ Àû¾î¾ß ÇÑ´Ù. ¸Þ´ºÀÇ ¿Ü°üÀ» °¡Àå ÀÚÀ¯ÀÚÁ¦·Î
²Ù¹Ð ¼ö ÀÖÁö¸¸, À̹ÌÁö¸Ê ÆÄÀÏÀ» »ç½Ç»ó ÀÏ¹Ý ¹®ÀÚÆÄÀÏÀÌ
¾Æ´Ñ HTML·Î ºÁ¾ß ÇÑ´Ù.</dd>
</dl>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ImapDefault</name>
<description>À̹ÌÁö¸Ê¿¡ ¾î´À ¿µ¿ª¿¡µµ ÇØ´çÇÏÁö ¾Ê´Â ÁÂÇ¥¸¦ ÁØ
°æ¿ì ±âº» Çൿ</description>
<syntax>ImapDefault error|nocontent|map|referer|<var>URL</var></syntax>
<default>ImapDefault nocontent</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>
<usage>
<p><directive>ImapDefault</directive> Áö½Ã¾î´Â À̹ÌÁö¸Ê
ÆÄÀÏ¿¡¼­ »ç¿ëÇÒ <code>default</code> ±âº»°ªÀ» ¼³Á¤ÇÑ´Ù.
À̹ÌÁö¸Ê ÆÄÀÏ ¾È¿¡¼­ <code>default</code> Áö½Ã¾î¸¦ »ç¿ëÇϸé
¿©±â¼­ ¼³Á¤ÇÑ °ªÀº ¹«½ÃÇÑ´Ù. µÑ ¸ðµÎ ¾ø´Ù¸é, <code>default</code>
ÇൿÀº Ŭ¶óÀ̾ðÆ®¿¡°Ô <code>204 No Content</code>¸¦ º¸³»´Â
<code>nocontent</code>ÀÌ´Ù. ÀÌ °æ¿ì Ŭ¶óÀ̾ðÆ®´Â ¿ø·¡ ÆäÀÌÁö¸¦
±×´ë·Î º¸¿©Áà¾ß ÇÑ´Ù.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ImapBase</name>
<description>À̹ÌÁö¸Ê ÆÄÀÏ¿¡¼­ <code>base</code> ±âº»°ª</description>
<syntax>ImapBase map|referer|<var>URL</var></syntax>
<default>ImapBase http://servername/</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>
<usage>
<p><directive>ImapBase</directive> Áö½Ã¾î´Â À̹ÌÁö¸Ê ÆÄÀÏ¿¡¼­
»ç¿ëÇÒ <code>base</code> ±âº»°ªÀ» ¼³Á¤ÇÑ´Ù. À̹ÌÁö¸Ê ÆÄÀÏ
¾È¿¡¼­ <code>base</code> Áö½Ã¾î¸¦ »ç¿ëÇÏ¸é ¿©±â¼­ ¼³Á¤ÇÑ
°ªÀº ¹«½ÃÇÑ´Ù. µÑ ¸ðµÎ ¾ø´Ù¸é, <code>base</code> ±âº»°ªÀº
<code>http://<var>servername</var>/</code>ÀÌ´Ù.</p>
</usage>
<seealso><directive module="core">UseCanonicalName</directive></seealso>
</directivesynopsis>
</modulesynopsis>