DocBook Hogyan Bátfai Norbert Debreceni Egyetem Informatikai Kar (DE IK), Információ Technológia Tanszék egyetemi tanársegéd Dokumentum verzió: 0.0.1, DocBookHogyanBN.odp Debrecen, január 11. Néhány egyéni használati eset a TÁMOP tartalomfejlesztési pályázat teljesítése: a DocBook kapcsán

DocBook Hogyan Bátfai, Norbert Debreceni Egyetem, Informatikai Kar, Információ Technológia Tanszék Copyright © 2009 Bátfai Norbert E közlemény felhatalmazást ad önnek jelen dokumentum sokszorosítására, terjesztésére és/vagy módosítására a Szabad Szoftver Alapítvány által kiadott GNU Szabad Dokumentációs Licenc 1.2-es, vagy bármely azt követő verziójának feltételei alapján. Nem változtatható szakaszok nincsenek. Címlap szövegek: Bátfai Norbert. Hátlap szövegek nincsenek. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with the no Invariant Sections with the Front- Cover Texts being: Bátfai Norbert and with no Back-Cover Texts. Felhasználási engedély A GNU Free Documentation License nem hivatalos magyar fordítása:

Az előadás vázlata Bevezetés és elmélet ● DocBook és előélet ● DTD, XML schema, Relax NG,... ● Szóban forgó verziók:..., 4.4,..., 5.0 ● Oprendszer, tapasztalatok, szoftverek Példák ● Ubuntu GNU/Linux, xmllint, xsltproc, dblatex,... ● Windows, xmllint, xsltproc, Altova XMLSpy, XML Editor,... Gyakorlat ● Ahogyan magam készítem

DocBook és előélet 2005-ben Juhász Istvánnal közös projektünk keretében sikerrel teljesítettünk egy ugyanilyen pályázatot: ● A HIK által konvertált böngészhető változat: ● A HIK által konevrtált pdf változat: ● A HIK által konevrtált MS Word doc változat: kurzus óta színesítem DocBook XML összefoglaló dolgozat beadatásával az XML, HTML óráimat hallgatók életét

DocBook és előélet Mese a DocBook-ról: mi a célja, milyen nagynevű helyeken, projektekben használják, itt az említett XML, HTML órám jegyzetének megfelelő fejezete: ● (itt – lévén laborjegyzetről van szó – a rövid mese mellett több magyar és angol doksi is be van linkleve, többek között páldául a DocBook 5.0: The Definitive Guide, , DocBook 5.0http://

DocBook V5.0 Az említett laboron két kurzus óta csak Relax NG alapján validált 5.0 beadandó dolgozatot (könyv) fogadok el (az első kurzusban, amikor a V5 még csak RC7 volt, akkor fogadtam még el alternatívaként 4.5 könyvet vagy cikket) A labor lapján elérhető a beadandó alapjául szolgáló 5.0-s xml forrás, az ebből konvertált html és pdf-ek.

DocBook V5.0 validálás Hallgatóim akár Windows, akár Linux alatt dolgozhatnak (bár pdf-et csak az utóbbi alatt tudnak készíteni), mert a validálást a Sun Multi- Schema Validator (MSV) validátorával (Jávás) végezzük: A ppmkonyv.xml eleje: <book xmlns=" version="5.0" xml:lang="hu" xmlns:xlink=" xmlns:xi=" ● Letöltése: ● Használata: java -Xss512K -jar elérési-út/msv /msv.jar \ ● ppmkonyv.xml

DocBook V5.0 validálás Illetve van egy saját Java progink, ami séma alapján validál:

DocBook 4.4 Viszont a lapján azt olvashatjuk, hogy a 2005-ös pályázat mintájára 4.4-et kérnek, séma alapján validálva. (Vannak itt továbbá útmutatók, rövid doksik, példa fájlok is.) Az 5.0 és a 4.4 sem oda, sem visszafelé nem kompatibilis a validítás szempontjából! Az említett lapon az XMLSpy triál verzióját ajánlják a validáláshoz. Hasonló triál elérhető az Oxygen-ből stb., de ezeknek a zárt kódú szoftvereknek a használata nem illene a kurzus szelleméhez!!! Persze a pályázatra koncentrálva a szerzők járjanak el úgy, ahogy a pályázat kiírói a teljesítéshez várják! A következő fóliákon azt mutatom be, hogyan készítem el a saját 4.4 könyvemet.

DocBook 4.4 A munka menete: ● Szövegszerkesztés: mindenki használhatja saját kedvencét (az említett kereskedelmi termékek tipikusan WYSIWYG nézetet is tartalmaznak) ● Validálás: xmllint* ● Konvertálás: xsltproc*, dblatex + *: mezei júzer Windows alá nem tudja feltenni, Linux alatt persze egy tipikus telepítéssel felmennek a szükséges progik + : csak Linux alatt (volt, aki jelezte, hogy Fedora alatt voltak problémák...) The xsltproc tool xmllint DocBook to LaTeX Publishing

DocBook 4.4 validálás

Konvertálás html-be

Konvertálás pdf-be

Köszönöm a figyelmet Skype: batfai.norbert MSN: A témák fórumai: Honlap: Ars Poetica Informaticae portál: