Update packaging for 3.1.2 (need of new mod_xml2enc dependency)
[manu/mod-proxy-html.git] / proxy_html.conf
1 # Configuration example.
2 #
3 # First, to load the module with its prerequisites.  Note: mod_xml2enc
4 # is not always necessary, but without it mod_proxy_html is likely to
5 # mangle pages in encodings other than ASCII or Unicode (utf-8).
6 #
7 # For Unix-family systems:
8 # LoadFile      /usr/lib/libxml2.so
9 # LoadModule    proxy_html_module       modules/mod_proxy_html.so
10 # LoadModule    xml2enc_module          modules/mod_xml2enc.so
11 #
12 # For Windows (I don't know if there's a standard path for the libraries)
13 # LoadFile      C:/path/zlib.dll
14 # LoadFile      C:/path/iconv.dll
15 # LoadFile      C:/path/libxml2.dll
16 # LoadModule    proxy_html_module       modules/mod_proxy_html.so
17 # LoadModule    xml2enc_module          modules/mod_xml2enc.so
18
19 # All knowledge of HTML links has been removed from the mod_proxy_html
20 # code itself, and is instead read from httpd.conf (or included file)
21 # at server startup.  So you MUST declare it.  This will normally be
22 # at top level, but can also be used in a <Location>.
23 #
24 # Here's the declaration for W3C HTML 4.01 and XHTML 1.0
25
26 ProxyHTMLLinks  a               href
27 ProxyHTMLLinks  area            href
28 ProxyHTMLLinks  link            href
29 ProxyHTMLLinks  img             src longdesc usemap
30 ProxyHTMLLinks  object          classid codebase data usemap
31 ProxyHTMLLinks  q               cite
32 ProxyHTMLLinks  blockquote      cite
33 ProxyHTMLLinks  ins             cite
34 ProxyHTMLLinks  del             cite
35 ProxyHTMLLinks  form            action
36 ProxyHTMLLinks  input           src usemap
37 ProxyHTMLLinks  head            profile
38 ProxyHTMLLinks  base            href
39 ProxyHTMLLinks  script          src for
40
41 # To support scripting events (with ProxyHTMLExtended On),
42 # you'll need to declare them too.
43
44 ProxyHTMLEvents onclick ondblclick onmousedown onmouseup \
45                 onmouseover onmousemove onmouseout onkeypress \
46                 onkeydown onkeyup onfocus onblur onload \
47                 onunload onsubmit onreset onselect onchange
48
49 # If you need to support legacy (pre-1998, aka "transitional") HTML or XHTML,
50 # you'll need to uncomment the following deprecated link attributes.
51 # Note that these are enabled in earlier mod_proxy_html versions
52 #
53 # ProxyHTMLLinks        frame           src longdesc
54 # ProxyHTMLLinks        iframe          src longdesc
55 # ProxyHTMLLinks        body            background
56 # ProxyHTMLLinks        applet          codebase
57 #
58 # If you're dealing with proprietary HTML variants,
59 # declare your own URL attributes here as required.
60 #
61 # ProxyHTMLLinks        myelement       myattr otherattr
62 #
63 ###########
64 # EXAMPLE #
65 ###########
66 #
67 # To define the URL /my-gateway/ as a gateway to an appserver with address
68 # http://some.app.intranet/ on a private network, after loading the
69 # modules and including this configuration file:
70 #
71 # ProxyRequests Off  <-- this is an important security setting
72 # ProxyPass /my-gateway/ http://some.app.intranet/
73 # <Location /my-gateway/>
74 #       ProxyPassReverse /
75 #       ProxyHTMLEnable On
76 #       ProxyHTMLURLMap http://some.app.intranet/ /my-gateway/
77 #       ProxyHTMLURLMap / /my-gateway/
78 # </Location>
79 #
80 # Many (though not all) real-life setups are more complex.
81 #
82 # See the documentation at
83 # http://apache.webthing.com/mod_proxy_html/
84 # and the tutorial at
85 # http://www.apachetutor.org/admin/reverseproxies