İSİM

       xsltproc - komut satırı xslt işlemcisi

KULLANIM

       xsltproc [ -V | --version ] [ -v | --verbose ] [{ -o | --output } { DOSYA | DİZİN }] [
                --timing | --repeat | --debug | --novalid | --noout | --maxdepth DEĞER |
                --maxvars DEĞER | --maxparserdepth DEĞER| --huge| --seed-rand TOHUM | --html|
                --encoding KODLAMA | --param İSİM DEĞER| --stringparam İSİM DEĞER | --nonet |
                --path YOL(LAR)" | --load-trace | --catalogs | --xinclude | --xincludestyle | [
                --profile | --norman ]| --dumpextensions | --nowrite | --nomkdir | --writesubtree
                YOL | --nodtdattr ] [XSL-BETİĞİ] { XML-DOSYA...| - }

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(3)’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 veya –-output seçeneğini kullanarak
       çıktı için bir dosya belirtebilirsiniz.

SEÇENEKLER

       xsltproc şu seçenekleri kabul eder (abecesel sıralıdı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.

       --debug
           Hata ayıklama amacıyla, dönüştürülmüş belgenin XML ağacını çıktılar.

       --dumpextensions
           Kayıtlı tüm eklentileri standart çıktıya listeler.

       --encoding KODLAMA
           Girdi için karakter KODLAMAsı belirtilmesini sağlar.

       --html
           Girdi olarak verilen belge bir HTML dosyasıdır.

       --load-trace
           İşlem sırasında yüklenen tüm belgeleri standart hatada gösterir.

       --maxdepth DEĞER
           libxslt(3)’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 3000’dir.

       --maxvars DEĞER
           Azami değişken sayısı. Öntanımlı değeri 15000’dir.

       --maxparserdepth DEĞER
           Çözümlenecek XML belgenin azami eleman iç içelik derinliği. 256 öntanımlıdır.

       --huge
           XML_PARSE_HUGE çözümleyici seçeneğini ayarlayarak XML çözümleyicinin sabit kodlanmış
           sınırlarını gevşetir.

       --seed-rand TOHUM
           Sözde rastgele sayı üretecini TOHUM ile ilklendirir.

       --nodtdattr
           Belge DTD’sindeki öntanımlı öznitelikler uygulanmaz.

       --nomkdir
           Dizinlerin oluşturulması reddedilir.

       --nonet
           DTD’ler, öğeler ve belgeleri almak için İnternet kullanılmaz.

       --noout
           Sonuçlar çıktılanmaz.

       --novalid
           Belge DTD’sinin yüklenmesi adımını atlar.

       --nowrite
           Herhangi bir dosyanın veya özkaynağın yazıllması reddedilir.

       -o, --output DOSYA | DİZİN
           Çıktı DOSYA ile belirtilen dosyaya yazılır. "kümeleme" (chunking) diye bilinen çoğul
           çıktılar ve kılavuz sayfaları için, dosyalar DİZİN ile belirtilen dizinin altına
           gönderilir.

           Önemli:
               Dizin sistemde mevcut olan bir dizin olmalıdır.

           Bilgi:
               DİZİN RFC 2396’nın “URI reference computation” bölümündeki açıklamaya uygun
               olmalıdır. Yani, örneğin -o dizin belki çalışır ama -o dizin/ kesin çalışacaktır.

               Ç.N. - Dizin belirtilir ve "I/O error : Is a directory" hatası alınırsa, dizinin
               sonuna örn. ’beni.sil’ eklenerek hatadan kurtulmak mümkündür. ’beni.sil’
               dosyalarınızla birlikte belirttiğiniz dizine yazılacaktır. İçinde muhtemelen
               çıktılanması unutulan veya çıktılanmaması gereken şeyler olacaktır.

       --param İSİM DEĞER
           XSLT şablonuna İSİM DEĞER çifti aktarmakta kullanılır. Böyle en fazla 32 İSİM DEĞER
           çifti belirtebilirsiniz. Değer bir dizge ise dizge ifadelerinde görülen ek tırnak
           imlerinden kaçınmak için --stringparam seçeneği kullanılmalıdır. XPath ifadesi mutlaka
           UTF-8 kodlanmış olmalıdır.

       --path "YOL(LAR)"
           DTD’leri, öğeleri ve belgeleri 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.

       --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 faydalı olabilir.

       --repeat
           Dönüşümü 20 kere gerçekleştirir. Zaman sınamaları için kullanılır.

       --nomkdir
           Çıktı dizinleri oluşturulmaz.

       --nowrite
           Çıktı herhangi bir dosya veya kaynağa yazılmaz.

       --stringparam İSİM DEĞER
           Değerin bir düğüm tanımlayıcısı değil de bir dizge olduğu durumlarda, XSLT şablonunun
           İSİM değişkenine DEĞER değerini aktarmakta kullanılır. Dizge mutlaka UTF-8 kodlanmış
           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.

       -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.

       -V, --version
           libxml(3) ve libxslt(3)’nin sürüm numaralarını gösterir.

       --writesubtree YOL
           Dosyalar sadece YOL dizinine ve alt dizinlerine yazılır.

       --xinclude
           Belgeyi Xinclude belirtimini kullanarak işler. Xinclude belirtimi hakkkında ayrıntılı
           bilgi için: http://www.w3.org/TR/xinclude/

       --xincludestyle
           XSLT şablonunu Xinclude belirtimini kullanarak işler.

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.

ÇIKIŞ DURUMU

       xsltproc çıkış kodları, betiklerden çağrılırken kullanılabilecek bilgileri sağlar.

       0   Hata yok (normal işlem).

       1   Hiç girdi yok.

       2   Çok fazla girdi var.

       3   Bilinmeyen seçenek.

       4   XSL şablonu çözümlenemedi.

       5   XSL şablonunda hata.

       6   Belgelerden birinde hata.

       7   Desteklenmeyen xsl:output yöntemi

       8   Hem tek hem de çift tırnak içeren dizge girdi.

       9   Dahili işlem hatası.

       10  İşlem bir sonlandırma iletisi ile durduruldu.

       11  Sonuç çıktı dosyasına yazılamadı.

İLGİLİ BELGELER

       libxml sanalyöresi: http://www.xmlsoft.org/
       W3C XSLT belirtimi (Türkçe): http://belgeler.org/recs/xslt/

YAZAN

       John Fleck tarafından yazılmıştır.

Ç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.