Provided by: manpages-tr_2.0.6-2_all 
İSİM
xmllint - komut satırı XML aracı
KULLANIM
xmllint [ --version | --debug | --shell | --xpath "XPath_ifadesi" | --debugent | --copy |
--recover | --noent | --noout| --nonet | --path "YOL" | --load-trace | --htmlout |
--nowrap | --valid | --postvalid | --dtdvalid URL | --dtdvalidfpi BGT | --timing |
--output DOSYA | --repeat | --insert | --compress | --html | --xmlout | --push |
--memory| --maxmem SAYI | --nowarning | --noblanks | --nocdata | --format |
--encode KODLAMA | --dropdtd | --nsclean | --testIO | --catalogs | --nocatalogs |
--auto | --xinclude | --noxincludenode | --loaddtd | --dtdattr | --stream |
--walker | --pattern ŞABLON | --chkregister | --relaxng ŞEMA | --schema ŞEMA |
--c14n ] { XML-DOSYA ...| - }
xmllint --help
GİRİŞ
xmllint, komut satırında XML-DOSYA olarak belirtilen bir veya daha fazla XML dosyasını (-
olarak belirtilmişse standart girdiyi) denetler. Belirtilen seçeneklere göre çeşitli türde
çıktı üretir. Hem XML kodlarındaki, hem de XML çözümleyicideki hataları tespit etmek için
oldukça faydalı bir araçtır.
libxml(3) içinde gelmektedir.
SEÇENEKLER
xmllint şu seçenekleri kabul eder (abecesel sıralıdır):
--auto
Denemek amacıyla küçük bir belge üretir.
--catalogs
SGML_CATALOG_FILES ortam değişkeninde belirtilen katalogları kullanır. Aksi taktirde,
öntanımlı olarak /etc/xml/catalog kullanılır.
--chkregister
Düğüm kaydını açar. Geliştiriciler için libxml(3) düğüm izleme kodlarını sınarken
faydalıdır.
--compress
Çıktıya gzip(1) sıkıştırması uygular.
--copy
Gerçeklemenin dahili kopyasını sınar.
--c14n
Çözümleme sonucunu standart çıktıda dizgeleştirmek W3C XML Kurallılaştırmasını (C14N)
kullanır. Yorumlar sonuçların içinde tutulur.
--dtdvalid URL
Geçerlilik doğrulamasında kullanılacak DTD URL’den (İnternette kaynağın bulunduğu
konumu belirten eşsiz adresten) okunur.
--dtdvalidfpi BGT
Geçerlilik doğrulaması için Biçimsel Genel Tanımlayıcı BGT ile belirtilen DTD’yi
kullanır, bunun çalışması için Biçimsel Genel Tanımlayıcıyı dışa aktaran bir katalog
gerekeceği unutulmamalıdır.
Biçimsel Genel Tanımlayıcı, DOCTYPE bildirimi içinde PUBLIC sözcüğünden sonra,
URL/URI’den önce gelir ve 4 alandan oluşur. Bir DOCTYPE örneği (BGT vurgulanmıştır):
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
// bir ayraçtır ve BGT’nin alanlarını ayırmakta kullanılır.
İlk alan -, DTD’nin biçimsel bir standarda bağlı olup olmadığını gösterir. DTD
onaylanmamışsa (örneğin siz yazmışsınızdır) -, standart dışı bir kuruluş tarafından
onaylamışsa + kullanılır. Resmi bir standart tarafından onaylanmışsa bu alan resmi
standarda bir başvuru içermelidir.
İkinci alan, DTD’den sorumlu kişi veya kuruluşu betimler (örnekte: "W3C").
Üçüncü alan, DTD’de açıklanan belge türünü betimler (örnekte: "DTD XHTML 1.0
Transitional"). Genelde sürüm numarası gibi ayırıcı özellikler içerir.
Dördüncü alan, DTD’de kullanılan dili iki harfle betimler (örnekte: "EN" - ingilizce).
--debug
Bir dosyayı çözümler ve belgenin bellekteki sürümünün açıklamalı ağacını çıktılar.
--debugent
Belgede tanımlı ENTITY alanlarında hata ayıklar.
--dropdtd
Çıktıdan DTD kaldırılır.
--dtdattr
Harici DTD alınır ve ağaç, miras alınan öznitelikler ile oluşturulur.
--encode KODLAMA
Belirtilen karakter kodlamasında çıktı üretilir. Bunun, XPath sorgularından
kaynaklanan parçalar veya sonuçlar için değil, tüm belge için çalıştığı
unutulmamalıdır.
--format
Çıktıyı yeniden biçimler ve girintiler. Girintileme için XMLLINT_INDENT ortam
değişkeninde belirtilen boşluklar kullanılır. İki boşluk " " öntanımlıdır (XML
desteklemediği için sekme karakteri, yani TAB tuşu kullanılmamalıdır).
--help
Kısa kullanım bilgisi gösterir ve çıkar.
--html
HTML çözümleyicisi kullanılır.
--htmlout
Sonuçları HTML dosyası olarak çıktılar. Bu seçenekle xmllint sonuç ağacının çıktısını
HTML etiketleri ile sarmalayarak, çıktının bir HTTP istemcisinde görüntülenebilmesini
sağlar.
--insert
Geçerli yerleştirmeleri sınar.
--loaddtd
Harici DTD okunur.
--load-trace
İşlem sırasında yüklenen tüm belgeleri standart hataya döker.
--maxmem SAYI
Çözümleyici için bellek desteğini sınar. SAYI kütüphanenin kullanımına ayrılan azami
bellek miktarının bayt değeridir. Ayrıca, XML dosyalarının betik kipinde işlenmesi
sırasında, sanal belleğin tüketmemesini sağlamak için de kullanılabilir.
--memory
Çözümleme bellekten yapılır.
--noblanks
Yoksayılabilir boş alanları kaldırır.
--nocatalogs
Herhangi bir katalog kullanılmaz.
--nocdata
CDATA bölümleri yerine eşdeğeri metin düğümleri kullanılır.
--noent
Öğe başvurularını değerleriyle değiştirir. Öntanımlı olarak, xmllint, bu başvurulara
(&başvuru;) dokunmaz.
--nonet
DTD’ler ve öğe başvuruları için interneti kullanmaz.
--noout
Sonuçlar çıktılanmaz. Öntanımlı olarak, xmllint sonuç ağacını çıktılar.
--nowarning
Çözümleme sırasında ve geçerlilik doğrulamasında uyarılar çıktılanmaz.
--nowrap
HTML etiketleri ile sarmalama yapılmaz.
--noxincludenode
XInclude işlemesi yapar ama XInclude başlangıç ve bitiş düğümlerini üretmez.
--nsclean
Gereksiz isim uzayı bildirimleri kaldırılır.
--output DOSYA
xmllint’in çözümleme sonucunu kaydedeceği dosyanın yolu belirtilir. Genellikle
uygulama bir ağaç oluşturur ve bunu standart çıktıya gönderir, bu seçenekle sonuçlanan
XML ağacı DOSYAya kaydedilir.
--path "YOL(LAR)"
DTD’leri veya öğeleri yüklemek için "YOL(LAR)" tarafından belirtilen dosya sistemi
yollarının (boşluk veya iki nokta üst üste ile ayrılmış) listesi kullanılır. Boşluk
ayraçlı yollar tırnak içine alınmalıdır.
--pattern ŞABLON
Ayrıştırıcıya yönelik okuyucu arayüzü ile kullanılabilen örüntü tanıma motorunu
çalıştırmak için kullanılır. Bir XPath (alt küme) ifadesine dayalı olarak belgedeki
bazı düğümlerin seçilmesini sağlar. Hata ayıklama için kullanılır.
--postvalid
DTD geçerlilik doğrulaması belge çözümlendikten sonra yapılır.
--push
Çözümleyicinin itme kipi kullanılır.
--recover
Geçersiz bir belgenin çözümlenebilir bölümlerini çıktılar.
--relaxng ŞEMA
Geçerliliği doğrulamak için ŞEMA isimli RELAXNG dosyası kullanılır.
--repeat
Zamanlama ve en iyileme için işlemi 100 kere tekrarlar.
--schema ŞEMA
Geçerliliği doğrulamak için ŞEMA isimli W3C XML şeması dosyası kullanılır.
--shell
Etkileşimli kabuk kipini başlatır. Kabuk kipinde kullanılan komutların listesi KABUK
KİPİ bölümünde açıklanmıştır.
--stream
G/Ç akımları kullanılır. --relaxng veya --valid seçeneğinin kullanımında geçerlik
doğrulaması için tutulan dosyalar bellekte çok yer kaplayacaksa bu seçenek yararlıdır.
--testIO
Kullanıcı G/Ç desteğini sınar.
--timing
xmllint’in çeşitli adımları gerçekleştirmek için harcadığı sürenin görüntülenmesini
sağlar.
--valid
Belgenin kullanılan DTD’ye uygun olarak hazırlanıp hazırlanmadığına bakar (DTD:
Document Type Definition - Belge Türü Tanımlaması). DTD geçerlilik sınaması komut
satırından -–dtdvalid seçeneği ile bir DTD belirtilerek de yapılabilir. Öntanımlı
olarak, xmllint ayrıca, belgenin iyi biçimli olup olmadığıyla ilgili sınamaları da
yapar.
--version
Kullanılan libxml(3) sürüm bilgisini gösterir.
--xinclude
XInclude çözümlemesi uygulanır.
--xmlout
--html seçeneği ile birlikte kullanılır. Genellikle HTML çözümlendiğinde, belge HTML
dizgeleştiricisi ile kaydedilir. Ancak bu seçenekle elde edilen belge, XML
dizgeleştiricisi ile kaydedilir. Bu seçenek, özellikle HTML girdiden XHTML belge
oluşturmak için kullanılır.
--xpath "XPath ifadesi"
Belirtilen "XPath ifadesi"ni çalıştırır ve sonucunu çıktılar. Düğüm kümesi sonuçları
durumumda, düğüm kümesindeki her düğüm çıktıda tamamen dizgeleştirilir. Boş düğüm
kümesi durumunda, "XPath set is empty" ("XPath kümesi boş") iletisini çıktılar ve bir
çıkış kodu ile çıkar.
KABUK KİPİ
xmllint, --shell seçeneği ile çalıştırıldığında etkileşimli bir kabuk açar. Bu kabukta
kullanılabilecek komutlar şunlardır:
base
Düğümün XML kökünü gösterir.
bye Kabuktan çıkar.
cat DÜĞÜM
Geçerli olan düğümü veya belirtilen düğümü görüntüler.
cd YOL
YOL düğümünü (eşsiz ise) geçerli düğüm yapar. YOL belirtilmemişse kök düğüm geçerli
düğüm olur.
dir YOL
Düğüm bilgilerini (isim uzayı, öznitelikler, içerik) dökümler.
du YOL
Belirtilmişse YOL düğümünün, belirtilmemişse geçerli düğümün alt ağacının yapısını
görüntüler.
exit
Kabuğu bırakır.
free
Bellek kullanımını görüntüler.
help
Bu yardım iletilerini görüntüler.
load DOSYA
DOSYA içeriğini yeni belge yapar.
ls YOL
YOL’un (şayet belirtilmişse) veya geçerli dizinin içeriğini listeler.
pwd Geçerli düğümün yolunu görüntüler.
quit
Kabuğu bırakır.
save DOSYA
Belgeyi belirtilmişse DOSYA adı ile, belirtilmemişse kendi adı ile kaydeder.
validate
Belgenin hatalara karşı doğruluğunu sınar.
write DOSYA
Geçerli düğümü DOSYAya yazar.
ORTAM DEĞİŞKENLERİ
SGML_CATALOG_FILES
SGML kataloğunun davranışı, sorgular kullanıcının kendi katalog listesine
yönlendirilerek değiştirilebilir. Bu, katalog listesi SGML_CATALOG_FILES ortam
değişkenine atanarak yapılabilir. Boş değer belirtilirse sorgular /etc/sgml/catalog
dosyasının içeriğindeki kataloglara yönlendirilir.
XML_CATALOG_FILES
XML kataloğunun davranışı, sorgular kullanıcının kendi katalog listesine
yönlendirilerek değiştirilebilir. Bu, katalog listesi XML_CATALOG_FILES ortam
değişkenine atanarak yapılabilir. Boş değer belirtilirse sorgular /etc/xml/catalog
dosyasının içeriğindeki kataloglara yönlendirilir.
XML_DEBUG_CATALOG
XML_DEBUG_CATALOG ortam değişkenine sıfırdan farklı bir değer atanarak, katalog
işlemleri ile ilgili hata ayıklama bilgilerinin çıktılanması sağlanabilir.
XMLLINT_INDENT
XMLLINT_INDENT ortam değişkenine atanan değer girintileme seviyesini belirler.
Öntanımlı değer iki boşluktur (" ").
ÇIKIŞ DURUMU
xmllint çıkış kodları, betiklerden çağrılırken kullanılabilecek bilgileri sağlar.
0 Hata yok.
1 Sınıflandırılmadı.
2 DTD’de hata var.
3 Geçerlilik doğrulama hatası.
4 Geçerlilik doğrulama hatası.
5 Şema derlenirken hata.
6 Çıktı yazılırken hata.
7 Şablonda hata (--pattern seçeneği kullanılırken üretilir)
8 Düğüm kaydında hata. (--chkregister seçeneği kullanılırken üretilir)
9 Bellek yetersiz.
10 XPath değerlendirme hatası.
YAZAN
John Fleck, Ziying Sherwin ve Heiko Rupp tarafından yazılmıştır.
İLGİLİ BELGELER
libxml(3)
Daha fazla bilgi için: <https://gitlab.gnome.org/GNOME/libxml2>
ÇEVİREN
© 2004 Yalçın Kolukısa
© 2022 Nilgün Belma Bugüner
Bu çeviri özgür yazılımdır: Yasaların izin verdiği ölçüde HİÇBİR GARANTİ YOKTUR.
Lütfen, çeviri ile ilgili bildirimde bulunmak veya çeviri yapmak için
https://github.com/TLBP/manpages-tr/issues adresinde "New Issue" düğmesine tıklayıp yeni
bir konu açınız ve isteğinizi belirtiniz.