.\" http://belgeler.org \- 2009\-10\-29T15:35:46+02:00 .TH "xmlto" 1 "Ekim 2002" "Linux" "xmlto" .nh .PD 0 .SH İSİM xmlto \- bir XSL dönüşüm dosyasını bir XML belgesine uygular .SH KULLANIM .nf \fBxmlto\fR [\fB\-o \fR\fIçıktı_dizini\fR] [\fB\-x \fR\fIözel_xsl\fR] [\fB\-m \fR\fIxsl_parçası\fR] \ [\fB\-v\fR] [\fB\-p \fR\fIardişlem_seçenekleri\fR] [\fB\-\-extensions\fR] \ [\fB\-\-searchpath \fR\fIdosyayolu\fR] [\fB\-\-skip\-validation\fR] {\fIbiçim\fR} {\fIdosya\fR} .fi .SH AÇIKLAMA \fBxmlto\fR\N'39'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: .IP 1. 3 Bir XSL\-T işlemcisi kullanılarak uygun bir XSL dönüşüm dosyasının uygulanması. .IP 2. 3 Diğer araçlar ile sonraki işlemlerin gerçekleştirilmesi. Bu ikinci adım zorunlu değildir, kullanılmasa da olur. .PP 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, \fBxmlto\fR biçim betiklerini kullanır. Bunlar \fBxmlto\fR 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. \fBxmlto\fR, 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 belirterek, istediğiniz betiği kullanabilirsiniz. İlk olarak, \fBxmlto\fR\N'39'ya, \fB\-x\fR seçeneği belirtilerek, tam olarak hangi dönüşüm dosyasının kullanılacağı belirtilmemişse, dönüşüm dosyasını ayarlamak için \fB$1\fR ile biçim betiği ç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 \fBxsltproc\fR); XSL_DIR ortam değişkeni \fBxmlto\fR ile birlikte gelen birkaç faydalı dönüşüm dosyasının bulunduğu dizine giden yolu tanımlar. Biçim betiği, standart çıktı için 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ır harici 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 işlemi yapıldıktan sonra), biçim betiği tekrar çağrılır. Bu sefer \fB$1\fR süreç sonrası için ayarlanı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ı (bu çıktının ismi XSLT_PROCESSED içinde saklanır ve bu isim, orjinal XML dosyasının uzantısının .proc ile değiştirilmiş halidir). INPUT_FILE orjinal XML dosyasının adına ayarlanır, OUTPUT_DIR çıktının en sonunda gönderileceği dizine ayarlanır ve SEARCHPATH ise iki nokta üst üste işareti ile ayrılmış son çare dizinlerine ayarlanır. Bu dizinler girdinin (örneğin resimlerin) arandığı 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. .SH SEÇENEKLER .br .ns .TP \fB\-v\fR Ayrıntılı kip (\fB\-vv\fR çok ayrıntılı kip). .TP \fB\-x \fR\fIözel_xsl\fR Bir biçim betiği yerine belirtilen \fIözel_xsl\fR dosyası kullanılır. .TP \fB\-m \fR\fIxsl_parçası\fR Dönüşüm dosyasında değişiklik yapmak için \fIxsl_parçası\fR kullanılır. .TP \fB\-o \fR\fIdizin\fR Çıktıyı, içinde çalışılan dizin yerine, belirtilen \fIdizin\fRe koyar. .TP \fB\-p \fR\fIardişlem_seçenekleri\fR Dönüşüm dosyası uygulamasından sonraki işlem evrelerine bu seçenekleri aktarır (örneğin; HTML çıktının links veya lynx\N'39'e aktarılması veya Tex\N'39'den DVI\N'39'ya giderken çıktının xmltex\N'39'e aktarılması) şayet \fB\-p\fR ikinci bir defa daha belirtmişse, seçenekler dönüşüm sonrası ikinci aşama uygulamalara gönderilir. Bu sadece xmltex ve dvips\N'39'ten PostScript çıktı elde edilirken uygulanabilir. .TP \fB\-\-extensions\fR Kullandığınız araç zinciri için dönüşüm genişletmelerini kullanmayı mümkün kılar. Örneğin, PassiveTeX kullanılıyorsa \N'34'passivetex.extensions\N'34' ve \N'34'use.extensions\N'34' etkinleştirilmelidir. Etkinleştirilen değişkenler Norman Walsh\N'39'ın DocBook XSL dönüşüm dosyalarında kullandıklarıdır. .TP \fB\-\-searchpath \fR\fIdosyayolu\fR Girdi için olanlar da dahil olmak üzere son çare olarak kullanılacak dizin isimlerinin iki nokta üstüste işaretleri ile ayrılmış listesi. .TP \fB\-\-skip\-validation\fR Normalde uygulanan geçerlilik işlemini atlar. .TP \fB\-\-help\fR Kısa bir kullanım iletisi görüntüler. Kullanılabilir çıktı biçimlerini ve \fBxmlto\fR seçeneklerini açıklar. .TP \fB\-v\fR, \fB\-\-version\fR Sürüm bilgilerini gösterir. .PP .SH ÖRNEKLER Bir DocBook XML belgesini PDF\N'39'ye çevirmek için: .nf xmlto pdf belgem.xml .fi Bir DocBook XML belgesini HTML\N'39'ye çevirmek ve çıktıyı HTML dosyası olarak başka bir dizinde saklamak için: .nf xmlto \-o html\-dizini html belgem.xml .fi Bir DocBook XML belgesinden tek sayfalık bir HTML dosyası elde etmek için: .nf xmlto html\-nochunks belgem.xml .fi Çıktıyı bir XSL parçası kullanarak düzenlemek için: .nf xmlto \-m ulink.xsl pdf belgem.xml .fi 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): .nf xmlto \-x dosyam.xsl pdf belgem.xml .fi .SH YAZAN Tim Waugh tarafından yazılmıştır. .SH ÇEVİREN Yalçın Kolukısa , Şubat 2004