mirror of
https://github.com/apache/httpd.git
synced 2025-11-03 17:53:20 +03:00
b0902b5782
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@101681 13f79535-47bb-0310-9956-ffa450edef68
839 lines
32 KiB
XML
839 lines
32 KiB
XML
<?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: 1.15 -->
|
|
<modulesynopsis metafile="mod_autoindex.xml.meta">
|
|
<name>mod_autoindex</name>
|
|
|
|
<description>자동으로 유닉스의 <code>ls</code> 명령어나 Win32의
|
|
<code>dir</code> 쉘명령어와 유사한 디렉토리 목록을 만든다</description>
|
|
<status>Base</status>
|
|
<sourcefile>mod_autoindex.c</sourcefile>
|
|
<identifier>autoindex_module</identifier>
|
|
|
|
<summary>
|
|
<p>디렉토리 목록은 얻는 방법은 두가지다:</p>
|
|
|
|
<ul>
|
|
<li>보통 <code>index.html</code>이란 이름으로 사용자가
|
|
작성한 파일. 이 파일의 이름은 <directive
|
|
module="mod_dir">DirectoryIndex</directive> 지시어로
|
|
지정한다. 이 작업은 <module>mod_dir</module>이 한다.</li>
|
|
|
|
<li>아니면 서버가 목록을 만든다. 이 목록의 형식을 지정하는
|
|
지시어들이 있다. <directive
|
|
module="mod_autoindex">AddIcon</directive>, <directive
|
|
module="mod_autoindex">AddIconByEncoding</directive>,
|
|
<directive module="mod_autoindex">AddIconByType</directive>은
|
|
여러 파일종류마다 보여줄 아이콘들을 지정한다. 각 파일에
|
|
대응하는 첫번째 아이콘을 보인다. 이 작업을
|
|
<module>mod_autoindex</module>가 한다.</li>
|
|
</ul>
|
|
<p>이 두 기능은 서로 별개로, 원한다면 자동 목록 생성을 완전히
|
|
제외할 (혹은 대체할) 수 있다.</p>
|
|
|
|
<p>자동 목록 생성은 <code>Options +Indexes</code>로 가능하다.
|
|
자세한 내용은 <directive module="core">Options</directive>
|
|
지시어를 참고하라.</p>
|
|
|
|
<p><directive module="mod_autoindex">IndexOptions</directive>
|
|
지시어에 <code><a href="#indexoptions.fancyindexing"
|
|
>FancyIndexing</a></code> 옵션을 주면, 열 이름을 출력할
|
|
순서를 바꾸는 링크로 만든다. 이름 링크를 선택하면 그 열의
|
|
값 순서로 목록을 다시 만든다. 같은 이름을 반복해서 선택하면
|
|
오름차순과 내림차순 사이를 오간다. <directive
|
|
module="mod_autoindex">IndexOptions</directive> 지시어의
|
|
<code>SuppressColumnSorting</code> 옵션은 이런 열 이름 링크를
|
|
만들지 않는다.</p>
|
|
|
|
<p>"Size(크기)" 순으로 볼때 출력되는 값 순서가 아니라 <em>실제</em>
|
|
파일크기 순서임을 주의하라. 즉, 1010 바이트 파일과 1011
|
|
바이트 파일은 둘다 "1K"로 보이더라도 항상 1010 바이트 파일이
|
|
앞에 나온다.</p>
|
|
</summary>
|
|
|
|
<section id="query">
|
|
<title>Autoindex 요청 아규먼트</title>
|
|
|
|
<p>아파치 2.0.23는 열순서에 대한 요청 아규먼트를 정리하고,
|
|
새로운 옵션들을 추가했다. 출력을 클라이언트가 조절할 수
|
|
없도록 만드는 <code><a
|
|
href="#indexoptions.ignoreclient">IndexOptions
|
|
IgnoreClient</a></code> 옵션이 추가되었다.</p>
|
|
|
|
<p>열순서 이름은 아래 나온 순서 요청 옵션을 더한 자기참조
|
|
링크다. 아래 옵션은 디렉토리 자원에 대한 어떤 요청에도
|
|
사용할 수 있다.</p>
|
|
|
|
<ul>
|
|
<li><code>C=N</code>은 파일명 순이다</li>
|
|
|
|
<li><code>C=M</code>은 최근 수정일 순, 그리고 파일명 순이다</li>
|
|
|
|
<li><code>C=S</code>는 크기 순, 그리고 파일명 순이다</li>
|
|
|
|
<li class="separate"><code>C=D</code>는 설명 순, 그리고 파일명
|
|
순이다</li>
|
|
|
|
<li><code>O=A</code>는 오름차순으로 목록을 정렬한다</li>
|
|
|
|
<li class="separate"><code>O=D</code>는 내림차순으로 목록을 정렬한다</li>
|
|
|
|
<li><code>F=0</code>은 (FancyIndexed가 아닌) 간단한 목록 형식이다</li>
|
|
|
|
<li><code>F=1</code>은 FancyIndexed 목록 형식이다</li>
|
|
|
|
<li class="separate"><code>F=2</code>는 HTMLTable FancyIndexed 목록
|
|
형식이다</li>
|
|
|
|
<li><code>V=0</code>은 버전 순으로 정렬하지 않는다</li>
|
|
|
|
<li class="separate"><code>V=1</code>은 버전 순으로 정렬한다</li>
|
|
|
|
<li><code>P=<var>pattern</var></code>은 주어진 <var>pattern</var>에
|
|
해당하는 파일만을 목록으로 만든다</li>
|
|
</ul>
|
|
|
|
<p>'P'attern 아규먼트는 일반적인 <directive module="mod_autoindex"
|
|
>IndexIgnore</directive> 지시어를 처리한 <em>후에</em>
|
|
검사하기때문에, 목록은 다른 autoindex 조건을 따름을 주의하라.
|
|
<module>mod_autoindex</module>의 요청 아규먼트를 읽어들일때
|
|
알 수 없는 옵션을 발견하면 더 이상 읽지않는다. 요청 아규먼트는
|
|
위의 표에 따라 만들어야 한다.</p>
|
|
|
|
<p>header.html 파일에 사용할 수 있는 아래 간단한 예제는
|
|
이 옵션들을 설명한다. submit 버턴의 알 수 없는 "X" 아규먼트는
|
|
mod_autoindex가 X=Go 전까지 모든 아규먼트를 읽어들임을
|
|
확인하기위해 마지막에 사용했다.</p>
|
|
|
|
<example>
|
|
<form action="" method="get"><br />
|
|
<indent>
|
|
Show me a <select name="F"><br />
|
|
<indent>
|
|
<option value="0"> Plain list</option><br />
|
|
<option value="1" selected="selected"> Fancy list</option><br />
|
|
<option value="2"> Table list</option><br />
|
|
</indent>
|
|
</select><br />
|
|
Sorted by <select name="C"><br />
|
|
<indent>
|
|
<option value="N" selected="selected"> Name</option><br />
|
|
<option value="M"> Date Modified</option><br />
|
|
<option value="S"> Size</option><br />
|
|
<option value="D"> Description</option><br />
|
|
</indent>
|
|
</select><br />
|
|
<select name="O"><br />
|
|
<indent>
|
|
<option value="A" selected="selected"> Ascending</option><br />
|
|
<option value="D"> Descending</option><br />
|
|
</indent>
|
|
</select><br />
|
|
<select name="V"><br />
|
|
<indent>
|
|
<option value="0" selected="selected"> in Normal order</option><br />
|
|
<option value="1"> in Version order</option><br />
|
|
</indent>
|
|
</select><br />
|
|
Matching <input type="text" name="P" value="*" /><br />
|
|
<input type="submit" name="X" value="Go" /><br />
|
|
</indent>
|
|
</form>
|
|
</example>
|
|
|
|
</section>
|
|
|
|
<directivesynopsis>
|
|
<name>AddAlt</name>
|
|
<description>파일명으로 선택한 아이콘대신 사용할 파일 설명글</description>
|
|
<syntax>AddAlt <var>string</var> <var>file</var> [<var>file</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>AddAlt</directive>는 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>에서
|
|
파일에 대한 아이콘대신 보일 글을 지정한다. <var>File</var>에는
|
|
설명할 파일의 파일 확장자, 파일명 일부, 와일드카드 표현,
|
|
전체 파일명을 사용할 수 있다. <var>String</var>에 공백이
|
|
들어간다면 따옴표(<code>"</code> 혹은 <code>'</code>)로
|
|
묶어야 한다. 클라이언트가 이미지를 볼 수 없거나, 이미지를
|
|
읽지않거나, 아이콘을 못 얻은 경우 이 추가 글이 보이게 된다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddAlt "PDF file" *.pdf<br />
|
|
AddAlt Compressed *.gz *.zip *.Z
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>AddAltByEncoding</name>
|
|
<description>MIME-encoding으로 선택한 아이콘대신 사용할 파일
|
|
설명글</description>
|
|
<syntax>AddAltByEncoding <var>string</var> <var>MIME-encoding</var>
|
|
[<var>MIME-encoding</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>AddAltByEncoding</directive>은 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>에서
|
|
파일에 대한 아이콘대신 보일 글을 지정한다. <var>MIME-encoding</var>은
|
|
<code>x-compress</code>와 같은 유효한 content-encoding이다.
|
|
<var>String</var>에 공백이 들어간다면 따옴표(<code>"</code>
|
|
혹은 <code>'</code>)로 묶어야 한다. 클라이언트가 이미지를
|
|
볼 수 없거나, 이미지를 읽지않거나, 아이콘을 못 얻은 경우
|
|
이 추가 글이 보이게 된다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddAltByEncoding gzip x-gzip
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>AddAltByType</name>
|
|
<description>MIME content-type으로 선택한 아이콘대신 사용할 파일
|
|
설명글</description>
|
|
<syntax>AddAltByType <var>string</var> <var>MIME-type</var>
|
|
[<var>MIME-type</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>AddAltByType</directive>은 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>에서
|
|
파일에 대한 아이콘대신 보일 글을 지정한다. <var>MIME-type</var>은
|
|
<code>text/html</code>과 같은 유효한 content-type이다.
|
|
<var>String</var>에 공백이 들어간다면 따옴표(<code>"</code>
|
|
혹은 <code>'</code>)로 묶어야 한다. 클라이언트가 이미지를
|
|
볼 수 없거나, 이미지를 읽지않거나, 아이콘을 못 얻은 경우
|
|
이 추가 글이 보이게 된다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddAltByType 'plain text' text/plain
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>AddDescription</name>
|
|
<description>파일에 대한 설명</description>
|
|
<syntax>AddDescription <var>string file</var> [<var>file</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p>이 지시어는 <code><a href="#indexoptions.fancyindexing"
|
|
>FancyIndexing</a></code>에서 파일에 대한 설명을 지정한다.
|
|
<var>File</var>에는 설명할 파일의 파일 확장자, 파일명 일부,
|
|
와일드카드 표현, 전체 파일명을 사용할 수 있다. <var>String</var>은
|
|
따옴표(<code>"</code>)로 묶어야 한다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddDescription "The planet Mars" /web/pics/mars.gif
|
|
</example>
|
|
|
|
<p>전형적인 기본 설명 필드폭은 23 바이트다. <code><a
|
|
href="#indexoptions.suppressicon">IndexOptions
|
|
SuppressIcon</a></code> 옵션을 사용하면 기본폭에 6 바이트를
|
|
더 추가하고, <code><a href="#indexoptions.suppresssize"
|
|
>IndexOptions SuppressSize</a></code> 옵션은 7 바이트를,
|
|
<code><a href="#indexoptions.suppresslastmodified"
|
|
>IndexOptions SuppressLastModified</a></code> 옵션은 19
|
|
바이트를 더 추가한다. 그러므로 가장 넓은 설명폭은 55 바이트다.</p>
|
|
|
|
<p>이 필드의 폭를 바꾸거나 설명의 길이를 무한대로 만드려면
|
|
<a href="#indexoptions.descriptionwidth"
|
|
>DescriptionWidth</a> <directive module="mod_autoindex"
|
|
>IndexOptions</directive> 키워드를 참고하라.</p>
|
|
|
|
<note><title>조심</title>
|
|
<p><directive>AddDescription</directive>으로 지정한 설명글에
|
|
태그나 character entity<transnote>&lt;, &amp; 등을
|
|
지칭</transnote>같은 HTML을 사용할 수 있다. 그러나 폭때문에
|
|
태그가 있는 부분이 짤리게되면 (예를 들어 굵은체 부분 끝이
|
|
짤리면) 나머지 디렉토리 목록에 영향을 줄 수 있다.</p>
|
|
</note>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>AddIcon</name>
|
|
<description>이름으로 선택한 파일에 사용할 아이콘</description>
|
|
<syntax>AddIcon <var>icon</var> <var>name</var> [<var>name</var>]
|
|
...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p>이 지시어는 <code><a href="#indexoptions.fancyindexing"
|
|
>FancyIndexing</a></code>에서 <var>name</var>으로 끝나는
|
|
파일 옆에 보여줄 아이콘을 지정한다. <var>Icon</var>은
|
|
아이콘의 (%-escaped) 상대 URL 혹은
|
|
<code>(<var>alttext</var>,<var>url</var>)</code> 형식이다.
|
|
여기서 <var>alttext</var>는 그림을 보여줄 수 없는 브라우저가
|
|
아이콘대신 사용할 문구이다.</p>
|
|
|
|
<p><var>Name</var>에는 디렉토리를 나타내는 <code>^^DIRECTORY^^</code>,
|
|
(목록 형식을 올바로 맞추기위해) 빈줄을 나타내는
|
|
<code>^^BLANKICON^^</code>, 파일 확장자, 와일드카드 표현,
|
|
파일명 일부 혹은 전체를 사용할 수 있다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br />
|
|
AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
|
|
AddIcon /icons/backup.xbm *~
|
|
</example>
|
|
|
|
<p>가능하면 <directive>AddIcon</directive>보다는 <directive
|
|
module="mod_autoindex">AddIconByType</directive>을 사용해야 한다.</p>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>AddIconByEncoding</name>
|
|
<description>MIME content-encoding으로 선택한 파일에 사용할 아이콘</description>
|
|
<syntax>AddIconByEncoding <var>icon</var> <var>MIME-encoding</var>
|
|
[<var>MIME-encoding</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p>이 지시어는 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>에서
|
|
파일 옆에 보여줄 아이콘을 지정한다. <var>Icon</var>은
|
|
아이콘의 (%-escaped) 상대 URL 혹은
|
|
<code>(<var>alttext</var>,<var>url</var>)</code> 형식이다.
|
|
여기서 <var>alttext</var>는 그림을 보여줄 수 없는 브라우저가
|
|
아이콘대신 사용할 문구이다.</p>
|
|
|
|
<p><var>MIME-encoding</var>는 content-encoding에 해당하는
|
|
와일드카드 표현이다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddIconByEncoding /icons/compress.xbm x-compress
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>AddIconByType</name>
|
|
<description>MIME content-type으로 선택한 파일에 사용할 아이콘</description>
|
|
<syntax>AddIconByType <var>icon</var> <var>MIME-type</var>
|
|
[<var>MIME-type</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p>이 지시어는 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>에서
|
|
<var>MIME-type</var>의 파일 옆에 보여줄 아이콘을 지정한다.
|
|
<var>Icon</var>은 아이콘의 (%-escaped) 상대 URL 혹은
|
|
<code>(<var>alttext</var>,<var>url</var>)</code> 형식이다.
|
|
여기서 <var>alttext</var>는 그림을 보여줄 수 없는 브라우저가
|
|
아이콘대신 사용할 문구이다.</p>
|
|
|
|
<p><var>MIME-type</var>은 mime type에 해당하는 와일드카드
|
|
표현이다.</p>
|
|
|
|
<example><title>예제</title>
|
|
AddIconByType (IMG,/icons/image.xbm) image/*
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>DefaultIcon</name>
|
|
<description>특정 아이콘을 설정하지않은 파일에 사용할 아이콘</description>
|
|
<syntax>DefaultIcon <var>url-path</var></syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>DefaultIcon</directive> 지시어는 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>에서
|
|
특정 아이콘을 설정하지않은 파일 옆에 나올 아이콘이다.
|
|
<var>Icon</var>은 아이콘의 (%-escaped) 상대 URL이다.</p>
|
|
|
|
<example><title>예제</title>
|
|
DefaultIcon /icon/unknown.xbm
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>HeaderName</name>
|
|
<description>파일목록 위에 삽입할 파일의 이름</description>
|
|
<syntax>HeaderName <var>filename</var></syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>HeaderName</directive> 지시어는 파일목록 앞에
|
|
삽입할 파일의 이름을 지정한다. <var>Filename</var>은 삽입할
|
|
파일명이다.</p>
|
|
|
|
<example><title>예제</title>
|
|
HeaderName HEADER.html
|
|
</example>
|
|
|
|
<note>
|
|
<p>현재 HeaderName과 <directive
|
|
module="mod_autoindex">ReadmeName</directive> 둘 모두
|
|
<var>Filename</var>을 접근하려는 디렉토리의 상대 URI 경로로
|
|
받아들인다. <var>Filename</var>이 슬래쉬로 시작하면 <directive
|
|
module="core">DocumentRoot</directive>에 상대적인 경로로
|
|
받아들인다.</p>
|
|
|
|
<example><title>예제</title>
|
|
HeaderName /include/HEADER.html
|
|
</example>
|
|
|
|
<p><var>Filename</var>에는 major content type이 <code>text/*</code>인
|
|
(<em>예를 들어</em>, <code>text/html</code>, <code>text/plain</code>,
|
|
등) 문서를 사용해야 한다. 즉, 스크립트의 (출력이 아닌) 실제 파일
|
|
type을 다음과 같이 <code>text/html</code>로 지정한다면
|
|
<var>filename</var>으로 CGI 스크립트를 지정할 수도 있다:</p>
|
|
|
|
<example>
|
|
AddType text/html .cgi
|
|
</example>
|
|
|
|
<p><directive module="core">Options</directive>
|
|
<code>MultiViews</code>을 사용하면 <a
|
|
href="../content-negotiation.html">내용협상</a>을 한다.
|
|
<var>filename</var>이 (CGI 스크립트가 아닌) 고정된
|
|
<code>text/html</code> 문서이고 <directive
|
|
module="core">options</directive> <code>Includes</code>나
|
|
<code>IncludesNOEXEC</code> 중 하나를 사용한다면 파일을
|
|
server-side includes로 처리한다. (<module>mod_include</module>
|
|
문서 참고)</p>
|
|
</note>
|
|
|
|
<p><directive>HeaderName</directive>으로 지정한 파일에
|
|
(<html>, <head>, 등) HTML 문서 시작부분이 포함되있다면
|
|
<a href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions
|
|
+SuppressHTMLPreamble</code></a>을 사용하여 이 부분을 추가하지않는
|
|
것이 좋다.</p>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>IndexIgnore</name>
|
|
<description>디렉토리 목록에서 숨길 파일목록을 추가한다</description>
|
|
<syntax>IndexIgnore <var>file</var> [<var>file</var>] ...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>IndexIgnore</directive> 지시어는 디렉토리
|
|
목록에서 감출 파일목록을 추가한다. <var>File</var>에는 감출
|
|
파일의 확장자, 파일명 일부, 화일드카드 표현, 전체 파일명을
|
|
사용할 수 있다. 여러 IndexIgnore 지시어를 사용하면 기존의
|
|
감출 파일목록을 대체하지않고 목록에 지정한 파일들을 추가한다.
|
|
기본적으로 목록은 <code>.</code>을 (현재 디렉토리) 포함한다.</p>
|
|
|
|
<example>
|
|
IndexIgnore README .htaccess *~
|
|
</example>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>IndexOptions</name>
|
|
<description>디렉토리 목록의 여러 설정들</description>
|
|
<syntax>IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>]
|
|
...</syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>IndexOptions</directive> 지시어는 디렉토리
|
|
목록을 설정한다. <var>Option</var>은 다음 중 하나이다</p>
|
|
|
|
<dl>
|
|
<dt><a name="indexoptions.descriptionwidth"
|
|
id="indexoptions.descriptionwidth"
|
|
>DescriptionWidth=[<var>n</var> | *]</a> (<em>아파치
|
|
2.0.23 이후</em>)</dt>
|
|
|
|
<dd><code>DescriptionWidth</code> 키워드를 사용하여 문자단위로
|
|
설명열의 폭을 지정할 수 있다.</dd>
|
|
|
|
<dd><code>-DescriptionWidth</code>를 지정하면 (혹은 아무것도
|
|
지정하지않으면) <module>mod_autoindex</module>가 최적의
|
|
폭을 계산한다.</dd>
|
|
|
|
<dd><code>DescriptionWidth=<var>n</var></code>은 열의
|
|
폭을 <var>n</var> 바이트로 고정한다.</dd>
|
|
|
|
<dd><code>DescriptionWidth=*</code>은 열의 폭을 가장 긴
|
|
설명글을 담을 수 있는만큼 늘린다.</dd>
|
|
|
|
<dd><strong>설정이 짤릴 수 있는 문제는 <directive
|
|
module="mod_autoindex">AddDescription</directive>
|
|
절을 참고하라.</strong></dd>
|
|
|
|
<dt><a name="indexoptions.fancyindexing"
|
|
id="indexoptions.fancyindexing">FancyIndexing</a></dt>
|
|
|
|
<dd>디렉토리의 fancy 목록을 만든다.</dd>
|
|
|
|
<dt><a name="indexoptions.foldersfirst"
|
|
id="indexoptions.foldersfirst">FoldersFirst</a>
|
|
(<em>아파치 2.0.23 이후</em>)</dt>
|
|
|
|
<dd>이 옵션을 사용하면 하위디렉토리 목록이 <em>항상</em>
|
|
먼저 나오고, 디렉토리에 있는 일반 파일이 뒤에 나온다.
|
|
기본적으로 목록은 파일과 하위디렉토리로 나뉘고, 따로
|
|
각각의 순서를 정리하여 하위디렉토리들을 먼저 보인다.
|
|
예를 들어, 이름 역순으로 정렬하고 <code>FoldersFirst</code>를
|
|
사용한다면 하위디렉토리 <code>Zed</code>가 하위디렉토리
|
|
<code>Beta</code> 앞에 나오고, 하위디렉토리 <code>Beta</code>는
|
|
일반 파일 <code>Gamma</code>와 <code>Alpha</code> 앞에
|
|
나온다. <strong>이 옵션은 <a href="#indexoptions.fancyindexing"
|
|
><code>FancyIndexing</code></a>을 함께 사용할때만 효과가
|
|
있다.</strong></dd>
|
|
|
|
<dt><a name="indexoptions.htmltable"
|
|
id="indexoptions.htmltable">HTMLTable</a> (<em>실험적,
|
|
아파치 2.0.23 이후</em>)</dt>
|
|
|
|
<dd>이 실험적인 FancyIndexing 옵션은 간단한 HTML 표로
|
|
fancy 디렉토리 목록을 만든다. 이 옵션은 오래된 브라우저를
|
|
혼란스럽게 할 수 있음을 주의하라. 이 옵션은 WinNT나 다른
|
|
utf-8 사용 플래폼에서 파일명이나 설명문의 읽기 순서(왼쪽에서
|
|
오른쪽 혹은 오른쪽에서 왼쪽으로)가 다를때 특별히 유용하다.</dd>
|
|
|
|
<dt><a name="indexoptions.iconsarelinks"
|
|
id="indexoptions.iconsarelinks">IconsAreLinks</a></dt>
|
|
|
|
<dd>fancy 목록에서 파일명 링크에 아이콘을 포함한다.</dd>
|
|
|
|
<dt><a name="indexoptions.iconheight"
|
|
id="indexoptions.iconheight">IconHeight[=<var
|
|
>pixels</var>]</a></dt>
|
|
|
|
<dd>이 옵션을 IconWidth와 같이 사용하면 서버는 파일 아이콘의
|
|
<code>img</code> 태그에 <code>height</code>와 <code>width</code>
|
|
속성을 포함한다. 그러면 브라우저는 모든 이미지를 받지않은
|
|
상황에서도 페이지 구성을 미리 계산할 수 있다. 옵션에 값을
|
|
주지않으면 아파치가 제공하는 아이콘의 표준 높이를 사용한다.</dd>
|
|
|
|
<dt><a name="indexoptions.iconwidth"
|
|
id="indexoptions.iconwidth">IconWidth[=<var
|
|
>pixels</var>]</a></dt>
|
|
|
|
<dd>이 옵션을 <code>IconHeight</code>와 같이 사용하면
|
|
서버는 파일 아이콘의 <code>img</code> 태그에
|
|
<code>height</code>와 <code>width</code> 속성을 포함한다.
|
|
그러면 브라우저는 모든 이미지를 박지않은 상황에서도 페이지
|
|
구성을 미리 계산할 수 있다. 옵션에 값을 주지않으면 아파치가
|
|
제공하는 아이콘의 표준 폭을 사용한다.</dd>
|
|
|
|
<dt><a name="indexoptions.ignorecase"
|
|
id="indexoptions.ignorecase">IgnoreCase</a></dt>
|
|
|
|
<dd>이 옵션을 사용하면 대소문자 구별하지않고 이름을 정렬한다.
|
|
예를 들어, 이름으로 오름차순이고 IgnoreCase를 사용하면
|
|
파일 Zeta는 파일 alfa 뒤에 나온다 (주의: 파일 GAMMA는
|
|
항상 파일 gamma 앞에 나온다). </dd>
|
|
|
|
<dt><a name="indexoptions.ignoreclient"
|
|
id="indexoptions.ignoreclient">IgnoreClient</a></dt>
|
|
|
|
<dd>이 옵션을 사용하면 <module>mod_autoindex</module>는
|
|
순서를 포함하여 클라이언트가 보내는 모든 질의변수를 무시한다.
|
|
(<code><a href="#indexoptions.suppresscolumnsorting"
|
|
>SuppressColumnSorting</a></code>을 가정한다.)</dd>
|
|
|
|
<dt><a name="indexoptions.namewidth"
|
|
id="indexoptions.namewidth">NameWidth=[<var>n</var>
|
|
| *]</a></dt>
|
|
|
|
<dd><code>NameWidth</code> 키워드는 바이트단위로 파일명
|
|
열의 폭을 지정한다.</dd>
|
|
|
|
<dd><code>-NameWidth</code>을 지정하면 (혹은 아무것도
|
|
지정하지않으면) <module>mod_autoindex</module>가 최적의
|
|
폭을 계산한다.</dd>
|
|
|
|
<dd><code>NameWidth=<var>n</var></code>는 열의 폭을 <var>n</var>
|
|
바이트로 고정한다.</dd>
|
|
|
|
<dd><code>NameWidth=*</code>은 열의 폭을 필요한만큼 늘린다.</dd>
|
|
|
|
<dt><a name="indexoptions.scanhtmltitles"
|
|
id="indexoptions.scanhtmltitles">ScanHTMLTitles</a></dt>
|
|
|
|
<dd>fancy 목록에서 HTML 문서의 title을 뽑는다. 파일에
|
|
<directive module="mod_autoindex">AddDescription</directive>로
|
|
지정한 설명이 없다면 웹서버는 문서의 <code>title</code>
|
|
요소값을 읽어들인다. 이 작업은 CPU와 디스크를 많이 사용한다.</dd>
|
|
|
|
<dt><a name="indexoptions.suppresscolumnsorting"
|
|
id="indexoptions.suppresscolumnsorting"
|
|
>SuppressColumnSorting</a></dt>
|
|
|
|
<dd>이 옵션을 사용하면 아파치는 FancyIndexed 디렉토리
|
|
목록에서 열 이름을 순서를 바꾸는 링크로 만들지 않는다.
|
|
보통은 열 이름을 링크로 만들어서, 열 이름을 선택하면 그
|
|
열에 있는 값순서로 디렉토리 목록을 만든다. <strong>아파치
|
|
2.0.23 이전에는 순서 아규먼트도 읽지 않았다.</strong>
|
|
아파치 2.0.23에서는 <a
|
|
href="#indexoptions.ignoreclient">IndexOptions
|
|
IgnoreClient</a>를 사용하여 순서 아규먼트를 읽지 않는다.</dd>
|
|
|
|
<dt><a name="indexoptions.suppressdescription"
|
|
id="indexoptions.suppressdescription"
|
|
>SuppressDescription</a></dt>
|
|
|
|
<dd>fancy 목록에서 파일 설명을 포함하지 않는다. 기본적으로
|
|
어떤 파일 설명도 정의되있지않고, 이 옵션을 사용하면 23
|
|
문자 공간을 다른 용도로 사용한다. 파일 설명을 지정하는
|
|
방법은 <directive module="mod_autoindex"
|
|
>AddDescription</directive>을 참고하라. 설명열의 크기를
|
|
지정하는 <code><a
|
|
href="#indexoptions.descriptionwidth">DescriptionWidth</a></code>
|
|
옵션도 참고하라.</dd>
|
|
|
|
<dt><a name="indexoptions.suppresshtmlpreamble"
|
|
id="indexoptions.suppresshtmlpreamble"
|
|
>SuppressHTMLPreamble</a></dt>
|
|
|
|
<dd>디렉토리에 <directive
|
|
module="mod_autoindex">HeaderName</directive> 지시어로
|
|
지정한 파일이 있는 경우 모듈은 보통 표준 HTML 시작부분
|
|
(<code><html></code>, <code><head></code>,
|
|
<em>et cetera</em>) 뒤에 파일 내용을 첨가한다. 그러나
|
|
<code>SuppressHTMLPreamble</code> 옵션을 사용하면 처음부터
|
|
header 파일 내용을 포함한다. 이 경우 header 파일에는 적절한
|
|
HTML 명령이 있어야 한다. header 파일이 없다면 일반적인
|
|
시작부분이 만들어진다.</dd>
|
|
|
|
<dt><a name="indexoptions.suppressicon"
|
|
id="indexoptions.suppressicon">SuppressIcon</a>
|
|
(<em>아파치 2.0.23 이후</em>)</dt>
|
|
|
|
<dd>fancy 목록에서 아이콘을 뺀다. <code>SuppressIcon</code>과
|
|
<code>SuppressRules</code>를 같이 사용하면, (FancyIndexed
|
|
목록이 사용한) <code>pre</code> 안에 <code>img</code>와
|
|
<code>hr</code> 요소 사용을 금지한 마지막 표준인 HTML 3.2에
|
|
알맞은 출력이 된다.</dd>
|
|
|
|
<dt><a name="indexoptions.suppresslastmodified"
|
|
id="indexoptions.suppresslastmodified"
|
|
>SuppressLastModified</a></dt>
|
|
|
|
<dd>fancy 목록에서 마지막 수정일을 표시하지 않는다.</dd>
|
|
|
|
<dt><a name="indexoptions.suppressrules"
|
|
id="indexoptions.suppressrules">SuppressRules</a>
|
|
(<em>아파치 2.0.23 이후</em>)</dt>
|
|
|
|
<dd>디렉토리 목록에서 수평줄을 (<code>hr</code> 요소)
|
|
사용하지 않는다. <code>SuppressIcon</code>과
|
|
<code>SuppressRules</code>를 같이 사용하면, (FancyIndexed
|
|
목록이 사용한) <code>pre</code> 안에 <code>img</code>와
|
|
<code>hr</code> 요소 사용을 금지한 마지막 표준인 HTML 3.2에
|
|
알맞은 출력이 된다.</dd>
|
|
|
|
<dt><a name="indexoptions.suppresssize"
|
|
id="indexoptions.suppresssize">SuppressSize</a></dt>
|
|
|
|
<dd>fancy 목록에서 파일크기를 표시하지 않는다.</dd>
|
|
|
|
<dt><a name="indexoptions.trackmodified"
|
|
id="indexoptions.trackmodified">TrackModified</a>
|
|
(<em>아파치 2.0.23 이후</em>)</dt>
|
|
|
|
<dd>디렉토리 목록의 HTTP 헤더에 Last-Modified와 ETag 값을
|
|
포함한다. 이 옵션은 운영체제와 파일시스템에서 적절한 stat()
|
|
결과를 얻을 수 있을때만 유효하다. 유닉스 시스템과 OS2의
|
|
JFS, Win32의 NTFS에서는 가능하다. 예를 들어, OS2와 Win32의
|
|
FAT은 불가능하다. 이 기능을 사용하면 클라이언트나 프록시는
|
|
<code>HEAD</code> 요청을 사용하여 파일목록의 변화를 추적할
|
|
수 있다. 어떤 운영체제는 새로운 파일과 삭제한 파일을 올바로
|
|
추적하지만, 디렉토리에 있는 파일의 크기나 날짜 변화를
|
|
추적하지 못함을 주의하라. <strong>모든 유닉스 플래폼에서
|
|
기존 파일의 크기나 날짜 변화시 Last-Modified 헤더가
|
|
바뀌지않는다.</strong> 이런 변화가 중요하다면 이 옵션을
|
|
사용하지 마라.</dd>
|
|
|
|
<dt><a name="indexoptions.versionsort"
|
|
id="indexoptions.versionsort">VersionSort</a>
|
|
(<em>아파치 2.0a3 이후</em>)</dt>
|
|
|
|
<dd><code>VersionSort</code> 키워드는 버전 번호를 포함한
|
|
파일명을 자연스럽게 정렬한다. 문자 부분은 정상적인 순서를
|
|
정렬하지만, 파일과 설명에 있는 숫자 부분은 숫자값으로
|
|
비교한다.
|
|
|
|
<example><title>예제:</title>
|
|
foo-1.7<br />
|
|
foo-1.7.2<br />
|
|
foo-1.7.12<br />
|
|
foo-1.8.2<br />
|
|
foo-1.8.2a<br />
|
|
foo-1.12
|
|
</example>
|
|
|
|
<p>수가 0으로 시작하면, 그 수를 분수로 취급한다:</p>
|
|
|
|
<example>
|
|
foo-1.001<br />
|
|
foo-1.002<br />
|
|
foo-1.030<br />
|
|
foo-1.04
|
|
</example>
|
|
</dd>
|
|
</dl>
|
|
|
|
<!--
|
|
XXX: we should consider to allow sections inside <usage>
|
|
this would require some xslt changes...
|
|
-->
|
|
<dl><dt>점진적인 IndexOptions</dt>
|
|
<dd>
|
|
<p>아파치 1.3.3에서 <directive>IndexOptions</directive>
|
|
지시어 처리방식이 크게 변화되었다. 특별히:</p>
|
|
|
|
<ul>
|
|
<li>이제 한 디렉토리에 대한 여러
|
|
<directive>IndexOptions</directive> 지시어들을 서로 결합한다.
|
|
다음의 결과는:
|
|
|
|
<example>
|
|
<Directory /foo>
|
|
<indent>
|
|
IndexOptions HTMLTable<br />
|
|
IndexOptions SuppressColumnsorting
|
|
</indent>
|
|
</Directory>
|
|
</example>
|
|
|
|
<p>다음과 같다</p>
|
|
|
|
<example>
|
|
IndexOptions HTMLTable SuppressColumnsorting
|
|
</example>
|
|
</li>
|
|
|
|
<li>(<em>예를 들어</em>, 키워드 앞에 <code>+</code>나
|
|
<code>-</code>를 붙이는) 점진적인 문법이 추가되었다.</li>
|
|
</ul>
|
|
|
|
<p>키워드 앞에 '+'나 '-'가 붙을때마다 해당 키워드가 현재
|
|
(상위 디렉토리에서 상속되었을) <directive>IndexOptions</directive>
|
|
설정에 반영된다. 그러나 앞에 아무것도 없는 키워드를 만나면
|
|
아직까지 상속되거나 점진적으로 변경된 설정을 모두 지운다.
|
|
다음 예제를 살펴보자:</p>
|
|
|
|
<example>
|
|
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
|
|
IndexOptions +SuppressSize
|
|
</example>
|
|
|
|
<p>앞에 아무것도 없는 <code>FancyIndexing</code>이 이전의
|
|
점진적인 설정을 지워버렸지만 설정이 다시 추가되여 결과는
|
|
<code>IndexOptions FancyIndexing +SuppressSize</code>와 같다.</p>
|
|
|
|
<p>특정 디렉토리에 대해 무조건적인
|
|
<directive>IndexOptions</directive>를 설정하려면 키워드
|
|
앞에 <code>+</code>나 <code>-</code>를 사용하지말고
|
|
상속된 설정을 지운다.</p>
|
|
</dd>
|
|
</dl>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>IndexOrderDefault</name>
|
|
<description>디렉토리 목록의 기본 순서를 설정한다</description>
|
|
<syntax>IndexOrderDefault Ascending|Descending
|
|
Name|Date|Size|Description</syntax>
|
|
<default>IndexOrderDefault Ascending Name</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>IndexOrderDefault</directive> 지시어는 <code><a
|
|
href="#indexoptions.fancyindexing">FancyIndexing</a></code>
|
|
목록 옵션과 함께 사용한다. 기본적으로 fancyindexed 디렉토리
|
|
목록은 파일명 오름차순이다. <directive>IndexOrderDefault</directive>는
|
|
이 초기 순서를 변경할 수 있다.</p>
|
|
|
|
<p><directive>IndexOrderDefault</directive>는 두 아규먼트를
|
|
받는다. 첫번째는 순서의 방향을 지시하는 <code>Ascending</code>
|
|
(오른차순) 이나 <code>Descending</code> (내림차순) 중 하나다.
|
|
두번째 아규먼트는 일차 순서를 나타내는 키워드 <code>Name</code>,
|
|
<code>Date</code>, <code>Size</code>, <code>Description</code>
|
|
중 하나다. 이차 순서는 <em>항상</em> 파일명 오름차순이다.</p>
|
|
|
|
<p>이 지시어와 <code><a
|
|
href="#indexoptions.suppresscolumnsorting"
|
|
>SuppressColumnSorting</a></code> 목록 옵션을 같이 사용하면
|
|
특정 순서로만 디렉토리 목록을 만든다. 이 경우 클라이언트는
|
|
다른 순서로 디렉토리 목록을 요청하지 못한다.</p>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>ReadmeName</name>
|
|
<description>파일목록 마지막에 삽입할 파일의 이름</description>
|
|
<syntax>ReadmeName <var>filename</var></syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
<override>Indexes</override>
|
|
|
|
<usage>
|
|
<p><directive>ReadmeName</directive> 지시어는 파일목록 끝에
|
|
삽입할 파일의 이름을 지정한다. <var>Filename</var>은 포함할
|
|
파일명이고, 목록을 만들려는 위치의 상대경로로 받아들인다.
|
|
<var>Filename</var>이 슬래쉬로 시작하면 <directive
|
|
module="core">DocumentRoot</directive>에 상대경로로 받아들인다.
|
|
</p>
|
|
|
|
<example><title>예제</title>
|
|
ReadmeName FOOTER.html
|
|
</example>
|
|
|
|
<example><title>예제 2</title>
|
|
ReadmeName /include/FOOTER.html
|
|
</example>
|
|
|
|
<p>이 동작을 자세히 설명한 <directive module="mod_autoindex"
|
|
>HeaderName</directive>도 참고하라.</p>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
</modulesynopsis>
|