Mercurial > hg > nginx-site

annotate xml/en/docs/http/ngx_http_xslt_module.xml @ 615:f3ef5b77d22a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented that "ipv6only" is now turned on by default for listening IPv6 sockets.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 31 Jul 2012 14:38:46 +0000
parents 764fbac1b8b4
children ae785c6aaa91
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
377
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 564
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 564
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 564
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 564
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 564
diff changeset
7
377
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Module ngx_http_xslt_module"
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/en/docs/http/ngx_http_xslt_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="en"
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
13 rev="1">
377
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="summary">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 The <literal>ngx_http_xslt_module</literal> (0.7.8+) is a filter
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 that transforms XML responses using one or more XSLT stylesheets.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23 This module is not built by default, it should be enabled with the
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24 <literal>--with-http_xslt_module</literal>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 configuration parameter.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 <note>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27 This module requires the
564
624ac281c628 Separate links to libxml2 and libxslt.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
28 <link url="http://xmlsoft.org">libxml2</link> and
624ac281c628 Separate links to libxml2 and libxslt.
Ruslan Ermilov <ru@nginx.com>
parents: 546
diff changeset
29 <link url="http://xmlsoft.org/XSLT/">libxslt</link> libraries.
377
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 </note>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 </section>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 <section id="example" name="Example Configuration">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 <example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 location / {
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 xml_entities /site/dtd/entities.dtd;
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 xslt_stylesheet /site/xslt/one.xslt param=value;
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 xslt_stylesheet /site/xslt/two.xslt;
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 }
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 </example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 </section>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 <section id="directives" name="Directives">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 <directive name="xml_entities">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 <syntax><value>path</value></syntax>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 <default/>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 <context>http</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 <context>server</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 <context>location</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61 Specifies the DTD file that declares character entities.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 This file is compiled during the configuration stage.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 For technical reasons the module is unable to use the
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 external subset declared in the processed XML, so it is
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 ignored and instead a specially defined file is used.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 This file should not describe the XML structure, it is
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67 enough to only declare the required character entities, for example:
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 <example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 &lt;!ENTITY nbsp "&amp;#xa0;"&gt;
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 </example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
71 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
72
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73 </directive>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
74
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
75
463
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
76 <directive name="xslt_param">
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
77 <syntax><value>parameter</value> <value>value</value></syntax>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
78 <default/>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
79 <context>http</context>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
80 <context>server</context>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
81 <context>location</context>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
82 <appeared-in>1.1.18</appeared-in>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
83
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
84 <para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
85 Defines parameters for XSLT stylesheets.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
86 The <value>value</value> is treated as an XPath expression.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
87 The <value>value</value> can contain variables.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
88 To pass a string value to a stylesheet,
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
89 the <link id="xslt_string_param"/> directive can be used.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
90 </para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
91
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
92 <para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
93 There could be several <literal>xslt_param</literal> directives.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
94 These directives are inherited from the previous level if and
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
95 only if there are no
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
96 <literal>xslt_param</literal> and <link id="xslt_string_param"/>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
97 directives defined on the current level.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
98 </para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
99
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
100 </directive>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
101
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
102
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
103 <directive name="xslt_string_param">
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
104 <syntax><value>parameter</value> <value>value</value></syntax>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
105 <default/>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
106 <context>http</context>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
107 <context>server</context>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
108 <context>location</context>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
109 <appeared-in>1.1.18</appeared-in>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
110
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
111 <para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
112 Defines string parameters for XSLT stylesheets.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
113 XPath expressions in the <value>value</value> are not interpreted.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
114 The <value>value</value> can contain variables.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
115 </para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
116
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
117 <para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
118 There could be several <literal>xslt_string_param</literal> directives.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
119 These directives are inherited from the previous level if and
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
120 only if there are no
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
121 <link id="xslt_param"/> and <literal>xslt_string_param</literal>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
122 directives defined on the current level.
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
123 </para>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
124
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
125 </directive>
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
126
dd9fec875834 Documented new directives: xslt_param and xslt_string_param.
Ruslan Ermilov <ru@nginx.com>
parents: 377
diff changeset
127
377
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
128 <directive name="xslt_stylesheet">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
129 <syntax>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130 <value>stylesheet</value>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131 [<value>parameter</value>=<value>value</value> ...]</syntax>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 <default/>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 <context>location</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 Defines the XSLT stylesheet and its optional parameters.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137 A stylesheet is compiled during the configuration stage.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141 Parameters can either be specified separately, or grouped in a
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 single line using the “<literal>:</literal>” delimiter.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 If a parameter includes the “<literal>:</literal>” character,
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 it should be escaped as “<literal>%3A</literal>”.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145 Also, <command>libxslt</command> requires to enclose parameters
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 that contain non-alphanumeric characters into single or double quotes,
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 for example:
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148 <example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 param1='http%3A//www.example.com':param2=value2
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 </example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 The description of parameters can contain variables, for example,
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155 the whole line of parameters can be taken from a single variable:
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
156 <example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
157 location / {
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158 xslt_stylesheet /site/xslt/one.xslt
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 $arg_xslt_params
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160 param1='$value1':param2=value2
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 param3=value3;
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
162 }
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 </example>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 It is possible to specify several stylesheets; in this case they
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 will be applied sequentially in the specified order.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 </directive>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174 <directive name="xslt_types">
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175 <syntax><value>mime-type</value> ...</syntax>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 <default>text/xml</default>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177 <context>http</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 <context>server</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
179 <context>location</context>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
180
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
181 <para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
182 Enables transformations in responses with the specified MIME types
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
183 in addition to “<literal>text/xml</literal>”.
546
694db9597ee0 Documented the special value "*" in various "*_type" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 463
diff changeset
184 The special value “<literal>*</literal>” matches any MIME type (0.8.29).
377
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
185 If the result of transformation is an HTML response, its MIME type
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
186 is changes to “<literal>text/html</literal>”.
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
187 </para>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
188
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
189 </directive>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
190
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
191 </section>
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192
e72701967099 English translation of ngx_http_xslt_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193 </module>