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
FancyIndexing
FoldersFirst
(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.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 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.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.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.SuppressLastModified
SuppressRules
(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.SuppressSize
TrackModified
(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ığı