İ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