XMLTO(1) Kullanıcı Komutları XMLTO(1)

İSİM

xmlto - bir XSL dönüşüm dosyasını bir XML belgesine uygular

[-o çıktı_dizini] [-x özel_xsl] [-m xsl_parçası] [-v] [-p ardişlem_seçenekleri] [--extensions] [--searchpath dosyayolu] [--skip-validation] [--stringparam isim=değer] [--noclean] [--noautosize] [--noextensions] [--profile] [--with-fop] [--with-dblatex] biçim xml-dosya
{ --help| --version }

xmlto’nun amacı, gereken bütün her şeyin kullanılarak, bir XML belgesinin arzu edilen biçime dönüştürülmesini sağlamaktır. Bu iki basamaklı bir işlemdir:

1.
Bir XSL-T işlemcisi kullanılarak uygun bir XSL dönüşüm dosyasının uygulanması.
2.
Diğer araçlar ile sonraki işlemlerin gerçekleştirilmesi. Bu ikinci adım zorunlu değildir, kullanılmasa da olur.

Hangi dönüşüm dosyasının kullanılacağına ve gerekli ise işlem sonrası çıktıya neler yapılacağına karar vermek için, xmlto biçim betiklerini kullanır. Bunlar xmlto tarafından dönüşüm sırasında çağrılan basit kabuk betikleridir.

Uygun biçim betikleri, XML dosyasının ve arzu edilen çıktı dosyasının biçimine bağlıdır. xmlto, DocBook XML dosyalarını çeşitli biçimlere çevirmeye yarayan hazır betikler ile birlikte gelir. Kullanmak istediğiniz biçim betiğinin tam adını komut satırından biçim ile belirterek, istediğiniz betiği kullanabilirsiniz.

İlk olarak, xmlto’ya, –x seçeneği belirtilerek, tam olarak hangi dönüşüm dosyasının kullanılacağı belirtilmemişse, biçim betiği stylesheet komut satırı seçeneği belirtilerek çağrılır. XSLT_PROCESSOR ortam değişkeni ile, XSL-T dönüşümünü sağlayacak uygulamanın ismi belirtilebilir (örneğin xsltproc). biçim betiği, standart çıktıya kullanılacak dönüşüm dosyasının adını yazmalı ve başarılı bir şekilde çıkmalıdır. Kullanılacak uygun bir dönüşüm dosyası yok ise sıfırdan farklı bir çıkış değeri döner (örneğin; elimizdeki tek dönüşüm dosyası kullanılacak XSL-T işlemcisi ile çalışmıyorsa). Şayet standart çıktıya hiçbir şey yazılmaz ama betik başarılı bir şekilde çıkar ise, XSL-T dönüşümü gerçekleşmez.

İkinci olarak (bir dönüşüm dosyası kullanılarak bir XSL-T dönüşümü yapıldıktan sonra), biçim betiği bu kez post-process komut satırı seçeneği belirtilerek çağrılır. biçim betiği XSL-T uygulanmış çıktıyı arzu edilen biçime sokmak için gereken bütün işlemleri, çıktıyı istenen dizine kopyalamak dahil, gerçekleştirmelidir. İşlem sonrası için, biçim betiği, sadece işlenen çıktıyı içeren geçici bir dizinde çalışır. İşlenen çıktının ismi, özgün XML dosyasının dosya uzantısı .proc yapılarak elde edilir ve XSLT_PROCESSED değişkeninde saklanır. Özgün XML dosyasının ismi INPUT_FILE değişkenine, çıktıyı içerecek dizin OUTPUT_DIR değişkeniene atanır. Son olarak SEARCHPATH değişkenine iki nokta üst üste imleri ile ayrılmış son çare dizinleri atanır. Bu dizinler girdinin (örneğin resimlerin) bulunduğu yerlerdir. Şayet bu adım başarısız olursa, biçim betiği sıfırdan farklı bir değer döndürür ve çıkar.

Ayrıntılı kip (daha fazla ayrıntı için -vv).

biçim betiğinden istemek yerine dönüşüm dosyası özel_xsl dosyasıyla doğrudan belirtilir.

Dönüşüm dosyasında değişiklik yapmak için xsl_parçası kullanılır.

Çıktıyı, içinde çalışılan dizin yerine, belirtilen dizine gönderir.

Dönüşüm dosyası uygulamasından sonraki işlem evrelerine (örneğin; HTML çıktıdan metin çıktı elde etmek için links(1) veya lynx(1)’e veya TeX çıktıdan DVI elde etmek için xmltex(1)’e) bu seçenekleri aktarır. Şayet –p ikinci bir defa daha belirtmişse, seçenekler dönüşüm sonrası uygulanan ikinci aşama uygulamalara gönderilir. Bu sadece xmltex(1) ve dvips üzerinden PostScript çıktı elde edilirken uygulanabilir.

Kullanılan araç zinciri için dönüşüm genişletmelerini kullanmayı mümkün kılar. (use.extensions etkinleştirilmelidir. Etkinleştirilen değişkenler Norman Walsh’ın DocBook XSL dönüşüm dosyalarında kullandıklarıdır.

Girdi için olanlar da dahil olmak üzere son çare olarak kullanılacak dizinlerin iki nokta üstüste imleri ile ayrılmış listesi.

Normalde uygulanan XML doğrulama işlemini atlar.

XSL-T dönüşümüne değişken atamak için komut satırından isim=değer çifti aktarmakta kullanılır.

Geçici dosyalar silinmez (isimleri gösterilir ve tmp dizininde tutulur). Sorunları incelemek için yararlıdır.

Öntanımllı olarak, bazı XSL değişkenleri otomatik algılama tarafından geçersiz kılınır (paperconf (libpaper)- kağıt yapılandırması- kullanımı için page.width (sayfa.genişliği) ve page.height (sayfa.yüksekliği), yerel tabanlı (LC_PAPER) seçim için paper.type (sayfa.türü)). Bu seçenekle, xmlto bu otomatik algılamayı kullanmaz ve kullanıcı öntanımlıları kendisi değiştirebilir (ya öntanımlı param.xsl değişikliği ya da kullanıcı tanımlı XSL parçası yoluyla).

Öntanımlı olarak, xmlto, pasiftex arka ucu için pasiftex.extensions, fop arka ucu için fop.extensions ve fop1.extensions XSL değişkenini etkinleştirir. Bu genellikle daha iyi sonuçlar verir. Herhangi bir nedenle bu değişkenleri kullanmak istemiyorsanız, bu seçeneği kullanarak bunları devre dışı bırakmanız yeterlidir.

Profil oluşturma dönüşümüyle XML belgesini önişlemden geçirir.

Biçimlendirme için fop kullanılır. Bu deneysel bir seçenektir, fop’un belirli bir konumda olması umulur (yapılandırılan sürede algılanır), xmlto betiğinde FOP_PATH elle değiştirilebilir.

Biçimleme için dblatex(1) kullanılır. Deneysel bir seçenektir. Belirli bir konumda olması umulur (yapılandırılan sürede algılanır), xmlto betiğinde DBLATEX_PATH elle değiştirilebilir.

Kısa bir kullanım iletisi görüntüler. Kullanılabilir çıktı biçimlerini ve xmlto seçeneklerini açıklar.

Sürüm bilgilerini gösterir.

XSL-T dönüşümünü yapacak uygulama komutunun adı (öntanımlı: xsltproc(1).

Geçici XSL-T dönüşüm dosyalarının oluşturulacağı dizin (öntanımlı: /tmp).

ÇIKIŞ DURUMU

0
Hata yok. Beklenen çıkış kodu budur.

1
xmlto yetersiz girdi ile çağrıldı.

2
mktemp(1) dosya/dizin oluştururken başarısız oldu. /tmp veya TMPDIR yazılabilir olmalıdır.

3
xmlto yapılandırılmış konumda çalıştırılabilirleri bulamadı. Gerekli tüm paketlerin kurulu olduğundan ve xmlto betiklerinde dosya yollarının düzgün atandığından emin olunmalıdır.

10+ (Sıfırdan farklı hata kodlu XML doğrulaması)
xmlto XML belgeyi doğrulamaya çalıştı, fakat doğrulama başarısız oldu. Daha iyi tanı koymak için, doğrulama çıktısı ve xmllint(1) çıkış kodu sağlanır. Ya XML belge doğrulanabilir duruma getirilmeli ya da --skip-validation seçeneği kullanılmalıdır.

ÖRNEKLER

Bir DocBook XML belgesini PDF’ye çevirmek için:

xmlto pdf belgem.xml

Bir DocBook XML belgesini HTML’ye çevirmek ve çıktıyı HTML dosyası olarak başka bir dizinde saklamak için: 

xmlto -o html-dizini html belgem.xml

Bir DocBook XML belgesinden tek sayfalık bir HTML dosyası elde etmek için: 

xmlto html-nochunks belgem.xml

Çıktıyı bir XSL parçası kullanarak düzenlemek için: 

xmlto -m ulink.xsl pdf belgem.xml

Hangi dönüşüm dosyasının kullanılacağını tanımlamak için (biçim betiğinin seçtiğini göz ardı etmek için): 

xmlto -x dosyam.xsl pdf belgem.xml

İlk olarak Tim Waugh tarafından yazılmıştır. 0.0.19 sürümünden beri Ondřej Vašík tarafından sürdürülmektedir.

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

Kasım 2011 xmlto 0.0.25