İ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