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 <!-- English Revision: 151408:395228 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <modulesynopsis metafile="mod_negotiation.xml.meta">
  24
  25 <name>mod_negotiation</name>
  26 <description><a href="../content-negotiation.html">\e$B%3%s%F%s%H%M%4%7%(!<%7%g%s\e(B</a>
  27   \e$B5!G=$rDs6!$9$k\e(B</description>
  28 <status>Base</status>
  29 <sourcefile>mod_negotiation.c</sourcefile>
  30 <identifier>negotiation_module</identifier>
  31
  32 <summary>
  33     <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
  34     \e$BJ#?tMQ0U$5$l$F$$$k%I%-%e%a%s%H$+$i!"%/%i%$%"%s%H$NG=NO$K0lHV9g$C$?\e(B
  35     \e$B%I%-%e%a%s%H$rA*Br$9$k5!G=$G$9!#$3$N<BAu$OFs$D$"$j$^$9!#\e(B</p>
  36
  37     <ul>
  38       <li>\e$B%?%$%W%^%C%W\e(B (<code>type-map</code>
  39       \e$B%O%s%I%i$G07$o$l$k%U%!%$%k\e(B)\e$B!#$3$l$O\e(B variants
  40       \e$B$r4^$s$G$$$k%U%!%$%k$rL@<(E*$K;XDj$7$^$9!#\e(B</li>
  41
  42       <li>MultiViews \e$B$NC5:w\e(B (<code>MultiViews</code> <directive
  43       module="core">Option</directive> \e$B$GM-8z$K$J$j$^$9\e(B)\e$B!#\e(B
  44       \e$B%5!<%P$,0EL[$NFb$K%U%!%$%kL>$N%Q%?!<%s%^%C%A$r9T$J$$!"\e(B
  45       \e$B$=$N7k2L$+$iA*Br$7$^$9!#\e(B</li>
  46     </ul>
  47 </summary>
  48 <seealso><directive module="core">Options</directive></seealso>
  49 <seealso><module>mod_mime</module></seealso>
  50 <seealso><a href="../content-negotiation.html">\e$B%3%s%F%s%H%M%4%7%(!<%7%g%s\e(B</a></seealso>
  51 <seealso><a href="../env.html">\e$B4D6-JQ?t\e(B</a></seealso>
  52
  53 <section id="typemaps"><title>\e$B%?%$%W%^%C%W\e(B</title>
  54     <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
  55     \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
  56     ('#') \e$B$G;O$^$k9T$O%3%a%s%H$H$7$F07$o$l$^$9!#\e(B
  57     \e$B%I%-%e%a%s%H$N@bL@$OJ#?t$N%X%C%@%l%3!<%I$+$i9=@.$5$l$^$9!#\e(B
  58     \e$B%l%3!<%I$O!"B3$-$N9T$,6uGr$G;O$^$C$F$$$k$HJ#?t$N9T$K$^$?$,$j$^$9!#\e(B
  59     \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
  60     \e$B%X%C%@%l%3!<%I$O%-!<%o!<%IL>$N8e$KCM$,B3$/$H$$$&7A<0$G!"\e(B
  61     \e$B%-!<%o!<%IL>$O>o$K%3%m%s$G=*$o$j$^$9!#6uGr$O%X%C%@L>$HCM$N4V!"\e(B
  62     \e$BCM$N%H!<%/%s$N4V$KF~$l$k$3$H$,$G$-$^$9!#\e(B
  63     \e$B;HMQ2DG=$J%X%C%@$O0J2<$N$H$*$j$G$9\e(B:</p>
  64
  65     <dl>
  66       <dt><code>Content-Encoding:</code></dt>
  67       <dd>\e$B%U%!%$%k$N%(%s%3!<%G%#%s%0!#\e(BApache \e$B$O\e(B <directive
  68       module="mod_mime">AddEncoding</directive> \e$B%G%#%l%/%F%#%V\e(B
  69       \e$B$GDj5A$5$l$?%(%s%3!<%G%#%s%0$@$1$rG'<1$7$^$9!#DL>o\e(B compress
  70       \e$B$5$l$?%U%!%$%k$N$?$a$N\e(B <code>x-compress</code> \e$B$H\e(B gzip
  71       \e$B$5$l$?%U%!%$%k$N$?$a$N\e(B <code>x-gzip</code> \e$B$r4^$_$^$9!#\e(B
  72       \e$B%(%s%3!<%G%#%s%0$NHf3S$r$9$k$H$-$O!"@\F,<-\e(B <code>x-</code>
  73       \e$B$OL5;k$5$l$^$9!#\e(B</dd>
  74
  75       <dt><code>Content-Language:</code></dt>
  76       <dd>\e$B%$%s%?!<%M%C%HI8=`$N8@8l%?%0\e(B
  77       (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>)
  78       \e$B$GDj5A$5$l$F$$$k8@8l$N<oN`!#Nc$($P!"\e(B<code>en</code>
  79       \e$B$O1Q8l$rI=$7$^$9!#\e(B
  80       \e$BJ#?t$N8@8l$,3JG<$5$l$k>l9g$O%3%s%^$G6h@Z$i$l$^$9!#\e(B</dd>
  81
  82       <dt><code>Content-Length:</code></dt>
  83       <dd>\e$B%U%!%$%k$ND9$5\e(B (\e$B%P%$%H?t\e(B)\e$B!#\e(B
  84       \e$B$3$N%X%C%@$,$J$$>l9g!"%U%!%$%k$N<B:]$ND9$5$,;HMQ$5$l$^$9!#\e(B</dd>
  85
  86       <dt><code>Content-Type:</code></dt>
  87       <dd>\e$B%I%-%e%a%s%H$N\e(B MIME
  88       \e$B%a%G%#%"%?%$%W!"%*%W%7%g%J%k$J%Q%i%a!<%?IU$-!#%Q%i%a!<%?$N9=J8$O\e(B
  89       <code>name=value</code>
  90       \e$B$G!"%a%G%#%"%?%$%W$dB>$N%Q%i%a!<%?$H$O%;%_%3%m%s$GJ,N%$5$l$^$9!#\e(B
  91       \e$B6&DL$N%Q%i%a!<%?$O0J2<$N$H$*$j\e(B:
  92
  93         <dl>
  94           <dt><code>level</code></dt>
  95           <dd>\e$B%a%G%#%"%?%$%W$N%P!<%8%g%s$r<($9@0?t!#\e(B
  96           <code>text/html</code> \e$B$G$O\e(B 2 \e$B$,%G%U%)%k%H$G!"$=$NB>$N>l9g$O\e(B
  97           0 \e$B$,%G%U%)%k%H$G$9!#\e(B</dd>
  98
  99           <dt><code>qs</code></dt>
 100           <dd>\e$B%/%i%$%"%s%H$NG=NO$K4X78$J$/!"\e(Bvariant
 101           \e$B$rB>$HHf3S$7$?$H$-$NAjBPE*$J!VIJ<A!W$G!"\e(B0.0 \e$B$+$i\e(B 1.0
 102           \e$B$NHO0O$NIbF0E@>.?t!#\e(B
 103           \e$BNc$($P!"<L??$rI=8=$7$h$&$H$7$F$$$k$H$-$OIaDL$O\e(B JPEG
 104           \e$B%U%!%$%k$NJ}$,\e(B ASCII \e$B%U%!%$%k$h$j$b9b$$IJ<A$K$J$j$^$9!#\e(B
 105           \e$B$7$+$7!"%j%=!<%9$,\e(B ASCII \e$B%"!<%H$GI=8=$5$l$F$$$k$H$-$O!"\e(BASCII
 106           \e$B%U%!%$%k$NJ}$,\e(B JPEG
 107           \e$B%U%!%$%k$h$j$b9b$$IJ<A$K$J$j$^$9!#$3$N$h$&$K!"\e(B<code>qs</code>
 108           \e$B$O%j%=!<%9Kh$KFCM-$NCM$r<h$j$^$9!#\e(B
 109           </dd>
 110         </dl>
 111
 112         <example><title>\e$BNc\e(B</title>
 113           Content-Type: image/jpeg; qs=0.8
 114         </example>
 115       </dd>
 116
 117       <dt><code>URI:</code></dt>
 118       <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
 119       \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
 120       \e$B2r<a$5$l$^$9!#F1$8%5!<%P$KB8:_$7$J$1$l$P$J$i$:!"%/%i%$%"%s%H$,\e(B
 121       \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>
 122
 123       <dt><code>Body:</code></dt>
 124       <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
 125       \e$B%j%=!<%9$N<B:]$NFbMF$r%?%$%W%^%C%W%U%!%$%k$K=q$/$3$H$,$G$-$^$9!#\e(B
 126       \e$B$3$N%X%C%@$OK\J8$NFbMF$N6h@Z$j$H$J$kJ8;zNs$G;O$^$kI,MW$,$"$j$^$9!#\e(B
 127       \e$B%?%$%W%^%C%W%U%!%$%k$NB3$/9T$O!"6h@Z$jJ8;zNs$,8+$D$+$k$^$G!"\e(B
 128       \e$B%j%=!<%9$NK\J8$K$J$j$^$9!#\e(B
 129
 130       <example><title>Example:</title>
 131         Body:----xyz----<br />
 132         &lt;html&gt;<br />
 133         &lt;body&gt;<br />
 134         &lt;p&gt;Content of the page.&lt;/p&gt;<br />
 135         &lt;/body&gt;<br />
 136         &lt;/html&gt;<br />
 137         ----xyz----
 138       </example>
 139       </dd>
 140     </dl>
 141 </section>
 142
 143 <section id="multiviews"><title>MultiViews</title>
 144     <p>MultiViews \e$BC5:w$O!"\e(B<code>Multiviews</code> <directive
 145     module="core">Options</directive> \e$B%G%#%l%/%F%#%V$K$h$jM-8z$K$J$j$^$9!#\e(B
 146     \e$B%5!<%P$,\e(B <code>/some/dir/foo</code>
 147     \e$B$X$N%j%/%(%9%H$r<u$1<h$j!"\e(B<code>/some/dir/foo</code> \e$B$,B8:_\e(B
 148     <em>\e$B$7$J$$\e(B</em>\e$B>l9g!"%5!<%P$O%G%#%l%/%H%j$rFI$s$G!"\e(B
 149     <code>foo.*</code> \e$B$K$"$F$O$^$kA4$F$N%U%!%$%k$rC5$7!"\e(B
 150     \e$B;v<B>e$=$l$i$N%U%!%$%k$r%^%C%W$9$k%?%$%W%^%C%W$r:n$j$^$9!#\e(B
 151     \e$B$=$N$H$-!"%a%G%#%"%?%$%W$H%3%s%F%s%H%(%s%3!<%G%#%s%0$O!"\e(B
 152     \e$B$=$N%U%!%$%kL>$rD>@\;XDj$7$?$H$-$HF1$8$b$N$,3d$jEv$F$i$l$^$9!#\e(B
 153     \e$B$=$l$+$i%/%i%$%"%s%H$NMW5a$K0lHV9g$&$b$N$rA*$S!"\e(B
 154     \e$B$=$N%I%-%e%a%s%H$rJV$7$^$9!#\e(B</p>
 155
 156     <p>\e$B%U%!%$%k$rA*Br$9$k:]$K!"4XO"$9$k%3%s%F%s%H%M%4%7%(!<%7%g%s$N\e(B
 157     \e$B%a%?>pJs$r;}$?$J$$%U%!%$%k$K$D$$$F!"H=Dj$r9T$&$+$I$&$+$r\e(B
 158     <directive module="mod_mime">MultiViewsMatch</directive>
 159     \e$B%G%#%l%/%F%#%V$G@_Dj$7$^$9!#\e(B</p>
 160 </section>
 161
 162 <directivesynopsis>
 163 <name>CacheNegotiatedDocs</name>
 164 <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
 165 \e$B%-%c%C%7%e$G$-$k$h$&$K$9$k\e(B</description>
 166 <syntax>CacheNegotiatedDocs On|Off</syntax>
 167 <default>CacheNegotiatedDocs Off</default>
 168 <contextlist><context>server config</context>
 169 <context>virtual host</context>
 170 </contextlist>
 171 <compatibility>\e$B%P!<%8%g%s\e(B 2.0\e$B$G9=J8$,JQ$o$j$^$7$?\e(B</compatibility>
 172
 173 <usage>
 174     <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
 175     \e$B$r$7$?7k2L$N%I%-%e%a%s%H$N%-%c%C%7%e$r5v2D$7$^$9!#\e(B
 176     \e$B$3$l$O!"%W%m%-%7$N8e$m$K$$$k%/%i%$%"%s%H$,G=NO$K0lHV9g$C$?\e(B
 177     \e$B%I%-%e%a%s%H$G$O$J$/!"\e(B
 178     \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>
 179
 180     <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
 181     \e$B$N$_$KE,MQ$5$l$^$9!#\e(BHTTP/1.1 \e$B$O!"\e(B
 182     \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
 183     \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>
 184     <p>2.0 \e$B$h$jA0$N%P!<%8%g%s$G$O!"\e(B
 185     <directive>CacheNegotiatedDocs</directive> \e$B$O0z?t$r<h$i$:!"\e(B
 186     \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>
 187 </usage>
 188 </directivesynopsis>
 189
 190 <directivesynopsis>
 191 <name>ForceLanguagePriority</name>
 192 <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
 193 </description>
 194 <syntax>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</syntax>
 195 <default>ForceLanguagePriority Prefer</default>
 196 <contextlist><context>server config</context><context>virtual host</context>
 197 <context>directory</context><context>.htaccess</context></contextlist>
 198 <override>FileInfo</override>
 199 <compatibility>\e$B%P!<%8%g%s\e(B 2.0.30 \e$B0J9_$G;HMQ2DG=\e(B</compatibility>
 200
 201 <usage>
 202     <p><directive>ForceLanguagePriority</directive> \e$B%G%#%l%/%F%#%V$O\e(B
 203     \e$BMW5a$K9g$&%I%-%e%a%s%H$r0l$D$@$1JV$9$3$H$,$G$-$J$$$H$-$K!"\e(B
 204     <directive module="mod_negotiation">LanguagePriority</directive>
 205     \e$B%G%#%l%/%F%#%V$r;H$C$F%M%4%7%(!<%7%g%s$N7k2L$rJV$7$^$9!#\e(B</p>
 206
 207     <p><code>ForceLanguagePriority Prefer</code> \e$B$O!"F1Ey$NA*Br;h$,\e(B
 208     \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
 209     <code>LanguagePriority</code> \e$B$r;H$C$F0l$D$@$1%I%-%e%a%s%H$rJV$9$h$&$K\e(B
 210     \e$B$7$^$9!#0J2<$N%G%#%l%/%F%#%V$,;XDj$5$l$F$$$F!"%f!<%6$N\e(B <code>Accept-Language</code>
 211     \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
 212     <code>.500</code> (\e$BF1$8$/$i$$5vMF\e(B) \e$B$G$"$k$H$-$O!"\e(B
 213     \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>
 214
 215     <example>
 216       LanguagePriority en fr de<br />
 217       ForceLanguagePriority Prefer
 218     </example>
 219
 220     <p><code>ForceLanguagePriority Fallback</code> \e$B$G$O!"\e(BHTTP 406
 221     (NOT ACCEPTABLE) \e$B$rAw?.$9$kBe$o$j$K!"\e(B
 222     <directive module="mod_negotiation">LanguagePriority</directive>
 223     \e$B$,@5$7$$7k2L$rAw$j$^$9!#\e(B
 224     \e$B0J2<$N%G%#%l%/%F%#%V$,;XDj$5$l$F$$$F!"%f!<%6$N\e(B <code>Accept-Language</code>
 225     \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
 226     \e$B0J2<$N\e(B <directive module="mod_negotiation">LanguagePriority</directive>
 227     \e$B$N%j%9%H$N:G=i$N\e(B variant \e$B$,Aw$l$l$^$9!#\e(B</p>
 228
 229     <example>
 230       LanguagePriority en fr de<br />
 231       ForceLanguagePriority Fallback
 232     </example>
 233
 234     <p><code>Prefer</code> \e$B$H\e(B <code>Fallback</code> \e$B$NN>J}$N%*%W%7%g%s$r\e(B
 235     \e$BF1;~$K;XDj$9$k$3$H$,$G$-$^$9!#\e(B
 236     \e$B$G$9$+$i!"J#?t$N\e(B variant \e$B$,$"$k$H$-$O\e(B
 237     <directive module="mod_negotiation">LanguagePriority</directive> \e$B$N:G=i$N\e(B
 238     variant \e$B$,Aw$i$l!"%/%i%$%"%s%H$N5vMF8@8l$K9g$&\e(B vaiant \e$B$,$J$$$H$-$O\e(B
 239     \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>
 240 </usage>
 241 <seealso><directive module="mod_mime">AddLanguage</directive></seealso>
 242 </directivesynopsis>
 243
 244 <directivesynopsis>
 245 <name>LanguagePriority</name>
 246 <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
 247 \e$B;XDj\e(B</description>
 248 <syntax>LanguagePriority <var>MIME-lang</var> [<var>MIME-lang</var>]
 249 ...</syntax>
 250 <contextlist><context>server config</context><context>virtual host</context>
 251 <context>directory</context><context>.htaccess</context></contextlist>
 252 <override>FileInfo</override>
 253
 254 <usage>
 255     <p><directive>LanguagePriority</directive> \e$B$O!"\e(BMultiViews
 256     \e$B%j%/%(%9%H$r07$&$H$-$K!"%/%i%$%"%s%H$,M%@h=g0L$rDs6!$7$F$$$J$$>l9g$N\e(B
 257     \e$B8@8l$NM%@h=g0L$r@_Dj$7$^$9!#\e(B<var>MIME-lang</var>
 258     \e$B$N%j%9%H$,M%@hEY$N9_=g$KJB$S$^$9!#\e(B</p>
 259
 260     <example><title>Example:</title>
 261       LanguagePriority en fr de
 262     </example>
 263
 264     <p><code>foo.html</code> \e$B$,%j%/%(%9%H$5$l!"\e(B<code>foo.html.fr</code>
 265     \e$B$H\e(B <code>foo.html.de</code> \e$B$,N>J}B8:_$7!"\e(B
 266     \e$B%V%i%&%6$,8@8l$NM%@h=g0L$rDs6!$7$F$J$$>l9g$O\e(B
 267     <code>foo.html.fr</code> \e$B$,JV$5$l$^$9!#\e(B</p>
 268
 269     <p>\e$B$3$N%G%#%l%/%F%#%V$OB>$NJ}K!$G!V:GA1!W\e(B
 270     \e$B$N8@8l$,7hDj$G$-$J$$$H$-$+!"\e(B<directive
 271     module="mod_negotiation">ForceLanguagePriority</directive> \e$B%G%#%l%/%F%#%V$,\e(B
 272     <code>None</code> \e$B0J30$N$H$-$K$N$_8z2L$,$"$k$3$H$KCm0U$7$F$/$@$5$$!#\e(B
 273     \e$B0lHLE*$K$O!"%5!<%PB&$G$O$J$/%/%i%$%"%s%HB&$G9%$_$N8@8l$r7hDj$7$^$9!#\e(B</p>
 274 </usage>
 275 <seealso><directive module="mod_mime">AddLanguage</directive></seealso>
 276 </directivesynopsis>
 277
 278 </modulesynopsis>