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. Kullanılan dosyanın veya dosyaları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.
İstemciye, dizin içeriğini listelerken neleri hangi sırada
listeleyeceğini belirleyebilmesi için içerik üzerinde biraz denetim
sağlayabileceği çeşitli sorgu dizgesi bileşenleri sağlanmıştır.
Çı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.
dosya kısmî dosya ismi içerebileceğinden çok kısa dosya ismi
belirtilmesi yüzünden istemeden de olsa başka dosyalarla
eşleşebileceğini unutmayın. Örneğin, le.html
doğrudan
le.html
ile eşleşebileceği gibi example.html
ile de eşleşecektir. Şüpheli durumların ortaya çıkabileceği durumlarda
mümkün olduğunca dosya isminin tamamını kullanın ve saptanan ilk
eşleşmenin kullanılacağını aklınızdan çıkarmayın ayrıca,
AddDescription
listesini de uygun şekilde sıralayın.
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.
Mutlak yollar henüz desteklenmemetedir ve çalışma anında hiçbir şeyle eşleşmeyeceklerdir. Normalde sadece htaccess bağlamında kullanılan, göreli yol bilgisi içeren değiştirgeler, kısmi dizin isimleriyle eşleşmemeleri için örtük olarak '*/' öneki alırlar.
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), tam nitelenmiş bir uzak URL 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.
^^BLANKICON^^
sadece biçemleme için kullanılır,
dolayısıyla IndexOptions HTMLTable
kullanıyorsanız
gereksizdir.
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), tam nitelenmiş uzak bir URL 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), tam nitelenmiş uzak bir URL 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) veya tam nitelenmiş uzak bir URL
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.
Bu yönerge,
Bu yönerge, diğer yapılandırma bölümlerince bir şekilde miras alınmayan
ve
Bu yönergeyi kullandıktan sonra, açıkça yoksaymak istediğiniz kalıpların bir listesi için öntanımlı yapılandırmayı gözden geçirin.
seçenek
olarak şunlar
belirtilebilir:
IndexOptions HTMLTable
etkin ve bir
IndexStyleSheet
tanımlı olduğunda dizin listesi
tablosunun her satırına fazladan bir CSS sınıfı bildirimi ekler.
Tablonun her satırına uygulanmaması için standart even
ve
odd
sınıfları yerine even-ALT
ve
odd-ALT
bildirimleri kullanılabilir. Burada
ALT ya bir dosya biçimiyle ilişkili standat bir alt
dizgesidir ya da AddAlt*
yönergeleriyle tanımlanan bir
alt dizgesidir.
Charset=karakter-kümesi
(Apache HTTP
Sunucusunun 2.0.61 ve sonraki sürümleri)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 Windows ve Mac OS
X'te UTF-8, diğerlerinde ISO-8859-1’dir (İlgili
dosya sisteminin Unicode dosya isimleri kullanıp kullanmamasına
bağlıdır).
DescriptionWidth=[n | *]
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
FancyIndexing
FoldersFirst
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
FancyIndexing
seçeneği ile birlikte süslü listeleme için basit bir tablo oluşturur.
UTF-8'in etkin olduğu platformlarda gereklidir. Bununla birlikte,
Linux, WinNT gibi sağdan sola veya soldan sağa yazım yönünün değiştiği
platformlarda dosya isimleri ve açıklamalar için bu özellikle gerekli
olabilir.IconsAreLinks
FancyIndexing
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 http tarafından
atanmış standart simge yüksekliği öntanımlıdır. Bu
seçenek sadece FancyIndexing
seçeneği etkinse etkili
olacaktı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 httpd tarafından
atanmış standart simge genişliği öntanımlıdır.IgnoreCase
IgnoreCase
etkinse Zeta dosyası alfa dosyasından sonra listelenir (Dikkat: GAMMA
daima gamma’dan önce listelenir.)IgnoreClient
SuppressColumnSorting
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.
ScanHTMLTitles
title
etiketinin içeriğini okuyacaktır. Bu
seçenek işlemciyi ve diski fazla meşgul eder.ShowForbidden
HTTP_UNAUTHORIZED
veya
HTTP_FORBIDDEN
döndürdüğünden dolayı normalde gizli olan
dosyalar bu seçenek belirtilmişse listede gösterilir.SuppressColumnSorting
IndexOptions IgnoreClient
ile sağlanmaktadır.SuppressDescription
DescriptionWidth
dizin listeleme seçeneğine de
bakınız. Bu seçenek sadece
FancyIndexing
seçeneği etkinse etkili olacaktır.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. Eğer
bir SuppressIcon
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.SuppressLastModified
FancyIndexing
seçeneği etkinse etkili olacaktır.SuppressRules
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. Bu seçenek sadece
FancyIndexing
seçeneği etkinse etkili olacaktır.SuppressSize
FancyIndexing
seçeneği etkinse etkili olacaktır.
TrackModified
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.Type
anahtar sözcüğü üretilen sayfanın MIME içerik
türünün belirtilebilmesini sağlar. text/html öntanımlıdır.
VersionSort
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
XHTML
seçeneği FancyIndexing
seçeneği etkinse etkili olacaktır.+
veya -
Önekli SeçeneklerÇok sayıda
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.
Sütunun tepesindeki sıralama bağını kaldırmak için
SuppressColumnSorting
seçeneğinin yanında, sıralama
tercihlerinizi geçersiz kılmak için sorgu dizgesine elle sıralama
seçenekleri eklenmesini engellemek için
IgnoreClient
seçeneğini de kullanarak istemcinin listeyi yeniden sıralamasını
engelleyebilirsiniz.
Bu yönergenin IndexOptions HTMLTable
ile birlikte
kullanılması sonuçlanan HTML dosyasına bir miktar CSS sınıfı ekler.
Tablonun tamamı indexlist
için bir CSS kimliği verir ve
aşağıdaki sınıflar listenin çeşitli parçalarıyla ilişkilendirilir:
Sınıf | Tanım |
---|---|
tr.indexhead | Liste satırının başlığı |
th.indexcolicon and td.indexcolicon | Simge sütunu |
th.indexcolname and td.indexcolname | Dosya ismi sütunu |
th.indexcollastmod and td.indexcollastmod | Son değişiklik sütunu |
th.indexcolsize and td.indexcolsize | Dosya boyutu sütunu |
th.indexcoldesc and td.indexcoldesc | Açıklama sütunu |
tr.breakrow | Tablonun altınaki yatay çizgi |
tr.odd and tr.even | Tek ve çift satırlar |
dosya-ismi
ile
listeye dahil edilecek dosyanın ismi listelenen dizine göreli olarak
belirtilir. Eğer dosya ismi 2. örnekteki gibi bir bölü çizgisi ile
başlıyorsa
Ayrıca bu davranışın daha ayrıntılı ele alındığı