Biológia - výukový program

        Copyright (c), 2000
           Joezf Bombiak
	e-mail: jozef.bombiak@st.fmph.uniba.sk	


Zameranie programu

    Program je urceny na vyku predmetu Biologia pre 3 a 4 rocnik gymnazii.
    Obsahuje temy z okruhu Obehova sustava.

Všeobecný popis

  Hlavný adresár programu je obsahuje nasledovné súbory a adresáre:
     READ.TXT - tento súbor
     BIOLOGIA.EXE - spustiteľný súbor programu
     THEMES.LST - zoznam tém
     IMAGES/ - adresár s obrázkami pre program
     THEMES/ - adresá s pripravenými témami



1. Všeobecný popis formátovaných súborov
========================================

  Súbory sú formátované pomocou značiek, ktoré sú buď párové alebo nepárové,
  uzavreté v znakoch < a >.
  Príklad:
     <ZNACKA1> ... </ZNACKA1>  - párová značka
     <ZNACKA2>                 - nepárová značka

  Ak je značka párová, má význam aj text, ktorý táto značka uzatvára.
  Príklad:
     <ZNACKA>Toto je text, ktorý má nejaký význam.</ZNACKA>

  Každá značka môže mať naviac niekoľko parametrov. Každý parameter má
  hodnotu, ktorá mu je priradená znakom "=".  Vľavo ani vpravo od
  tohto znaku nesmie byť medzera! Ak hodnota parametra obsahuje znak
  medzera, musí byť táto hodnota uzavretá v apostrofoch  "". Na poradí
  parametrov nezávisí.
  Príklad:
     <ZNACKA P1=2 PARAMETER2=43> ... </ZNACKA>
     <ZNACKA P1="hodnota 1" PARAMETER2="hodnota 2">


1. Popis súboru THEMES.LST
==========================

  Tento súbor sa nachádza v hlavnom adresári programu. Obsahuje
  popis všetkých tém. Jeho štruktúra je nasledovná:

    Jednotlivé témy sú popísané v značke THEME. T.j. <THEME>
    Táto značka má nasledujúce parametre:
       ID - identifikačné číslo, určuje, aký obrázok reprezentuje
            tému. Obrázky sú v adresári images/ a majú názov
            book_n.bmp, kde n je číslo.
       NAME - názov témy
       ROOT - adresár, v ktorom je uložená téma, je ukončený znakom "\"
       FILE - názov súboru, v ktorom je uložená téma
       TEST - názov súboru, v ktorom je uložený test
    Príklad:
       <THEME ID=2
              NAME="Toto je názov témy"
              ROOT="themes\example\"
              FILE="theme_example.thm"
              TEST="test_example.exm">


2. Popis súboru s témou
=======================

  Obsahuje údaje pre jednu konkrétnu tému. Každá téma pozostáva z niekoľkých
  stránok. Stránka je uzavretá v párovej značke PAGE.
  Príklad:
     <PAGE> ... </PAGE>
  Značka má nepoviné parametre pre zadanie okrajov:
     LB - ľavý okraj
     RB - pravý okraj
     TB - horný okraj
     BB - dolný okraj
  Príklad:
     <PAGE LB=10 RB=20 TB=20 BB=30> ... </PAGE>

  Za značkou stránky môže byť uvedený zoznam obrázkov, ktoré sa na nej
  zobrazia. Obrázok má nepárovú značku IMAGE a obsahuje niekoľko povinných
  a nepovinných parametrov.
  Povinné parametre:
     SRC - zdrojový súbor s obrázkom v BMP formáte.
     POS - pozícia obrázka na stránke, prípustné hodnoty sú:
              TOP - obrázok bude v hornej časti stránky
              BOTTOM - obrázok bude v spodnej časti stránky
              LEFT - obrázok bude v ľavej časti stránky
              RIGHT - obrázok bude v pravej časti stránky
              TOPLEFT - obrázok bude v ľavej hornej časti stránky
              TOPRIGHT - obrázok bude v pravej hornej časti stránky
              BOTTOMLEFT - obrázok bude v ľavej spodnej časti stránky
              BOTTOMRIGHT - obrázok bude v pravej dolnej časti stránky
  Nepovinné:
     LB - ľavý okraj 
     RB - pravý okraj
     TB - horný okraj
     BB - dolný okraj
  Príklad: ( na stránke budú 2 obrázky )
     <PAGE LB=10 RB=20 TB=20 BB=30>
     <IMAGE SRC="obrazok1.bmp" POS=LEFT LB=20 RB=20 TB=10 BB=10>
     <IMAGE SRC="obrazok2.bmp" POS=BOTTOMRIGHT LB=20 RB=20 BB=10>
     .
     .
     </PAGE>

  Text, ktorý sa na stránke zobrazí je uzavretý v párovej značke TEXT,
  ktorá nemá žiadne parametre.
  Príklad:
     <PAGE LB=10 RB=20 TB=20 BB=30>
     <IMAGE SRC="obrazok1.bmp" POS=LEFT LB=20 RB=20 TB=10 BB=10>
     <IMAGE SRC="obrazok2.bmp" POS=BOTTOMRIGHT LB=20 RB=20 BB=10>
     <TEXT> Nejaký text, ktorý sa zobrazí na stránke </TEXT> 
     </PAGE>

  Text môže byť formátovaný. T.j. môže obsahovať jednu z nasledujúcich
  značiek pre formátovanie:
     párová značka <COLOR=farba> farebný text </COLOR> 
          - text vnútri bude mať farbu podľa parametra, kde farba
            môže byť RED, YELLOW, BLUE alebo GREEN.
     nepárová značka <NL> 
          - nový riadok ( new line )
     nepárová značka <P> 
          - posun textu, odstavec ( paragraph )
     párová značka <B> tučný text </B>
          - zmena písma na tučné ( bold )
  Príklad:
     ... <TEXT> Obyčajný text <B>tučný text</B> text <COLOR=RED> farebný
      text</COLOR> text <NL><P><P> Toto bude na novom riadku dvakrát
      posunuté </TEXT> ...


3. Popis súboru s testom
========================

  Obsahuje údaje pre jeden test. Každý test pozostáva z niekoľkých
  otázok rôzneho typu. Otázke je uzavretá v párovej značke QUESTION.
  Typ otázky je jeden z nasledovných:
     - typ A - výber správnej odpovede spomedzi zadaných odpovedí - typ A
     - typ B - popis obrázka
     - typ C - doplňovanie slov do textu
     - typ D - spájanie dvojíc
  Značka má jeden povinný parameter, 
     TYPE - typ otázky 
  a niekoľko nepovinných parametrov:
     POINTS - počet bodov za otázku
     TEXT - zadanie úlohy
     LB, RB, BB, TB - prametre pre formátovanie okrajov
  Príklad:
     <QUESTION TYPE=C POINTS=10 TEXT="Zadanie úlohy" LB=20 RB=20>
     ... </QUESTION>    
      
  3.1. Typ otázky A
  -----------------
     
     Výber správnej odpovede spomedzi zadaných odpovedí. Otázka môže 
     obsahovať niekoľko správnych a niekoľko nesprávnych možností.
     Odpoved predstavuje párová značka ITEM. Jej paramter LABEL 
     predstavuje text odpovede a text, ktorý značka uzatvára, je
     buď YES - správna odpoveď, alebo NO - nesprávna.
     Príklad:
        <QUESTION TYPE=A ...>
        <ITEM LABEL="správna odpoveď č.1">YES</ITEM>  
        <ITEM LABEL="správna odpoveď č.2">YES</ITEM>  
        <ITEM LABEL="nesprávna odpoveď č.1">NO</ITEM>  
        ... 
        </QUESTION>
     
    3.2. Typ otázky B
    -----------------
      
     Popis obrázka. Otázka obsahuje obrázok, ktorý treba správne 
     popísať. T.j. k návestiam v obrázku treba priradiť príslušný popis.
     Obrázok je vložený do otázky pomocou značky IMAGE, ktorá má takú
     istú štruktúru ako vnútri stránky výkladu textu, až na obmedzenie
     paramtera POS, ktorý môže obsahovať iba hodnoty LEFT alebo RIGHT.
     Príklad:
        <QUESTION TYPE=B ...>
        <IMAGE SRC="obrázok.bmp" POS=LEFT>
        ... 
        </QUESTION>
     Ďalej nasleduje popis návestí obrázka a ich hodnoty. Tento popis 
     je podobný, ako pri predchádzajúcom type, t.j. uzavretý v párovej 
     značke ITEM. Ak je napríklad v obrázku návestie 3, značka bude
     vyzerať nasledovne:
        <ITEM LABEL=3>popis časti obrázka s označením 3</ITEM>
     Môžu byť uvedené aj nesprávne možnosti, ktoré nepatria ku žiadnemu
     návestiu:
        <ITEM>Toto je tiež možné vybrať ako odpoveď</ITEM>
       
  3.3. Typ otázky C
  -----------------
       
     Doplňovanie slov do textu. Text, do ktrého treba doplniť slová, je
     uzavretý v párovej značke TEXT. Slovo, ktoré má byť doplnené, je 
     vynechané a namiesto neho je uvedená nepárová značka LABEL.
     Označuje návestie k tomuto slovu. Zoznam slov, z ktorých je možné
     vyberať, je uvedený za textom, uzavrý v párových značkách ITEM.
     Značka má paramter LABEL. Jeho hodnota je jedna z tých, ktoré sú
     v texte a znamená, že na pozíciu s týmto návestím musí ísť
     toto slovo. Pokiaľ nie je parameter uvedený, jedná sa o nesprávnu 
     odpoveď.
     Príklad:
        <QUESTION TYPE=C ...>
        <TEXT>Sem doplň <LEBEL="slovo1"> a sem zas <LABEL="dopln1">
        niečo iné ... </TEXT> 
        <ITEM LABEL="slovo1">nejaké slovo</ITEM>
        <ITEM LABEL="dopln1">doplň</ITEM>
        <ITEM>neplatné</ITEM>
        <ITEM>nesprávne</ITEM>
        ...
        </QUESTION>


  3.4. Typ otázky D
  -----------------
     
     Spájanie dvojíc slov. Podobne ako pri otázke typu A. Ľavý pár popisuje
     parameter LABEL značky ITEM. Pravý pár táto značka uzatvára. 
     Príklad:
        <ITEM LABEL="ľavá časť 1">jej pravá časť (1)</ITEM>  
        <ITEM LABEL="ľavá časť 2">jej pravá časť (2)</ITEM>  
        <ITEM LABEL="ľavá časť 3">jej pravá časť (3)</ITEM>  
        <ITEM>pravá časť bez svojej ľavej časti</ITEM>


4. Poznámky:
============

   1. Ak je text, ktorý sa má zobraziť na stránkre je príliš dlhý, program o tom
      podá správu. 

   2. Poradie značiek pri formátovaní textu je potrbné dodržať.
   
   3. Poradie odpovedí (správnych, nesprávnych) nie je potrebné dodržať.
      Príklad:
        <ITEM LABEL="ľavá časť 1">jej pravá časť (1)</ITEM>  
	<ITEM LABEL="ľavá časť 3">jej pravá časť (3)</ITEM>  
        <ITEM>pravá časť bez svojej ľavej časti</ITEM>
	...
        <ITEM LABEL="ľavá časť 2">jej pravá časť (2)</ITEM>