|
|
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ı
DOSYA
ya
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.
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ü
DOSYA
ya 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.
|