Scroll to navigation

XMLLINT(1) Kullanıcı Komutları XMLLINT(1)

İSİM

xmllint - komut satırı XML aracı

KULLANIM

[ --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 ...| - }
--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):

Denemek amacıyla küçük bir belge üretir.

SGML_CATALOG_FILES ortam değişkeninde belirtilen katalogları kullanır. Aksi taktirde, öntanımlı olarak /etc/xml/catalog kullanılır.

Düğüm kaydını açar. Geliştiriciler için libxml(3) düğüm izleme kodlarını sınarken faydalıdır.

Çıktıya gzip(1) sıkıştırması uygular.

Gerçeklemenin dahili kopyasını sınar.

Çö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.

Geçerlilik doğrulamasında kullanılacak DTD URL’den (İnternette kaynağın bulunduğu konumu belirten eşsiz adresten) okunur.

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).

Bir dosyayı çözümler ve belgenin bellekteki sürümünün açıklamalı ağacını çıktılar.

Belgede tanımlı ENTITY alanlarında hata ayıklar.

Çıktıdan DTD kaldırılır.

Harici DTD alınır ve ağaç, miras alınan öznitelikler ile oluşturulur.

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.

Çı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).

Kısa kullanım bilgisi gösterir ve çıkar.

HTML çözümleyicisi kullanılır.

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.

Geçerli yerleştirmeleri sınar.

Harici DTD okunur.

İşlem sırasında yüklenen tüm belgeleri standart hataya döker.

Çö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.

Çözümleme bellekten yapılır.

Yoksayılabilir boş alanları kaldırır.

Herhangi bir katalog kullanılmaz.

CDATA bölümleri yerine eşdeğeri metin düğümleri kullanılır.

Öğe başvurularını değerleriyle değiştirir. Öntanımlı olarak, xmllint, bu başvurulara (&başvuru;) dokunmaz.

DTD’ler ve öğe başvuruları için interneti kullanmaz.

Sonuçlar çıktılanmaz. Öntanımlı olarak, xmllint sonuç ağacını çıktılar.

Çözümleme sırasında ve geçerlilik doğrulamasında uyarılar çıktılanmaz.

HTML etiketleri ile sarmalama yapılmaz.

XInclude işlemesi yapar ama XInclude başlangıç ve bitiş düğümlerini üretmez.

Gereksiz isim uzayı bildirimleri kaldırılır.

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.

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.

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.

DTD geçerlilik doğrulaması belge çözümlendikten sonra yapılır.

Çözümleyicinin itme kipi kullanılır.

Geçersiz bir belgenin çözümlenebilir bölümlerini çıktılar.

Geçerliliği doğrulamak için ŞEMA isimli RELAXNG dosyası kullanılır.

Zamanlama ve en iyileme için işlemi 100 kere tekrarlar.

Geçerliliği doğrulamak için ŞEMA isimli W3C XML şeması dosyası kullanılır.

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.

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.

Kullanıcı G/Ç desteğini sınar.

xmllint’in çeşitli adımları gerçekleştirmek için harcadığı sürenin görüntülenmesini sağlar.

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.

Kullanılan libxml(3) sürüm bilgisini gösterir.

XInclude çözümlemesi uygulanır.

--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.

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:

Düğümün XML kökünü gösterir.

Kabuktan çıkar.

Geçerli olan düğümü veya belirtilen düğümü görüntüler.

YOL düğümünü (eşsiz ise) geçerli düğüm yapar. YOL belirtilmemişse kök düğüm geçerli düğüm olur.

Düğüm bilgilerini (isim uzayı, öznitelikler, içerik) dökümler.

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.

Kabuğu bırakır.

Bellek kullanımını görüntüler.

Bu yardım iletilerini görüntüler.

DOSYA içeriğini yeni belge yapar.

YOL’un (şayet belirtilmişse) veya geçerli dizinin içeriğini listeler.

Geçerli düğümün yolunu görüntüler.

Kabuğu bırakır.

Belgeyi belirtilmişse DOSYA adı ile, belirtilmemişse kendi adı ile kaydeder.

Belgenin hatalara karşı doğruluğunu sınar.

Geçerli düğümü DOSYAya yazar.

ORTAM DEĞİŞKENLERİ

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 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 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 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.

17 Ağustos 2022 libxml2 2.10.1