Provided by: manpages-tr_2.0.6-2_all bug

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

libxml2 2.10.1                                   17 Ağustos 2022                                      XMLLINT(1)