Dokumentáció a
program telepítéséhez és az ellenőrző
kérdések szerkesztéséhez
I. Program specifikáció
A program (test.cgi) egy adott (későbiekben részletezett)
szintaktikájú formának az adatait dolgozza fel, és
gyűjti össze. A program ezáltal alkalmassá válik
akár internet-en keresztüli virtuális dolgozat írásra
is. A tanár elkészíti a kérdéseket, a
megadott szintaktika szerint, a diákok válaszolnak a kérdésekre,
a program pedig összegyűjti a válaszokat.
II. Installálási folyamat
A program több részből áll, installálása
egy kevés szakértelmet igényel. A fő része
a programnak a webserver-en futó test.cgi, ez egy perl-ben
megírt script, futtatásához szükség van
egy perl interpreterre. A perl interperter ingyenes, és létezik
szinte minden platformra, könnyen beszerezhető a http://WWW.Perl.org/
címről.
Az interpreter instalálása után lehet a test.cgi-t
elindítani, ehhez pár dologra van szükség.
- A .htacces (x.hta a CD-n), test.cgi, ready.htm file-ok felmásolása
(SULINET.WWW\TEST\" könyvtárban a CD-n). A .htacces
file tartalmazza a web server beállításait, hogy
futtatni tudja a test.cgi-t, ami a tulajdonképpeni
program, és végül a ready.htmm, ami a kimenete a
programnak. Ez szabadon átírható de léteznie
kell.
- A script első sorában be kell állítani
az perl elérési útvonalát, pl.
#!/usr/local/bin/perl
(ez az eredeti)
#!/usr/sbin/perl
#!c:\perl\bin\perl
- A test.cgi a webserver-en gyűjti össze a válaszokat,
egy fileba írja ki őket, ezért engedélyezni
kell, hogy írni tudjon abba a fileba.
- Unix alapú rendszereknél ez a chmod a+s
test.cgi paranccsal oldható meg.
- Windows NT vagy más rendszereknél is a létrehozó
jogaival kell felruházni, így ha a létrehozó
tudja írni a filet akkor a program is tudni fogja
III. A program használata (ellenőrző kérdések
szerkesztése)
A programot alapvetően két csoport használja majd,
azok akik a kérdéseket elkészítik és
azok, akik válaszolnak rá.
Akik válaszolnak azoknak egyszerű dolguk van, csak végig
kell olvasniuk a kérdéseket, és a kérdéshez
tartozó text mezőbe be kell gépelni a választ,
majd a folyamat végén meg kell nyomni a kész
gombot.
Azoknak akik a kérdéseket elkészítik, kicsit
több dolguk van, és valamivel több joggal is kell hogy
rendelkezenek.
Átírhatják a ready.htm-et. Teljesen
szabadon, semmi megkötés nincs, ezt a lapot jeleníti
meg a program abban az esetben ha a válaszadó megnyomta a
kész gombot és minden sikeresen lezajlott.
Átírhatják a kerdesX.htm-et (SULINET.WWW\TEST\"kerdes1.htm-kerdes5.htm).
Itt azonban már a program szintaktikájához kell
tartani magunkat, mert különben a test.cgi nem tudja
feldolgozni a válaszokat.
A kerdesX.htm felépítése:
- a fejléc, cím, bevezetőre nincs korlátozás,
a program szintakszisa csak a kérdés feltevő részre
vonatkozik, ami igy kezdődik:
- <form METHOD=post ACTION="test.cgi">
- ebben a sorban állítjuk be a test.cgi elérési
útvonalát az idézőjelek között,
ezen akkor kell módosítani ha más könyvtárba
kerül atest.cgi mint az index.html, ilyenkor ki
kell írni a teljen vagy a relativ elérési útvonalat.
- A következő sor igy nézki
- <input type=hidden name="filename" value="valaszok.txt">
- Ez tartalmazza annak a file-nak a nevét amibe a válaszokat
szeretnénk gyűjteni, jelen esetben a valaszok.txt".
Ha a file nem létezik, akkor a program kreál egyet.
Mindennek ellenére célszerű egy üres fájlt
kreálni, és beállítani hogy csak a gazda számára
legyen olvasható, mert így a ravasz válaszolók
nem tudják majd a mások válaszait megnézni.
- Ezután következnek a kérdesek. Az első kérdés
a válaszoló neve:
- <ul><li>Nevem:<input type=text name="name"
size=50><p>
- Ezt kell hagyni mindenképpen az első kérdésnek,
mert a program így várja.
- Ezután következnek a kérdések sorszámozva:
- <li>Első kérdés?
- <br><textarea name=answer_1 rows=5 cols=50></textarea><p>
- Az első sor a kérdés, a második a válasz
mező leírása. A kérdés természetesen
lehet hosszabb is egy sornál.
- A második sor a válasz leírása, ez egy
text mező aminek van egy neve: answer_x" ahol x"
a válasz sorszáma ennek 1-el kell kezdődnie és
egyesével nő, illetve le van írva a textmező
mérete, jelen esetben 5 sor és 50 oszlop. Ha a válasz
nem férne el ebbe a mezőbe akkor ez minden irányban
görgethető, a méretnek csak esztétikai jelentősége
van.
- Ennek a két sornak kell ismétlődnie addig amíg
minden kérdést le nem írunk. A kérdéseket
pedig az alábbi sorokkal kell zárni:
- </ul>
- <input type=submit value=" Kész ">
- <input type=reset value=" Torol ">
- </form>
- Ez a két gomb leírását tartalmazza.
Ha elkészültek a kérdéseket tartalmazó kerdesX.htm"
nevű fájlok, azokat fel kell másolni a WWW szerver
megfelelő könyvtárába, valamint azok útvonalát
be kell írni pl. Notepad segítségével forráskódban
a leckeszövegek végén lévő sor megfelelő
helyére:
<P><FONT SIZE="+1"> <B> <AHREF="http://www.sch.bme.hu/~deity/work/kerdes3.htm"
TARGET="_top"> Ellenõrzõkérdések</A></B></FONT></P>
A kérdések elkészítése, WWW szerverre
történő felrakása és a leckeszövegekben
való specifikálása után a rendszer használható,
a válaszok a megadott fájlban jönnek majd létre.