X-Git-Url: http://git.home-dn.net/?p=manu%2Fmod-proxy-html.git;a=blobdiff_plain;f=guide.html;h=017c4eb529f0951f92bfd87e0453d161bc1b4af9;hp=fac13e29f1d5abe586892d22c02841d58e17cc03;hb=c242c0c9941559d96d2e566e61d2cd7e3fcd12d9;hpb=e2a89f3329582da3ca7b270db0f99c6fc20b2155 diff --git a/guide.html b/guide.html index fac13e2..017c4eb 100644 --- a/guide.html +++ b/guide.html @@ -5,10 +5,14 @@ +
mod_proxy_html From Version 2.4 (Sept 2004).
+mod_proxy_html From Version 2.4 (Sept 2004). +Updates in Version 3 (Dec. 2006) are highlighted.
linked_elts
in pstartElement
.
-Rules are applicable provided the h flag is not set.
+Rules are applicable provided the h flag is not set.
+From Version 3, the definition of links to use is
+delegated to the system administrator via the ProxyHTMLLinks
+directive.
An HTML link always contains exactly one URL. So whenever mod_proxy_html
finds a matching ProxyHTMLURLMap
rule, it will apply the
-transformation once and stop processing the attribute.
l
flag, which causes processing
+a URL to continue after a rewrite.
Scripting events are the contents of event attributes as defined in the
HTML4 and XHTML1 DTDs; for example onclick
. For a full list,
see the declaration of events
in pstartElement
.
-Rules are applicable provided the e flag is not set.
ProxyHTMLEvents
+directive.
A scripting event may contain more than one URL, and will contain other
text. So when ProxyHTMLExtended
is On, all applicable rules
will be applied in order until and unless a rule with the L flag
@@ -116,11 +128,18 @@ apply the appropriate rules in generating output. HTML saves a few bytes.
If you declare a custom DTD, you should specify whether to generate HTML or XHTML syntax in the output. This affects empty elements: HTML <br> vs XHTML <br />.
+If you select standard HTML or XHTML, mod_proxy_html 3 will
+perform some additional fixups of bogus markup. If you don't want this,
+you can enter a standard DTD using the nonstandard form of
+ProxyHTMLDTD
, which will then be treated as unknown
+(no corrections).
The parser uses UTF-8 (Unicode) internally, and -mod_proxy_html always generates output as UTF-8. This is -supported by all general-purpose web software, and supports more -character sets and languages than any other charset.
+mod_proxy_html prior to version 3 always generates output as UTF-8. +This is supported by all general-purpose web software, and supports more +character sets and languages than any other charset. +Version 3 supports, but does not recommend different outputs, using +theProxyHTMLCharsetOut
directive.
The character encoding should be declared in HTTP: for example
Content-Type: text/html; charset=latin1
mod_proxy_html has always supported this in its input, and ensured
@@ -139,11 +158,28 @@ information.
<meta http-equiv="Content-Type" ...>
, any charset declared
here is used.
ProxyHTMLCharsetDefault
value is assumed.
In version 3.0, this remains the default, but +internationalisation support is further improved, and is no longer +limited to the encodings supported by libxml2:
+ProxyHTMLCharsetAlias
directive enables server
+administrators to support additional encodings by aliasing them to
+something supported by libxml2.apr_xlate
, which on most platforms
+is a wrapper for the leading conversion utility iconv
.
+Because of undocumented behaviour of libxml2, this may cause problems
+when charset is specified in an HTML META
element. This
+feature is therefore only enabled when ProxyHTMLMeta
is On.The HTML meta
element includes a form
<meta http-equiv="Some-Header" contents="some-value">