EF2HTM - Ein EF-Konverter für HTML Version 0.45 (1. März 1999)

TU Dresden, Psychologie des Lehrens und Lernens
Rüdiger Krauße

Allgemeines     Aufrufen von ef2htm     Schalter     EF-Hauptseite

"Beim EF-Format handelt es sich um eine Möglichkeit, die abstrakten Daten einer Aufgabe in einer Datei abzuspeichern.
EF-Datein enthalten also nur die Werte, wie z.B. Überschrift, Frage, Antwortformat, Hinweise usw., ohne spezielle Angaben über das Erscheinungsbild oder den Verarbeitungsablauf im Computer. EF ist ein Plain-Text-Format, d.h. es handelt sich um normal lesbaren Text, der auch mit einem gewöhnlichem Text-Editor bearbeitet werden kann ..."
Um die Aufgaben dann schließlich bearbeiten zu können, werden die Datein von speziellen Anwendungsprogrammen gelesen und die Aufgaben werden entsprechend generiert.
Das Programm ef2htm generiert in diesem Sinne aus EF-Quellkode-Datein HTML-Datein (mit Javascript), sodass man die Aufgaben in einem Internet-Browser bearbeiten kann. Die Schaubeispiele in der EF-Dokumentation sind beispielsweise mit ef2htm erstellt. ef2htm kann aber auch HTML-Datein erzeugen, die man in MS WORD importieren kann, um Papierversionen der Aufgaben zu erhalten. Dabei können auch EFC-Datein (Mehrere Aufgaben zu einem Test zusammengefaßt) angegeben werden. Bei der Ausgabe für WORD wird gleichzeitig eine kleine HTML-Datei mit der korrekten Lösung erzeugt.
Wichtig: Die so erzeugten HTML-Datein für Browser funktionieren nur in Browsern ab der 4. Generation (also Version 4.x).
Für Insider: Es werden nämlich das all-Objekt (Microsoft) bzw. Layer (Netscape 4.x) bzw. das DOM (Netscape ab 6.1)  verwendet.

Zu ef2htm gehören folgende Dateien (Version 0.6):

ef2htm.exe	Der eigentliche Compiler, der dann auch aufgerufen wird.
#Simple.htm #Simple_t.htm : :	"Schablonen"-Datein für die verschiedenen Plattformen. Wenn Sie das Outfit der erzeugten Datein global ändern wollen (Hintergrundfarbe usw.), dann müssten Sie in diesen Datein ihr Glück versuchen.
ef_h2t.js ef_st.js ef_pl.js : :	JavaScript-Datein, die Teile des Programmcodes für die Bearbeitung der Aufgaben im Browserfenster enthalten.

Wichtig: Alle diese Datein müssen sich in ein und dem selben Verzeichnis befinden.

ef2htm selbst ist ein relativ robustes Programm. Auch wenn der EF-Quellkode fehlerhaft ist, versucht das Programm immer eine Ausgabedatei zu erzeugen, die dann jedoch unter Umständen unvollständig oder fehlerhaft ist. Wenn es sich aber nur um kleinere Fehler handelt (z.B. Zeichenkette nicht geschlossen) müsste die HTML-Datei eigentlich OK sein (Das soll jetzt aber keine Aufforderung zum Schreiben schlampiger EF-Datein sein!).

Kommandozeilenaufruf     "Windows-Klick" einrichten     Batch-Datein

ef2htm.exe ist ein Windows-Konsolenprogramm, d.h. es öffnet sich ein (schwarzes) DOS-Fenster und das Programm wird abgearbietet. Es besteht während das Übersetzens keine Möglichkeit Daten oder Parameter einzugeben. Diese Werte müssen ef2htm alle zu Beginn übermittelt werden, siehe dazu auch den Abschnitt Schalter. Es können auch mehrere Dateien auf einmal übersetzt werden.
Im wesentlichen gibt es 3 gängige Methoden des Aufrufs, die im folgenden beschrieben werden.

ef2htm.exe ist ein Windows-Konsolenprogramm. Der Aufruf erfolgt über "Ausführen" im Windows-Startmenü. Als Parameter ist der Name der EF-Datei bzw. EFC-Datei anzugeben, die übersetzt werden soll. Es ist auch möglich, mehrere EF-Fateien anzugeben und Wildcards (?, *) zu verwenden. ef2htm erzeugt, dann jeweils eine HTML-Datei, die den selben Namen wie die Quell-Datei hat, aber als Anhängsel ".htm". Bei der Ausgabe für WORD wird zusätzlich eine Datei erzeugt, die auf "..._loes.htm" endet und die Lösung enthält (ebenfalls für die Weiterverarbeitung in WORD gedacht).Wenn das nicht klappt, versuchen Sie einfach den "Windows-Klick" einzurichten. Der geht eigentlich immmer.

Beispiel: In diesem Fall wird aus der EF-Datei aufgabe1.ef in die Datei aufgabe.htm generiert. (Die Angabe der Extension .ef in der Komandozeile ist optional, .efc hingegen muß immer angegeben werden) Wichtig: Unter Umständen ist es erforderlich, das ganze von dem Verzeichnis aus zu starten, in dem sich auch ef2htm befindet.

Für TEE: Wenn diese Aufgabe in TEE eingebunden werden soll muß in der Kommandozeile noch der Schalter "-t" hinzugefügt werden.

Für study2000: Wenn diese Aufgabe in den Studierplatz study2000 eingebunden werden soll, muß in der Kommandozeile noch der Schalter "-s" hinzugefügt werden.

Für MS WORD: Wenn diese Aufgabe als Papierversion benötigt wird muß in der Kommandozeile noch der Schalter "-w" hinzugefügt werden. Die entstehende HTM-Datei kann dann mühelos in MS Word übernommen werden. ef2htm erzeugt in diesem Fall eine weitere Datei, die auf "..._loes.htm" endet, und die Lösung der Aufgabe(n) enthält.

Für AM: Wenn diese Aufgabe im Aufgabenmodul AM verwendet werden soll, so ist der Schalter "-a" anzugeben.

Weitere Schalter finden Sie im Abschnitt Schalter.

Die Kommandozeilengeschichte ist aber in der Regel etwas mühseelig. Lesen Sie deshalb am besten auch die beiden folgenden Abschnitte.

Wenn man ef2htm öfter benutzt, ist der Kommandozeilenaufruf eher umständlich (falls er überhaupt funktioniert). Es wäre hingegen sehr praktisch, wenn man eine EF-Datei mit der rechten Maustaste anklicken könnte und dann im üblichen Pop-Up-Menü einen Eintrag "Nach HTML übersetzen" hätte. Und genau das kann man (mit einmaligem Aufwand) such einrichten. (Es lohnt sich auf jeden Fall.) Die folgende Beschreibung ist soll eher exakt als schön sein. Wer damit Probleme hat wende sich einfach an mich.

(Achtung: alle jetzt vorkommenden Anführungszeichen sind als solche gedacht und natürlich nicht in die Eingabefelder einzutragen.)

1. Registrieren von .ef

• Klicken sie mit der Rechten Maustaste auf eine EF-Datei.
• Wählen Sie im erscheinenden Pop-Up-Menü den Punkt "Öffnen mit ..."
• Tragen Sie im erscheinenden Dialog in der Zeile "Beschreibung" am besten "EF-Exercise-Format" ein.
• Wählen Sie im unterhalb in der Liste den Eintrag "NotePad" (oder einen ähnlichen Texteditor). Wenn Sie dann später auf EF-Datein doppel-klicken, wird diese Datei dann mit diesem Editor geöffnet ... sehr praktisch)
• Drücken Sie auf "OK", falls der Dialog noch da ist.

2. Anschließen von ef2htm

• Öffnen Sie ein normales Verzeichnisfenster.
• Wählen Sie in der Menüleiste bei "Ansicht" den Unterpunkt "Optionen" (ganz unten).
• Klicken Sie im erscheinenden Dialogfenster auf den Karteikartenreiter "Dateitypen".
• Suchen Sie in der Liste der registrierten Dateitypen den Eintrag "EF-Exercise-Format" (oder was auch immer sie oben bei 1. im 3. Punkt eingetragen haben)
• Klicken Sie jetzt auf den Button "Bearbeiten ...".
• Klicken Sie im neu erscheinen den Dialog auf den Button "Neu...".
• Es erscheint ein kleines Dialogfenster. Wir sind endlich da. Tragen Sie in der Zeile "Vorgang:" am besten "-> HTM" ein (oder was dann immer im Pop-Up-Menü beim Anklicken erscheinen soll)
• Klicken Sie auf den Button "Durchsuchen" und stellen sie im erscheinenden Open-File-Dialog den Eintrag ef2htm.exe ein. (Liegt bei uns unter Y:\Gruppen\Aufgaben\EF_Code\ef2htm.exe)
  Hinter dem Dateinamen können Sie noch Schalter angeben, je nachdem, für welche Zeilplattform die erzeugten HTM-Datein verwendet werden sollen. (weitere Schalter finden Sie im Abschnitt Schalter)

  Schalter	Ziel
  -t	für TEE
  -s	für Studierplatz SP3
  -w	für Word
  -a	für Aufgabenmodul

• Wenn Sie außerdem Verzeichnisse verwenden wollen, die Leerzeichen im Namen haben, sollten Sie außerdem noch ""%1"" hinzufügen. (In der Zeile würde dann z.B. stehen: Y:\gruppen\Aufgaben\EF_Code\ef2htm.exe -s "%1" ).
• Dann beenden Sie diesen Dialog mit "OK"
• Schließen Sie rückwärts alle Dialogfenster mit "OK".

Wenn Sie mit mehreren Zielumgebungen arbeiten, ist es sinnvoll sich mehrere "Klicks" anzulegen (mit jeweils verschiedenen Schaltern).

3. EF-Logo (optional, non plus ultra für Schönheits-Fans) (Windows verwendet dann ein spezielles Icon in den Verzeichnis-Fenstern)

• Öffnen Sie ein normales Verzeichnisfenster.
• Wählen Sie in der Menüleiste bei "Ansicht" den Unterpunkt "Optionen" (ganz unten).
• Klicken Sie im erscheinenden Dialogfenster auf den Karteikartenreiter "Dateitypen".
• Suchen Sie in der Liste der registrierten Dateitypen den Eintrag "EF-Exercise-Format" (oder was auch immer sie oben bei 1. im 3. Punkt eingetragen haben)
• Klicken Sie jetzt auf den Button "Bearbeiten ...".
• Klicken Sie im neu erscheinenden Dialog auf den Button "Anderes Symbol ...".
• Klicken Sie auf den Button "Durchsuchen .." und öffnen im File-Dialog ein Icon (bei uns Y:\Gruppen\Aufgaben\EF_Code\ef.ico)
• Doppelklicken Sie auf das Icon in der Mittelzeile und schließen Sie rückwärts alle Dialogfenster mit "OK" bzw. "Schließen".

Wenn man EFC-Datein verwendet, muß man das ganze noch mal für einrichten (nämlich für EFC, klar).

Die Batch-Datein (Extension *.bat) sind ein nützliches Überbleibsel aus der DOS-Ära. Sie enthalten Textzeilen, die wie aufeinander folgende Eingaben im "Aufführen"-Dialog abgearbeitet werden.

Beispiel: demo.bat

Diese Datei würde also die Datein auf1.ef, auf2.ef, auf3.ef und auf4.ef ef für TEE übersetzen ohne Anzuhalten (siehe Abschnitt Schalter).
Solche Batch-Datein können in der Regel mit beliebigen Texteditoren (z.B. Notepad) bearbeitet werden und werden durch Doppelklick gestartet.

Natürlich kann man auch alle EF-Dateien auf einmal übergeben:

Unter Verwendung von Wildcard läßt sich dies aber auch noch kürzer realisieren:

Hier eine Übersicht über die Schalter, die in der Kommandozeile, in Stapeldatein oder Verknüpfungen hinter dem Dateinamen angegeben werden können (Reihenfolge beliebig, es können auch mehrere Schalter angegeben werden, sofern sich diese nicht wiedersprechen). Manche Schalter bestehen aufs einem Buchstaben und einem übergebenen Wert. Dieser kann optional (zur besseren Übersicht) durch einen Doppelpunkt abgetrennt werden (d.h. -r:rep.txt und -rrep.txt bedeuten das gleiche).

Das wars!

Alle möglichen Feed-Backs bitte an R.Krauße rkrausse@rcs.urz.tu-dresden.de.

Originalquelle im WEB: http://linus.psych.tu-dresden.de/Stupla/ef/doc/ef2htm.htm