xsltproc(1) · macOS Kılavuz Sayfası

Özet

       xsltproc [[-V | --version] [-v | --verbose] [{-o | --output} {FILE | DIRECTORY}] | --timing |
		--repeat | --debug | --novalid | --noout | --maxdepth VALUE | --maxvars VALUE |
		--maxparserdepth VALUE | --huge | --seed-rand VALUE | --html | --encoding ENCODING
		| --param PARAMNAME PARAMVALUE	| --stringparam PARAMNAME PARAMVALUE  | --nonet |
		--path "PATH(S)" | --load-trace | --catalogs | --xinclude | --xincludestyle |
		[--profile | --norman] | --dumpextensions | --nowrite | --nomkdir |
		--writesubtree PATH | --nodtdattr] [STYLESHEET] {XML-FILE... | -}

Açıklama

xsltproc, XML belgelerine XSLT stil sayfalarını (stylesheets) uygulamak için kullanılan bir komut satırı aracıdır. GNOME için XSLT C kütüphanesi olan libxslt(3)'ün bir parçasıdır. GNOME projesinin bir parçası olarak geliştirilmiş olsa da, GNOME masaüstünden bağımsız olarak çalışabilir.

xsltproc, kullanılacak stil sayfasının adı ve ardından stil sayfasının uygulanacağı dosya veya dosyaların adı ile komut satırından çağrılır. Sağlanan dosya adı - ise standart girdiyi (stdin) kullanır.

Bir XML belgesine bir Stil Sayfası İşleme Talimatı (Stylesheet Processing Instruction) ile bir stil sayfası dahil edilmişse, komut satırında herhangi bir stil sayfası adının belirtilmesine gerek yoktur. xsltproc dahil edilen stil sayfasını otomatik olarak tespit edecek ve kullanacaktır.

Varsayılan olarak çıktı standart çıktıya (stdout) verilir. -o veya --output seçeneğini kullanarak çıktı için bir dosya belirtebilirsiniz.

Seçenekler

xsltproc aşağıdaki seçenekleri kabul eder (alfabetik sırayla):

--catalogs Harici varlıkların (entities) konumunu çözümlemek için SGML_CATALOG_FILES içinde belirtilen SGML kataloğunu kullanır. Varsayılan olarak xsltproc, XML_CATALOG_FILES içinde belirtilen kataloğu arar. Eğer bu belirtilmemişse, /etc/xml/catalog adresini kullanır.

--debug Hata ayıklama amacıyla dönüştürülen belgenin bir XML ağacını çıktı olarak verir.

--dumpextensions Kayıtlı tüm uzantıların (extensions) listesini standart çıktıya (stdout) döker.

--html Girdi belgesi bir HTML dosyasıdır.

--load-trace İşlem sırasında yüklenen tüm belgeleri standart hataya (stderr) görüntüler.

--maxdepth VALUE libxslt(3) sonsuz bir döngüde olduğu sonucuna varmadan önce şablon yığınının (template stack) maksimum derinliğini ayarlar. Varsayılan değer 3000'dir.

--maxvars VALUE Maksimum değişken sayısı. Varsayılan değer 15000'dir.

--maxparserdepth VALUE Ayrıştırılan XML belgelerinin maksimum öğe iç içe yerleştirme (nesting) seviyesidir. Varsayılan değer 256'dır.

--huge XML_PARSE_HUGE ayrıştırıcı seçeneğini ayarlayarak XML ayrıştırıcısının sabit sınırlarını gevşetir.

--seed-rand VALUE Sözde rastgele sayı üretecini (pseudo random number generator) belirli bir başlangıç değeri (seed) ile başlatır.

--nodtdattr Belgenin DTD'sinden gelen varsayılan öznitelikleri uygulamaz.

--nomkdir Dizin oluşturmayı reddeder.

--nonet DTD'leri, varlıkları veya belgeleri getirmek için interneti kullanmaz.

--noout Sonucu çıktı olarak vermez.

--novalid Belgenin DTD'sini yüklemeyi atlar.

--nowrite Herhangi bir dosyaya veya kaynağa yazmayı reddeder.

-o veya --output DOSYA | DİZİN Çıktıyı belirtilen DOSYA'ya yönlendirir. Bu seçeneğin bir DİZİN ile kullanılması, çıktı dosyalarını belirtilen dizine yönlendirir. Bu, birden fazla çıktı (ayrıca "parçalama" - "chunking" olarak da bilinir) veya kılavuz sayfası işleme için yararlı olabilir.

Önemli Belirtilen dizin halihazırda mevcut olmalıdır.

Not DOSYA ve DİZİN ifadelerinin RFC 2396 ve sonrakilerde açıklandığı gibi “URI referans hesaplaması” kurallarına uyduğundan emin olun. Bu, örneğin -o dizin komutunun çalışmayabileceği, ancak -o dizin/ komutunun çalışacağı anlamına gelir.

--encoding ENCODING Girdi için kodlama (encoding) belirtilmesine olanak tanır.

--param PARAMNAME PARAMVALUE Stil sayfasına PARAMETRE_ADI adında ve PARAMETRE_DEĞERİ değerinde bir parametre iletir. En fazla 32 adet olmak üzere birden fazla ad/değer çifti iletebilirsiniz. İletilen değer bir dizgi (string) ise, dizgi ifadelerinde görünen ek tırnak karakterlerini önlemek için bunun yerine --stringparam kullanabilirsiniz. Not: XPath ifadesi UTF-8 kodlu olmalıdır.

--path "YOL(LAR)" DTD'leri, varlıkları veya belgeleri yüklemek için YOL(LAR) tarafından belirtilen (boşluk veya iki nokta üst üste ile ayrılmış) dosya sistemi yolları listesini kullanır. Boşlukla ayrılmış listeleri tırnak işaretleri içine alın.

--profile veya --norman Stil sayfasının her bir bölümünde harcanan zaman miktarını ayrıntılarıyla gösteren profil oluşturma (profiling) bilgilerini çıktı verir. Bu, stil sayfası performansını optimize etmede yararlıdır.

--repeat Dönüşümü 20 kez çalıştırır. Zamanlama testleri için kullanılır.

--stringparam PARAMNAME PARAMVALUE PARAMETRE_DEĞERİ değerinin bir düğüm tanımlayıcısından ziyade bir dizgi (string) olduğu durumlarda PARAMETRE_ADI adında ve PARAMETRE_DEĞERİ değerinde bir parametre iletir. Not: Dizgi UTF-8 kodlu olmalıdır.

--timing Stil sayfasının ayrıştırılması, belgenin ayrıştırılması, stil sayfasının uygulanması ve sonucun kaydedilmesi için harcanan süreyi görüntüler. Milisaniye cinsinden gösterilir.

-v veya --verbose xsltproc tarafından stil sayfası ve belgenin işlenmesinde atılan her adımı çıktı olarak verir.

-V veya --version Kullanılan libxml(3) ve libxslt(3) sürümlerini gösterir.

--writesubtree PATH Dosya yazma işlemine yalnızca YOL (PATH) alt ağacı içinde izin verir.

--xinclude Girdi belgesini XInclude belirtimini kullanarak işler. Bu konuda daha fazla ayrıntı XInclude belirtiminde bulunabilir: http://www.w3.org/TR/xinclude/

--xincludestyle Stil sayfasını XInclude ile işler.

Ortam Değişkenleri

SGML_CATALOG_FILES SGML katalog davranışı, sorgular kullanıcının kendi katalog kümesine yönlendirilerek değiştirilebilir. Bu, SGML_CATALOG_FILES ortam değişkeni bir katalog listesine ayarlanarak yapılabilir. Boş bir liste, varsayılan /etc/sgml/catalog kataloğunun yüklenmesini devre dışı bırakmalıdır.

XML_CATALOG_FILES XML katalog davranışı, sorgular kullanıcının kendi katalog kümesine yönlendirilerek değiştirilebilir. Bu, XML_CATALOG_FILES ortam değişkeni bir katalog listesine ayarlanarak yapılabilir. Boş bir liste, varsayılan /etc/xml/catalog kataloğunun yüklenmesini devre dışı bırakmalıdır.

Teşhis

xsltproc dönüş kodları, betiklerden çağrıldığında kullanılabilecek bilgiler sağlar.

0 Hata yok (normal çalışma)

1 Argüman yok

2 Çok fazla parametre

3 Bilinmeyen seçenek

4 Stil sayfası ayrıştırılamadı

5 Stil sayfasında hata

6 Belgelerden birinde hata

7 Desteklenmeyen xsl:output yöntemi

8 Dizgi parametresi hem tek hem de çift tırnak içeriyor

9 Dahili işlem hatası

10 İşlem, bir sonlandırma mesajı ile durduruldu

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

Ayrıca Bakınız

libxml(3), libxslt(3)

Daha fazla bilgi şu adreslerde bulunabilir:

• libxml(3) web sayfası https://gitlab.gnome.org/GNOME/libxslt

• W3C XSLT sayfası http://www.w3.org/TR/xslt

Yazar

John Fleck jfleck@inkstain.net Yazar.

Telif Hakkı

libxslt $Date$ XSLTPROC(1)