granicus.if.org Git - apache/blob - docs/manual/mod/mod_negotiation.xml.ja

   1 <?xml version="1.0" encoding="iso-2022-jp"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <modulesynopsis>
   5 <!-- English revision: 1.11 -->
   6
   7 <name>mod_negotiation</name>
   8 <description><a href="../content-negotiation.html">\e$B%3%s%F%s%H%M%4%7%(!<%7%g%s\e(B</a>
   9   \e$B5!G=$rDs6!$9$k\e(B</description>
  10 <status>Base</status>
  11 <sourcefile>mod_negotiation.c</sourcefile>
  12 <identifier>negotiation_module</identifier>
  13
  14 <summary>
  15     <p>\e$B%3%s%F%s%H%M%4%7%(!<%7%g%s!"$h$j@53N$K$O%3%s%F%s%D$NA*Br5!G=$O!"\e(B
  16     \e$BJ#?tMQ0U$5$l$F$$$k%I%-%e%a%s%H$+$i!"%/%i%$%"%s%H$NG=NO$K0lHV9g$C$?\e(B
  17     \e$B%I%-%e%a%s%H$rA*Br$9$k5!G=$G$9!#$3$N<BAu$OFs$D$"$j$^$9!#\e(B</p>
  18
  19     <ul>
  20       <li>\e$B%?%$%W%^%C%W\e(B (<code>type-map</code>
  21       \e$B%O%s%I%i$G07$o$l$k%U%!%$%k\e(B)\e$B!#$3$l$O\e(B variants
  22       \e$B$r4^$s$G$$$k%U%!%$%k$rL@<(E*$K;XDj$7$^$9!#\e(B</li>
  23
  24       <li>MultiViews \e$B$NC5:w\e(B (<code>MultiViews</code> <directive
  25       module="core">Option</directive> \e$B$GM-8z$K$J$j$^$9\e(B)\e$B!#\e(B
  26       \e$B%5!<%P$,0EL[$NFb$K%U%!%$%kL>$N%Q%?!<%s%^%C%A$r9T$J$$!"\e(B
  27       \e$B$=$N7k2L$+$iA*Br$7$^$9!#\e(B</li>
  28     </ul>
  29 </summary>
  30 <seealso><directive module="core">Options</directive></seealso>
  31 <seealso><module>mod_mime</module></seealso>
  32 <seealso><a href="../content-negotiation.html">\e$B%3%s%F%s%H%M%4%7%(!<%7%g%s\e(B</a></seealso>
  33 <seealso><a href="../env.html">\e$B4D6-JQ?t\e(B</a></seealso>
  34
  35 <section id="typemaps"><title>\e$B%?%$%W%^%C%W\e(B</title>
  36     <p>\e$B%?%$%W%^%C%W$O\e(B RFC 822 \e$B$N%a!<%k%X%C%@$KN`;w$7$?=q<0$G$9!#\e(B
  37     \e$B%I%-%e%a%s%H$N5-=R$,6u9T$GJ,N%$5$l$F=q$+$l$F$$$F!"%O%C%7%eJ8;z\e(B
  38     ('#') \e$B$G;O$^$k9T$O%3%a%s%H$H$7$F07$o$l$^$9!#\e(B
  39     \e$B%I%-%e%a%s%H$N@bL@$OJ#?t$N%X%C%@%l%3!<%I$+$i9=@.$5$l$^$9!#\e(B
  40     \e$B%l%3!<%I$O!"B3$-$N9T$,6uGr$G;O$^$C$F$$$k$HJ#?t$N9T$K$^$?$,$j$^$9!#\e(B
  41     \e$B:G=i$N6uGr$,>C5n$5$l$F!"A0$N9T$H$D$J$2$F\e(B 1 \e$B9T$H$7$F07$o$l$^$9!#\e(B
  42     \e$B%X%C%@%l%3!<%I$O%-!<%o!<%IL>$N8e$KCM$,B3$/$H$$$&7A<0$G!"\e(B
  43     \e$B%-!<%o!<%IL>$O>o$K%3%m%s$G=*$o$j$^$9!#6uGr$O%X%C%@L>$HCM$N4V!"\e(B
  44     \e$BCM$N%H!<%/%s$N4V$KF~$l$k$3$H$,$G$-$^$9!#\e(B
  45     \e$B;HMQ2DG=$J%X%C%@$O0J2<$N$H$*$j$G$9\e(B:</p>
  46
  47     <dl>
  48       <dt><code>Content-Encoding:</code></dt>
  49       <dd>\e$B%U%!%$%k$N%(%s%3!<%G%#%s%0!#\e(BApache \e$B$O\e(B <directive
  50       module="mod_mime">AddEncoding</directive> \e$B%G%#%l%/%F%#%V\e(B
  51       \e$B$GDj5A$5$l$?%(%s%3!<%G%#%s%0$@$1$rG'<1$7$^$9!#DL>o\e(B compress
  52       \e$B$5$l$?%U%!%$%k$N$?$a$N\e(B <code>x-compress</code> \e$B$H\e(B gzip
  53       \e$B$5$l$?%U%!%$%k$N$?$a$N\e(B <code>x-gzip</code> \e$B$r4^$_$^$9!#\e(B
  54       \e$B%(%s%3!<%G%#%s%0$NHf3S$r$9$k$H$-$O!"@\F,<-\e(B <code>x-</code>
  55       \e$B$OL5;k$5$l$^$9!#\e(B</dd>
  56
  57       <dt><code>Content-Language:</code></dt>
  58       <dd>\e$B%$%s%?!<%M%C%HI8=`$N8@8l%?%0\e(B
  59       (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>)
  60       \e$B$GDj5A$5$l$F$$$k8@8l$N<oN`!#Nc$($P!"\e(B<code>en</code>
  61       \e$B$O1Q8l$rI=$7$^$9!#\e(B
  62       \e$BJ#?t$N8@8l$,3JG<$5$l$k>l9g$O%3%s%^$G6h@Z$i$l$^$9!#\e(B</dd>
  63
  64       <dt><code>Content-Length:</code></dt>
  65       <dd>\e$B%U%!%$%k$ND9$5\e(B (\e$B%P%$%H?t\e(B)\e$B!#\e(B
  66       \e$B$3$N%X%C%@$,$J$$>l9g!"%U%!%$%k$N<B:]$ND9$5$,;HMQ$5$l$^$9!#\e(B</dd>
  67
  68       <dt><code>Content-Type:</code></dt>
  69       <dd>\e$B%I%-%e%a%s%H$N\e(B MIME
  70       \e$B%a%G%#%"%?%$%W!"%*%W%7%g%J%k$J%Q%i%a!<%?IU$-!#%Q%i%a!<%?$N9=J8$O\e(B
  71       <code>name=value</code>
  72       \e$B$G!"%a%G%#%"%?%$%W$dB>$N%Q%i%a!<%?$H$O%;%_%3%m%s$GJ,N%$5$l$^$9!#\e(B
  73       \e$B6&DL$N%Q%i%a!<%?$O0J2<$N$H$*$j\e(B:
  74
  75         <dl>
  76           <dt><code>level</code></dt>
  77           <dd>\e$B%a%G%#%"%?%$%W$N%P!<%8%g%s$r<($9@0?t!#\e(B
  78           <code>text/html</code> \e$B$G$O\e(B 2 \e$B$,%G%U%)%k%H$G!"$=$NB>$N>l9g$O\e(B
  79           0 \e$B$,%G%U%)%k%H$G$9!#\e(B</dd>
  80
  81           <dt><code>qs</code></dt>
  82           <dd>\e$B%/%i%$%"%s%H$NG=NO$K4X78$J$/!"\e(Bvariant
  83           \e$B$rB>$HHf3S$7$?$H$-$NAjBPE*$J!VIJ<A!W$G!"\e(B0.0 \e$B$+$i\e(B 1.0
  84           \e$B$NHO0O$NIbF0E@>.?t!#\e(B
  85           \e$BNc$($P!"<L??$rI=8=$7$h$&$H$7$F$$$k$H$-$OIaDL$O\e(B JPEG
  86           \e$B%U%!%$%k$NJ}$,\e(B ASCII \e$B%U%!%$%k$h$j$b9b$$IJ<A$K$J$j$^$9!#\e(B
  87           \e$B$7$+$7!"%j%=!<%9$,\e(B ASCII \e$B%"!<%H$GI=8=$5$l$F$$$k$H$-$O!"\e(BASCII
  88           \e$B%U%!%$%k$NJ}$,\e(B JPEG
  89           \e$B%U%!%$%k$h$j$b9b$$IJ<A$K$J$j$^$9!#$3$N$h$&$K!"\e(B<code>qs</code>
  90           \e$B$O%j%=!<%9Kh$KFCM-$NCM$r<h$j$^$9!#\e(B
  91           </dd>
  92         </dl>
  93
  94         <example><title>\e$BNc\e(B</title>
  95           Content-Type: image/jpeg; qs=0.8
  96         </example>
  97       </dd>
  98
  99       <dt><code>URI:</code></dt>
 100       <dd>(\e$B;XDj$N%a%G%#%"%?%$%W!"%3%s%F%s%H%(%s%3!<%G%#%s%0$N\e(B) variant \e$B$N\e(B
 101       \e$B%U%!%$%k$N\e(B uri.  \e$B$3$l$O!"%^%C%W%U%!%$%k$+$i$NAjBP\e(B URL \e$B$H$7$F\e(B
 102       \e$B2r<a$5$l$^$9!#F1$8%5!<%P$KB8:_$7$J$1$l$P$J$i$:!"%/%i%$%"%s%H$,\e(B
 103       \e$BD>@\%j%/%(%9%H$7$?$H$-$K%"%/%;%9$r5v2D$5$l$k$b$N$G$J$1$l$P$J$j$^$;$s!#\e(B</dd>
 104
 105       <dt><code>Body:</code></dt>
 106       <dd>Apache 2.0 \e$B$G?7@_$5$l$?$3$N\e(B Body \e$B%X%C%@$r;H$C$F!"\e(B
 107       \e$B%j%=!<%9$N<B:]$NFbMF$r%?%$%W%^%C%W%U%!%$%k$K=q$/$3$H$,$G$-$^$9!#\e(B
 108       \e$B$3$N%X%C%@$OK\J8$NFbMF$N6h@Z$j$H$J$kJ8;zNs$G;O$^$kI,MW$,$"$j$^$9!#\e(B
 109       \e$B%?%$%W%^%C%W%U%!%$%k$NB3$/9T$O!"6h@Z$jJ8;zNs$,8+$D$+$k$^$G!"\e(B
 110       \e$B%j%=!<%9$NK\J8$K$J$j$^$9!#\e(B
 111
 112       <example><title>Example:</title>
 113         Body:----xyz----<br />
 114         &lt;html&gt;<br />
 115         &lt;body&gt;<br />
 116         &lt;p&gt;Content of the page.&lt;/p&gt;<br />
 117         &lt;/body&gt;<br />
 118         &lt;/html&gt;<br />
 119         ----xyz----
 120       </example>
 121       </dd>
 122     </dl>
 123 </section>
 124
 125 <section id="multiviews"><title>MultiViews</title>
 126     <p>MultiViews \e$BC5:w$O!"\e(B<code>Multiviews</code> <directive
 127     module="core">Options</directive> \e$B%G%#%l%/%F%#%V$K$h$jM-8z$K$J$j$^$9!#\e(B
 128     \e$B%5!<%P$,\e(B <code>/some/dir/foo</code>
 129     \e$B$X$N%j%/%(%9%H$r<u$1<h$j!"\e(B<code>/some/dir/foo</code> \e$B$,B8:_\e(B
 130     <em>\e$B$7$J$$\e(B</em>\e$B>l9g!"%5!<%P$O%G%#%l%/%H%j$rFI$s$G!"\e(B
 131     <code>foo.*</code> \e$B$K$"$F$O$^$kA4$F$N%U%!%$%k$rC5$7!"\e(B
 132     \e$B;v<B>e$=$l$i$N%U%!%$%k$r%^%C%W$9$k%?%$%W%^%C%W$r:n$j$^$9!#\e(B
 133     \e$B$=$N$H$-!"%a%G%#%"%?%$%W$H%3%s%F%s%H%(%s%3!<%G%#%s%0$O!"\e(B
 134     \e$B$=$N%U%!%$%kL>$rD>@\;XDj$7$?$H$-$HF1$8$b$N$,3d$jEv$F$i$l$^$9!#\e(B
 135     \e$B$=$l$+$i%/%i%$%"%s%H$NMW5a$K0lHV9g$&$b$N$rA*$S!"\e(B
 136     \e$B$=$N%I%-%e%a%s%H$rJV$7$^$9!#\e(B</p>
 137 </section>
 138
 139 <directivesynopsis>
 140 <name>CacheNegotiatedDocs</name>
 141 <description>\e$B%3%s%F%s%H%M%4%7%(!<%7%g%s$5$l$?%I%-%e%a%s%H$r%W%m%-%7%5!<%P$,\e(B
 142 \e$B%-%c%C%7%e$G$-$k$h$&$K$9$k\e(B</description>
 143 <syntax>CacheNegotiatedDocs On|Off</syntax>
 144 <default>CacheNegotiatedDocs Off</default>
 145 <contextlist><context>server config</context>
 146 <context>virtual host</context>
 147 </contextlist>
 148 <compatibility>\e$B%P!<%8%g%s\e(B 2.0\e$B$G9=J8$,JQ$o$j$^$7$?\e(B</compatibility>
 149
 150 <usage>
 151     <p>\e$B$3$N%G%#%l%/%F%#%V$,@_Dj$5$l$F$$$k$H!"%3%s%F%s%H%M%4%7%(!<%7%g%s\e(B
 152     \e$B$r$7$?7k2L$N%I%-%e%a%s%H$N%-%c%C%7%e$r5v2D$7$^$9!#\e(B
 153     \e$B$3$l$O!"%W%m%-%7$N8e$m$K$$$k%/%i%$%"%s%H$,G=NO$K0lHV9g$C$?\e(B
 154     \e$B%I%-%e%a%s%H$G$O$J$/!"\e(B
 155     \e$B%-%c%C%7%e$r$h$j8z2LE*$K$9$k$b$N$rF@$k2DG=@-$,$"$k$H$$$&$3$H$G$9!#\e(B</p>
 156
 157     <p>\e$B$3$N%G%#%l%/%F%#%V$O\e(B HTTP/1.0 \e$B%V%i%&%6$+$i$N%j%/%(%9%H\e(B
 158     \e$B$N$_$KE,MQ$5$l$^$9!#\e(BHTTP/1.1 \e$B$O!"\e(B
 159     \e$B8r>D$5$l$?%I%-%e%a%s%H$N%-%c%C%7%e$KBP$7$F$:$C$H$h$$@)8f$,2DG=$J$N$G!"\e(B
 160     \e$B$3$N%G%#%l%/%F%#%V$O\e(B HTTP/1.1 \e$B$N%j%/%(%9%H$K$O1F6A$7$^$;$s!#\e(B</p>
 161     <p>2.0 \e$B$h$jA0$N%P!<%8%g%s$G$O!"\e(B
 162     <directive>CacheNegotiatedDocs</directive> \e$B$O0z?t$r<h$i$:!"\e(B
 163     \e$B%G%#%l%/%F%#%V$,B8:_$9$k$3$H$G\e(B on \e$B$NF0:n$r$7$F$$$^$7$?!#\e(B</p>
 164 </usage>
 165 </directivesynopsis>
 166
 167 <directivesynopsis>
 168 <name>ForceLanguagePriority</name>
 169 <description>\e$BMW5a$K9g$&C1FH$N%I%-%e%a%s%H$,8+$D$+$i$J$+$C$?$H$-$K9T$J$&$3$H$r;XDj\e(B
 170 </description>
 171 <syntax>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</syntax>
 172 <default>ForceLanguagePriority Prefer</default>
 173 <contextlist><context>server config</context><context>virtual host</context>
 174 <context>directory</context><context>.htaccess</context></contextlist>
 175 <override>FileInfo</override>
 176 <compatibility>\e$B%P!<%8%g%s\e(B 2.0.30 \e$B0J9_$G;HMQ2DG=\e(B</compatibility>
 177
 178 <usage>
 179     <p><directive>ForceLanguagePriority</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 180     \e$BMW5a$K9g$&%I%-%e%a%s%H$r0l$D$@$1JV$9$3$H$,$G$-$J$$$H$-$K!"\e(B
 181     <directive module="mod_negotiation">LanguagePriority</directive>
 182     \e$B%G%#%l%/%F%#%V$r;H$C$F%M%4%7%(!<%7%g%s$N7k2L$rJV$7$^$9!#\e(B</p>
 183
 184     <p><code>ForceLanguagePriority Prefer</code> \e$B$O!"F1Ey$NA*Br;h$,\e(B
 185     \e$B$$$/$D$+$"$k$H$-$K!"\e(BHTTP \e$B$N\e(B 300 (MULTIPLE CHOICES) \e$B$rJV$9Be$o$j$K!"\e(B
 186     <code>LanguagePriority</code> \e$B$r;H$C$F0l$D$@$1%I%-%e%a%s%H$rJV$9$h$&$K\e(B
 187     \e$B$7$^$9!#0J2<$N%G%#%l%/%F%#%V$,;XDj$5$l$F$$$F!"%f!<%6$N\e(B <code>Accept-Language</code>
 188     \e$B%X%C%@$G$O\e(B <code>en</code> \e$B$H\e(B <code>de</code> \e$B$NIJ<A$,6&$K\e(B
 189     <code>.500</code> (\e$BF1$8$/$i$$5vMF\e(B) \e$B$G$"$k$H$-$O!"\e(B
 190     \e$B:G=i$K%^%C%A$9$k\e(B variant \e$B$N\e(B <code>en</code> \e$B$,Aw$i$l$^$9!#\e(B</p>
 191
 192     <example>
 193       LanguagePriority en fr de<br />
 194       ForceLanguagePriority Prefer
 195     </example>
 196
 197     <p><code>ForceLanguagePriority Fallback</code> \e$B$G$O!"\e(BHTTP 406
 198     (NOT ACCEPTABLE) \e$B$rAw?.$9$kBe$o$j$K!"\e(B
 199     <directive module="mod_negotiation">LanguagePriority</directive>
 200     \e$B$,@5$7$$7k2L$rAw$j$^$9!#\e(B
 201     \e$B0J2<$N%G%#%l%/%F%#%V$,;XDj$5$l$F$$$F!"%f!<%6$N\e(B <code>Accept-Language</code>
 202     \e$B$,\e(B <code>es</code> \e$B8@8l$N$_$r5v2D$7$F$$$F!"$5$i$K$=$N$h$&$J\e(B variant \e$B$,$J$$$H$-$K$O!"\e(B
 203     \e$B0J2<$N\e(B <directive module="mod_negotiation">LanguagePriority</directive>
 204     \e$B$N%j%9%H$N:G=i$N\e(B variant \e$B$,Aw$l$l$^$9!#\e(B</p>
 205
 206     <example>
 207       LanguagePriority en fr de<br />
 208       ForceLanguagePriority Fallback
 209     </example>
 210
 211     <p><code>Prefer</code> \e$B$H\e(B <code>Fallback</code> \e$B$NN>J}$N%*%W%7%g%s$r\e(B
 212     \e$BF1;~$K;XDj$9$k$3$H$,$G$-$^$9!#\e(B
 213     \e$B$G$9$+$i!"J#?t$N\e(B variant \e$B$,$"$k$H$-$O\e(B
 214     <directive module="mod_negotiation">LanguagePriority</directive> \e$B$N:G=i$N\e(B
 215     variant \e$B$,Aw$i$l!"%/%i%$%"%s%H$N5vMF8@8l$K9g$&\e(B vaiant \e$B$,$J$$$H$-$O\e(B
 216     \e$BB8:_$9$k%I%-%e%a%s%H$G:G=i$N$b$N$,Aw$i$l$k!"$H$$$&MM$K$9$k$3$H$,$G$-$^$9!#\e(B</p>
 217 </usage>
 218 <seealso><directive module="mod_mime">AddLanguage</directive></seealso>
 219 </directivesynopsis>
 220
 221 <directivesynopsis>
 222 <name>LanguagePriority</name>
 223 <description>\e$B%/%i%$%"%s%H$,M%@hEY$r<($5$J$+$C$?$H$-$N8@8l$N\e(B variant \e$B$NM%@hEY$r\e(B
 224 \e$B;XDj\e(B</description>
 225 <syntax>LanguagePriority <var>MIME-lang</var> [<var>MIME-lang</var>]
 226 ...</syntax>
 227 <contextlist><context>server config</context><context>virtual host</context>
 228 <context>directory</context><context>.htaccess</context></contextlist>
 229 <override>FileInfo</override>
 230
 231 <usage>
 232     <p><directive>LanguagePriority</directive> \e$B$O!"\e(BMultiViews
 233     \e$B%j%/%(%9%H$r07$&$H$-$K!"%/%i%$%"%s%H$,M%@h=g0L$rDs6!$7$F$$$J$$>l9g$N\e(B
 234     \e$B8@8l$NM%@h=g0L$r@_Dj$7$^$9!#\e(B<var>MIME-lang</var>
 235     \e$B$N%j%9%H$,M%@hEY$N9_=g$KJB$S$^$9!#\e(B</p>
 236
 237     <example><title>Example:</title>
 238       LanguagePriority en fr de
 239     </example>
 240
 241     <p><code>foo.html</code> \e$B$,%j%/%(%9%H$5$l!"\e(B<code>foo.html.fr</code>
 242     \e$B$H\e(B <code>foo.html.de</code> \e$B$,N>J}B8:_$7!"\e(B
 243     \e$B%V%i%&%6$,8@8l$NM%@h=g0L$rDs6!$7$F$J$$>l9g$O\e(B
 244     <code>foo.html.fr</code> \e$B$,JV$5$l$^$9!#\e(B</p>
 245
 246     <p>\e$B$3$N%G%#%l%/%F%#%V$OB>$NJ}K!$G!V:GA1!W\e(B
 247     \e$B$N8@8l$,7hDj$G$-$J$$$H$-$+!"\e(B<directive
 248     module="mod_negotiation">ForceLanguagePriority</directive> \e$B%G%#%l%/%F%#%V$,\e(B
 249     <code>None</code> \e$B0J30$N$H$-$K$N$_8z2L$,$"$k$3$H$KCm0U$7$F$/$@$5$$!#\e(B
 250     HTTP/1.1 \e$B%j%/%(%9%H$,@5$7$/<BAu$5$l$F$$$k>l9g$K$O!"\e(B
 251     \e$B$3$N%G%#%l%/%F%#%V$OL58z$K$J$j$^$9!#\e(B</p>
 252 </usage>
 253 <seealso><directive module="mod_mime">AddLanguage</directive></seealso>
 254 </directivesynopsis>
 255
 256 </modulesynopsis>