XMLTO(1) Kullanıcı Komutları  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] [--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.
Yasal Uyarı
 * Özgün Belgenin Lisans ve Telif Hakkı bilgileri:
 *
 * xmlto - apply an XSL stylesheet to an XML document
 * Copyright (C) 2001, 2002, 2003  Tim Waugh <twaugh@redhat.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, see <http://www.gnu.org/licenses/>.