apache/docs/manual/mod/mod_charset_lite.xml.ko

<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 151408:420990 (outdated) -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_charset_lite.xml.meta">

<name>mod_charset_lite</name>
<description>문자집합 변환을 지정</description>
<status>Experimental</status>
<sourcefile>mod_charset_lite.c</sourcefile>
<identifier>charset_lite_module</identifier>

<summary>
    <p>이 모듈은 <strong>실험적인</strong> 모듈이고, 주의있게
    사용해야 한다. 원하는 동작을 하는지
    <module>mod_charset_lite</module> 설정을 시험해봐라.</p>

    <p><module>mod_charset_lite</module>를 사용하여 문서 원본의
    문자집합과 문서를 클라이언트로 보내기 전에 변환할 문자집합을
    지정할 수 있다. <module>mod_charset_lite</module>는 직접
    자료를 변환하지않고 대신 아파치에게 변환하라고 요청한다.
    <module>mod_charset_lite</module>는 EBCDIC과 ASCII 환경에서
    사용할 수 있다. EBCDIC 환경에서 아파치는 보통 아파치 프로세스의
    코드페이지에서 ISO-8859-1 문자집합으로 문서를 변환한다.
    <module>mod_charset_lite</module>를 사용하여 다른 변환을
    지시할 수 있다. ASCII 환경에서 아파치는 기본적으로 변환을
    하지 않기때문에, 어떤 변환을 위해서는
    <module>mod_charset_lite</module>가 필요하다.</p>

    <p>이 모듈은 러시아판 아파치의 <code>mod_charset</code>이
    제공하는 설정의 일부를 제공한다.</p>
</summary>

<section id="problems"><title>일반적인 문제점</title>

    <section><title>잘못된 문자집합 이름</title>

      <p><module>mod_charset_lite</module>를 사용하는 시스템의
      ARP 번역기능이 <directive
      module="mod_charset_lite">CharsetSourceEnc</directive>와
      <directive module="mod_charset_lite">CharsetDefault</directive>의
      파라미터인 문자집합 이름을 처리할 수 있어야 한다. 문자집합
      이름은 표준화되지 않았고, http 헤더에 사용하는 값과 항상
      같지는 않다. 현재 APR은 iconv(3)만을 사용하기때문에,
      다음과 같이 iconv(1) 프로그램을 사용하여 특정 문자집합
      이름을 사용할 수 있는지 쉽게 알 수 있다:</p>

      <example>
        iconv -f charsetsourceenc-value -t charsetdefault-value
      </example>
    </section>

    <section><title>내용과 변환규칙의 문자집합이 서로 다름</title>

      <p>변환규칙이 상황에 맞지않으면 다음과 같은 여러 방식으로
      변환이 실패할 수 있다:</p>

      <ul>
      <li>변환기능이 실패 반환코드를 반환하고 연결이 끊어질
      수 있다.</li>

      <li>입력버퍼를 변환하지 못할때 출력버퍼에 대신 특별한
      문자를 (예, 물음표) 적을 수 있다.</li>
      </ul>
    </section>
</section>

<directivesynopsis>
<name>CharsetSourceEnc</name>
<description>파일 원본의 문자집합</description>
<syntax>CharsetSourceEnc <var>charset</var></syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context>
</contextlist>
<override>FileInfo</override>

<usage>
    <p><directive>CharsetSourceEnc</directive> 지시어는 지시어를
    사용한 위치에 있는 파일들 원본의 문자집합을 지정한다.</p>

    <p><var>charset</var> 아규먼트에는 APR이 지원하는 문자집합
    이름을 사용해야 한다. 일반적으로 iconv가 지원하는 문자집합을
    의미한다.</p>
    
    <example><title>예제</title>
      &lt;Directory /export/home/trawick/apacheinst/htdocs/convert&gt;<br />
      <indent>
        CharsetSourceEnc  UTF-16BE<br />
        CharsetDefault    ISO-8859-1<br />
      </indent>
      &lt;/Directory&gt;
    </example>

    <p>Solaris 8의 iconv가 이 예제의 문자집합을 지원한다.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CharsetDefault</name>
<description>변환할 문자집합</description>
<syntax>CharsetDefault <var>charset</var></syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context>
</contextlist>
<override>FileInfo</override>

<usage>
    <p><directive>CharsetDefault</directive> 지시어는 지시어를
    사용한 위치에 있는 원본을 변환할 문자집합을 지정한다.</p>

    <p><var>charset</var> 아규먼트에는 APR이 지원하는 문자집합
    이름을 사용해야 한다. 일반적으로 iconv가 지원하는 문자집합을
    의미한다.</p>

    <example><title>예제</title>
      &lt;Directory /export/home/trawick/apacheinst/htdocs/convert&gt;<br />
      <indent>
        CharsetSourceEnc  UTF-16BE<br />
        CharsetDefault    ISO-8859-1<br />
      </indent>
      &lt;/Directory&gt;
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CharsetOptions</name>
<description>문자집합 변환 기능을 설정</description>
<syntax>CharsetOptions <var>option</var> [<var>option</var>] ...</syntax>
<default>CharsetOptions DebugLevel=0 NoImplicitAdd</default>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context>
</contextlist>
<override>FileInfo</override>

<usage>
    <p><directive>CharsetOptions</directive> 지시어는
    <module>mod_charset_lite</module>의 기능을 설정한다.
    <var>Option</var>에는 아래 항목들을 사용할 수 있다</p>

    <dl>
      <dt><code>DebugLevel=<var>n</var></code></dt>

      <dd><code>DebugLevel</code> 키워드는
      <module>mod_charset_lite</module>가 기록하는 디버그문구의
      수준을 설정한다. 기본적으로 어떤 것도 기록하지 않는다.
      이는 <code>DebugLevel=0</code>과 같다. 높은 숫자를 사용할수록
      더 많은 디버그문구를 기록하게되어 서버 성능이 떨어진다.
      숫자값의 실제 의미는 <code>mod_charset_lite.c</code> 앞부분의
      DBGLVL_ 상수 정의를 참고하라.</dd>

      <dt><code>ImplicitAdd | NoImplicitAdd</code></dt>

      <dd><code>ImplicitAdd</code> 키워드는 내용을 변환할
      문자집합을 지정하면 자동으로 <module>mod_charset_lite</module>를
      필터에 추가한다. <directive module="mod_mime"
      >AddOutputFilter</directive> 지시어로 필터순서를 직접
      지정한다면, <code>NoImplicitAdd</code>를 사용하여
      <module>mod_charset_lite</module>가 자동으로 필터에
      추가되지않도록 해야 한다.</dd>
    </dl>
</usage>
</directivesynopsis>

</modulesynopsis>