mkquiz(1)                                                            mkquiz(1)



NAME
       mkquiz - erzeugt HTML Dateien mit einem Quiz fr akfquiz4.js


SYNTAX
       mkquiz [Optionen] [Quiz-Dateien]
       mkquiz [-h|--help|/?]


BESCHREIBUNG
       Das  Programm erzeugt aus einfach zu erstellenden Vorlagen HTML Dateien
       mit einem Quiz.

       Diese HTML Dateien bentigen auerdem das Script "akfquiz4.js" und  die
       Dateien  "leer.png", "richtig.png" und "falsch.png" und falls angegeben
       noch eine CSS Datei. Diese Dateien mssen im selben Verzeichnis liegen,
       oder der Pfad kann ber das Stichwort HauptURI angegeben werden.

       Das Format der Eingabedateien ist in akfquiz(5) beschrieben.

       Die  Dateinamen  fr  die  Ausgabedateien werden von den Dateinamen der
       Eingabedateien hergeleitet.

       Wird mkquiz ohne Dateinamen und  ohne  den  Parameter  -a  bzw.  --auto
       aufgerufen,  liest  es  von  der  Standardeingabe  und schreibt auf die
       Standardausgabe.


BENUTZUNG
   Optionen
       -o <Verz.> | --out <Verz.>
              Verzeichnis fr die Ausgabe-Dateien


       -a | --auto
              bearbeite alle Quiz-Dateien im aktuellen Verzeichnis


       -i | --index
              erstelle eine index.html mit allen bearbeiteten Quiz-Dateien

Wenn man Eingabedateien auf der Kommandozeile  angibt,  kann  man  die  Datei-
Endung ".akfquiz" bzw. ".aqz" weglassen.


   Benutzung der erzeugten HTML-Datei:
       Es  handelt  sich  um eine HTML Datei die ein JavaScript einbindet. Die
       Benutzung ist somit weitestgehend vom Browser abhngig. Bei den meisten
       Browsern  kann man die Antworten und die Bedienelemente am Ende mit der
       Maus oder einem anderen Zeigegert "anklicken". Auerdem  erlauben  die
       meisten  Browser,  dass  man mit der Tabulator-Taste die Bedienelemente
       anwhlen und mit der Leertaste oder der Enter-Taste aktivieren kann.

       Zustzlich zu den Bedienelementen im unteren Teil der Seite werden noch
       Tastatur-Krzel definiert.

       Auf PCs sind diese folgendermaen aufrufbar:

       Alt + R
          zeigt die Auswertung an (R wie "Resultat", engl. "Result")

       Alt + S
          zeigt die Lsung an (S wie engl. "solution")

       Alt + N
          erlaubt alles Neu zu machen (N wie "Neu", engl. "New")


       Diese Tastatur-Krzel sind nur auf neueren Browsern verfgbar.


   Drucken:
       Um  das  Quiz zu drucken, drucken Sie bitte die erzeugte HTML-Datei und
       nicht die Eingabedatei. In der HTML Datei, sowie  in  den  CSS  Dateien
       sind  spezielle  Anweisungen  fr den Druck. Es wird also nicht einfach
       nur die Bildschirmdarstellung ausgedruckt.

       Wenn man neben dem Aufgaben-Blatt noch ein Lsungs-Blatt drucken  will,
       kann man einfach den Knopf Auflsung bzw. Solution drcken und dann das
       Ganze nochmal ausdrucken.


DIAGNOSE
   Wenn Fehler auftreten:
       Das Programm mkquiz sollte auch dann  immer  korrektes  HTML  ausgeben.
       Fehlermeldungen  werden  mit  in  den  HTML Code geschrieben. Auf diese
       Weise kann man die Position von Fehlern leicht ermitteln, indem man mit
       einem  Browser  einfach  schaut,  an  welcher  Stelle die Fehlermeldung
       eingefgt wurde.

       Wenn das Programm mit den Eingabedaten gar nichts anfangen  kann,  gibt
       es nichts aus bzw. erstellt eine leere Datei.

       Der  HTML-Code,  den das Programm erstellt, sollte immer formal korrekt
       sein solange man das Stichwort "htmlcode:" nicht verwendet. Wenn man es
       verwendet, ist man selber fr die korrekte Verwendung verantwortlich.


   Zusatzinformationen:
       In  den HTML Code werden einige wenige Zusatzinformationen aufgenommen,
       die im Browser nicht zu sehen sind.  Es wird die  Sprache  gespeichert,
       wenn  man  das  Stichwort  "language:"  verwendet hat. Diese Angabe ist
       brigens auch technisch relevant und sollte deshalb  nicht  weggelassen
       werden.  Auerdem  wird  auch  der  Autor  so  eingetragen, dass es von
       Software  leicht  ausgelesen  werden  kann  (zB.  von   Suchmaschinen).
       Ebenfalls  gespeichert  wird,  mit welchem Programm und welcher Version
       die Datei erstellt wurde.


MACKEN
       Das JavaScript akfquiz4.js zeigt keine Grafik bei "multi:" Fragen an.


DATEIEN
       Folgende  Dateien  mssen  mit  der  erzeugten  HTML  Datei  im  selben
       Verzeichnis liegen:


       akfquiz4.js
              JavaScript Datei - wird von der erzeugten HTML Datei bentigt


       leer.png, richtig.png, falsch.png
              bentigte Grafik-Dateien


       Falls  in  der AKFQuiz Datei eine CSS Datei angegeben wurde, muss diese
       ebenfalls in dem Verzeichnis liegen. Evtl.  bentigt  diese  CSS  Datei
       weitere Dateien.



LIZENZ
       Copyright  2003-2005 Andreas K. Frster
       <akfquiz@akfoerster.de>

       AKFQuiz ist Freie Software. Sie knnen es unter den Bedingungen der GNU
       General  Public  License,  wie  von  der   Free   Software   Foundation
       verffentlicht,   weitergeben  und/oder  modifizieren,  entweder  gem
       Version 2 der Lizenz oder (nach Ihrer Option) jeder spteren Version.

       Die Verffentlichung von AKFQuiz erfolgt in der Hoffnung, dass es Ihnen
       von  Nutzen  sein  wird,  aber ohne irgendeine Garantie, sogar ohne die
       implizite Garantie der Marktreife oder  der  Verwendbarkeit  fr  einen
       bestimmten Zweck.


SIEHE AUCH
       akfquiz(5) crtquiz(1) grquiz(1) diaquiz(1) akfquiz.cgi(8) linequiz(1)



AKFQuiz                              4.0.3                           mkquiz(1)
