DragMath equation editor

Einführung

Um das W3C zu zitieren [1]:

Dies ist ein open-source drag and drop Editor für  mathematische Gleichungen der in Java geschrieben ist.
Sobald ein Ausdruck erstellt wurde, kann der/die Nutzer/in ihn konvertieren in verschiedene mathematisch
lineare Syntax, einschließlich MathMl, LaTeX, Maple, Maxima oder andere Nutzer/innen definierte Stile.

Entwickelt von Christoper Sangwin und Alexander Billingsley an der Universität von Birmingham als Teil von STACK project, erlaubt DragMath Student/innen mathematische Ausdrücke mit Hilfe einer graphischen drag und drop Schnittstelle zu erstellen, die in ihrem Aussehen denen ähnelt, die man in einer Anzahl von Office Produkten findet.

Ursprünglich in Moodle integriert um mit dem Moodle Tex Filter genutzt zu werden, bietet die Exportfunktion die durch DragMath zur Verfügung steht nun die Möglichkeit einer Integration, die die Erstellung von LaTex Text Ausdrücken ermöglicht, mit oder ohne doppelte Dollarzeichen für ein 'signal parsing' durch den Filter genauso wie AsciiMathMl Text Ausdrücke.

Um DragMath zu nutzen müssen Nutzer/innen auf ihren Desktop Computern die Java Laufzeit Umgebung (JRE) in der Version 1.5 oder höher installiert haben. Auf den meisten Systemen ist JRE in der Standardinstallation integriert, so dass sie eventuell nichts tun müssen. Wenn Sie JRE manuell installieren müssen, können Sie es von hier herunterladen. Beachten Sie dass die JRE gemeinhin als Java Software für Ihren Computer, Java Runtime Environment, the Java Runtime, Runtime Environment, Runtime, Java Virtual Machine, Virtual Machine, Java VM, JVM, VM, or Java download, bezeichnet wird.

Sie können eine Demoversion vom DragMath Editor hier anseghen. Die DragMath Schnittstelle ist sehr intuitiv und jede/r kann Sie nach wenigen Minuten von Versuch und Irrtum nutzen. Wenn Sie Fragen zum Editor haben gibt es hier eine kleine Bedienungsanleitung.

Wie der DragMath Editor in Moodle integriert wurde

DragMath ist in Moodle durch einen neuen Button in der Werkzeugleiste des Html-Editors integriert. Auf diesem Wege ist er überall verfügbar wo Ihre Student/innen dazu aufgerufen werden Text einzugeben. Bitte beachten: Der DragMath Editor wird nicht mit Moodle zusammen geliefert. Sie (oder ihr/e Administrator/in ) müssen ihn installieren. Die folgenden Kommentare beziehen sich auf die Installation mit einer Datei, die die beliebten Smileys beibehält.

Loslegen

Nehmen wir an, dass sie einen Text geschrieben haben und einen Punkt erreicht haben, wo Sie einen mathematischen Ausdruck einfügen wollen. Wenn Sie den DragMath Schalter drücken, erscheint ein kleines Popup Fenster (Bemerkung: wenn Sie dies das erste Mal tun, dann wird es einige Sekunden Verzögerung geben, da das Applet initialisiert wird).

Die mathematischen Ausdrücke in DragMath erstellen

Ziehen Sie die verschiedenen grafischen Bestandteile Ihrer Gleichung in das Bearbeitungsfeld bis die Gleichung zu Ihrer Zufriedenheit ist.

Den Ausdruck speichern

In der Menü-Leiste klicken Sie Datei->Speichern oder auf das Diskettensymbol. Geben Sie einen Ort an wo die Gleichung gespeichert werden soll und das Applet speichert die Gleichung in einer .dgrm Datei.

Das Exportformat wählen

Klicken Sie in der Menü-Leiste auf Optionen->Export Format einstellen. Wenn Sie den Text Ausdruck für eine Tex Formula eingeben wollen, wählen Sie LaTex. Wenn Sie den Textausdruck mit den doppelten Dollarzeichen eingeben wollen, so dass der Ausdruck durch den Moodle Tex Filter interpretiert wird, wählen Sie MoodleTex (dies ist wahrscheinlich die Standardeinstellung in Ihrem Applet). Wenn Sie den Tex Filter durch den ASCIIMathML Filter ersetzt haben, wählen Sie ASCIIMathML.

Einen Ausdruck einfügen

Klicken Sie auf den 'Einfügen' Button und das war es. Der Editor wird verschwinden und die Ausgabe die Sie ausgewählt haben wird eingefügt werden.Wenn Sie MoodleTex gewählt haben, wird der LaTeX Ausdruck (mit den eingefügten $$ Begrenzern an jedem Ende) in Ihren Text eingefügt an der aktuellen Position Ihres Cursors. Beachten Sie den Screenshot unten. Dies demonstriert die Ergebnisse wenn Sie MoodleTex gewählt haben um Ihre Gleichung einzufügen. Bemerkung für ASCIIMathML Nutzer/innen: die ASCIIMathML.xml Datei hat zur Zeit rückwärts geneigte Hochkommata (backtics) als Begrenzer (tokens) gesetzt. Sie können die Datei bearbeiten um die 'auto nomenclature' zu nutzen.

Parameter des Applets ändern

Das Fenster das vom dragmath plugin angezeigt wird, wird von einer Applet Referenz in einer php Datei kontrolliert, die für die htmlarea bei Moodle 1.9.x dlg_ins_dragmath.php ist. Dies ist eine der Dateien die in dieser Distribution enthalten sind und sie liegt unter moodleroot/lib/editor/htmlarea/popups . Die Applet Parameter können nach der DragMath Dokumentation in dieser Datei verändert werden. Per Voreinstellung ist die Sprache auf Englisch gesetzt und das Ausgabeformat auf MoodleTex (dies bedeutet das die Ausgabe doppelte Dollarzeichen enthalten wird. Wenn Sie Ihren Tex Filter ausgeschaltet haben und asciimath nutzen, dann werden Sie wahrscheinlich die Voreinstellung auf ASCIIMathML ändern wollen).

Als Antwort auf die Wünsche der NutzerInnen wurde die Möglichkeit hinzugefügt, den Punkt den DragMath immer bei 3x zwischen dem Koeffizienten und der Variablen eingefügt hat, wie bei 3∙x, wegzulassen. Sie werden einen Menüpunkt gleich neben den Formatierungsmöglichkeiten in der graphischen Benutzeroberfläche bei DragMath finden, um dies an- und abzuschalten. Diese Einstellung kann auch über die Applet Parameter gesetzt werden.

Sie können Formate und Sprachen hinzufügen über /lib/DragMath/Config.xml mit den verschiedenen XML Exportformaten im 'formats' Unterverzeichnis von 'applets' oder die Sprachen über die Unterverzeichnisse im 'lang' Verzeichnis. Natürlich können Sie, mit Vorsicht, die verschiedenen xml-Dateien bearbeiten.

Wenn Sie Veränderungen machen wollen dann vergessen Sie nicht vorher Ihre Original-Dateien zu sichern.

DragMath installieren

Die aktuellste Version von DragMath kann jetzt einfach installiert werden, indem man unzip nutzt. (siehe den Abschnitt genau unter diesem). Das Moodle CVS System und der Umgang mit der Datei adminlib.php haben uns dazu gebracht zu diesem neuen und einfacher zu nutzenden Paket überzugehen. Das neue Paket bietet ein einziges zip das nicht nur die zu integrierenden Dateien enthält (für die htmlarea mit den smileys) sondern auch die aktuellen DragMath Dateien. Die Datei kann auf der Stelle entpackt werden, eine willkommene Änderung zu den Schwierigkeiten mit der Installation durch das Moodle cvs System; man braucht die zip-Datei nur noch im Wurzelverzeichnis von moodle abzulegen und zu entpacken.

Diese Methode unterscheidet sich von den zwei vorangegangenen. Vermeiden sie Installationshinweise oder Dateien in Foren die vor Juli 2009 veröffentlicht wurden, diese können sich auf Dateien und Methoden beziehen, die nicht mehr länger genutzt werden. Sie können auch eine Auswahl an Entwicklungscode in den Foren finden, der sich mit der Nutzung von DragMath in verschiedenen Editoren beschäftigt. Manches kann funktionieren, anderes nicht aber nichts wird aktuell sein. Sie können alles nutzen, auf eigenes Risiko!

DragMath wird eventuell in den Kerncode von Moodle integriert. Dies bedeutet, dass ab einer bestimmten Version eine Installation nicht mehr nötig ist. Die Installationshinweise werden aber bleiben um ältere Versionen, solange wie möglich, zu unterstützen.

DragMath mit einem nicht-CVS zip installieren - Empfohlen!

Wir sind zum Ausgangspunkt zurückgekehrt und als Ergebnis des Themas eine aktuelle adminlib.php für jede Version zu pflegen genauso wie für den möglichen Umzug von DragMath der mit Moodle 2.0 stattfinden könnte , steht DragMath jetzt als zip-Datei zur Verfügung, die einfach vom Wurzelverzeichnis des Moodle-Verzeichnisses aus installiert werden kann (anders als das CVS-zip das unten beschrieben wird, ein Grund warum wir Ihnen raten nicht länger das CVS-zip zu nutzen).

Um die Sache so einfach wie möglich zu machen können die Spezifikationen zum Herunterladen der aktuellsten Version hier gefunden werden. Laden Sie einfach die zip-Datei herunter, platzieren Sie die zip-Datei in Ihrem Moodle Wurzelverzeichnis (für viele /moodle) und entpacken Sie die Datei. Die DragMath Dateien werden an den richtigen Stellen installiert. Zusätzlich werden Sie eine Datei mit dem Namen adminlib_exampleonly.php erhalten, die Sie mit Ihrer adminlib.php vergleichen können (diff) um die hinzugefügten Zeilen zu zeigen die nötig sind um das dragmath icon an- und abzuschalten. (siehe DragMath equation editor#Die Editor Icons mit adminlib.php anpassen).

Löschen Sie NICHT die zip-Datei nachdem Sie DragMath entpackt haben. Jedes Mal wenn Sie Moodle aktualisieren, werden mehrere der Dateien die für die Integration nötig sind, überschrieben. Die einfachste Lösung ist, die zip-Datei zu behalten und nach jeder Aktualisierung neu auszupacken.

Wenn Sie eine frühere Version von DragMath nutzen, wird empfohlen das Sie eine Neuinstallation machen, da es einige interne Änderungen im DragMath Verzeichnis gab und auch in den Integrationsdateien. Sobald Sie eine neue Installation mit der oben genannten zip-Datei gemacht haben werden zukünftige Versionen von DragMath in Moodle 1.9.x voraussichtlich nur noch die Ersetzung des DragMath Verzeichnisses unter /lib/DragMath mit einem neuen Verzeichnis von sourgeforce zur Folge haben (oder Sie warten, bis eine Aktualisierung auf Moodle erscheint).

Leute, die das noch unveröffentlichte Moodle 2 testen, sollten wissen, dass DragMath zur Zeit in HEAD eingebunden ist und nicht extra installiert werden muss und sollten den Abschnitt über Moodle 2 weiter unten ansehen.

DragMath mit Hilfe des Moodle CVS installieren - NICHT ZU EMPFEHLEN

Bitte beachten Sie, dass das Moodle CVS für DragMath nicht länger unterstützt wird. Die Dateien sind gleichwohl noch vorhanden und wenn Sie es drauf anlegen, dann können Sie auf sie zugreifen. Es wird empfohlen dies NICHT zu tun.

Wenn Sie die Version 1.9.+ am laufen haben hier klicken oder wenn Sie die Moodle Version 1.8.4 oder größer nutzen aber nicht 1.9.x hier klicken dann wird der Download der cvs-Datei gestartet (zur Zeit gibt es keine Unterschiede zwischen den beiden Versionen.)

At this point you can unzip on your workstation and then you can upload the included files to their appropriate locations (but read the warning below first). This version retains the smileys and includes all integration files and all DragMath files (demos, docs, and all export formats) The Moodle automagically creates the zip with a parent directory of "dragmath". Should you wish you can unzip the files and then rezip with the top level directory being /lib, and this will allow you to simply upload the zip you just created to your moodle root and unzip there, and the files will be placed in their appropriate locations. However, please DO NOT include the adminlib.php file and make sure all files are backed up, and in as much as there are only a few files you may want to manually install even if a zip with /lib as top directory were provided here just to ensure each file is backed up before installation. Upload the zip file to your Moodle root and unzip.

Warning: At present the CVS zip file includes a version of adminlib.php. This file is included because there is a line added to it that allows you to hide the dragmath icon. In any event, the included adminlib.php should NOT be used to over write your adminlib.php!

DO NOT over write your adminlib.php. Install the rest of the files (other than adminlib.php) and DragMath will work without a problem.