ls veya Win32 dir kabuk komutunun
yaptığı gibi dizin içeriğini listeler.Bir dizin içerik dosyası iki kaynaktan gelebilir:
index.html
adında bir dosya olarak. Dosyanın ismi İki işlev birbirinden ayrı tutulmuştur, böylece kendiliğinden içerik listesi üretimi tamamen iptal edilebilir (veya değiştirilebilir).
Kendiliğinden içerik listesi üretimi Options +Indexes ile
etkin kılınabilir. Daha fazla bilgi için
FancyIndexing
seçeneği ile kullanılmışsa sütun başlıkları listenin sıralamasını
sütundaki sıralamaya göre değiştirecek hiper bağlar haline getirilir
(süslü liste). Aynı başlığa peşpeşe tıklamak suretiyle sıralamayı
büyükten küçüğe veya tersine değiştirebilirsiniz. Bu sütun başlığı
bağlarının oluşturulması SuppressColumnSorting seçeneği ile kullanılarak
engellenebilir.
Boyuta göre sıralamada daima dosyanın asıl boyutuna bakılır. Dolayısıyla ikisi de "1K" olarak gösterilen iki dosyadan 1010 baytlık olanı küçükten büyüğe sıralamada 1011 baytlıktan önce gösterilecektir.
Apache 2.0.23’te Sütun Sıralama için Sorgu Seçenekleri yeniden
düzenlenip tamamen yeni bir sorgu seçenekleri grubu oluşturulmuştur.
Çıktı üzerinde kullanıcı denetimini tamamen ortadan kaldırmak için
IgnoreClient
seçeneği kullanılabilir.
Sütun sıralama başlıklarının her biri hedefi kendisi olan birer hiper bağ olup aşağıda sıralanan sorgu seçeneklerini kullanırlar. Bu seçeneklerin her biri her dizin içerik listesi isteğine eklenebilir.
C=N dizini dosya adına göre sıralarC=M dizini son değişiklik zamanına ve ardından dosya
ismine göre sıralar.C=S dizini boyuta ve ardından dosya adına göre
sıralarC=D dizini açıklamaya ve ardından
dosya adına göre sıralar.O=A artan sıralama uygulanır.O=D azalan sıralama uygulanır.F=0 listeleme basit listeleme biçiminde yapılır
(FancyIndexing seçeneği ile etkinleştirilen biçimde
değil)F=1 listeleme FancyIndexing seçeneği ile
etkinleştirilen biçimde yapılırF=2 listeleme FancyIndexing ve
HTMLTable seçeneği
ile etkinleştirilen biçimde yapılır.V=0 sürüme göre sıralama iptal edilir.V=1 sürüme göre sıralama etkin
kılınır.P=kalıp sadece belirtilen
kalıp ile eşleşen dosyalar istelenir.P=kalıp sorgu seçeneğinin normalde
Aşağıdaki basit örnekte sorgu seçeneklerinin kullanımı gösterilmiştir.
Son satırda bulunan "submit" düğmesindeki tanınmayan "X" girdisine
dikkat ediniz. "X=Göster" girdisi tüm seçenekler işlendikten sonra
<form action="" method="get">
<input type="text" name="P" value="*" /> ile eşleşen
<select name="C">
<option value="N" selected="selected">isme</option>
<option value="M"> değişiklik tarihine</option>
<option value="S"> boyuta</option>
<option value="D"> açıklamaya</option>
</select> göre
<select name="O">
<option value="A" selected="selected"> artan</option>
<option value="D"> azalan</option>
</select>
<select name="V">
<option value="0" selected="selected">normal</option>
<option value="1"> sürümlü</option>
</select> sıralamayla bir
<select name="F">
<option value="0"> basit liste</option>
<option value="1" selected="selected"> süslü liste</option>
<option value="2"> tablolu liste</option>
</select>
<input type="submit" name="X" value="Göster" />
</form>
FancyIndexing seçeneğiyle
üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
metni belirler. dosya olarak dosya türünü
betimleyecek bir dosya uzantısı, dosya isminin bir kısmı, bir dosya ismi
kalıbı veya tam yoluyla bir dosya ismi belirtilebilir. Eğer
metin boşluk karakterleri içeriyorsa tırnak içine
(" veya ') alınmalıdır. Simge metni, simge
bulunamadığı veya istemci resim gösteremediği takdirde ya da kullanıcı
resim yüklememeyi tercih etmişse gösterilir.
FancyIndexing seçeneğiyle
üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
metni belirler. MIME-kodlaması olarak
x-compress gibi geçerli bir içerik kodlaması
belirtilmelidir. Eğer metin boşluk karakterleri
içeriyorsa tırnak içine (" veya ')
alınmalıdır. Simge metni simge bulunamadığı veya istemci resim
gösteremediği takdirde ya da kullanıcı resim yüklememeyi tercih etmişse
gösterilir.
FancyIndexing seçeneğiyle
üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
metni belirler. MIME-türü olarak
text/html gibi geçerli bir içerik türü belirtilmelidir.
Eğer metin boşluk karakterleri içeriyorsa tırnak
içine (" veya ') alınmalıdır. Simge metni
simge bulunamadığı veya istemci resim gösteremediği takdirde ya da
kullanıcı resim yüklememeyi tercih etmişse gösterilir.
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde bir
dosya için gösterilecek açıklamayı belirler. dosya
olarak dosya türünü betimleyecek bir dosya uzantısı, dosya isminin bir
kısmı, bir dosya ismi kalıbı veya tam yoluyla bir dosya ismi
belirtilebilir. Eğer dosya açıklamasını içeren
metin boşluk karakterleri içeriyorsa çift tırnak
(") içine alınmalıdır.
Normalde öntanımlı açıklama alanının genişliği 23 bayttır. IndexOptions SuppressIcon
seçeneği buna 6 bayt daha ekler; IndexOptions SuppressSize
seçeneği 7 bayt, IndexOptions SuppressLastModified seçeneği ise 19 bayt
ekler. Böylece en fazla 55 karakterlik öntanımlı sütun genişliğine
ulaşılabilir.
Açıklama sütununun öntanımlı genişliği geçersiz kılınabilir hatta
sınırsız açıklama uzunluğu atanabilir. Bu konu için DescriptionWidth
seçeneğinin açıklamasına bakınız.
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde adı
isim ile biten bir dosya için gösterilecek simgeyi
belirler. simge ya simgenin göreli URL’si (%
öncelemeli) ya da (alt-metin,url)
biçeminde olmalıdır; buradaki alt-metin simge
gösterilemediği durumda tarayıcı tarafından simgenin yerinde
gösterilecek metindir.
isim olarak ya (listeyi düzgün biçemlemek
amacıyla) dizinler için ^^DIRECTORY^^, boş satırlar için
^^BLANKICON^^ ya da dosya türünü betimleyecek bir dosya
uzantısı, dosya isminin bir kısmı, bir dosya ismi kalıbı veya tam
yoluyla bir dosya ismi belirtilebilir.
Mümkünse
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde bir
dosya için gösterilecek simgeyi belirler. simge ya
simgenin göreli URL’si (% öncelemeli) ya da
(alt-metin,url) biçeminde olmalıdır;
buradaki alt-metin simge gösterilemediği durumda
tarayıcı tarafından simgenin yerinde gösterilecek metindir.
MIME-kodlaması olarak x-compress
gibi geçerli bir içerik kodlaması belirtilmelidir.
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde MIME
türü MIME-türü olarak belirtilen bir dosya için
gösterilecek simgeyi belirler. simge ya simgenin
göreli URL’si (% öncelemeli) ya da
(alt-metin,url) biçeminde olmalıdır;
buradaki alt-metin simge gösterilemediği durumda
tarayıcı tarafından simgenin yerinde gösterilecek metindir.
MIME-türü MIME türleri ile eşleşen bir dosya kalıbı ifadesi olabilir.
The FancyIndexing seçeneğiyle
üretilen dizin listesinde özel bir simge atanmamış dosyalar için
gösterilecek simgeyi belirler. URL-yolu simgeye
bir göreli URL (% öncelemeli) belirtir.
dosya-ismi ile belirtilir.
HeaderName and dosya-ismi artık içeriği listelenecek dizine
erişmek için kullanılan bir göreli URL yolu olarak ele alınmaktadır.
Eğer dosya-ismi bir bölü çizgisi ("/") ile
başlıyorsa
dosya-ismi, içerik türü text/*
(text/html, text/plain gibi) olan bir belge
olarak çözümlenmelidir. Yani, aşağıdaki örnekteki gibi betiğin asıl
dosya türü text/html olarak imlenmişse
dosya-ismi bir CGI betiğinin ismi bile
olabilir:
MultiViews etkin kılınmışsa dosyaya içerik dili uzlaşımı da
uygulanabilir. dosya-ismi ile belirtilen dosya
text/html türünde durağan bir belge (bir CGI betiği
değil) ise ve Includes ve IncludesNOEXEC seçeneklerinden
biri belirtilmişse dosya bir SSI sayfası olarak ele alınır
(
Eğer yönergede belirtilen dosya bir HTML belge gibi başlıyorsa
(<html>, <head>, vs.) ve bu etiketlerin yinelenmemesini
istiyorsanız IndexOptions +SuppressHTMLPreamble ataması yapmanız
gerekecektir.
dosya olarak kabuk tarzı bir dosya ismi kalıbı
veya tam yoluyla bir dosya ismi belirtilebilir. Evvelce yapılmış bir
atamada değişiklik yapmak yerine birden fazla
./) içerir.
seçenek olarak şunlar
belirtilebilir:
Charset=karakter-kümesi (Apache 2.0.61
ve sonrası)Charset seçeneği üretilen sayfa için bir karakter
kümesi belirtebilmenizi sağlar. Dizinin bulunduğu dosya sisteminin
karakter kodlamasına bağlı olarak öntanımlı değeri ya
ISO-8859-1 ya da UTF-8’dir.
Type=MIME-türü (Apache 2.0.61 ve
sonrası)Type seçeneği üretilen sayfa için bir MIME türü
belirtebilmenizi sağlar. Öntanımlı değer text/html’dir.
DescriptionWidth=[n | *]
(Apache 2.0.23 ve sonrası)DescriptionWidth seçeneği üretilen sayfada açıklama
sütununun genişliğini sizin belirleyebilmenizi sağlar. Bu seçenek
kullanılmadığında veya -DescriptionWidth olarak
belirtildiğinde uygun genişliği
DescriptionWidth=n ile açıklama sütununun
genişliği n baytla sınırlanır.
DescriptionWidth=* ile açıklama sütununun genişliği en
uzun açıklama metni sığacak şekilde arttırılır.
Sütun genişliğinin sabitliği nedeniyle metnin
kırpılmasından kaynaklanan sorunlar için
FancyIndexingFoldersFirst
(Apache 2.0.23 ve sonrası)FoldersFirst etkinse Zed dizini listede
Beta dizininden ve Gamma ve
Alpha dosyalarından önce yer alacaktır. Bu
seçenek sadece FancyIndexing seçeneği etkinse etkili
olacaktır.HTMLTable
(Deneysel, Apache 2.0.23 ve sonrası)FancyIndexing seçeneği ile birlikte süslü listeleme
için basit bir tablo oluşturur. Fakat bu eski tarayıcıları yanıltır.
Bununla birlikte, Linux, WinNT gibi sağdan sola veya soldan sağa yazım
yönünün UTF-8 karakter koduna göre değiştiği platformlarda dosya
isimleri ve açıklamalar için bu özellikle gerekli olabilir.IconsAreLinksFancyIndexing seçeneği ile birlikte süslü
listelemede dosya simgesini dosyaya bir hiper bağ haline getirir.IconHeight[=benek-sayısı]IconWidth seçeneği ile
kullanıldığında dosya simgesinin img etiketinin
height ve width özniteliklerini içermesine
sebep olur. Böylece tarayıcının tüm simgelerin yüklenmesini beklemeden
sayfa yerleşimi için bir ön hesaplama yapabilmesi mümkün olur. Seçenek
bir değer belirtilmeksizin kullanıldığında Apache tarafından atanmış
standart simge yüksekliği öntanımlıdır.IconWidth[=benek-sayısı]IconHeight seçeneği ile
kullanıldığında dosya simgesinin img etiketinin
height ve width özniteliklerini içermesine
sebep olur. Böylece tarayıcının tüm simgelerin yüklenmesini beklemeden
sayfa yerleşimi için bir ön hesaplama yapabilmesi mümkün olur. Seçenek
bir değer belirtilmeksizin kullanıldığında Apache tarafından atanmış
standart simge genişliği öntanımlıdır.IgnoreCaseIgnoreCase
etkinse Zeta dosyası alfa dosyasından sonra listelenir (Dikkat: GAMMA
daima gamma’dan önce listelenir.)IgnoreClientSuppressColumnSorting uygulanır).NameWidth=[n | *]NameWidth seçeneği dosya ismi sütunu için bir
genişlik belirtebilmenizi mümkün kılar.
Hiç belirtilmediğinde veya -NameWidth biçeminde
belirtildiğinde
NameWidth=n ile sütun genişliği
n bayt genişlikte sabitlenir.
NameWidth=* olduğunda ise sütun genişliği en geniş
satırın sığacağı kadar arttırılır.
ScanHTMLTitlestitle etiketinin içeriğini okuyacaktır. Bu
seçenek işlemciyi ve diski fazla meşgul eder.ShowForbiddenHTTP_UNAUTHORIZED veya
HTTP_FORBIDDEN döndürdüğünden dolayı normalde gizli olan
dosyalar bu seçenek belirtilmişse listede gösterilir.SuppressColumnSortingIndexOptions
IgnoreClient ile sağlanmaktadır.SuppressDescriptionDescriptionWidth dizin listeleme seçeneğine de
bakınız.SuppressHTMLPreamble<html>, <head>,
vs.) yerleştirir. Bu seçenek bu davranışı iptal ederek modülün dosya
içeriğinin başlangıcına bir şey eklememesini sağlar. Bu durumda başlık
dosyasının uygun HTML etiketlerini içermesi gerekir. Böyle bir başlık
dosyası yoksa normal olarak HTML başlangıç etiketleri üretilir.SuppressIcon
(Apache 2.0.23 ve sonrası)pre
etiketinin içeriğinde img ve hr
etiketlerinin bulunmasına izin vermediğinden SuppressIcon
ve SuppressRules seçenekleri birlikte kullanılarak HTML
3.2 belirtimine uyum sağlanır.SuppressLastModifiedSuppressRules
(Apache 2.0.23 ve sonrası)hr etiketinin kullanımını engeller.
Son belirtim, süslü dizin listelemede kullanılan pre
etiketinin içeriğinde img ve hr
etiketlerinin bulunmasına izin vermediğinden SuppressIcon
ve SuppressRules seçenekleri birlikte kullanılarak HTML
3.2 belirtimine uyum sağlanır.SuppressSizeTrackModified
(Apache 2.0.23 ve sonrası)Last-Modified ve ETag alanlarının dönmesini
sağlar. Sadece işletim sistemi veya dosya sistemi uygun stat()
sonuçlarını döndürüyorsa bu geçerlidir. Bazı Unix sistemleri ve
OS/2'nin JFS'si ile Win32’nin NTFS’i böyledir. Ancak OS/2 ve Win32 FAT dosya
sistemleri böyle değildir. Bu özellik etkin kılındığında istemci veya
vekil HEAD istekleriyle dosya listesindeki değişiklikleri
izleyebilirler. Yalnız, bazı işletim sistemlerinin yeni ve silinmiş
dosyaların izini iyi sürdüğü halde dizin içindeki dosyaların boyut ve
tarih değişikliklerini izlemediklerine dikkat ediniz. Mevcut
bir dosyanın boyut ve zaman damgasındaki değişiklikler
Last-Modified başlığının güncellenmesini tüm Unix
sistemlerinde sağlamaz. Bu gibi durumlarda bu seçeneğin
kapalı kalması daha iyidir.VersionSort
(Apache 2.0a3 ve sonrası)VersionSort seçeneği isimlerinde sürüm numarası bulunan
dosyaların sayısal sıralamaya uygun olarak sıralanmalarını sağlar.
Normalde sıralama karakter sıralamasına göre yapılır, ardından sürüm
numaralı dosyalar veya açıklamalar kendi aralarında sayısal sıralamaya
tabi tutulur.
Sıfır ile başlalan numaralara ondalık sayı muamelesi yapılır:
XHTML
(Apache 2.0.49 ve sonrası)XHTML seçeneği + veya - Önekli SeçeneklerApache 1.3.3’te
yapılandırmasındaki
yönergesine eşdeğerdir.
+ veya - önekleri
kullanılabilmektedir.+ veya - önekli seçeneklere rastlandığında
bunlar mevcut (üst dizinden miras alınanlar ve/veya önceki atamalar)
Bunun net etkisi IndexOptions FancyIndexing +SuppressSize
atamasına eşdeğerdir, çünkü öneksiz FancyIndexing seçeneği
kendinden önceki önekli seçenekleri iptal etmiş fakat hemen ardından
eklenmelerine izin vermiştir.
Belli bir dizine önceki seçenekleri temizleyerek koşulsuz olarak
tamamen yeni seçenekler atamak istiyorsanız
+ veya - öneklerini kullanmadan
belirtiniz.
FancyIndexing seçeneğinin
etkin olduğu durumda işe yarar. Öntanımlı olarak süslü listelemede dizin
içeriği dosya ismine göre artan sıralamayla listelenir.
Ascending (küçükten büyüğe)
veya Descending (büyükten küçüğe) olmak zorundadır. İkinci
değer ise birincil sıralama anahtarını belirtmek üzere Name,
Date, Size ve Description
sözcüklerinden biri olmalıdır (anlamları sırayla: İsim, Tarih, Boyut,
Açıklama). İkincil sıralama anahtarı daima artan sıralamayla
dosya ismidir.
Dizin listesinin belli bir sırada gösterilmesini zorunlu kılmak için
yönergeyi SuppressColumnSorting sıralama seçeneği ile birlikte
belirtebilirsiniz; böylece, istemcinin farklı sıralamalara sahip içerik
isteğini engellemiş olursunuz.
dosya-ismi ile
listeye dahil edilecek dosyanın ismi listelenen dizine göreli olarak
belirtilir. Eğer dosya ismi bir bölü çizgisi ile başlıyorsa
Ayrıca bu davranışın daha ayrıntılı ele alındığı