Hzi feladat, ZH, ptzh, iv, vizsgapont nyilvntart s osztlyoz.
A pontszmok gpbe rsa utn a flv kzben visszajelzst ad az egyes
dikok addigi teljestmnyrl, kiszri a dupln szereplket,
statisztikt kszt, alrst ellenriz, flv vgn s a vizsgk
sorn osztlyoz is. Vlogat gyakorlatvezetk s/vagy vizsgalap alapjn,
s megjelenti a teljes informci minket rdekl rszt is, ha kell 
(pl. Neptunba jegybersnl hasznos).

Telepts:
^^^^^^^^^^
Feltve, hogy a home knyvtrban nincs egy "zhpontozo" nev knyvtr, a 
home knyvtrban ki kell adni, hogy

gzip -d zh.tar.gz

azutn pedig

tar -xf zh.tar		Ez ltrehozza a "zhpontozo" knyvtrat a 
			szksges file-okkal, ezzel a lerssal, s pldkkal.


Szksges file-ok:
^^^^^^^^^^^^^^^^^^
<filenev>.kov	Flv kvetelmnyei, pontos formtum albb
<filenev>.zhk	Flvben szerzett pontszmok, pontos formtum albb
<filenev>.knv	A kurzus neve


Hasznlat:
^^^^^^^^^^
~/zhpontozo/zh [-o oszlopok] [-v vizsgalap file] [-g gyakorlatvezet] [-n] <filenv> 
(kiterjeszts nlkl!!)

	ahol az opcionlis paramterek rtkei a kvetkezk:

	"oszlopok" vesszvel (space nlkl) elvlasztott szmok;
	"vizsgalap file" tipikusan a Neptunbl nyomtatott vizsgalap html 
		file neve (de brmilyen file megfelel, amiben a listzni 
		kvnt hallgatk Neptun kdjai zrjelben szerepelnek);
	"gyakorlatvezet" egyetlen monogramot jell;
	a -n paramter letiltja a sznek hasznlatt.

FONTOS, hogy ahol kiadjuk ezt a parancsot, ott minden <filenev> elej,
s .zhg, .zhv, .zhr, .zhb, .zhe, .zhd .zhs, .osz, .zhc, .zha kiterjeszts
file trlve lesz.


(A "zh" file-t brmilyen path-ban lev knyvtrba is bemsolhatjuk; pl. a 
home-ban nyitott bin nev knyvtrba, s ekkor hozzadhatjuk a .bashrc 
file-hoz (vagy ltrehozhatunk egy ilyen file-t, ha mg nem volt, benne 
azzal), hogy

PATH="$PATH:$HOME/bin:"
export PATH

Ezutn brhonnan kiadhat a "zh" (illetve "zhe, zhus") utasts.)


Kimenet file-ok:
^^^^^^^^^^^^^^^^
<filenev>.html		Teljes lista, www bngszvel nzhet, sajt 
			hasznlatra;
publ_<filenev>.html	Publikus lista, nv nlkl a hallgatk okulsra, 
			kitehet a trgy honlapjra.

Ehelyett "~/zhpontozo/zhe" (illetve "zhe") utasts ugyangy hasznlva 
mindezt angol nyelven kszti.

A "~/zhpontozo/zhus" (illetve "zhus") utasitssal pedig angol nyelv, 
amerikai pontozs (A^+, A, A^-, B^+, B, B^-, C^+, C, C^-, D, F) 
eredmnyt kapunk.

------

Az opcik nlkl a "zh" script a <filenev>.kov file-ban rgztett 
kvetelmnyek alapjn feldolgozza a <filenev>.zhk fileban vezetett 
pontszmokat (formtumokat lsd albb), s a <filenev>.knv kurzusnv 
segtsgvel html file formjban egy ttekint tblzatot kszt. A 
tblzat tartalmazza a neveket (illetve a publ_<filenev>.html nem 
tartalmazza a neveket), Neptun kdot, gyakorlatvezet monogramjt, a hzi 
feladat pontszmokat (ha voltak), a zh pontszmokat (ha voltak), a ptzh 
pontszmokat (ha voltak), a ptptzh pontszmokat (ha voltak) az ivzh 
pontszmokat (ha voltak), az alrs kirtkelst, a flvkzi jegyet 
(ha van), a vizsgkon elrt pontszmokat (ha vannak), s a 
vizsgajegyeket (ha vannak). A (Neptun kd alapjn) dupln szerepl
hallgatk pontszamai mellett nyilak figyelmeztetnek a problmra.

A ptptzh ugyanolyan jelleg, mint a ptzh: fellrja az elz adott
zh-k pontszmait. Ezzel szemben az ivzh gy van elkpzelve, mint egy nagy 
szmonkrs a teljes flv gyakorlati anyagbl, ezrt ha van ivzh az 
kln ponthatrok alapjn mkdik, s sikeres teljestse esetn a teljes 
flvre az elre belltott minimlisan elrend pontszm lesz figyelembe
vve.

A <filenev>.kov -ben bellthat (lsd albb), hogy a fentiek kzl 
milyen szmonkrsek s jegyek vannak a trgybl.

A -o [szmok, vesszvel (space nlkl) elvlasztva] opcival a html file 
csak a megadott szm oszlopokat tartalmazza. Kivtel ezall a nv s a 
Neptun kd, ezekre a -o opcinak nincs hatsa.

A -v [vizsgalap file] opci akkor mkdik, ha az aktulis knyvtrban 
tallhat egy Neptunrl nyomtatott vizsgalap html file. A tblzat ekkor 
csak azokat a hallgatkat fogja tartalmazni, akik szerepelnek a 
vizsgalapon. A Neptunbl kapott file mellett brmilyen egyb file is 
megfelel, melyben a megjelentend hallgatk Neptun kdjai zrjelben 
szerepelnek.

A -g [gyakorlatvezet monogramja] opcival a megjelentend hallgatk 
listja (tovbb) szkthet a gyakorlatvezet hallgatira.

A -n opci (parmter nem rhat hozz) esetn megvlhatunk a tblzat 
gynyr szneitl, ez nyomtatsnl jl jhet.

------

Formtum a <filenev>.kov kvetelmnyek file-hoz: <vltoz>=rtk, ahol a 
kvetkez vltozkat kell megadni, mindegyiket kln sorban. Nem 
szksges egsz rtkeket megadni, de a tizedespont pont legyen s ne 
vessz.

hfszam=		a flvben kitztt hzi feladatok szma (hasznlhat kis 
			ellenrzsekre is); 0, ha nincs ellenrztt hzi 
			feladat
hfdobas=	szm, i vagy n; i esetn a legrosszabbul sikerlt hzi
		        feladat pontszma nem lesz figyelembe vve,
			szm esetn a legrosszabbul sikerlt [szm] darab
			pontszama nem lesz figyelembe vve
hfmax=		egy adott hzi feladaton elrhet maximlis pontszm
hfsummin=	a hzi feladatokon sszesen elrend minimum pontszm; 0, 
			ha nincs ilyen kvetelmny
hfnev=		ha a sok kis ellenrzs nem hzi feladat, akkor itt 
			megdhat, hogy hogy hvjuk inkbb. Legyen rvid; 
			ha nincs megadva, akkor "HF".
zhszam=		a flv ZH-inak szma
zhmax=		egy adott ZH-n elrhet maximlis pontszm
zhmin=		egy adott ZH-n elrend minimlis pontszm; 0, ha nincs 
			ilyen kvetelmny
zhsummin=	a ZH-kon sszesen elrend minimlis pontszm; 0, ha 
			nincs ilyen kvetelmny
hfszorzo=	a flvkzi vagy vizsga sszpontszmba ilyen szorzval 
			addnak be a hzi feladatok. Automatikusan 1, ha 
			nincs megadva.
zhszorzo=	a flvkzi vagy vizsga sszpontszamba ilyen szorzval 
			addnak be a ZH pontszmok. Automatikusan 1, ha 
			nincs megadva.
felevmin=	a flvben sszesen (ZH-kbl s hzi feladatokbl) 
			elrend minimlis pontszm az alrshoz. Ez
			mr "hfszorzo"-val s "zhszorzo"-val van szmolva!
felevkozi=	i vagy n, attl fggen, hogy van-e a trgybl flvkzi 
			jegy. Ha van, akkor a flvbl hozott pontszm 
			nem szmt bele a vizsgajegyekbe (ha vannak), 
			viszont vizsgajegy csak akkor adhat, ha a 
			flvkzi jegy legalbb elgsges.
minfva=		flvkzi jegy esetn legalbb ennyi pont kell a teljes 
			flvben (HF, ZH) a jeleshez
minfvap=	"zhus" esetn kell csak, legalbb ennyi kell az A^+ 
			flvkzi jegyhez. 
minfvam=	"zhus" esetn kell csak, az A^- jegyhez.
minfvb=		flvkzi jegy esetn legalbb ennyi pont kell a teljes 
			flvben (HF, ZH) a jhoz
minfvbp=	"zhus" esetn.
minfvbm=	"zhus" esetn.
minfvc=		flvkzi jegy esetn legalbb ennyi pont kell a teljes 
			flvben (HF, ZH) a kzepeshez
minfvcp=	"zhus" esetn.
minfvcm=	"zhus" esetn.
minfvd=		flvkzi jegy esetn legalbb ennyi pont kell a teljes 
			flvben (HF, ZH) az elgsgeshez
ivmax=		az IV-n elrhet maximum pontszm
ivmin=		az alrsrt szksges minimum pontszm az IV-n, vizsgn 
			ez lesz a teljes flvrl hozott pontszm sikeres
			IV esetn. Ne felejtsk, hogy a flvi pontba mr
			beleszmolandk a "hfszorzo" s "zhszorzo" faktorok!
miniva=		flvkzi jegy esetn legalbb ennyi pont kell az IV-n a 
			jeleshez
minivap=	"zhus" esetn.
minivam=	"zhus" esetn.
minivb=		flvkzi jegy esetn legalbb ennyi pont kell az IV-n a 
			jhoz
minivbp=	"zhus" esetn.
minivbm=	"zhus" esetn.
minivc=		flvkzi jegy esetn legalbb ennyi pont kell az IV-n a 
			kzepeshez
minivcp=	"zhus" esetn.
minivcm=	"zhus" esetn.
minivd=		flvkzi jegy esetn legalbb ennyi pont kell az IV-n az 
			elgsgeshez
korabbialairas=	a korbbi flvekben szerzett alrs ennyi flvi pontot
		  	r a vizsgn. Csak akkor van figyelembe vve, ha
			enlkl a hallgat nem kapn meg az alrst. Ne
			felejtsk, hogy a flvi pontba mr beleszmolandk
			a "hfszorzo" s "zhszorzo" faktorok!
vizsgaszam=	a trgybl tartott vizsgk szma; 0 a csak flvkzi 
			jegyes trgyak esetn
vizsgamax=	egy adott vizsgn maximlisan elrhet pontszm
vizsgamin=	egy adott vizsgn minimlisan elrend pontszm; 0, ha 
			nincs ilyen kvetelmny
vizsgaszorzo=	a vizsga sszpontszmba ilyen szorzval szmt be maga 
			a vizsga. Automatikusan 1, ha nincs megadva.
mina=		legalbb ennyi pont kell a teljes flvben (HF, ZH, 
			vizsga) a jeleshez
minap=		"zhus" esetn.
minam=		"zhus" esetn.
minb=		legalbb ennyi pont kell a teljes flvben (HF, ZH, 
			vizsga) a jhoz
minbp=		"zhus" esetn.
minbm=		"zhus" esetn.
minc=		legalbb ennyi pont kell a teljes flvben (HF, ZH, 
			vizsga) a kzepeshez
mincp=		"zhus" esetn.
mincm=		"zhus" esetn.
mind=		legalbb ennyi pont kell a teljes flvben (HF, ZH, 
			vizsga) az elgsgeshez
csalas=		csals esetn ennyi pont kerl levonsra a jegyek 
			megllaptsnl
vakompsz=	i rtk esetn a Vetier Andrs fle kompenzcis
		szably lp rvnybe (lsd pelda7 s pelda8)
minnemala=	i rtk esetn lesz alrs akkor is, ha a flv
		sorn a minimumkvetelmnyek (pl. zhmin) nem teljesltek,
		de a flvkzi jegy ilyenkor csak elgtelen lehet.

Formatum a <filenev>.zhk fileokehoz: a # karakterrel kezdd sorokat a 
program figyelmen kvl hagyja. Nem egsz szmok tizedesponttal (s nem 
tizedesvesszvel!) adandk meg. A file hallgatnknt egy sorban, 
pontosvesszvel elvlasztva space nlkl, a kvetkez sorrendben kell, 
hogy tartalmazza a kvetkez adatokat:

Nev;
Neptun kod;
Gyakorlatvezet monogramja, de ha nem akarunk gyakorlatvezet szerint 
	vlogatni, akkor nem szksges;
Hzi feladatok pontszmai; (csak ha van hzi feladat, azaz hfszam>0)
ZH-k pontszmai;
PtZH-k pontszmai;
PtptZH-k pontszmai;
Az IV pontszma;
"k", ha korbbrl van alrs, res egybknt, angol nyelven a zhe-hez 
	s zhus-hez "e" kell "k" helyett. Ha egyebet runk ide, az 
	kzvetlenl megjelenik az eredmnyben, s a program nem veszi
	figyelembe az alrst. J, ha valami extra felttel nem
	teljeslt;
A vizsgkon elrt pontszmok (csak ha van vizsga, azaz vizsgaszam>0)

Tblzatkezelben val szerkesztshez lsd a tablkezelo.txt file-t.

A mr megtrtnt, de be nem nyjtott rtkelst "-" jellel kell jellni, 
ez azrt fontos, hogy minden sorban ugyanannyi nemres bejegyzs legyen. 
Pontszmok helyett berhat "cs" is, ezesetben az adott rtkels nem 
lesz figyelembe vve, s a jegyek megllaptsnl a csalas vltozban 
belltott pontszm levonsra kerl, angol nyelven "ch" kell "cs" 
helyett.

A ~/zhpontozo/pelda<1..6> knyvtrakban klnfle kurzusokhoz tartoz 
pldk tallhatk, rvid lerssal. A "zhus"-nek megfelelen mdostott 
plda szerepel a ~/zhpontozo/pelda4_us knyvtrban.

----8<----

Ez itt albb mr nem szksges a hasznlathoz, de jl jhet ha a dolog 
lelkivilgval kell foglalkoznunk. Egy kis lers a keletkez (majd 
letrlt, de a script vgn a trlst kiiktathatjuk) fileokrl s 
formtumokrl:

.zhk --> .zhg  itt mr csak a gyakorlatvezet monogramjnak megfelel 
	hallgatk szerepelnek, de a formtum mg nem vltozott.

.zhg --> .zhv  itt gyakorlatvezet s vizsgalap szerint is megszrtk a 
	hallgatkat, formtum nem vltozott.

.zhv --> .zhr  itt trtnik a kirtkels s az tlagok kiszmolsa. Az 
	utols sorokban vannak a statisztikk, a pontos formtumot lsd 
	lejjebb.

.zhr --> .zhb neptunt elre tesszk, nv msodik.

.zhb --> .zhe Ezutn egy elzetes abc rendezs neptun kd MAJD nv MAJD
        pontszmok szerint.

.zhe --> .zhd Bejelljk a dupla neptunosokat.

.zhd --> .zhs  itt szedjk ki a szneket, ha a -n opci jelen van.

.zhs --> .osz  A .osz file-ban lthat, hogy mely oszlopokra van szksg 
	(-o opci, illetve publ_ esetben a nevek kirtse).

.zhs --> .zhc  Itt kirtjk az sszes oszlopot, amire nincs szksg.

.zhc --> .zha  ABC sorrendbe rendezs; a statisztikt eltte levlasztjuk 
	s utna visszaragasztjuk. Az ABC rendezsek rendszerfggst egy 
	agresszv sed paranccsal kerljk ki, mely a betket a betkod.sed 
	s kodbet.sed file-okban lertak alapjn szmokk vltoztatja, s 
	eszerint trtnik a rendezs a sort ltal.

.zha --> .html A vgs html file elksztse, ehhez kellenek a fej- s 
	lblcek is.


Formtum a .zhk, .zhg, .zhv fileokhoz: 
1. Nv;
2. Neptun kd;
3. gyakvez neve;
3+i. i. hf; i=1..hfszam
3+hfszam+i. i. zh; i=1..zhszam
3+hfszam+zhszam+i. i. ptzh; i=1..zhszam
3+hfszam+2*zhszam+i. i. ptptzh; i=1..zhszam
4+hfszam+3*zhszam. ivzh;
5+hfszam+3*zhszam. k, ha korabbrol van alairas, egyebkent barmi;
5+hfszam+3*zhszam+i. i. vizsga; i=1..vizsgaszam


Formatum a .zhr (reszletes), .zhs .zhc, .zha fileokehoz: 
1. Nev (Ures a public opcioval, ekkor a html gyarto nem veszi figyelembe.);
2. Neptun kod;
3. gyakvez neve (Ures a public opcioval, a html gyarto nem veszi figy.be.);
3+i. i. hf; i=1..hfszam ("cs" lehetseges, zarojel, ha eldobtuk)
3+hfszam+i. i. zh; i=1..zhszam (zarojel, "cs", feketeseg lehetseges)
3+hfszam+zhszam+i. i. potzh; i=1..zhszam (zarojel, "cs", feketeseg lehetseges)
3+hfszam+2*zhszam+i. i. potpotzh; i=1..zhszam (zjel vagy "cs" lehet)
4+hfszam+3*zhszam. hfsum (zarojel, feketeseg lehetseges)
5+hfszam+3*zhszam. zhsum (zarojel, feketeseg lehetseges)
6+hfszam+3*zhszam. ivzh; (feketeseg, "cs" lehetseges)
7+hfszam+3*zhszam. k, ha korabbrol van alairas, ! ha nem jol allnak a 
dolgok de nem vegleges, + ha megvan az alairas, - ha nincs meg az 
alairas, egyebkent ures;
8+hfszam+3*zhszam. felevkozi jegy
7+hfszam+3*zhszam+2*i. i. vizsgapont; i=1..vizsgaszam 
(feketeseg, cs lehetseges)
8+hfszam+3*zhszam+2*i. i. vizsgajegy; i=1..vizsgaszam

Szinkodok: n: nincs szin, lgt, lgs, koz, jo, jel: erdemjegy, f: fekete hatter
8+hfszam+3*zhszam+2*vizsgaszam+i. i=1..hfszam: az i. hf szine
8+2*hfszam+3*zhszam+2*vizsgaszam+i. i=1..zhszam: az i. zh szine
8+2*hfszam+4*zhszam+2*vizsgaszam+i. i=1..zhszam: az i. potzh szine
8+2*hfszam+5*zhszam+2*vizsgaszam+i. i=1..zhszam: az i. potpotzh szine
9+2*hfszam+6*zhszam+2*vizsgaszam. a hfsum szine
10+2*hfszam+6*zhszam+2*vizsgaszam. a zhsum szine
11+2*hfszam+6*zhszam+2*vizsgaszam. az ivzh szine
11+2*hfszam+6*zhszam+2*vizsgaszam+i. i=1..vizsgaszam: az i. vizsgapont 
szine
