xsltproc(1)

İ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