Die Hilfe zur Bedienung des Programms:
ZEUGASS(1) User Contributed Perl Documentation ZEUGASS(1)
NAME
zeugass - Ihr Zeugnis Assistent
SYNTAX
"zeugass [-acdehilmnqtL] [-k ##] [DATEIEN]"
BESCHREIBUNG
Dieses Programm sammelt die Zeugnistexte aller Lehrer und stellt sie in
Datenbank-Tabellen zusammen, damit sie mit der Serienbrief-Funktion
einer Textverarbeitung in die Zeugnis-Vorlagen eingefügt werden können.
Wird das Programm ohne Optionen aufgerufen, erscheint das Menü.
Aufgaben:
+ Einlesen der Zeugnis-Eingabe-Dateien. - Alle Daten und Texte werden
diesem Programm durch die Zeugnis-Eingabe-Dateien (kurz: Eingabe-
datei) übergeben. Die Eingabedateien sind Textdateien mit Feldbe-
fehlen, wie sie mit jedem Texteditor und Textbearbeitungsprogramm
hergestellt werden können.
+ Anlegen der Datenbank: Die Datenbank-Tabellen sind im Text-Format.
Der Tabulator dient als Trennzeichen. Es wird für jede Klasse eine
Tabelle geführt, die bei jedem Programmende daraus eine gesammte
Tabelle schreibt.
+ Herstellen der Eingabedateien mit Feldbefehlen und den Namen der
Schüler. Und einer Anleitung zum Eintragen der Zeugnistexte
(liesmich.txt).
+ Kopieren der Eingabedateien zusammen mit der liesmich.txt auf
Diskette.
+ Sortieren, anzeigen und prüfen der Daten.
+ Ausgabe der Zeugnisse in DAT-Dateien für Latex
Menü und Optionen
Alle Komandos des Menüs können auch als Optionen beim Programmstart
angegeben werden. Deshalb werden sie nachfolgend gemeinsam beschrieben.
-m = Menü
Die Komandos werden in Menüs angeboten.
Dieses ist zu gleich die Vorgabe, wenn keine oder eine ungültige
Option angegeben wird.
-l [ DATEI [ DATEI ... ]] = Daten lesen
Liest die Eingabedateien ein.
Wird keine Datei angegeben, werden alle Dateien aus dem Hauptverze-
ichnis der Diskette gelesen.
Die Dokumentation für den Aufbau der Eingabedatei steht in der
liesmich.txt, die mit der Option -i angelegt und angezeigt wird.
Hinweis_1: Das Anlegen einer neuen Klasse (s. Kapitel "Stammdaten"
in der Datei liesmich.txt) ist nur möglich, wenn die Datenbank mit
dem Namen der Klasse noch nicht existiert.
Hinweis_2: Nachträgliche Änderungen an den Stammdaten werden nicht
durch dieses Programm unterstützt. Sollten nachträgliche Änderun-
gen notwendig sein, öffnen Sie die Datenbank-Tabelle mit einem
geeigneten Texteditor und bearbeiten die Stammdaten direkt. So
können auch Namen gelöscht werden.
Oder passen Sie die Eingabedatei mit den Stammdaten an und löschen
alle Datenbank-Dateien und lesen dann alle Eingabe-Dateien aus dem
log-Verzeichnis neu ein (zeugass -l log/*).
-e = Eingabedatei anlegen
Aus den Tabelen werden die Eingabedateien und die liesmich.txt
angelegt.
-d = Kopiert auf die Diskette
Kopiert die Eingabedateien und die liesmich.txt auf die Diskette.
Hinweis: Vorher müssen diese Dateien mit -e angelegt worden sein.
-i = liesmich.txt anzeigen
erzeugt die Datei liesmich.txt und zeigt sie an. Die Datei enthält
Hinweise zum Ausfüllen der Eingabedateien.
-k KLASSE = Klasse auswählen
KLASSE ist die Klasse auf die die folgenden Befehle angewendet wer-
den sollen.
Wenn keine Klasse angegeben wird oder die Klasse nicht besteht,
werden alle ausgewählt.
-q = quit (=beenden)
Beendet das Programm vom Menü aus.
-h = Hilfe
zeigt diese Hilfe an.
-t = Test-modus
Schaltet den Test-modus ein. Im Test-modus wird die Datenbank nicht
gespeichert. Er dient zum Kennenlernen und Testen des Programms.
-a = Zeugnisse ansehen
Zeigt die Zeugnisse zur Kontrolle der Fächer und des Tabellenauf-
baues an. Dabei sind nur die Anfänge der Zeugnistexte sichtbar.
Wenn keine Klasse angegeben wird, werden die Zeugnisse des ersten
Schülers aller Klassen angezeigt; wenn eine Klasse angegeben wird,
werden die Zeugnisse aller Schüler der einen Klasse angezeigt.
Hinweis: Die Länge der Texte wird von der Breite der Konsole bes-
timmt (s. Funktion konsole()).
-n = Datenbank nach Namen Sortieren
Sortiert die Datenbank nach Nachnamen, dann Vornamen alphabethisch.
-L = Ausgabe für Latex
Ausgabe der Zeugnisse in DAT-Dateien für Latex
ABHÄNGIGKEITEN und externe PROGRAMME
Außer der Standard-Perl-Installation werden folgende Programme
benötigt:
mtools: für den Zugriff auf die Diskette. Es beachtet die Umwandlung
des Zeilenumbruchs (CR/LF und LF) der unter DOS und UNIX verschieden
ist.
mc: mcedit und mcview sind zum Bearbeiten und Ansehen der Textdateien
voreingestelt (das kann in den Einstellungen geändert werden).
iconv: wird benötigt für das konvertieren des Zeichensatzes der
Eingabedateien.
Und weitere Programme aus den LINUX- / UNIX- GNU-tools.
DATEIEN und VERZEICHNISSE
Es wird keine Einstellungsdatei benutzt. Die Einstellungen werden am
Anfang der Programmdatei vorgenommen. Dort können auch die Pfade ein
gestellt und nachgesehen werden.
Die folgenden Pfade müssen zu Beginn der Arbeit leer sein und es müssen
verschiedene Verzeichnisse sein, die vor der ersten Ausführung des Pro-
gramms vom Anwender angelegt werden.
Pfad für die Datenbank:
Hier werden die Tabellen im Text-Format abgelegt, die die Zeugnis-
texte enthalten. Mit der Serienbrief-Funktion einer Textverar-
beitung werden die Texte in das Zeugnis-Formular Übernommen (oder
jemand schreibt dafür ein zweites Programm).
Pfad für Vorlagen zum Verteilen:
Hier werden die Vorlagen und die Anleitung für die Steuerdateien
Angelegt, die dann auf Disketten kopiert werden und an alle Lehrer
verteilt werden.
Pfad für Log- und Sicherungsdateien:
Hier werden Kopien der eingelesenen Eingabedateien abgelegt und
Logdateien.
TODO - Noch zu erledigende Arbeiten
zu viel! Viel zu viel um es hier aufzuschreiben. Eine grobe Auswahl:
Installationshilfe / -Programm integrieren, das gestartet wird, wenn
die Pfade nicht angelegt sind.
Sonderregeln für Zeugnisspruch sind noch nicht geschrieben.
Schreiben der Logdatei fehlt noch.
Benutzerschnittstelle einrichten mit: dialog, xdialog, kdialog, gdialog
Datenbank zugriffe so ändern, daß die Datenbank nicht mehr als ganzes
in den Hauptspeicher eingelesen wird und dann alle Klassen in einer
Datenbank verwaltet werden können. Ideal wäre eine Datenbank im DBF-
Format oder ein Zugriff auf eine SQL-Datenbank.
BUGS - Bekannte Fehler
(in Arbeit) Ständig wechselnd
Ich konnte noch nicht alle Möglichkeiten testen, deshalb die Bitte:
sendet mir Eingabedateien mit einer Fehlerbeschreibung zu, die Fehler
enthalten, die noch nicht richtig behandelt werden.
AUTOR
(c) 2003 Arnold Johannes Jäger
www.beleuchtungskunst.de/pc/
LIZENZ
Dieses Programm unter liegt der GPL-Licenz. Es kann frei verbreitet und
geändert werden. Die Autoren müssen genannt werden und freuen sich,
wenn sie erfahren, wer mit dem Programm arbeitet. Jedes Programm, das
Code aus diesem Programm enthält muß wieder unter der GPL-Lizenz
veröffentlicht werden.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
Der Autor haftet nicht für Schäden, die durch die Anwendung des Pro-
gramms enstanden sind. Auch kann er keine Garantie für das Funktion-
ieren übernehmen.
perl v5.8.0 2004-04-26 ZEUGASS(1)
|
Zeugass - Ihr Zeugnis-Assistent :
Eingabe-Datei zur Eingabe der Namen :
Eingabe-Datei zur Eingabe der Zeugnistexte :
Hilfetext für die Lehrer