xmllint

XMLLINT(1)

Kullanıcı Komutları

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

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.

Yasal Uyarı

 * Özgün Belgenin Lisans ve Telif Hakkı bilgileri:
 *
 * Copyright (C) 1998-2022 Daniel Veillard.  All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files
 * (the "Software"), to deal in the Software without restriction,
 * including without limitation the rights to use, copy, modify, merge,
 * publish, distribute, sublicense, and/or sell copies of the Software,
 * and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

libxml2 2.10.1

17 Ağustos 2022

XMLLINT(1)