xmlto(1)

İ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] {biçim} {dosya}

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 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, dönüşüm dosyasını ayarlamak için $1 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 xsltproc); XSL_DIR ortam değişkeni xmlto 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 $1 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.

SEÇENEKLER

-v  Ayrıntılı kip (-vv çok ayrıntılı kip).

-x özel_xsl
    Bir biçim betiği yerine belirtilen özel_xsl dosyası kullanılır.

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

-p ardişlem_seçenekleri
    Dönüşüm dosyası uygulamasından sonraki işlem evrelerine bu seçenekleri aktarır (örneğin; HTML çıktının links veya lynx'e aktarılması veya Tex'den DVI'ya giderken çıktının xmltex'e aktarılması) şayet -p ikinci bir defa daha belirtmişse, seçenekler dönüşüm sonrası ikinci aşama uygulamalara gönderilir. Bu sadece xmltex ve dvips'ten PostScript çıktı elde edilirken uygulanabilir.

--extensions
    Kullandığınız araç zinciri için dönüşüm genişletmelerini kullanmayı mümkün kılar. Örneğin, PassiveTeX kullanılıyorsa "passivetex.extensions" ve "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 dizin isimlerinin iki nokta üstüste işaretleri ile ayrılmış listesi.

--skip-validation
    Normalde uygulanan geçerlilik işlemini atlar.

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

Ö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
Tim Waugh <twaugh (at) redhat.com> tarafından yazılmıştır.

ÇEVİREN
Yalçın Kolukısa <yalcin (at) belgeler.org>, Şubat 2004