XSLTPROC(1) Kullanıcı Komutları  XSLTPROC(1)

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

Bilginize

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.
Yasal Uyarı
 * Özgün Belgenin Lisans ve Telif Hakkı bilgileri:
 *
 * Copyright (C) 1998-2022 Daniel Veillard.  All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files
 * (the "Software"), to deal in the Software without restriction,
 * including without limitation the rights to use, copy, modify, merge,
 * publish, distribute, sublicense, and/or sell copies of the Software,
 * and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.