Szöveges értékelés nyomtatása
A szöveges értékelés nyomtatása sablon fájl alapján történik. A sablon tartalmaz speciális azonosítókat, amik helyére a program a megfelelő értékeket fogja behelyettesíteni.
A /var/mayor/print/module-naplo/templates
könyvtárba találhatók a sablonok, illetve nekünk is ide kell elhelyezni a sajátunkat az intézmény rövid nevének megfelelő nevű alkönyvtárba. Ha ilyen alkönyvtár nincs, vagy nincs benne megfelelő sablon, akkor a default
alkönyvtárban található sablonokat használja a rendszer. Találunk még egy draft
alkönyvtárat is, amibe a lecsupaszított sablonok találhatók - ezek mutatják meg a lehetséges használható sablonelemeket.
A szöveges értékelés nyomtatásakor a rendszer egy szovegesErtekeles.tmpl
nevű sablon állományt keres - előbb az intézmény mappájában, majd ha ott nem talált ilyet, akkor a default
mappában.
A sablonban a következő speciális jelöléseket használjuk:
%!függvény kiterjesztés
Ez a vezérlősor csak a file első sora lehet, különben a program figyelmen kívül hagyja. Arra szolgál, hogy megmondjuk a sablon alapján generált szöveges állományt feldolgozó függvény nevét és a keletkező állomány kiterjesztését. Például:
%!pdfLaTeXA5 pdf
Ha nincs ilyen sor, akkor a program egyszerű szöveges állományt készít.
%$paraméterNév
Egyszerű lecserélendő, behelyettesítendő változót takar.
%{blokkNév ... %}blokkNév
A blokk nyitó, illetve csukó jelekkel egy szövegrészt foghatunk közre. Fontos, hogy a nyitó és csukó szimbólumok külön-külön, önálló sorokat alkossanak. Egy-egy ilyen blokk többször, többféle paraméterezéssel lesz bemásolva a végső szövegbe. Körlevél szerű megoldásról van szó, azzal a különbséggel, hogy itt lehetnek egymásba ágyazott blokkok is. Például a szöveges értékelések esetén minden diák számára el kell készíteni egy-egy értékelést (ez egy diák blokk-kal írható le), ezeken belül tárgyanként lesznek értékelések, a tárgyak blokkjain belül az egyes tárgyakra vonatkozó szempontok jelennek meg, azon belül a szempontokra vonatkozó minősítések jelennek meg. Ez így adjuk meg:
%{diak ... %{targy ... %{szempont ... %{minosites ... %}minosites ... %}szempont ... %}targy ... %}diak
Az utolsó a feltételes szövegrészek jelölése:
%?paraméterNév|igazSzöveg|hamisSzöveg%?
A program ilyen esetben a szöveg kifejtésekor az adott helyen megvizsgálja a megadott paraméter logikai értékét (csak valódi logikai értéket vesz figyelembe!), és igaz esetén az igazSzöveg
-et, hamis logikai érték esetén a hamisSzöveget
, minden egyéb esetben üres sztringet fog helyettesíteni a kifejezés helyére. Például:
%?valasztott|X|O%? %$minosites
A fenti sor kifejtése során, ha olyan minősítéshez jutunk, ami az adott tanuló esetén ki lett választva, meg lett jelölve, akkor a file-ba X
kerül a minősítés szövege elé, míg egyéb esetben a minősítés magában áll, vagy O
előzi meg.
%?elsoValasztott|%$minosites||?%?%tobbedikValasztott|, %$minosites||%?
A fenti sor két elágazást tartalmaz: az első kiválasztott minősítést kiírjuk (vessző nélkül), a többedik - szintén kiválasztott - minősítéseket bevezető vesszővel írjuk ki. Így tulajdonképpen a kiválasztott minősítések listáját kapjuk meg.
%>utolsó<%>nem utolsó%>
Kísérleti opció! A blokk utolsó, illetve nem utolsó elemére vonatkozó elágazás. Lehet bele ágyazva %? szerkezet.
Ha a forrásszövegbe valódi % jelet kívánunk elhelyezni (pl. TeX komment), akkor használjuk a
%%
jelölést!