Mercurial > hg > nginx-site

annotate xml/en/docs/http/ngx_http_charset_module.xml @ 1194:9264fdb6c833

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added links to uwsgi.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 17 May 2014 01:55:27 +0400
parents b8f0362f61e5
children 4cafd82e5007
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
7
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Module ngx_http_charset_module"
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/en/docs/http/ngx_http_charset_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="en"
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
13 rev="4">
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="summary">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 The <literal>ngx_http_charset_module</literal> module adds the specified
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 charset to the <header>Content-Type</header> response header field.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 In addition, the module can convert data from one charset to another,
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 with some limitations:
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 <list type="bullet">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24 <listitem>
367
f4033b9bc4ec - Removed unnecessary instances of unbreakable space.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
25 conversion is performed one way — from server to client,
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 </listitem>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 <listitem>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 only single-byte charsets can be converted
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 </listitem>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32 <listitem>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 or single-byte charsets to/from UTF-8.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 </listitem>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 </list>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 </section>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 <section id="example" name="Example Configuration">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 350
diff changeset
46 include conf/koi-win;
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 350
diff changeset
48 charset windows-1251;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 350
diff changeset
49 source_charset koi8-r;
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50 </example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 </section>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 <section id="directives" name="Directives">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 <directive name="charset">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 <syntax><value>charset</value> | <literal>off</literal></syntax>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 <default>off</default>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61 <context>http</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 <context>server</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 <context>location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 <context>if in location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67 Adds the specified charset to the <header>Content-Type</header>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 response header field.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 If this charset is different from the charset specified
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 in the <link id="source_charset"/> directive, a conversion is performed.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
71 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
72
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
74 The parameter <literal>off</literal> cancels the addition of charset
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
75 to the <header>Content-Type</header> response header field.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
76 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
78 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
79 A charset can be defined with a variable:
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80 <example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81 charset $charset;
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82 </example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 In such a case, all possible values of a variable need to be present
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 in the configuration at least once in the form of the
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 <link id="charset_map"/>, <link id="charset"/>, or
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 <link id="source_charset"/> directives.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 For <literal>utf-8</literal>, <literal>windows-1251</literal>, and
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
88 <literal>koi8-r</literal> charsets, it is sufficient to include the files
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89 <path>conf/koi-win</path>, <path>conf/koi-utf</path>, and
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 <path>conf/win-utf</path> into configuration.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 For other charsets, simply making a fictitious conversion table works,
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 for example:
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 <example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 charset_map iso-8859-5 _ { }
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 </example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
98 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
99 In addition, a charset can be set in the
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
100 <header>X-Accel-Charset</header> response header field.
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
101 This capability can be disabled using the
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
102 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>,
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
103 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>,
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
104 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_ignore_headers"/>,
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
105 and
1181
b8f0362f61e5 Added links to scgi.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
106 <link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
107 directives.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
108 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 367
diff changeset
109
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
110 </directive>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 <directive name="charset_map">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 <syntax block="yes"><value>charset1</value> <value>charset2</value></syntax>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115 <default/>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 <context>http</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119 Describes the conversion table from one charset to another.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
120 A reverse conversion table is built using the same data.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
121 Character codes are given in hexadecimal.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
122 Missing characters in the range 80-FF are replaced with “<literal>?</literal>”.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 When converting from UTF-8, characters missing in a one-byte charset
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124 are replaced with “<literal>&amp;#XXXX;</literal>”.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
128 Example:
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
129 <example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130 charset_map koi8-r windows-1251 {
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131 C0 FE ; # small yu
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 C1 E0 ; # small a
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 C2 E1 ; # small b
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 C3 F6 ; # small ts
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 ...
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 }
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137 </example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141 When describing a conversion table to UTF-8, codes for the UTF-8 charset should
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 be given in the second column, for example:
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 <example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 charset_map koi8-r utf-8 {
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145 C0 D18E ; # small yu
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 C1 D0B0 ; # small a
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 C2 D0B1 ; # small b
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148 C3 D186 ; # small ts
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 ...
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 }
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 </example>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155 Full conversion tables from <literal>koi8-r</literal> to
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
156 <literal>windows-1251</literal>, and from <literal>koi8-r</literal> and
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
157 <literal>windows-1251</literal> to <literal>utf-8</literal>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158 are provided in the distribution files <path>conf/koi-win</path>,
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 <path>conf/koi-utf</path>, and <path>conf/win-utf</path>.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
162 </directive>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 <directive name="charset_types">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 <syntax><value>mime-type</value> ...</syntax>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 <default>text/html text/xml text/plain text/vnd.wap.wml
952
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
168 application/javascript application/rss+xml</default>
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 <context>http</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 <context>server</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 <context>location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172 <appeared-in>0.7.9</appeared-in>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175 Enables module processing in responses with the specified MIME types
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 in addition to “<literal>text/html</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
177 The special value “<literal>*</literal>” matches any MIME type (0.8.29).
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
179
952
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
180 <para>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
181 <note>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
182 Until version 1.5.4, “<literal>application/x-javascript</literal>” was used
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
183 as the default MIME type instead of “<literal>application/javascript</literal>”.
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
184 </note>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
185 </para>
417dc982362e Updated default for the "charset_types" directive.
Valentin Bartenev <vbart@nginx.com>
parents: 589
diff changeset
186
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
187 </directive>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
188
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
189
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
190 <directive name="override_charset">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
191 <syntax><literal>on</literal> | <literal>off</literal></syntax>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192 <default>off</default>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193 <context>http</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
194 <context>server</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
195 <context>location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
196 <context>if in location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
197
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
198 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
199 Determines whether a conversion should be performed for answers
1194
9264fdb6c833 Added links to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents: 1181
diff changeset
200 received from a proxied or a FastCGI/uwsgi/SCGI server
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
201 when the answers already carry a charset in the <header>Content-Type</header>
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
202 response header field.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
203 If conversion is enabled, a charset specified in the received
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
204 response is used as a source charset.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
205 <note>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
206 It should be noted that if a response is received in a subrequest
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
207 then the conversion from the response charset to the main request charset
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 952
diff changeset
208 is always performed, regardless of the <literal>override_charset</literal>
350
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
209 directive setting.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
210 </note>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
211 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
212
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
213 </directive>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
214
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
215
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
216 <directive name="source_charset">
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
217 <syntax><value>charset</value></syntax>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
218 <default/>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
219 <context>http</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
220 <context>server</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
221 <context>location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
222 <context>if in location</context>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
223
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
224 <para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
225 Defines the source charset of a response.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
226 If this charset is different from the charset specified
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
227 in the <link id="charset"/> directive, a conversion is performed.
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
228 </para>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
229
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
230 </directive>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
231
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
232 </section>
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
233
55c1c4a1748f English translation of ngx_http_charset_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
234 </module>