mirror of
https://github.com/apache/httpd.git
synced 2026-01-06 09:01:14 +03:00
c5961168c5
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@85304 13f79535-47bb-0310-9956-ffa450edef68
228 lines
6.2 KiB
HTML
228 lines
6.2 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>Apache module mod_charset_lite</TITLE>
|
|
</HEAD>
|
|
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
|
|
<BODY
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#000080"
|
|
ALINK="#FF0000"
|
|
>
|
|
<!--#include virtual="header.html" -->
|
|
<H1 ALIGN="CENTER">Module mod_charset_lite</H1>
|
|
|
|
<P>
|
|
This module is contained in the <CODE>mod_charset_lite.c</CODE> file, with
|
|
Apache 2.0 and later. It provides the ability to specify character set
|
|
translation, or recoding, by directory or location or virtual server. It
|
|
is not compiled into the server by default. <CODE>mod_charset_lite</CODE>
|
|
requires that Apache is compiled with APACHE_XLATE defined.
|
|
</P>
|
|
|
|
<P>
|
|
This module provides a small subset of configuration mechanisms
|
|
implemented by Russian Apache and its associated <CODE>mod_charset</CODE>.
|
|
</P>
|
|
|
|
<H2>Summary</H2>
|
|
<P>
|
|
This is an <STRONG>experimental</STRONG> module and should be used with
|
|
care. Experiment with your <CODE>mod_charset_lite</CODE> configuration to
|
|
ensure that it performs the desired function.
|
|
</P>
|
|
<P>
|
|
<CODE>mod_charset_lite</CODE> allows the administrator to specify the
|
|
source character set of objects as well as the character set they should
|
|
be translated into before sending to the client.
|
|
<CODE>mod_charset_lite</CODE> does not translate the data itself but
|
|
instead tells Apache what translation to perform.
|
|
<CODE>mod_charset_lite</CODE> is applicable to EBCDIC and ASCII
|
|
host environments. In an EBCDIC environment, Apache normally translates
|
|
text content from the code page of the Apache process locale to
|
|
ISO-8859-1. <CODE>mod_charset_lite</CODE> can be used to specify that
|
|
a different translation is to be performed. In an ASCII environment,
|
|
Apache normally performs no translation, so <CODE>mod_charset_lite</CODE>
|
|
is needed in order for any translation to take place.
|
|
</P>
|
|
|
|
<H2>Directives</H2>
|
|
<UL>
|
|
<LI><A HREF="#charsetsourceenc">CharsetSourceEnc</A>
|
|
<LI><A HREF="#charsetdefault">CharsetDefault</A>
|
|
<LI><A HREF="#charsetdebug">CharsetDebug</A>
|
|
</LI>
|
|
</UL>
|
|
|
|
<HR>
|
|
|
|
<H2><A NAME="charsetsourceenc">CharsetSourceEnc</A></H2>
|
|
<P>
|
|
<A
|
|
HREF="directive-dict.html#Syntax"
|
|
REL="Help"
|
|
><STRONG>Syntax:</STRONG></A> CharsetSourceEnc <EM>charset</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Default"
|
|
REL="Help"
|
|
><STRONG>Default:</STRONG></A> <EM>None</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Context"
|
|
REL="Help"
|
|
><STRONG>Context:</STRONG></A> directory, virtual host
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Override"
|
|
REL="Help"
|
|
><STRONG>Override:</STRONG></A> <EM>FileInfo</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Status"
|
|
REL="Help"
|
|
><STRONG>Status:</STRONG></A> Experimental
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Module"
|
|
REL="Help"
|
|
><STRONG>Module:</STRONG></A> mod_charset_lite
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Compatibility"
|
|
REL="Help"
|
|
><STRONG>Compatibility:</STRONG></A> Only available in Apache 2.0 or later
|
|
|
|
<P>
|
|
The <CODE>CharsetSourceEnc</CODE> directive specifies the source charset
|
|
of files in the associated container.
|
|
</P>
|
|
|
|
<P>
|
|
The value of the <EM>charset</EM> argument must be accepted as a valid
|
|
character set name by the character set support in APR. Generally, this
|
|
means that it must be supported by iconv.
|
|
</P>
|
|
|
|
Example:
|
|
|
|
<PRE>
|
|
<Directory "/export/home/trawick/apacheinst/htdocs/convert">
|
|
CharsetSourceEnc UTF-16BE
|
|
CharsetDefault ISO8859-1
|
|
</Directory>
|
|
</PRE>
|
|
|
|
The character set names in this example work with the iconv
|
|
translation support in Solaris 8.
|
|
<P>
|
|
|
|
<H2><A NAME="charsetdefault">CharsetDefault</A></H2>
|
|
<P>
|
|
<A
|
|
HREF="directive-dict.html#Syntax"
|
|
REL="Help"
|
|
><STRONG>Syntax:</STRONG></A> CharsetDefault <EM>charset</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Default"
|
|
REL="Help"
|
|
><STRONG>Default:</STRONG></A> <EM>None</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Context"
|
|
REL="Help"
|
|
><STRONG>Context:</STRONG></A> directory, virtual host
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Override"
|
|
REL="Help"
|
|
><STRONG>Override:</STRONG></A> <EM>FileInfo</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Status"
|
|
REL="Help"
|
|
><STRONG>Status:</STRONG></A> Experimental
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Module"
|
|
REL="Help"
|
|
><STRONG>Module:</STRONG></A> mod_charset_lite
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Compatibility"
|
|
REL="Help"
|
|
><STRONG>Compatibility:</STRONG></A> Only available in Apache 2.0 or later
|
|
|
|
<P>
|
|
The <CODE>CharsetDefault</CODE> directive specifies the charset that
|
|
content in the associated container should be translated to.
|
|
</P>
|
|
|
|
<P>
|
|
The value of the <EM>charset</EM> argument must be accepted as a valid
|
|
character set name by the character set support in APR. Generally, this
|
|
means that it must be supported by iconv.
|
|
</P>
|
|
|
|
Example:
|
|
|
|
<PRE>
|
|
<Directory "/export/home/trawick/apacheinst/htdocs/convert">
|
|
CharsetSourceEnc UTF-16BE
|
|
CharsetDefault ISO8859-1
|
|
</Directory>
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
<H2><A NAME="charsetdebug">CharsetDebug</A></H2>
|
|
<P>
|
|
<A
|
|
HREF="directive-dict.html#Syntax"
|
|
REL="Help"
|
|
><STRONG>Syntax:</STRONG></A> CharsetDebug <EM>on/off</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Default"
|
|
REL="Help"
|
|
><STRONG>Default:</STRONG></A> <EM>off</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Context"
|
|
REL="Help"
|
|
><STRONG>Context:</STRONG></A> directory, virtual host
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Override"
|
|
REL="Help"
|
|
><STRONG>Override:</STRONG></A> <EM>FileInfo</EM>
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Status"
|
|
REL="Help"
|
|
><STRONG>Status:</STRONG></A> Experimental
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Module"
|
|
REL="Help"
|
|
><STRONG>Module:</STRONG></A> mod_charset_lite
|
|
<BR>
|
|
<A
|
|
HREF="directive-dict.html#Compatibility"
|
|
REL="Help"
|
|
><STRONG>Compatibility:</STRONG></A> Only available in Apache 2.0 or later
|
|
|
|
<P>
|
|
The <CODE>CharsetDebug</CODE> directive specifies whether or not
|
|
verbose logging should be performed by <CODE>mod_charset_lite</CODE>.
|
|
Such logging is written to the Apache error log with level
|
|
<EM>debug</EM>.
|
|
</P>
|
|
|
|
<!--#include virtual="footer.html" -->
|
|
</BODY>
|
|
</HTML>
|