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 "akfquiz5.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


   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 akfquiz5.js zeigt keine Grafik bei "multi:" Fragen an.


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


       akfquiz5.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-2006 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.


INTERNET
       Kontakt:
              mailto:akfquiz@akfoerster.de


       Homepage:
              http://akfoerster.de/akfquiz/de


       Beispiele:
              http://akfoerster.de/akfquiz/quiz.html


       Quiz verffentlichen:
              http://akfoerster.de/akfquiz/quizupload (keine Garantie!)



SIEHE AUCH
       akfquiz(5) scrquiz(1) grquiz(1) diaquiz(1) cgiquiz(8) linequiz(1)



AKFQuiz                              4.2.0                           mkquiz(1)
