İ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

                                                                                      xsltproc(1)