İSİM¶
xsltproc - komut satırı xslt işlemcisi
KULLANIM¶
xsltproc [-V | -v | -o dosya | --timing | --repeat
| --debug | --novalid | --noout | --maxdepth değer
| --html | --docbook | --param isim değer
| --stringparam isim değer | --nonet | --catalogs
| --xinclude | --profile | --dumpextensions | --nowrite
| --nomkdir | --writesubtree] [xsl_betiği] [dosya1]
[ dosya2] [....]
GİRİŞ¶
xsltproc, XML belgelerine XSLT şablonlarını uygulamak
için kullanılan bir komut satırı aracıdır. GNOME
projesinin XSLT C kütüphanesi olan libxslt'nin bir
parçasıdır. GNOME projesinin bir parçası olarak
geliştirilmesine rağmen, GNOME masaüstü ortamından
bağımsız olarak da kullanılabilir.
xsltproc, komut satırından xslt şablonlarını
içeren betiğin adı ve bu şablonların
uygulanacağı dosya veya dosyaların adı belirtilerek
kullanılır.
Şayet bir XML belge içinde xslt betiği ile ilgili bir işlem
komutu varsa, komut satırında xslt betiğinin isminin bildirmesi
gerekmez.
xsltproc, bu betiği bulur ve onu kullanır.
Öntanımlı olarak, çıktı standart
çıktıya yazılır.
-o seçeneğini
kullanarak çıktı için bir dosya belirtebilirsiniz.
KOMUT SATIRI SEÇENEKLERݶ
- -V, --version
- libxml ve libxslt'nin sürüm
numaralarını verir.
- -v, --verbose
- XML belgenin ve xslt dosyasının işlenmesi
sırasında xsltproc tarafından
gerçekleştirilen bütün adımlar hakkında
ayrıntılı bilgi verilir.
- -o, --output dosya_adı
- Çıktı dosya_adı ile belirtilen
dosyaya yazılır. "Tomarlama" (chunking) diye bilinen
çoğul çıktılar için, -o
dizin/ şeklinde kullanım, bütün dosyaların
dizin ile belirtilen dizinin altına gönderilmesini
sağlar. Dizin sistemde mevcut olan bir dizin olmalıdır.
- --timing
- XML belgenin ve XSLT şablon dosyasının
çözümlenmesi ve belgeye şablonların
uygulanması ile sonuçların kaydedilmesi sırasında
geçen süreyi görüntüler. Sonuç milisaniye
cinsindendir.
- --repeat
- Dönüşümü 20 kere
gerçekleştirir. Zaman testi için kullanılır.
- --debug
- Hata ayıklama amacıyla,
dönüştürülmüş belgenin XML
ağacını çıktılar.
- --novalid
- Belgenin DTD'sinin yüklenmesi adımını
atlar.
- --noout
- Sonuçlar çıktılanmaz.
- --maxdepth değer
- Libxslt'nin bir sonsuz döngüye girmesini
engellemek üzere şablon yığıtının
derinliğini sınırlamakta kullanılır.
Öntanımlı değeri 500'dür.
- --html
- Girdi olarak verilen belge bir HTML dosyasıdır.
- --docbook
- Girdi olarak verilen belge bir DocBook SGML
dosyasıdır. DocBook XML belgelerle çalışmak
için --docbook seçeneğini kullanmayın. Bu
seçenek sadece Docbook'un SGML sürümüne
sınırlı bir destek vermek için
tasarlanmıştır.
- --param isim değer
- XSLT şablonunun isim parametresine
değer değerini aktarmakta kullanılır En fazla
32 çift isim/değer çifti aktarabilirsiniz. Şayet
verilen değer bir düğüm
tanımlayıcısı değil de bir dizge ise,
--stringparam seçeneğini kullanmak daha uygundur.
- --stringparam isim değer
- Değerin bir düğüm
tanımlayıcısı değil de bir dizge olduğu
durumlarda, XSLT şablonunun isim parametresine
değer değerini aktarmakta kullanılır. Dizge
mutlaka UTF-8 kodlanmış olmalıdır.
- --nonet
- DTD'ler ve öğeler sadece yerel dosya sisteminden
alınır.
- --catalogs
- Harici girdilerin aranacağı yerler için
SGML_CATALOG_FILES içinde tanımlanmış SGML
kataloglarını kullanır. Öntanımlı olarak,
xsltproc XML_CATALOG_FILES içinde belirtilmiş kataloglara
bakar. Şayet bu da belirtilmemiş ise /etc/xml/catalog
kullanılır.
- --xinclude
- Belgeyi Xinclude belirtimini kullanarak işler.
Xinclude belirtimi hakkkında ayrıntılı bilgi için
bakınız: http://www.w3.org/TR/xinclude/
- --profile, --norman
- XSLT şablonlarının her bir
bölümü için harcanan zaman hakkında kısa bir
bilgi verir. XSLT şablonlarının
başarımını eniyilemek için
uğraşırken faydalı olabilir.
- --dumpextensions
- Kayıtlı bütün eklentilerin listesini
standart çıktıya yazar.
- --nowrite
- Çıktı herhangi bir dosya veya kaynağa
yazılmaz.
- --nomkdir
- Çıktı dizinleri oluşturulmaz.
- --writesubtree dosyayolu
- Yazma işlemi sadece dosyayolu ile belirtilen
dizinin alt dizinlerinde yapılır.
DÖNEN DEĞERLER¶
xsltproc'un geri döndürdüğü değerler,
xsltproc'u bir betik aracılığı ile
çalıştırmayı denediğiniz durumlarda işinize
yarayabilir.
0: normal
1: argüman belirtilmemiş
2: çok fazla parametre verilmiş
3: bilinmeyen seçenek
4: xslt şablon dosyası çözümlenemedi
5: xslt şablon dosyasında hata
6: belgelerden birinde hata var
7: desteklenmeyen xsl:output yöntemi
8: dizge parametresi hem çift tırnak hem de tek tırnak içeriyor
9: dahili işlem hatası
10: işlemin bitirilmesini gerektiren bir ileti tarafından süreç durduruldu
AYRINTILI BİLGİ İÇİN¶
libxml sanalyöresi:
http://www.xmlsoft.org/
W3C XSLT belirtimi:
http://www.w3.org/TR/xslt/
YAZAN¶
John Fleck <jfleck (at) inkstain.net> tarafından
yazılmıştır.
ÇEVİREN¶
Yalçın Kolukısa <yalcink01 (at) yahoo.com>, Ocak 2004