XMLLINT(1)

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