2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
4 <!-- English Revision: 689261:758929 (outdated) -->
5 <!-- =====================================================
6 Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
7 Reviewed by: Orhan Berent <berent belgeler.org>
8 ========================================================== -->
11 Licensed to the Apache Software Foundation (ASF) under one or more
12 contributor license agreements. See the NOTICE file distributed with
13 this work for additional information regarding copyright ownership.
14 The ASF licenses this file to You under the Apache License, Version 2.0
15 (the "License"); you may not use this file except in compliance with
16 the License. You may obtain a copy of the License at
18 http://www.apache.org/licenses/LICENSE-2.0
20 Unless required by applicable law or agreed to in writing, software
21 distributed under the License is distributed on an "AS IS" BASIS,
22 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
23 See the License for the specific language governing permissions and
24 limitations under the License.
27 <modulesynopsis metafile="mod_autoindex.xml.meta">
28 <name>mod_autoindex</name>
30 <description>Unix <code>ls</code> veya Win32 <code>dir</code> kabuk komutunun
31 yaptığı gibi dizin içeriğini listeler.</description>
33 <sourcefile>mod_autoindex.c</sourcefile>
34 <identifier>autoindex_module</identifier>
37 <p>Bir dizin içerik dosyası iki kaynaktan gelebilir:</p>
40 <li>Kullanıcı tarafından yazılmış ve genellikle <code>index.html</code>
41 adında bir dosya olarak. Dosyanın ismi <directive module="mod_dir"
42 >DirectoryIndex</directive> yönergesi ile belirlenir ve
43 <module>mod_dir</module> tarafından denetlenir.</li>
45 <li>Kullanıcı tarafından böyle bir dosya sağlanmadığı takdirde dizin
46 içerik listesini sunucu üretir. Diğer yönergeler bu listenin biçemini
47 belirler. Listede gösterilen dosya türü simgeleri <directive
48 module="mod_autoindex" >AddIcon</directive>, <directive
49 module="mod_autoindex" >AddIconByEncoding</directive> ve <directive
50 module="mod_autoindex" >AddIconByType</directive> yönergeleri ile
51 belirlenir. Bunlar <module>mod_autoindex</module> tarafından
55 <p>İki işlev birbirinden ayrı tutulmuştur, böylece kendiliğinden içerik
56 listesi üretimi tamamen iptal edilebilir (veya değiştirilebilir).</p>
58 <p>Kendiliğinden içerik listesi üretimi <code>Options +Indexes</code> ile
59 etkin kılınabilir. Daha fazla bilgi için <directive module="core"
60 >Options</directive> yönergesinin açıklamasına bakınız.</p>
62 <p><directive module="mod_autoindex">IndexOptions</directive> yönergesi
63 <code><a href="#indexoptions.fancyindexing" >FancyIndexing</a></code>
64 seçeneği ile kullanılmışsa sütun başlıkları listenin sıralamasını
65 sütundaki sıralamaya göre değiştirecek hiper bağlar haline getirilir
66 (süslü liste). Aynı başlığa peşpeşe tıklamak suretiyle sıralamayı
67 büyükten küçüğe veya tersine değiştirebilirsiniz. Bu sütun başlığı
68 bağlarının oluşturulması <directive module="mod_autoindex"
69 >IndexOptions</directive> yönergesi <code><a
70 href="#indexoptions.suppresscolumnsorting"
71 >SuppressColumnSorting</a></code> seçeneği ile kullanılarak
74 <p>Boyuta göre sıralamada daima dosyanın asıl boyutuna bakılır.
75 Dolayısıyla ikisi de "1K" olarak gösterilen iki dosyadan 1010 baytlık
76 olanı küçükten büyüğe sıralamada 1011 baytlıktan önce
81 <title>Sütun Sıralamada Sorgu Seçenekleri</title>
83 <p>Apache 2.0.23’te Sütun Sıralama için Sorgu Seçenekleri yeniden
84 düzenlenip tamamen yeni bir sorgu seçenekleri grubu oluşturulmuştur.
85 Çıktı üzerinde kullanıcı denetimini tamamen ortadan kaldırmak için
86 <directive module="mod_autoindex">IndexOptions</directive> yönergesinin
87 <code><a href="#indexoptions.ignoreclient">IgnoreClient</a></code>
88 seçeneği kullanılabilir.</p>
90 <p>Sütun sıralama başlıklarının her biri hedefi kendisi olan birer hiper
91 bağ olup aşağıda sıralanan sorgu seçeneklerini kullanırlar. Bu
92 seçeneklerin her biri her dizin içerik listesi isteğine eklenebilir.</p>
95 <li><code>C=N</code> dizini dosya adına göre sıralar</li>
97 <li><code>C=M</code> dizini son değişiklik zamanına ve ardından dosya
98 ismine göre sıralar.</li>
100 <li><code>C=S</code> dizini boyuta ve ardından dosya adına göre
103 <li class="separate"><code>C=D</code> dizini açıklamaya ve ardından
104 dosya adına göre sıralar.</li>
106 <li><code>O=A</code> artan sıralama uygulanır.</li>
108 <li class="separate"><code>O=D</code> azalan sıralama uygulanır.</li>
110 <li><code>F=0</code> listeleme basit listeleme biçiminde yapılır
111 (<code>FancyIndexing</code> seçeneği ile etkinleştirilen biçimde
114 <li><code>F=1</code> listeleme <code>FancyIndexing</code> seçeneği ile
115 etkinleştirilen biçimde yapılır</li>
117 <li class="separate"><code>F=2</code> listeleme <code><a
118 href="#indexoptions.fancyindexing" >FancyIndexing</a></code> ve
119 <code><a href="#indexoptions.htmltable" >HTMLTable</a></code> seçeneği
120 ile etkinleştirilen biçimde yapılır.</li>
122 <li><code>V=0</code> sürüme göre sıralama iptal edilir.</li>
124 <li class="separate"><code>V=1</code> sürüme göre sıralama etkin
127 <li><code>P=<var>kalıp</var></code> sadece belirtilen
128 <code><em>kalıp</em></code> ile eşleşen dosyalar istelenir.</li>
131 <p><code>P=<var>kalıp</var></code> sorgu seçeneğinin normalde <directive
132 module="mod_autoindex" >IndexIgnore</directive> yönergesi işleme
133 sokulduktan sonra değerlendirildiğine ve dosya isimlerinin diğer
134 kendiliğinden içerik listeleme koşullarının konusu olmaya devam ettiğine
135 dikkat ediniz. <module>mod_autoindex</module> modülündeki Sorgu
136 Seçenekleri çözümleyicisi tanımadığı bir seçeneğe rastlar rastlamaz
137 işlemi durdurur. Sorgu Seçenekleri yukarıda belirtilene uygun olarak iyi
138 biçimli olmak zorundadır.</p>
140 <p>Aşağıdaki basit örnekte sorgu seçeneklerinin kullanımı gösterilmiştir.
141 Son satırda bulunan "submit" düğmesindeki tanınmayan "X" girdisine
142 dikkat ediniz. "X=Göster" girdisi tüm seçenekler işlendikten sonra
143 <module>mod_autoindex</module> tarafından son argüman olarak ele
144 alınacak ve çözümleme işlemi o noktada duracaktır.</p>
147 <form action="" method="get">
148 <input type="text" name="P" value="*" /> ile eşleşen
150 <option value="N" selected="selected">isme</option>
151 <option value="M"> değişiklik tarihine</option>
152 <option value="S"> boyuta</option>
153 <option value="D"> açıklamaya</option>
156 <option value="A" selected="selected"> artan</option>
157 <option value="D"> azalan</option>
160 <option value="0" selected="selected">normal</option>
161 <option value="1"> sürümlü</option>
162 </select> sıralamayla bir
164 <option value="0"> basit liste</option>
165 <option value="1" selected="selected"> süslü liste</option>
166 <option value="2"> tablolu liste</option>
168 <input type="submit" name="X" value="Göster" />
176 <description>Dosyaya göre seçilen simgenin yerinde gösterilecek metni belirler.
178 <syntax>AddAlt <var>metin</var> <var>dosya</var> [<var>dosya</var>] ...</syntax>
179 <contextlist><context>server config</context><context>virtual host</context>
180 <context>directory</context><context>.htaccess</context>
182 <override>Indexes</override>
185 <p><directive>AddAlt</directive> yönergesi, <code><a
186 href="#indexoptions.fancyindexing">FancyIndexing</a></code> seçeneğiyle
187 üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
188 metni belirler. <code><em>dosya</em></code> olarak dosya türünü
189 betimleyecek bir dosya uzantısı, dosya isminin bir kısmı, bir dosya ismi
190 kalıbı veya tam yoluyla bir dosya ismi belirtilebilir. Eğer
191 <code><em>metin</em></code> boşluk karakterleri içeriyorsa tırnak içine
192 (<code>"</code> veya <code>'</code>) alınmalıdır. Simge metni, simge
193 bulunamadığı veya istemci resim gösteremediği takdirde ya da kullanıcı
194 resim yüklememeyi tercih etmişse gösterilir.</p>
196 <example><title>Örnekler</title>
197 AddAlt "PDF dosya" *.pdf<br />
198 AddAlt Sıkıştırılmış *.gz *.zip *.Z
204 <name>AddAltByEncoding</name>
205 <description>Dosyanın MIME kodlamasına göre seçilen simgenin yerinde
206 gösterilecek metni belirler.</description>
207 <syntax>AddAltByEncoding <var>metin</var> <var>MIME-kodlaması</var>
208 [<var>MIME-kodlaması</var>] ...</syntax>
209 <contextlist><context>server config</context><context>virtual host</context>
210 <context>directory</context><context>.htaccess</context>
212 <override>Indexes</override>
215 <p><directive>AddAltByEncoding</directive> yönergesi, <code><a
216 href="#indexoptions.fancyindexing">FancyIndexing</a></code> seçeneğiyle
217 üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
218 metni belirler. <code><em>MIME-kodlaması</em></code> olarak
219 <code>x-compress</code> gibi geçerli bir içerik kodlaması
220 belirtilmelidir. Eğer <code><em>metin</em></code> boşluk karakterleri
221 içeriyorsa tırnak içine (<code>"</code> veya <code>'</code>)
222 alınmalıdır. Simge metni simge bulunamadığı veya istemci resim
223 gösteremediği takdirde ya da kullanıcı resim yüklememeyi tercih etmişse
226 <example><title>Örnek</title>
227 AddAltByEncoding gzip x-gzip
233 <name>AddAltByType</name>
234 <description>Dosyanın MIME türüne göre seçilen simgenin yerinde gösterilecek
235 metni belirler.</description>
236 <syntax>AddAltByType <var>metin</var> <var>MIME-türü</var>
237 [<var>MIME-türü</var>] ...</syntax>
238 <contextlist><context>server config</context><context>virtual host</context>
239 <context>directory</context><context>.htaccess</context>
241 <override>Indexes</override>
244 <p><directive>AddAltByType</directive> yönergesi, <code><a
245 href="#indexoptions.fancyindexing">FancyIndexing</a></code> seçeneğiyle
246 üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
247 metni belirler. <code><em>MIME-türü</em></code> olarak
248 <code>text/html</code> gibi geçerli bir içerik türü belirtilmelidir.
249 Eğer <code><em>metin</em></code> boşluk karakterleri içeriyorsa tırnak
250 içine (<code>"</code> veya <code>'</code>) alınmalıdır. Simge metni
251 simge bulunamadığı veya istemci resim gösteremediği takdirde ya da
252 kullanıcı resim yüklememeyi tercih etmişse gösterilir.</p>
254 <example><title>Örnek</title>
255 AddAltByType 'salt metin' text/plain
261 <name>AddDescription</name>
262 <description>Bir dosya için gösterilecek açıklama belirtilir.</description>
263 <syntax>AddDescription <var>metin dosya</var> [<var>dosya</var>] ...</syntax>
264 <contextlist><context>server config</context><context>virtual host</context>
265 <context>directory</context><context>.htaccess</context>
267 <override>Indexes</override>
270 <p>Yönerge, <code><a href="#indexoptions.fancyindexing"
271 >FancyIndexing</a></code> seçeneğiyle üretilen dizin listesinde bir
272 dosya için gösterilecek açıklamayı belirler. <code><em>dosya</em></code>
273 olarak dosya türünü betimleyecek bir dosya uzantısı, dosya isminin bir
274 kısmı, bir dosya ismi kalıbı veya tam yoluyla bir dosya ismi
275 belirtilebilir. Eğer dosya açıklamasını içeren
276 <code><em>metin</em></code> boşluk karakterleri içeriyorsa çift tırnak
277 (<code>"</code>) içine alınmalıdır.</p>
279 <example><title>Örnek</title>
280 AddDescription "Mars Gezegeni" /resimler/mars.gif
283 <p>Normalde öntanımlı açıklama alanının genişliği 23 bayttır. <code><a
284 href="#indexoptions.suppressicon" >IndexOptions SuppressIcon</a></code>
285 seçeneği buna 6 bayt daha ekler; <code><a
286 href="#indexoptions.suppresssize" >IndexOptions SuppressSize</a></code>
287 seçeneği 7 bayt, <code><a href="#indexoptions.suppresslastmodified"
288 >IndexOptions SuppressLastModified</a></code> seçeneği ise 19 bayt
289 ekler. Böylece en fazla 55 karakterlik öntanımlı sütun genişliğine
292 <p>Açıklama sütununun öntanımlı genişliği geçersiz kılınabilir hatta
293 sınırsız açıklama uzunluğu atanabilir. Bu konu için <directive
294 module="mod_autoindex" >IndexOptions</directive> yönergesinin <a
295 href="#indexoptions.descriptionwidth" ><code>DescriptionWidth</code></a>
296 seçeneğinin açıklamasına bakınız.</p>
298 <note><title>Önemli</title>
299 <p><directive>AddDescription</directive> ile tanımlanan açıklama metni
300 HTML etiketleri ve karakter öğeleri içerebilir. Eğer açıklama
301 sütununun genişlik sınırlamasından dolayı bir HTML etiketinin içeriği
302 kırpılırsa bu durum dizin listesinin kalanını etkileyebilir (örneğin,
303 kalın gösterim listenin kalanına yayılabilir).</p>
310 <description>Bir dosya için gösterilecek simgeyi dosya adına göre belirler.
312 <syntax>AddIcon <var>simge</var> <var>isim</var> [<var>isim</var>]
314 <contextlist><context>server config</context><context>virtual host</context>
315 <context>directory</context><context>.htaccess</context>
317 <override>Indexes</override>
320 <p>Yönerge, <code><a href="#indexoptions.fancyindexing"
321 >FancyIndexing</a></code> seçeneğiyle üretilen dizin listesinde adı
322 <code><em>isim</em></code> ile biten bir dosya için gösterilecek simgeyi
323 belirler. <code><em>simge</em></code> ya simgenin göreli URL’si (%
324 öncelemeli) ya da <code>(<var>alt-metin</var>,<var>url</var>)</code>
325 biçeminde olmalıdır; buradaki <code><em>alt-metin</em></code> simge
326 gösterilemediği durumda tarayıcı tarafından simgenin yerinde
327 gösterilecek metindir.</p>
329 <p><code><em>isim</em></code> olarak ya (listeyi düzgün biçemlemek
330 amacıyla) dizinler için <code>^^DIRECTORY^^</code>, boş satırlar için
331 <code>^^BLANKICON^^</code> ya da dosya türünü betimleyecek bir dosya
332 uzantısı, dosya isminin bir kısmı, bir dosya ismi kalıbı veya tam
333 yoluyla bir dosya ismi belirtilebilir.</p>
335 <example><title>Örnekler</title>
336 AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br />
337 AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
338 AddIcon /icons/backup.xbm *~
341 <p>Mümkünse <directive>AddIcon</directive> yerine <directive
342 module="mod_autoindex">AddIconByType</directive> yönergesi tercih
348 <name>AddIconByEncoding</name>
349 <description>Bir dosya için gösterilecek simgeyi dosyanın MIME kodlamasına
350 göre belirler.</description>
351 <syntax>AddIconByEncoding <var>simge</var> <var>MIME-kodlaması</var>
352 [<var>MIME-kodlaması</var>] ...</syntax>
353 <contextlist><context>server config</context><context>virtual host</context>
354 <context>directory</context><context>.htaccess</context>
356 <override>Indexes</override>
359 <p>Yönerge, <code><a href="#indexoptions.fancyindexing"
360 >FancyIndexing</a></code> seçeneğiyle üretilen dizin listesinde bir
361 dosya için gösterilecek simgeyi belirler. <code><em>simge</em></code> ya
362 simgenin göreli URL’si (% öncelemeli) ya da
363 <code>(<var>alt-metin</var>,<var>url</var>)</code> biçeminde olmalıdır;
364 buradaki <code><em>alt-metin</em></code> simge gösterilemediği durumda
365 tarayıcı tarafından simgenin yerinde gösterilecek metindir.</p>
367 <p><code><em>MIME-kodlaması</em></code> olarak <code>x-compress</code>
368 gibi geçerli bir içerik kodlaması belirtilmelidir.</p>
370 <example><title>Örnek</title>
371 AddIconByEncoding /icons/compress.xbm x-compress
377 <name>AddIconByType</name>
378 <description>Bir dosya için gösterilecek simgeyi dosyanın MIME türüne göre
379 belirler.</description>
380 <syntax>AddIconByType <var>simge</var> <var>MIME-türü</var>
381 [<var>MIME-türü</var>] ...</syntax>
382 <contextlist><context>server config</context><context>virtual host</context>
383 <context>directory</context><context>.htaccess</context>
385 <override>Indexes</override>
388 <p>Yönerge, <code><a href="#indexoptions.fancyindexing"
389 >FancyIndexing</a></code> seçeneğiyle üretilen dizin listesinde MIME
390 türü <code><em>MIME-türü</em></code> olarak belirtilen bir dosya için
391 gösterilecek simgeyi belirler. <code><em>simge</em></code> ya simgenin
392 göreli URL’si (% öncelemeli) ya da
393 <code>(<var>alt-metin</var>,<var>url</var>)</code> biçeminde olmalıdır;
394 buradaki <code><em>alt-metin</em></code> simge gösterilemediği durumda
395 tarayıcı tarafından simgenin yerinde gösterilecek metindir.</p>
397 <p><var>MIME-türü</var> MIME türleri ile eşleşen bir dosya kalıbı ifadesi
400 <example><title>Örnek</title>
401 AddIconByType (IMG,/icons/image.xbm) image/*
407 <name>DefaultIcon</name>
408 <description>Özel bir simge atanmamış dosyalar için gösterilecek simgeyi
409 belirler.</description>
410 <syntax>DefaultIcon <var>URL-yolu</var></syntax>
411 <contextlist><context>server config</context><context>virtual host</context>
412 <context>directory</context><context>.htaccess</context>
414 <override>Indexes</override>
417 <p>The <directive>DefaultIcon</directive> yönergesi <code><a
418 href="#indexoptions.fancyindexing" >FancyIndexing</a></code> seçeneğiyle
419 üretilen dizin listesinde özel bir simge atanmamış dosyalar için
420 gösterilecek simgeyi belirler. <code><em>URL-yolu</em></code> simgeye
421 bir göreli URL (% öncelemeli) belirtir.</p>
423 <example><title>Örnek</title>
424 DefaultIcon /icon/unknown.xbm
430 <name>HeaderName</name>
431 <description>Dizin listesinin tepesine yerleştirilecek dosyanın ismini
432 belirler.</description>
433 <syntax>HeaderName <var>dosya-ismi</var></syntax>
434 <contextlist><context>server config</context><context>virtual host</context>
435 <context>directory</context><context>.htaccess</context>
437 <override>Indexes</override>
440 <p><directive>HeaderName</directive> yönergesi, dizin listesinin tepesine
441 yerleştirilecek dosyanın ismini belirler. Dosyanın ismi
442 <code><em>dosya-ismi</em></code> ile belirtilir.</p>
444 <example><title>Örnek</title>
445 HeaderName HEADER.html
449 <p><code>HeaderName</code> and <directive module="mod_autoindex"
450 >ReadmeName</directive> yönergelerinde
451 <code><em>dosya-ismi</em></code> artık içeriği listelenecek dizine
452 erişmek için kullanılan bir göreli URL yolu olarak ele alınmaktadır.
453 Eğer <code><em>dosya-ismi</em></code> bir bölü çizgisi ("/") ile
454 başlıyorsa <directive module="core">DocumentRoot</directive>
455 yönergesinde belirtilen dizine göre belirtildiği varsayılır.</p>
457 <example><title>Örnek</title>
458 HeaderName /include/HEADER.html
461 <p><code><em>dosya-ismi</em></code>, içerik türü <code>text/*</code>
462 (<code>text/html</code>, <code>text/plain</code> gibi) olan bir belge
463 olarak çözümlenmelidir. Yani, aşağıdaki örnekteki gibi betiğin asıl
464 dosya türü <code>text/html</code> olarak imlenmişse
465 <code><em>dosya-ismi</em></code> bir CGI betiğinin ismi bile
469 AddType text/html .cgi
472 <p><directive module="core">Options</directive> ile
473 <code>MultiViews</code> etkin kılınmışsa dosyaya <a
474 href="../content-negotiation.html">içerik dili uzlaşımı</a> da
475 uygulanabilir. <code><em>dosya-ismi</em></code> ile belirtilen dosya
476 <code>text/html</code> türünde durağan bir belge (bir CGI betiği
477 değil) ise ve <directive module="core">options</directive> ile
478 <code>Includes</code> ve <code>IncludesNOEXEC</code> seçeneklerinden
479 biri belirtilmişse dosya bir SSI sayfası olarak ele alınır
480 (<module>mod_include</module> belgesine bakınız).</p>
483 <p>Eğer yönergede belirtilen dosya bir HTML belge gibi başlıyorsa
484 (<html>, <head>, vs.) ve bu etiketlerin yinelenmemesini
485 istiyorsanız <a href="#indexoptions.suppresshtmlpreamble"
486 ><code>IndexOptions +SuppressHTMLPreamble</code></a> ataması yapmanız
492 <name>IndexIgnore</name>
493 <description>Dizin içerik listesinden gizlenecek dosyaların listesi belirtilir.
495 <syntax>IndexIgnore <var>dosya</var> [<var>dosya</var>] ...</syntax>
496 <contextlist><context>server config</context><context>virtual host</context>
497 <context>directory</context><context>.htaccess</context>
499 <override>Indexes</override>
502 <p><directive>IndexIgnore</directive> yönergesi, dizin içerik listesinden
503 gizlenecek dosyaların listesini belirtmek için kullanılır.
504 <code><em>dosya</em></code> olarak kabuk tarzı bir dosya ismi kalıbı
505 veya tam yoluyla bir dosya ismi belirtilebilir. Evvelce yapılmış bir
506 atamada değişiklik yapmak yerine birden fazla
507 <directive>IndexIgnore</directive> ataması yapabilirsiniz. Liste
508 öntanımlı olarak içinde bulunulan dizini (<code>./</code>) içerir.</p>
511 IndexIgnore README .htaccess *.bak *~
517 <name>IndexOptions</name>
518 <description>Dizin içerik listesini yapılandıracak seçenekler belirtilir.
520 <syntax>IndexOptions [+|-]<var>seçenek</var> [[+|-]<var>seçenek</var>]
522 <contextlist><context>server config</context><context>virtual host</context>
523 <context>directory</context><context>.htaccess</context>
525 <override>Indexes</override>
528 <p><directive>IndexOptions</directive> yönergesi dizin içerik listesinin
529 davranışını belirler. <code><em>seçenek</em></code> olarak şunlar
533 <dt><a name="indexoptions.charset" id="indexoptions.charset"
534 ><code>Charset=<em>karakter-kümesi</em></code></a> (<em>Apache 2.0.61
535 ve sonrası</em>)</dt>
537 <dd><code>Charset</code> seçeneği üretilen sayfa için bir karakter
538 kümesi belirtebilmenizi sağlar. Dizinin bulunduğu dosya sisteminin
539 karakter kodlamasına bağlı olarak öntanımlı değeri ya
540 <var>ISO-8859-1</var> ya da <var>UTF-8</var>’dir.
542 <example><title>Örnek</title>
543 IndexOptions Charset=UTF-8
547 <dt><a name="indexoptions.type" id="indexoptions.type"
548 ><code>Type=<em>MIME-türü</em></code></a> (<em>Apache 2.0.61 ve
551 <dd><code>Type</code> seçeneği üretilen sayfa için bir MIME türü
552 belirtebilmenizi sağlar. Öntanımlı değer <var>text/html</var>’dir.
554 <example><title>Örnek</title>
555 IndexOptions Type=text/plain
559 <dt><a name="indexoptions.descriptionwidth"
560 id="indexoptions.descriptionwidth"
561 ><code>DescriptionWidth=[<em>n</em> | *]</code></a>
562 (<em>Apache 2.0.23 ve sonrası</em>)</dt>
564 <dd><p><code>DescriptionWidth</code> seçeneği üretilen sayfada açıklama
565 sütununun genişliğini sizin belirleyebilmenizi sağlar. Bu seçenek
566 kullanılmadığında veya <code>-DescriptionWidth</code> olarak
567 belirtildiğinde uygun genişliği <module>mod_autoindex</module>
570 <p><code>DescriptionWidth=<em>n</em></code> ile açıklama sütununun
571 genişliği <code><em>n</em></code> baytla sınırlanır.</p>
573 <p><code>DescriptionWidth=*</code> ile açıklama sütununun genişliği en
574 uzun açıklama metni sığacak şekilde arttırılır.</p>
576 <p><strong>Sütun genişliğinin sabitliği nedeniyle metnin
577 kırpılmasından kaynaklanan sorunlar için <directive
578 module="mod_autoindex" >AddDescription</directive> yönergesinin
579 açıklamasına bakınız.</strong></p></dd>
581 <dt><a name="indexoptions.fancyindexing"
582 id="indexoptions.fancyindexing"
583 ><code>FancyIndexing</code></a></dt>
585 <dd>Dizin içerik listesi süslü olur.</dd>
587 <dt><a name="indexoptions.foldersfirst"
588 id="indexoptions.foldersfirst"
589 ><code>FoldersFirst</code></a>
590 (<em>Apache 2.0.23 ve sonrası</em>)</dt>
592 <dd>Bu seçenek etkin kılındığında dizin içerik listesinde alt dizinler
593 dosyalardan önce listelenir. Listelemede genel olarak iki bileşen
594 vardır: Alt dizinler ve dosyalar. Her biri kendi arasında sıraya
595 dizilir ve alt dizinlerin tamamı dosyalardan önce gösterilir. Örneğin
596 sıralama isme göre azalan sırada yapılıyorsa ve
597 <code>FoldersFirst</code> etkinse <code>Zed</code> dizini listede
598 <code>Beta</code> dizininden ve <code>Gamma</code> ve
599 <code>Alpha</code> dosyalarından önce yer alacaktır. <strong>Bu
600 seçenek sadece <a href="#indexoptions.fancyindexing"
601 ><code>FancyIndexing</code></a> seçeneği etkinse etkili
602 olacaktır.</strong></dd>
604 <dt><a name="indexoptions.htmltable"
605 id="indexoptions.htmltable"
606 ><code>HTMLTable</code></a>
607 (<em>Deneysel, Apache 2.0.23 ve sonrası</em>)</dt>
609 <dd>Bu deneysel seçenek <a href="#indexoptions.fancyindexing"
610 ><code>FancyIndexing</code></a> seçeneği ile birlikte süslü listeleme
611 için basit bir tablo oluşturur. Fakat bu eski tarayıcıları yanıltır.
612 Bununla birlikte, Linux, WinNT gibi sağdan sola veya soldan sağa yazım
613 yönünün UTF-8 karakter koduna göre değiştiği platformlarda dosya
614 isimleri ve açıklamalar için bu özellikle gerekli olabilir.</dd>
616 <dt><a name="indexoptions.iconsarelinks"
617 id="indexoptions.iconsarelinks"
618 ><code>IconsAreLinks</code></a></dt>
620 <dd>Bu seçenek <a href="#indexoptions.fancyindexing"
621 ><code>FancyIndexing</code></a> seçeneği ile birlikte süslü
622 listelemede dosya simgesini dosyaya bir hiper bağ haline getirir.</dd>
624 <dt><a name="indexoptions.iconheight" id="indexoptions.iconheight"
625 ><code>IconHeight[=<em>benek-sayısı</em>]</code></a></dt>
627 <dd>Bu seçeneğin varlığı <code>IconWidth</code> seçeneği ile
628 kullanıldığında dosya simgesinin <code>img</code> etiketinin
629 <code>height</code> ve <code>width</code> özniteliklerini içermesine
630 sebep olur. Böylece tarayıcının tüm simgelerin yüklenmesini beklemeden
631 sayfa yerleşimi için bir ön hesaplama yapabilmesi mümkün olur. Seçenek
632 bir değer belirtilmeksizin kullanıldığında Apache tarafından atanmış
633 standart simge yüksekliği öntanımlıdır.</dd>
635 <dt><a name="indexoptions.iconwidth" id="indexoptions.iconwidth"
636 ><code>IconWidth[=<em>benek-sayısı</em>]</code></a></dt>
638 <dd>Bu seçeneğin varlığı <code>IconHeight</code> seçeneği ile
639 kullanıldığında dosya simgesinin <code>img</code> etiketinin
640 <code>height</code> ve <code>width</code> özniteliklerini içermesine
641 sebep olur. Böylece tarayıcının tüm simgelerin yüklenmesini beklemeden
642 sayfa yerleşimi için bir ön hesaplama yapabilmesi mümkün olur. Seçenek
643 bir değer belirtilmeksizin kullanıldığında Apache tarafından atanmış
644 standart simge genişliği öntanımlıdır.</dd>
646 <dt><a name="indexoptions.ignorecase" id="indexoptions.ignorecase"
647 ><code>IgnoreCase</code></a></dt>
649 <dd>Bu seçenek etkin kılındığında isimler harf büyüklüğüne duyarsız
650 sıralanır. Örneğin, isme göre artan sıralamada <code>IgnoreCase</code>
651 etkinse Zeta dosyası alfa dosyasından sonra listelenir (Dikkat: GAMMA
652 daima gamma’dan önce listelenir.)</dd>
654 <dt><a name="indexoptions.ignoreclient" id="indexoptions.ignoreclient"
655 ><code>IgnoreClient</code></a></dt>
657 <dd>Bu seçenek <module>mod_autoindex</module>’in listenin sıralanmasına
658 etki edenler dahil tüm sorgu değişkenlerini yoksaymasına sebep olur
659 (örtük olarak <code><a href="#indexoptions.suppresscolumnsorting"
660 >SuppressColumnSorting</a></code> uygulanır).</dd>
662 <dt><a name="indexoptions.namewidth" id="indexoptions.namewidth"
663 ><code>NameWidth=[<em>n</em> | *]</code></a></dt>
665 <dd><p><code>NameWidth</code> seçeneği dosya ismi sütunu için bir
666 genişlik belirtebilmenizi mümkün kılar.</p>
668 <p>Hiç belirtilmediğinde veya <code>-NameWidth</code> biçeminde
669 belirtildiğinde <module>mod_autoindex</module> uygun genişliği kendisi
672 <p><code>NameWidth=<em>n</em></code> ile sütun genişliği
673 <code><em>n</em></code> bayt genişlikte sabitlenir.</p>
675 <p><code>NameWidth=*</code> olduğunda ise sütun genişliği en geniş
676 satırın sığacağı kadar arttırılır.</p></dd>
678 <dt><a name="indexoptions.scanhtmltitles"
679 id="indexoptions.scanhtmltitles"
680 ><code>ScanHTMLTitles</code></a></dt>
682 <dd>Bu seçenek süslü listeleme için HTML belgelerden sayfa başlığının
683 okunmasını sağlar. Dosya için <directive module="mod_autoindex"
684 >AddDescription</directive> ile bir açıklama tanımlanmımışsa httpd
685 belgenin <code>title</code> etiketinin içeriğini okuyacaktır. Bu
686 seçenek işlemciyi ve diski fazla meşgul eder.</dd>
688 <dt><a name="indexoptions.showforbidden"
689 id="indexoptions.showforbidden"
690 ><code>ShowForbidden</code></a></dt>
692 <dd>Alt istek <code>HTTP_UNAUTHORIZED</code> veya
693 <code>HTTP_FORBIDDEN</code> döndürdüğünden dolayı normalde gizli olan
694 dosyalar bu seçenek belirtilmişse listede gösterilir.</dd>
696 <dt><a name="indexoptions.suppresscolumnsorting"
697 id="indexoptions.suppresscolumnsorting"
698 ><code>SuppressColumnSorting</code></a></dt>
700 <dd>Bu seçenek belirtilmişse Apache, süslü dizin listesinde sütun
701 başlıklarını sıralama için hiper bağ haline getirmeyecektir. Sütun
702 başlıkları için öntanımlı davranış hiper bağ olmak olup bunlar
703 seçilerek dizin listesinin o sütundaki değerlere göre sıralanması
704 sağlanır. <strong>Apache 2.0.23 öncesinde, bu seçenek ayrıca, sıralama
705 dizgesi için sorgu sözcüklerinin çözümlenmesini de iptal
706 ederdi.</strong> Bu davranış Apache 2.0.23’ten beri <a
707 href="#indexoptions.ignoreclient" ><code>IndexOptions
708 IgnoreClient</code></a> ile sağlanmaktadır.</dd>
710 <dt><a name="indexoptions.suppressdescription"
711 id="indexoptions.suppressdescription"
712 ><code>SuppressDescription</code></a></dt>
714 <dd>Süslü listelemede dosya açıklamalarının gösterilmesini engeller.
715 Öntanımlı olarak hiçbir dosya açıklaması tanımlı değildir, dolayısıyla
716 bu seçenek kullanılarak ekran genişliğinden 23 karakterlik yer
717 kazanılabilir. Dosya açıklamalarının nasıl belirlendiğini öğrenmek
718 için <directive module="mod_autoindex" >AddDescription</directive>
719 yönergesinin açıklamasına bakınız. Ayrıca, açıklama sütununun
720 genişliğini ayarlayan <code><a href="#indexoptions.descriptionwidth"
721 >DescriptionWidth</a></code> dizin listeleme seçeneğine de
724 <dt><a name="indexoptions.suppresshtmlpreamble"
725 id="indexoptions.suppresshtmlpreamble"
726 ><code>SuppressHTMLPreamble</code></a></dt>
728 <dd>Eğer dizin aslında <directive module="mod_autoindex"
729 >HeaderName</directive> yönergesi ile belirtilmiş bir dosya içeriyorsa
730 modül normal olarak bu dosyanın içeriğinin öncesine HTML başlangıç
731 etiketlerini (<code><html></code>, <code><head></code>,
732 vs.) yerleştirir. Bu seçenek bu davranışı iptal ederek modülün dosya
733 içeriğinin başlangıcına bir şey eklememesini sağlar. Bu durumda başlık
734 dosyasının uygun HTML etiketlerini içermesi gerekir. Böyle bir başlık
735 dosyası yoksa normal olarak HTML başlangıç etiketleri üretilir.</dd>
737 <dt><a name="indexoptions.suppressicon"
738 id="indexoptions.suppressicon"><code>SuppressIcon</code></a>
739 (<em>Apache 2.0.23 ve sonrası</em>)</dt>
741 <dd>Süslü dizin listesinde dosya simgelerinin gösterilmesini engeller.
742 Son belirtim, süslü dizin listelemede kullanılan <code>pre</code>
743 etiketinin içeriğinde <code>img</code> ve <code>hr</code>
744 etiketlerinin bulunmasına izin vermediğinden <code>SuppressIcon</code>
745 ve <code>SuppressRules</code> seçenekleri birlikte kullanılarak HTML
746 3.2 belirtimine uyum sağlanır.</dd>
748 <dt><a name="indexoptions.suppresslastmodified"
749 id="indexoptions.suppresslastmodified"
750 ><code>SuppressLastModified</code></a></dt>
752 <dd>Süslü dizin listelemede son değişiklik tarihinin gösterilmesi
755 <dt><a name="indexoptions.suppressrules"
756 id="indexoptions.suppressrules"><code>SuppressRules</code></a>
757 (<em>Apache 2.0.23 ve sonrası</em>)</dt>
759 <dd>Dizin listelemede <code>hr</code> etiketinin kullanımını engeller.
760 Son belirtim, süslü dizin listelemede kullanılan <code>pre</code>
761 etiketinin içeriğinde <code>img</code> ve <code>hr</code>
762 etiketlerinin bulunmasına izin vermediğinden <code>SuppressIcon</code>
763 ve <code>SuppressRules</code> seçenekleri birlikte kullanılarak HTML
764 3.2 belirtimine uyum sağlanır.</dd>
766 <dt><a name="indexoptions.suppresssize" id="indexoptions.suppresssize"
767 ><code>SuppressSize</code></a></dt>
769 <dd>Süslü dizin listelemede dosya boyutunun gösterilmesi engellenir.</dd>
771 <dt><a name="indexoptions.trackmodified"
772 id="indexoptions.trackmodified"><code>TrackModified</code></a>
773 (<em>Apache 2.0.23 ve sonrası</em>)</dt>
775 <dd>Bu seçenek listelenen dizin için HTTP başlığında
776 <code>Last-Modified</code> ve <code>ETag</code> alanlarının dönmesini
777 sağlar. Sadece işletim sistemi veya dosya sistemi uygun stat()
778 sonuçlarını döndürüyorsa bu geçerlidir. Bazı Unix sistemleri, OS2’nin
779 JFS’si ve Win32’nin NTFS’i böyledir. Ancak OS2 ve Win32 FAT dosya
780 sistemleri böyle değildir. Bu özellik etkin kılındığında istemci veya
781 vekil <code>HEAD</code> istekleriyle dosya listesindeki değişiklikleri
782 izleyebilirler. Yalnız, bazı işletim sistemlerinin yeni ve silinmiş
783 dosyaların izini iyi sürdüğü halde dizin içindeki dosyaların boyut ve
784 tarih değişikliklerini izlemediklerine dikkat ediniz. <strong>Mevcut
785 bir dosyanın boyut ve zaman damgasındaki değişiklikler
786 <code>Last-Modified</code> başlığının güncellenmesini tüm Unix
787 sistemlerinde sağlamaz</strong>. Bu gibi durumlarda bu seçeneğin
788 kapalı kalması daha iyidir.</dd>
790 <dt><a name="indexoptions.versionsort"
791 id="indexoptions.versionsort"><code>VersionSort</code></a>
792 (<em>Apache 2.0a3 ve sonrası</em>)</dt>
794 <dd><code>VersionSort</code> seçeneği isimlerinde sürüm numarası bulunan
795 dosyaların sayısal sıralamaya uygun olarak sıralanmalarını sağlar.
796 Normalde sıralama karakter sıralamasına göre yapılır, ardından sürüm
797 numaralı dosyalar veya açıklamalar kendi aralarında sayısal sıralamaya
800 <example><title>Örnek:</title>
809 <p>Sıfır ile başlalan numaralara ondalık sayı muamelesi yapılır:</p>
819 <dt><a name="indexoptions.xhtml"
820 id="indexoptions.xhtml"><code>XHTML</code></a>
821 (<em>Apache 2.0.49 ve sonrası</em>)</dt>
823 <dd><code>XHTML</code> seçeneği <module>mod_autoindex</module>’in kodu
824 HTML 3.2’ye değil XHTML 1.0’a uygun üretmesini sağlar.</dd>
828 XXX: we should consider to allow sections inside <usage>
829 this would require some xslt changes...
831 <dl><dt><code>+</code> veya <code>-</code> Önekli Seçenekler</dt>
833 <p>Apache 1.3.3’te <directive>IndexOptions</directive> yönergelerinin ele
834 alınışıyla ilgili önemil değişiklikler yapılmıştır. Bunlar:</p>
837 <li>Tek bir dizin için çok sayıda <directive>IndexOptions</directive>
838 yönergesi belirtilmişse bunlar ayrı ayrı değil birlikte ele alınır.
842 <Directory /foo>
844 IndexOptions HTMLTable<br />
845 IndexOptions SuppressColumnsorting
850 <p>yapılandırmasındaki <directive>IndexOptions</directive>
854 IndexOptions HTMLTable SuppressColumnsorting
857 <p>yönergesine eşdeğerdir.</p>
860 <li>Seçeneklerde <code>+</code> veya <code>-</code> önekleri
861 kullanılabilmektedir.</li>
864 <p><code>+</code> veya <code>-</code> önekli seçeneklere rastlandığında
865 bunlar mevcut (üst dizinden miras alınanlar ve/veya önceki atamalar)
866 <directive>IndexOptions</directive> yönergelerine uygulanır. Ancak,
867 önek kullanılmamış bir seçeneğe raslandığında, o noktada önceki ve
868 miras alınmış bu tür seçenekler iptal edilir. Şu örneği ele alalım:</p>
871 IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
872 IndexOptions +SuppressSize
875 <p>Bunun net etkisi <code>IndexOptions FancyIndexing +SuppressSize</code>
876 atamasına eşdeğerdir, çünkü öneksiz <code>FancyIndexing</code> seçeneği
877 kendinden önceki önekli seçenekleri iptal etmiş fakat hemen ardından
878 eklenmelerine izin vermiştir.</p>
880 <p>Belli bir dizine önceki seçenekleri temizleyerek koşulsuz olarak
881 tamamen yeni seçenekler atamak istiyorsanız
882 <directive>IndexOptions</directive> yönergesinde seçenekleri
883 <code>+</code> veya <code>-</code> öneklerini kullanmadan
891 <name>IndexOrderDefault</name>
892 <description>Dizin içerik listesinin öntanımlı sıralamasını belirler.
894 <syntax>IndexOrderDefault Ascending|Descending
895 Name|Date|Size|Description</syntax>
896 <default>IndexOrderDefault Ascending Name</default>
897 <contextlist><context>server config</context><context>virtual host</context>
898 <context>directory</context><context>.htaccess</context>
900 <override>Indexes</override>
903 <p><directive>IndexOrderDefault</directive> yönergesi <code><a
904 href="#indexoptions.fancyindexing" >FancyIndexing</a></code> seçeneğinin
905 etkin olduğu durumda işe yarar. Öntanımlı olarak süslü listelemede dizin
906 içeriği dosya ismine göre artan sıralamayla listelenir.
907 <directive>IndexOrderDefault</directive> yönergesi bu öntanımlı
908 sıralamanın değiştirilmesini mümkün kılar.</p>
910 <p><directive>IndexOrderDefault</directive> yönergesi iki değer alır. İlki
911 sıralama yönünü belirtmek üzere <code>Ascending</code> (küçükten büyüğe)
912 veya <code>Descending</code> (büyükten küçüğe) olmak zorundadır. İkinci
913 değer ise birincil sıralama anahtarını belirtmek üzere <code>Name</code>,
914 <code>Date</code>, <code>Size</code> ve <code>Description</code>
915 sözcüklerinden biri olmalıdır (anlamları sırayla: İsim, Tarih, Boyut,
916 Açıklama). İkincil sıralama anahtarı <em>daima</em> artan sıralamayla
919 <p>Dizin listesinin belli bir sırada gösterilmesini zorunlu kılmak için
920 yönergeyi <code><a href="#indexoptions.suppresscolumnsorting"
921 >SuppressColumnSorting</a></code> sıralama seçeneği ile birlikte
922 belirtebilirsiniz; böylece, istemcinin farklı sıralamalara sahip içerik
923 isteğini engellemiş olursunuz.</p>
928 <name>IndexStyleSheet</name>
929 <description>Dizin listesine bir biçembent ekler.</description>
930 <syntax>IndexStyleSheet <var>url-yolu</var></syntax>
931 <contextlist><context>server config</context><context>virtual host</context>
932 <context>directory</context><context>.htaccess</context>
934 <override>Indexes</override>
937 <p><directive>IndexStyleSheet</directive> yönergesi dizin listelemesi için
938 kullanılacak biçembent dosyasının ismini belirtmek için kullanılır.</p>
940 <example><title>Örnek</title>
941 IndexStyleSheet "/css/style.css"
947 <name>IndexHeadInsert</name>
948 <description>Bir dizin sayfasının HEAD bölümüne metin yerleştirir.</description>
949 <syntax>IndexHeadInsert <var>"imlenim ..."</var></syntax>
950 <contextlist><context>server config</context><context>virtual host</context>
951 <context>directory</context><context>.htaccess</context>
953 <override>Indexes</override>
956 <p><directive>IndexHeadInsert</directive> yönergesi, dizin listesi için
957 üretilen HTML’nin <var><head></var> bölümüne yerleştirilecek bir
960 <title>Example</title>
961 IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
967 <name>ReadmeName</name>
968 <description>Dizin listesinin sonuna yerleştirilecek dosyanın ismini
969 belirler.</description>
970 <syntax>ReadmeName <var>dosya-ismi</var></syntax>
971 <contextlist><context>server config</context><context>virtual host</context>
972 <context>directory</context><context>.htaccess</context>
974 <override>Indexes</override>
977 <p><directive>ReadmeName</directive> yönergesi dizin listesinin sonuna
978 eklenecek dosyanın ismini belirler. <code><em>dosya-ismi</em></code> ile
979 listeye dahil edilecek dosyanın ismi listelenen dizine göreli olarak
980 belirtilir. Eğer dosya ismi bir bölü çizgisi ile başlıyorsa <directive
981 module="core">DocumentRoot</directive>’a göreli belirtildiği
984 <example><title>1. Örnek</title>
985 ReadmeName FOOTER.html
988 <example><title>2. Örnek</title>
989 ReadmeName /include/FOOTER.html
992 <p>Ayrıca bu davranışın daha ayrıntılı ele alındığı <directive
993 module="mod_autoindex" >HeaderName</directive> yönergesine de