Provided by: manpages-tr_2.0.6-2_all 
İSİM
xmlto - bir XSL dönüşüm dosyasını bir XML belgesine uygular
KULLANIM
xmlto [-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
xmlto { --help| --version }
AÇIKLAMA
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.
SEÇENEKLER
-v Ayrıntılı kip (daha fazla ayrıntı için -vv).
-x özel_xsl
biçim betiğinden istemek yerine dönüşüm dosyası özel_xsl dosyasıyla doğrudan belirtilir.
-m xsl_parçası
Dönüşüm dosyasında değişiklik yapmak için xsl_parçası kullanılır.
-o dizin
Çıktıyı, içinde çalışılan dizin yerine, belirtilen dizine gönderir.
-p ardişlem_seçenekleri
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.
--extensions
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.
--searchpath dosyayolu
Girdi için olanlar da dahil olmak üzere son çare olarak kullanılacak dizinlerin iki nokta üstüste
imleri ile ayrılmış listesi.
--skip-validation
Normalde uygulanan XML doğrulama işlemini atlar.
--stringparam isim=değer
XSL-T dönüşümüne değişken atamak için komut satırından isim=değer çifti aktarmakta kullanılır.
--noclean
Geçici dosyalar silinmez (isimleri gösterilir ve tmp dizininde tutulur). Sorunları incelemek için
yararlıdır.
--noautosize
Ö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).
--noextensions
Ö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.
--profile
Profil oluşturma dönüşümüyle XML belgesini önişlemden geçirir.
--with-fop
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.
--with-dblatex
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.
--help
Kısa bir kullanım iletisi görüntüler. Kullanılabilir çıktı biçimlerini ve xmlto seçeneklerini
açıklar.
-v, --version
Sürüm bilgilerini gösterir.
ORTAM DEĞİŞKENLERİ
XSLT_PROCESSOR
XSL-T dönüşümünü yapacak uygulama komutunun adı (öntanımlı: xsltproc(1).
TMPDIR
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
YAZAN
İ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.
xmlto 0.0.25 Kasım 2011 XMLTO(1)