Felsőoktatási Tankönyv- és Szakkönyvpályázat GYIK
Kedves Pályázó!
Az alábbiakban a leggyakrabban feltett kérdésekre adunk válaszokat az egyszerűbbektől a bonyolultabbakig. A listát az újonnan feltett kérdéseknek megfelelően folyamatosan bővítjük. Továbbá mi is elhelyeztünk egy-két alapkérést a lista végén. Amennyiben az itt felsorolt kérdések nem adnának választ az Ön problémájára, kérjük, jelezze ezt a tankonyvtar@hik.hu e-mail címen.
1. Milyen változások történtek a technikai követelményekben a tavalyi pályázathoz képest?
Az elektronikus könyvekkel szemben támasztott technikai követelményekben a következő újdonságokkal találkozhatunk:
a.) Fájl- és könyvtárnevek képzése:
A fájlnevekben csak az angol ábécé kisbetűi, számok, valamint a ’-’ (kötőjel) és ’_’ (aláhúzásjel) szerepelhetnek, nagybetűk, ékezetes és más különleges karakterek vagy szóköz nem.
c.) A könyvre vonatkozó metaadatokat külön fájlban kell leadni.
d.) A könyvben szereplő matematikai formulák - ha van ilyen - MathML változatát külön fájlokban kell leadni.
e.) A névvel jelölt XML entitások (pl. á) nem használhatóak.
f.) A leadott elektronikus könyvnek kötött könyvtárszerkezetben tárolt, a következő szabályok szerint elnevezett fájlokból kell állnia:
book.xml - A tankönyv DocBook XML formátumban (javasolt elnevezés)
./images/ ‑ A tankönyv képanyagát tároló alkönyvtár javasolt elnevezése. A képeket tehát más módon elnevezett alkönyvtárban is el lehet helyezni, a fájl- és könyvtárnév-képzési szabályok betartásával. A DocBook XML fájlban a kép- és egyéb fájlhivatkozásokat az XML fájlhoz képest relatív útvonallal kell megadni.
./meta/ ‑ A tankönyv metaadatai. A metaadatokat két formátumban kell leadni: a Dublin Core metaadatokat kötelezően a ./meta/dc.xml fájlban, a MARCXML metaadatokat kötelezően a ./meta/marc-xml fájlban kell tárolni.
./math/ ‑ Amennyiben az elektronikus könyvben matematikai formulák találhatóak, azokat kötelező MathML formátumban is megadni (tehát egy egyenletet három formátumban kell elkészíteni: szövegesen, képként és MathML-ben). A ./math alkönyvtárban egyenként, külön fájlokként tároljuk a tankönyv XML forrásában {egyenlet id} id-vel jelölt formulákat (equation, inlineequation, informalequation), a MathML fájlokat kötelezően {egyenlet id}.math alakban elnevezve.
A javasolt elnevezés azt jelenti, hogy ezen könyvtárak ill. fájlok neve az általános fájlnév-képzési szabályokon belül tetszőleges lehet,
A kötelező elnevezés ill. képzési szabály azt jelenti, hogy ezen könyvtárak ill. fájlok nevét a megadottak szerint képzett névvel várjuk.
2. Hogyan tudok ékezetes és más speciális karaktereket írni?
Használjunk megfelelő beviteli eszközt, pl. a Microsoft Windows-ban az adott nyelvnek megfelelő billentyűzetkiosztást (Vezérlőpult - Területi és nyelvi beállítások - Nyelvek - Szövegbeviteli nyelvek és módszerek - Hozzáadás - Nyelv kiválasztása, pl. Görög).
Az elektronikus könyv kódolása legyen UTF-8. Használjunk UTF-8 képes szerkesztőeszközöket. A DocBook XML-ben az XML saját entity renferenciáin (< > ' " és &) kívül más névvel jelölt entitás (pl. az á helyett á) nem használható. A különleges karakterek - olyan esetben, amikor nem rendelkezünk a megfelelő nyelvi beviteli eszközzel - megadhatók Unicode karakterkódjaikkal, pl. a â vagy â jelöli az â karaktert, 欢 vagy 欢 jelöli a 欢 karaktert.
Magyar nyelvű szövegekben a kalapos ô és û használata kerülendő.
Nyomdai kötő- és idézőjelek, egyéb szimbólumok kódjai:
|
Karakter |
Decimális |
Hex |
Megjelenítés |
|
en dash |
– |
– |
- |
|
em dash |
— |
— |
— |
|
Szimpla bal idézőjel |
‘ |
‘ |
‘ |
|
Szimpla jobb idézőjel |
’ |
’ |
’ |
|
Szimpla bal alsó idézőjel |
‚ |
‚ |
‚ |
|
Dupla bal idézőjel |
“ |
“ |
“ |
|
Dupla jobb idézőjel |
” |
” |
' |
|
Dupla bal also idézőjel |
„ |
„ |
' |
|
Dagger |
† |
† |
† |
|
Double dagger |
‡ |
‡ |
‡ |
|
Ezrelék |
‰ |
‰ |
‰ |
|
Euro |
€ |
€ |
€ |
1. Valamilyen speciális karakter az XSL transzformáció után nem jelenik meg. Mi a teendő?
Ellenőrizzük, hogy a fájlt UTF-8 kódolással mentettük-e.
2. Az XSL transzformáció után a HTML felület nem úgy mutat, ahogyan szeretném.
a.) A nevek idegen formában jelennek meg: 'Péter Nagy' a 'Nagy Péter' forma helyett, a táblázat- és ábraszámozások idegen formában jelennek meg: Table 1, Figure 1 az 1. táblázat, 1. ábra helyett.
A <book> tag-ben adjuk meg a magyar nyelvet: <book lang='hu'>.
b.) Az ábra- és táblázatszövegek egyrészt félkövéren jelennek meg, másrészt az ábrák és táblázatok fölött és nem alatt, ami nem felel meg a hazai szokásoknak. A szöveg második sora a lábjegyzet szám alatt nem ugrik el jobbra, hanem homogénen balra van ütköztetve.
Az elektronikus tankönyvtár esztétikailag egységes megjelenésű dokumentumokból áll, ez azonban nem érinti azok tartalmát.
3. A végterméket csak XML-ben kell a HIK-nek leadni?
Igen.
4. A képeket elhelyezhetjük tetszőlegesen megválasztott nevű és mélységű relatív könyvtárakban?
Igen, az elnevezési szabályok betartásával.
5. A képleteket valóban 3 alternatív formában is meg kell adni?
Ha igen, abban az esetben is, ha egyszerű felső és alsó indexekkel is megoldható a dolog?
Igen, mindhárom alternatív forma kötelező. Ha egy képlet egyszerű alsó és felső indexekkel is előállítható és a szöveg logikájából nem következik, hogy <equation>-ként jelöljük (mert pl. nem kell szerepelnie az egyenletek listájában és hivatkozni sem fogunk rá), elfogadható az egyszerűsítés. Nem szükséges továbbá egyenletként jelölni (és mindhárom formátumban előállítani) egy félkövér-dőlt B betűt sem (amire volt példa).
6. Csak egyetlen betűtípus alkalmazása lehetséges?
Nem, azonban a HTML kimenet megjelenését, stílusát a HIK szabja meg. Törekszünk a Tankönyvtár elektronikus könyveinek egységes formázására. A HTML formátumú kimenethez csatolt CSS fájlban eltérő formázást lehet alkalmazni akár az egyes HTML elemekre és elemosztályokra.
7. Bizonyos esetekben jelezni kell a szövegrészről, hogy ez nem afféle olvasmányos szöveg, hanem a gépi keresés megjelenített parancsaiból álló állomány.
A programlista jelölésére több megoldás lehetséges:
1) <computeroutput> a folyószövegben a számítógép kimenetének jelölésére
2) <screen> és <screenco> a képernyő tartalmának megjelenítésére (a szóközöket, sortöréseket, tabulátorokat is megőrzi)
A <screen> és <screenco> (valamint a programlisting és párja) közt az a különbség, hogy a ...co végűek kötelezően tartalmaznak callout-okat, magyarázat-hivatkozásokat, az előbbiek opcionálisan.
Példa:
8. Miért nem láthatóak egyes képek a HIK szerverén publikált HTML verzióban?
Kérjük, ellenőrizze az alábbiakat:
a.) létezik-e a hivatkozott képfájl?
b.) a könyvtárak elválasztására ne használjuk a \ karaktert, helyette a / karakter kötelező.
rossz: <imagedata fileref='images\11k.png' format='PNG' align='center'/>
jó: <imagedata fileref='images/11k.png' format='PNG' align='center'/>
c.) ne szerepeljen abszolút hivatkozás az XML-ben.
rossz:
<imagedata fileref='C:\Documents and Settings\Peter\Asztal\xmlmunka\images\11k.png' format='PNG' align='center'/>
rossz:
<imagedata fileref='/images/11k.png' format='PNG' align='center'/>
jó:
<imagedata fileref='images/11k.png' format='PNG' align='center'/>
9. Hogyan kell megadni a könyv egyenleteit?
Az elektronikus könyvben szereplő egyenleteket három formátumban kell megadni. A MahtML megjelenítésére nem képes böngészőkben a matematikai formulákat képként szolgáltatjuk, a képekhez azokkal egyező értelmű szöveges információnak is kapcsolódnia kell, amit a kép ALT szövegeként használunk. Emellett a képleteket MathML-ként is szükséges elkészíteni.
A DocBook XML-ben az egyenlet jelölésére használatos <equation>, <informalequation> vagy <inlineequation> elemekkel jelölhetjük az egyenleteket. Az elemeket kötelező id-vel ellátni és ebből az id-ből képezni a képlet MathML változatának fájlnevét: ./math/{egyenlet id}.math.
Példa (DocBook XML részlet):
<equation id='eq_0002'>
<title>Teszt egyenlet</title>
<alt>x=-b±sqrt(b^2-4ac) over 2a</alt>
<graphic fileref='math/eq_0002.png'/>
</equation>
Inline - azaz a folyószövegben megjelenített - egyenletet az <inlineequation>, <title> nélküli egyszerű képletet pedig az <informalequation> elemekkel jelölhetünk. A <graphic> elem helyett használható a <mediaobject> elem is.
A MathML fájlokat az egyenlet id-jéből képzett fájlnévvel (a fenti példához eq_0002.math néven) állítjuk elő és a könyv XML-hez képest relatív math alkönyvtárban tároljuk. A képek elhelyezésére szintén használhatjuk a math alkönyvtárat. A MathML fájlok validálásához használt XSD helye: http://www.w3.org/Math/XMLSchema/mathml2/mathml2.xsd.
Példa:
10. Hogyan kell megadni a könyv Dublin Core metaadatait?
A Dublin Core metaadatokat külön fájlban (./meta/dc.xml) kell átadni.
11. Hogyan kell megadni a könyv MARCXML metaadatait?
A MARC mezők kitöltésével kapcsolatban további információk:
A MARCXML metaadatokat külön fájlban (./meta/marc.xml) kell átadni.
12. Milyen formátumú és mekkora méretű képeket használjuk a könyvek készítésekor?
Az elektronikus könyvek illusztrációihoz az általánosan használt, minden korszerű böngészőben támogatott képformátumokat várjuk el (PNG, JPEG, GIF). A képek lehetőleg ne legyenek szélesebbek 900 képpontnál.
13. Az én könyvem nem szokásos formátumú könyv, hanem lexikon/szótár/névtár. Hogyan készítsem el DocBook XML-ben?
Ha a szótári rész előtt előszó, magyarázat, vagy más szöveg van, azt jelöljük a szokásos módon (pl. <chapter>). Ezután a <chapter>-t zárjuk le, és a szótári részt osszuk fel a fő chapter-ekkel egy szinten lévő <glossary> szakaszokra, amelyek <title> elemei az ábécé betűit tartalmazzák (a HTML konverzió után ezek lesznek kattinthatóak a tartalomjegyzékben).
14. Miért nem érhető el minden könyv PDF, DOC és Microsoft eBook (LIT) formátumban is?
A Tankönyvtárban publikált elektronikus tankönyvek elsődleges formátuma a HTML. Ezen felül igyekszünk a lehető legtöbb könyvet más formátumokban is közzétenni, hogy látogatóink egy fájlban le tudják tölteni a teljes könyveket (PDF), akár szerkeszthessék is (DOC), vagy kéziszámítógépeiken szabadon hordozhassák (LIT). Egyes, jellemzően a képanyagban gazdag könyvek esetében azonban az egyetlen fájlba történő konverzió túlságosan nagy (100-300 MB) fájlokat eredményezne, melyek előállítása és szolgáltatása túlzottan igénybe venné jelenleg rendelkezésre álló számítási és hálózati erőforrásainkat. Ezért e könyveinket csak HTML formátumban szolgáltatjuk.
15. Hozzájuthatok a konverzióhoz szükséges XSL-ekhez?
