İ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