DocBook Hogyan Bátfai Norbert Debreceni Egyetem Informatikai Kar (DE IK), Információ Technológia.

Az előadások a következő témára: "DocBook Hogyan Bátfai Norbert Debreceni Egyetem Informatikai Kar (DE IK), Információ Technológia."— Előadás másolata:

1 DocBook Hogyan Bátfai Norbert batfai.norbert@inf.unideb.hu http://www.inf.unideb.hu/~nbatfai/ Debreceni Egyetem Informatikai Kar (DE IK), Információ Technológia Tanszék egyetemi tanársegéd Dokumentum verzió: 0.0.1, DocBookHogyanBN.odp Debrecen, 2010. 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

2 DocBook Hogyan Bátfai, Norbert Debreceni Egyetem, Informatikai Kar, Információ Technológia Tanszék nbatfai@inf.unideb.hu 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: http://www.gnu.hu/fdl.htmlhttp://www.gnu.hu/fdl.html

3 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

4 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: http://www.tankonyvtar.hu/informatika/javat-tanitok-javat-080904 http://www.tankonyvtar.hu/informatika/javat-tanitok-javat-080904 ● A HIK által konevrtált pdf változat:http://www.tankonyvtar.hu/site/upload/pdf/b10108.pdfhttp://www.tankonyvtar.hu/site/upload/pdf/b10108.pdf ● A HIK által konevrtált MS Word doc változat: http://www.tankonyvtar.hu/site/upload/doc/b10108.doc http://www.tankonyvtar.hu/site/upload/doc/b10108.doc 3 kurzus óta színesítem DocBook XML összefoglaló dolgozat beadatásával az XML, HTML óráimat hallgatók életét

5 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: ● http://www.inf.unideb.hu/~nbatfai/ppmkonyv.html#d0e954 (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, 0.0.25, DocBook 5.0http://www.docbook.org/tdg5/en/html/docbook.html) http://www.inf.unideb.hu/~nbatfai/ppmkonyv.html#d0e954http://www.docbook.org/tdg5/en/html/docbook.html

6 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 http://www.inf.unideb.hu/~nbatfai/#ppm 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.http://www.inf.unideb.hu/~nbatfai/#ppm

7 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="http://docbook.org/ns/docbook" version="5.0" xml:lang="hu" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> ● Letöltése: https://msv.dev.java.net/https://msv.dev.java.net/ ● Használata: java -Xss512K -jar elérési-út/msv-20070407/msv.jar \ ● http://www.docbook.org/xml/5.0/rng/docbook.rng ppmkonyv.xml

8 DocBook V5.0 validálás Illetve van egy saját Java progink, ami séma alapján validál: http://www.inf.unideb.hu/~nbatfai/ppmkonyv.html#d0e1226

9 DocBook 4.4 Viszont a http://www.tankonyvtar.hu/ 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.)http://www.tankonyvtar.hu/ Az 5.0 és a 4.4 sem oda, sem visszafelé nem kompatibilis a validítás szempontjából! Az említett http://www.tankonyvtar.hu/ 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!http://www.tankonyvtar.hu/ A következő fóliákon azt mutatom be, hogyan készítem el a saját 4.4 könyvemet.

10 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 http://xmlsoft.org/XSLT/xsltproc2.html xmllint http://xmlsoft.org/xmllint.html DocBook to LaTeX Publishing http://dblatex.sourceforge.net/

11 DocBook 4.4 validálás

12 Konvertálás html-be

13 Konvertálás pdf-be

14 Köszönöm a figyelmet Email: batfai.norbert@inf.unideb.hubatfai.norbert@inf.unideb.hu nbatfai@gmail.com Skype: batfai.norbert MSN: nbatfai@inf.unideb.hunbatfai@inf.unideb.hu A témák fórumai: http://dev.inf.unideb.hu:8080/web/bnthttp://dev.inf.unideb.hu:8080/web/bnt Honlap: http://www.inf.unideb.hu/~nbatfai/http://www.inf.unideb.hu/~nbatfai/ Ars Poetica Informaticae portál: http://dev.inf.unideb.hu:8080http://dev.inf.unideb.hu:8080