Provided by: manpages-tr_1.0.5.1-2_all bug

ISIM

       xmlto - bir XSL donusum dosyasini bir XML belgesine uygular

KULLANIM

       xmlto [-o ,cikti_dizini] [-x "ozel_xsl] [-m xsl_par,casi]
             [-v] [-p ardi,slem_se,cenekleri] [--extensions]
             [--searchpath dosyayolu] [--skip-validation] {bi,cim} {dosya}

A,CIKLAMA

       xmlto'nun   amaci,  gereken  butun  her  seyin  kullanilarak,  bir  XML
       belgesinin arzu edilen  bicime  donusturulmesini  saglamaktir.  Bu  iki
       basamakli bir islemdir:

       1. Bir  XSL-T  islemcisi  kullanilarak uygun bir XSL donusum dosyasinin
          uygulanmasi.

       2. Diger araclar ile sonraki islemlerin gerceklestirilmesi.  Bu  ikinci
          adim zorunlu degildir, kullanilmasa da olur.

       Hangi  donusum  dosyasinin kullanilacagina ve gerekli ise islem sonrasi
       ciktiya neler yapilacagina karar vermek icin, xmlto  bicim  betiklerini
       kullanir.  Bunlar  xmlto  tarafindan  donusum  sirasinda cagrilan basit
       kabuk betikleridir.

       Uygun bicim betikleri, XML dosyasinin ve arzu edilen  cikti  dosyasinin
       bicimine  baglidir.  xmlto,  DocBook  XML dosyalarini cesitli bicimlere
       cevirmeye  yarayan  hazir  betikler  ile  birlikte   gelir.   Kullanmak
       istediginiz  bicim  betiginin  tam  adini  komut satirindan belirterek,
       istediginiz betigi kullanabilirsiniz.

       Ilk olarak,  xmlto'ya,  -x  secenegi  belirtilerek,  tam  olarak  hangi
       donusum  dosyasinin  kullanilacagi  belirtilmemisse,  donusum dosyasini
       ayarlamak icin $1  ile  bicim  betigi  cagrilir.  XSLT_PROCESSOR  ortam
       degiskeni   ile,   XSL-T   donusumunu   saglayacak   uygulamanin   ismi
       belirtilebilir (ornegin xsltproc); XSL_DIR ortam  degiskeni  xmlto  ile
       birlikte gelen birkac faydali donusum dosyasinin bulundugu dizine giden
       yolu tanimlar. Bicim betigi, standart cikti icin  kullanilacak  donusum
       dosyasinin   adini   yazmali   ve   basarili  bir  sekilde  cikmalidir.
       Kullanilacak uygun bir donusum dosyasi yok ise sifir harici  bir  cikis
       degeri  doner  (ornegin;  elimizdeki  tek  donusum dosyasi kullanilacak
       XSL-T islemcisi ile calismiyorsa). Sayet standart  ciktiya  hicbir  sey
       yazilmaz  ama  betik  basarili  bir  sekilde  cikar ise, XSL-T donusumu
       gerceklesmez.

       Ikinci olarak  (bir  donusum  dosyasi  kullanilarak  bir  XSL-T  islemi
       yapildiktan  sonra),  bicim  betigi  tekrar cagrilir. Bu sefer $1 surec
       sonrasi icin ayarlanir. Bicim  betigi  XSL-T  uygulanmis  ciktiyi  arzu
       edilen  bicime  sokmak  icin  gereken  butun islemleri, ciktiyi istenen
       dizine kopyalamak dahil, gerceklestirmelidir. Islem sonrasi icin, bicim
       betigi,  sadece islenen ciktiyi (bu ciktinin ismi XSLT_PROCESSED icinde
       saklanir ve bu isim,  orjinal  XML  dosyasinin  uzantisinin  .proc  ile
       degistirilmis   halidir).   INPUT_FILE  orjinal  XML  dosyasinin  adina
       ayarlanir,  OUTPUT_DIR  ciktinin  en   sonunda   gonderilecegi   dizine
       ayarlanir ve SEARCHPATH ise iki nokta ust uste isareti ile ayrilmis son
       care dizinlerine ayarlanir. Bu dizinler girdinin  (ornegin  resimlerin)
       arandigi  yerlerdir.  Sayet  bu  adim  basarisiz  olursa,  bicim betigi
       sifirdan farkli bir deger dondurur ve cikar.

SE,CENEKLER

       -v     Ayrintili kip (-vv cok ayrintili kip).

       -x "ozel_xsl
              Bir bicim betigi yerine belirtilen "ozel_xsl dosyasi kullanilir.

       -m xsl_par,casi
              Donusum   dosyasinda   degisiklik   yapmak   icin    xsl_par,casi
              kullanilir.

       -o dizin
              Ciktiyi, icinde calisilan dizin yerine, belirtilen dizine koyar.

       -p ardi,slem_se,cenekleri
              Donusum  dosyasi  uygulamasindan  sonraki  islem  evrelerine  bu
              secenekleri aktarir (ornegin; HTML ciktinin  links  veya  lynx'e
              aktarilmasi  veya  Tex'den  DVI'ya  giderken  ciktinin  xmltex'e
              aktarilmasi)  sayet  -p  ikinci  bir  defa   daha   belirtmisse,
              secenekler donusum sonrasi ikinci asama uygulamalara gonderilir.
              Bu sadece xmltex ve dvips'ten PostScript  cikti  elde  edilirken
              uygulanabilir.

       --extensions
              Kullandiginiz   arac   zinciri   icin  donusum  genisletmelerini
              kullanmayi  mumkun  kilar.  Ornegin,  PassiveTeX  kullaniliyorsa
              "passivetex.extensions"            ve           "use.extensions"
              etkinlestirilmelidir.   Etkinlestirilen    degiskenler    Norman
              Walsh'in DocBook XSL donusum dosyalarinda kullandiklaridir.

       --searchpath dosyayolu
              Girdi  icin  olanlar  da  dahil  olmak  uzere  son  care  olarak
              kullanilacak dizin isimlerinin iki nokta ustuste isaretleri  ile
              ayrilmis listesi.

       --skip-validation
              Normalde uygulanan gecerlilik islemini atlar.

       --help Kisa  bir  kullanim  iletisi  goruntuler.  Kullanilabilir  cikti
              bicimlerini ve xmlto seceneklerini aciklar.

       -v, --version
              Surum bilgilerini gosterir.

"ORNEKLER

       Bir DocBook XML belgesini PDF'ye cevirmek icin:

       xmlto pdf belgem.xml

       Bir DocBook XML belgesini HTML'ye  cevirmek  ve  ciktiyi  HTML  dosyasi
       olarak baska bir dizinde saklamak icin:

       xmlto -o html-dizini html belgem.xml

       Bir  DocBook  XML  belgesinden tek sayfalik bir HTML dosyasi elde etmek
       icin:

       xmlto html-nochunks belgem.xml

       Ciktiyi bir XSL parcasi kullanarak duzenlemek icin:

       xmlto -m ulink.xsl pdf belgem.xml

       Hangi  donusum  dosyasinin  kullanilacagini  tanimlamak   icin   (bicim
       betiginin sectigini goz ardi etmek icin):

       xmlto -x dosyam.xsl pdf belgem.xml

YAZAN

       Tim Waugh <twaugh (at) redhat.com> tarafindan yazilmistir.

,CEVIREN

       Yalcin Kolukisa <yalcin (at) belgeler.org>, Subat 2004