TEE - Dokumentaion

Ich beschreibe hier zuerst einmal nur den Hauptteil der Generierung von TEE, und zwar lasse ich die Anbindung von Aufgaben und Info-Pop-Up-Fenstern weg.
Input: eine WS-Datei mit der Wissensstruktur und zu jedem Knoten eine HTML-Datei, die den Inhalt repäsentiert
Output: TEE-System (Vernetzte interaktive HTML-Dokumente mit automatisch generierten Grafiken)

		Die gewünschte Struktur des Wissensdiagramms ist in einer WS-Datei enthalten (kompakter Plain-Text). In dieser Datei können auch Angaben zum Autor und zu zusätzlichen Links angegeben werden, die dann in TEE im unteren linken Fenster erscheinen.
		Zu jedem Knoten gehört eine HTM-Datei, die jeweils angezeigt werden soll, wenn der entsprechende Knoten gewählt wurde. Diese Datei enthält keine Strukturdaten, sondern wirklich nur den Wissens-Inhalt. Links zu anderen Datein sind erlaubt. Links zu Datein der anderen Knoten werden später erkannt und gesondert behandelt.
		ws2bmp generiert aus der WS-Datei die Grafik-Datein der Liniendiagramme
		ws2htm scannt (gesteuert von der WS-Datei) die HTM-Datein der einzelnen Knoten und gibt gleichnamige Datein in einem gesonderten Verzeichnis "compiled" aus. Dabei werden für TEE notwendige Steuerdaten eingefügt. Enthaltene Links werden verschiedentlich umgearbeitet: Links auf Datein von Knoten: Die Links werden jetzt auch von der Steuerelementen von TEE registriert. Links auf Datein im selben Verzeichnis: Diese Datein werden ebenfalls gescannt und mit Steuerinformationen versehen. Links auf Datein im Verzeichnis "info\...": Diese Links erzeugen für die aufgerufenen Datein kleine Pop-Up-Fenster. Links ins Internet (beginnen mit "http:\\ ...") Diese Links werden unverändert übernommen. Aus diese Weise kann man beliebige Links legen.
		Die unter erwähnten Grafikdatein. Leider im BMP-Format. Sie müssen noch mit einem beliebigen Grafikprogramm in GIF-Datein umgewandelt werden.
		ws2htm erzeugt zusätzlich Start- und Steuer-HTM-Datein (unter zu Hilfenahme von "Schablonen"-HTM-Datein).
		Die unter erwähnten compilierten HTM-Datein für die entsprechenden Knoten. Wie gesagt: diese Datein sollten nicht nachbearbeitet werden, den beim nächsten Übersetzten sind diese Änderungen futsch (oder was auch immer). Immer die Quell-Datein editieren.

Die Datein aus dem "compiled"-Verzeichnis müssen dann nur noch in ein entsprechendes Verzeichnis kopiert werden und das Verzeichnis Data (enthält Buttongrafiken und Hilfs-Datein) muß neben dieses Verzeichnis kopiert werden. Fertig.

Ganz so einfach, wie im vorangegangenen Kapitel beschrieben, ist die Sache natürlich nicht, wenn Aufgaben eingebunden werden. Es gibt dann logischer Weise mehr Quell- und Ergebnis-Datein, und beim Zusammenstellen der der Datein zum funktionierenden System muß man etwas mehr aufpassen. Es muß dabei insbesondere eine feste Verzeichnisstruktur beachtet werden.

Die Quelldatein befinden sich alle innerhalb eines Hauptverzeichnises

, welches im folgenden auch mit Kapitelverzeichnis bezeichnet wird. Dieses enthält die Unterverzeichnisse "aufgaben"

, "info"

und weitere beliebige Verzeichnisse

mit Hilfsdatein für die Wissenseiten

(z.B. für Grafiken, Java-code, usw. ...).
Das Kapitel-Verzeichnis

muß eine WS-Datei

enthalten, in der die Wissens-Struktur angegeben ist. Ihr Name wird übrigens auch für einige Ergebnis-Datein verwendet. Außerdem muß das Kapitel-Verzeichnis

für jeden Knoten eine HTM-Datei

enthalten, die das entsprechende Wissen präsentiert (die Namen müssen den ID's in der WS-Datei

entsprechen).
Das Aufgaben-Verzeichnis

enthält für alle Knoten, an denen Aufgaben eingebunden werden sollen, eine EX-Datei

, die angibt, welche Aufgaben, mit wieviel Punkten usw. eingehen sollen. Die Namen dieser Datein müssen wieder den ID's der Knoten entsprechen. Die Aufgaben-HTM's

müssen mit ef2htm aus aus EF-Datein erzeugt werden (mit Schalteroption -t) und sollten sich möglichst auch in diesem Verzeichnis befinden.
Das Info-Verzeichnis

enthält alle Info-Datein

, die später als kleines Pop-Up-Fenster erscheinen sollen (Zusatzwissen, Biografien, usw.). Sie müssen in den Wissensseiten

als lokale Links eingebunden werden (diese beginnen dann mit "info/...").

Bis auf die Anbindung der Aufgaben müssen die Wissensseiten in dieser Konfiguration bereits "funktionieren", d.h. Links auf Grafiken, Java, Info-Seiten, Links untereinander usw. müssen dieser Verzeichnisstruktur entsprechen. Man kann sich daher schon durch die Quell-Datein klicken, und schauen, ob alle Links OK sind.

Die Ergebnisdatein werden im Verzeichnis "compiled" im Kapitel-Verzeichnis abgelegt (gegebenenfalls wird dieses automatisch erzeugt).
Direkt im Compiled-Verzeichnis

befinden sich die automatisch erzeugten Grafiken

der Diagramme, die Startseite

, die HTM-Datein

mit dem Javascriptcode (2 Varianten, jeweils für Netscape und MS IExplorer) und zu jedem Knoten eine HTM-Datein

, die das Wissen präsentiert (dabei handelt es sich um "angereicherte" Versionen der Quell-Datein.
Im Info-Verzeichnis

werden "compilierte" Versionen der Info-Datein

abgelegt.

Damit das ganze auch funktioniert, müssen die Datein noch speziell zusammengestellt werden.
In ein Haupt-Verzeichnis (Tee) muß das Data-Verzeichnis von Tee (enhält Standard-Seiten, Buttons, "Knödel" usw.) kopiert werden und es muß wieder ein Kapitelverzeichnis (ELehre) angelegt werden (der Name ist aber egal). In dieses Verzeichniss sind die Verzeichnisse mit den Hilfsdatein zu kopieren (===>), die Datein des Compiled-Verzeichnis, kommen direkt in das Kapitelverzeichnis (===>), die des compilierten Info-Verzeichnisses als Info-Verzeichnis ebenfalls ins Kapitel-Verzeichnis (===>).
Die Startseiten für das Kapitel, sind die HTM-Datein mit die Namen der WS-Datei (im Beispiel also ELehre.htm).
Es ist auch möglich mehrere Kapitelverzeichnisse im Hauptverzeichnis anzulegen. Diese zu vernetzen und verlinken ist sicher Teil der nächsen Version von Tee ...

Zugang zum TEE für die ELehre.(Physikstoff Elektrizitätslehre) (Autor: Ulrike Schurig)
Ich hab auch mal die Daten der Listen des Operanten Konditionierens für TEE (Autor: Grit Reiman, verschiedene) übersetzt (Vorsicht: Nicht über das Diagramm erschrecken. Es ist nur ein völlig unbearbeitetes Demo-Provisorium.)