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.