A.3. A formázott kimenet előállítása

Ebben a szakaszban feltételezzük, hogy már vagy kézzel vagy pedig a hozzá tartozó port segítségével telepítettük a textproc/docproj portban szereplő segédeszközöket. Emellett továbbá még feltesszük, hogy az összes eszközt a /usr/local könyvtár alá telepítettük és a binárisok elérési útvonala része a PATH környezeti változónak. Amennyiben ezektől a feltételezésektől valamilyen módon eltértünk, akkor a példákat értelemszerűen a saját környezetünkre alkalmazva kell végrehajtani.

A.3.1. A Jade használata

A.3. példa - DocBook forrás átalakítása HTML formátumúra (egyetlen nagy állomány)
% jade -V nochunks \  1
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 2
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \3
    -t sgml 4 állomány.xml > állomány.html 5

1

A nochunks paramétert adja át a stíluslapoknak és az eredményt a szabványos kimenetre irányítattja át (Norm Walsh stíluslapjait használjuk).

2

Megadjuk a Jade által feldolgozandó katalógusokat. Itt három katalógust kell megadni. Az első katalógus a DSSSL stíluslapok, a második a DocBook DTD és a harmadik a Jade számára tartalmaz információkat.

3

A Jade a dokumentum feldolgozásához az itt megadott DSSSL stíluslapot fogja felhasználni.

4

A Jade itt kap utasítást arra, hogy az egyik DTD-ból a másikba alakítsa át a dokumentumot. Ebben a példában most a DocBook DTD-ból alakítunk át a HTML DTD-ba.

5

Megadjuk a feldolgozandó állományt a Jade számára és átirányítjuk a kimenetet egy .html kiterjesztésű állományba.


A.4. példa - DocBook forrás átalakítása HTML formátumúra (több kisebb állomány)
% jade \
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 1
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \2
    -t sgml 3 állomány.xml 4

1

Megadjuk a Jade által feldolgozandó katalógusokat. Itt három katalógust kell megadni. Az első katalógus a DSSSL stíluslapok, a második a DocBook DTD és a harmadik a Jade számára tartalmaz információkat.

2

A Jade a dokumentum feldolgozásához az itt megadott DSSSL stíluslapot fogja felhasználni.

3

A Jade itt kap utasítást arra, hogy az egyik DTD-ból a másikba alakítsa át a dokumentumot. Ebben a példában most a DocBook DTD-ból alakítunk át a HTML DTD-ba.

4

Megadjuk a feldolgozandó állományt a Jade számára. A stíluslap fogja majd eldönteni, hogy mi legyen a neve a menet közben keletkező egyes HTML állományoknak, illetve a gyökérnek (ez az az állomány, ahonnan a dokumentum kezdődik).

Előfordulhat, hogy ez a parancs szintén csak egyetlen HTML állományt generál. Ez függ a feldolgozandó dokumentum szerkezetétől és a stíluslap feldarabolást vezérlő szabályaitól.


A.5. példa - DocBook forrás átalakítása Postscript formátumúra

Az SGML forrást TeX állománnyá akarjuk alakítani.

% jade -V tex-backend \ 1
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 2
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/print/docbook.dsl \3
    -t tex 4 állomány.xml

1

Felparaméterezzük a stíluslapot a TeX formátumú kimenet előállításához.

2

Megadjuk a Jade által feldolgozandó katalógusokat. Itt három katalógust kell megadni. Az első katalógus a DSSSL stíluslapok, a második a DocBook DTD és a harmadik a Jade számára tartalmaz információkat.

3

A Jade a dokumentum feldolgozásához az itt megadott DSSSL stíluslapot fogja felhasználni.

4

Megadjuk a Jade számára, hogy TeX formátumú kimenetet készítsen.

Az így keletkező .tex kiterjesztésű állomány aztán a &jadetex makrócsomaggal együtt átadható bemenetként a tex parancsnak.

% tex "&jadetex" állomány.tex

A tex parancsot legalább háromszor le kell futtatni. Először feldolgozza a dokumentumot, és szétválogatja az egyes részeit, hogy meg tudja állapítani részeit hivatkoztuk valahonnan máshonnan, hogyan indexelje stb.

Ha ebben a fázbisban különböző figyelmeztetéseket látunk, mint például LaTeX Warning: Reference `136' on page 5 undefined on input line 728., akkor még ilyenkor ne foglalkozzunk különösebben velük.

A második futtatás során újra feldolgozza a dokumentumot a korábbi feldolgozásból származó bizonyos előismeretek (például a dokumentum oldalszámának) alapján. Ekkor az indexek és a kereszthivatkozások már gond nélkül feloldhatóak.

A harmadik menetben elvégzi az utolsó simításokat, amennyiben szükség van rájuk.

Ebben a fázisban egy állomány.dvi alakú eredményt kapunk.

Végezetül az imént kapott .dvi állomány Postscript formátumúra alakításához futtassuk le a dvips parancsot:

% dvips -o állomány.ps állomány.dvi

A.6. példa - DocBook forrás átalakítása PDF formátumúra

A feldolgozási folyamat első része hasonló ahhoz, amikor DocBook forrásból akarunk Postscript formátumú állományt készíteni, tehát elegendő a jade parancsot az előbb megadott paraméterekkel meghívni (lásd A.5. példa - DocBook forrás átalakítása Postscript formátumúra).

Amikor viszont megkaptuk a .tex állományt, akkor a pdfTeX programot futtassuk le rá. Ügyeljünk arra, hogy ekkor már a &pdfjadetex makrócsomagot kell használnunk:

% pdftex "&pdfjadetex" állomány.tex

Ebben az esetben is háromszor kell lefuttatnunk a parancsot.

Ennek eredményeképpen aztán végül előáll egy további feldolgozást már nem igénylő állomány.pdf állomány.


Ha kérdése van a FreeBSD-vel kapcsolatban, a következő címre írhat (angolul): <questions@FreeBSD.org>.

Ha ezzel a dokumentummal kapcsolatban van kérdése, kérjük erre a címre írjon: <gabor@FreeBSD.org>.