Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_xslt_module.xml @ 966:95c3c3bbf1ce

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Text review.
author Egor Nikitin <yegor.nikitin@gmail.com>
date Wed, 14 Aug 2013 12:03:41 +0400
parents ae785c6aaa91
children eeed494bba51
comparison
equal deleted inserted replaced
965:fadccc156188 966:95c3c3bbf1ce
57 <context>server</context> 57 <context>server</context>
58 <context>location</context> 58 <context>location</context>
59 59
60 <para> 60 <para>
61 Specifies the DTD file that declares character entities. 61 Specifies the DTD file that declares character entities.
62 This file is compiled during the configuration stage. 62 This file is compiled at the configuration stage.
63 For technical reasons the module is unable to use the 63 For technical reasons, the module is unable to use the
64 external subset declared in the processed XML, so it is 64 external subset declared in the processed XML, so it is
65 ignored and instead a specially defined file is used. 65 ignored and a specially defined file is used instead.
66 This file should not describe the XML structure, it is 66 This file should not describe the XML structure.
67 enough to only declare the required character entities, for example: 67 It is enough to declare just the required character entities, for example:
68 <example> 68 <example>
69 &lt;!ENTITY nbsp "&amp;#xa0;"&gt; 69 &lt;!ENTITY nbsp "&amp;#xa0;"&gt;
70 </example> 70 </example>
71 </para> 71 </para>
72 72
80 <context>server</context> 80 <context>server</context>
81 <context>location</context> 81 <context>location</context>
82 <appeared-in>1.5.1</appeared-in> 82 <appeared-in>1.5.1</appeared-in>
83 83
84 <para> 84 <para>
85 Allows to preserve the <header>Last-Modified</header> header field 85 Allows preserving the <header>Last-Modified</header> header field
86 from the original response during XSLT transformations 86 from the original response during XSLT transformations
87 to facilitate response caching. 87 to facilitate response caching.
88 </para> 88 </para>
89 89
90 <para> 90 <para>
103 <context>server</context> 103 <context>server</context>
104 <context>location</context> 104 <context>location</context>
105 <appeared-in>1.1.18</appeared-in> 105 <appeared-in>1.1.18</appeared-in>
106 106
107 <para> 107 <para>
108 Defines parameters for XSLT stylesheets. 108 Defines the parameters for XSLT stylesheets.
109 The <value>value</value> is treated as an XPath expression. 109 The <value>value</value> is treated as an XPath expression.
110 The <value>value</value> can contain variables. 110 The <value>value</value> can contain variables.
111 To pass a string value to a stylesheet, 111 To pass a string value to a stylesheet,
112 the <link id="xslt_string_param"/> directive can be used. 112 the <link id="xslt_string_param"/> directive can be used.
113 </para> 113 </para>
130 <context>server</context> 130 <context>server</context>
131 <context>location</context> 131 <context>location</context>
132 <appeared-in>1.1.18</appeared-in> 132 <appeared-in>1.1.18</appeared-in>
133 133
134 <para> 134 <para>
135 Defines string parameters for XSLT stylesheets. 135 Defines the string parameters for XSLT stylesheets.
136 XPath expressions in the <value>value</value> are not interpreted. 136 XPath expressions in the <value>value</value> are not interpreted.
137 The <value>value</value> can contain variables. 137 The <value>value</value> can contain variables.
138 </para> 138 </para>
139 139
140 <para> 140 <para>
155 <default/> 155 <default/>
156 <context>location</context> 156 <context>location</context>
157 157
158 <para> 158 <para>
159 Defines the XSLT stylesheet and its optional parameters. 159 Defines the XSLT stylesheet and its optional parameters.
160 A stylesheet is compiled during the configuration stage. 160 A stylesheet is compiled at the configuration stage.
161 </para> 161 </para>
162 162
163 <para> 163 <para>
164 Parameters can either be specified separately, or grouped in a 164 Parameters can either be specified separately, or grouped in a
165 single line using the “<literal>:</literal>” delimiter. 165 single line using the “<literal>:</literal>” delimiter.
172 param1='http%3A//www.example.com':param2=value2 172 param1='http%3A//www.example.com':param2=value2
173 </example> 173 </example>
174 </para> 174 </para>
175 175
176 <para> 176 <para>
177 The description of parameters can contain variables, for example, 177 The parameters description can contain variables, for example,
178 the whole line of parameters can be taken from a single variable: 178 the whole line of parameters can be taken from a single variable:
179 <example> 179 <example>
180 location / { 180 location / {
181 xslt_stylesheet /site/xslt/one.xslt 181 xslt_stylesheet /site/xslt/one.xslt
182 $arg_xslt_params 182 $arg_xslt_params
185 } 185 }
186 </example> 186 </example>
187 </para> 187 </para>
188 188
189 <para> 189 <para>
190 It is possible to specify several stylesheets; in this case they 190 It is possible to specify several stylesheets.
191 will be applied sequentially in the specified order. 191 They will be applied sequentially in the specified order.
192 </para> 192 </para>
193 193
194 </directive> 194 </directive>
195 195
196 196
203 203
204 <para> 204 <para>
205 Enables transformations in responses with the specified MIME types 205 Enables transformations in responses with the specified MIME types
206 in addition to “<literal>text/xml</literal>”. 206 in addition to “<literal>text/xml</literal>”.
207 The special value “<literal>*</literal>” matches any MIME type (0.8.29). 207 The special value “<literal>*</literal>” matches any MIME type (0.8.29).
208 If the result of transformation is an HTML response, its MIME type 208 If the transformation result is an HTML response, its MIME type
209 is changes to “<literal>text/html</literal>”. 209 is changed to “<literal>text/html</literal>”.
210 </para> 210 </para>
211 211
212 </directive> 212 </directive>
213 213
214 </section> 214 </section>