====== Integration der Online-IDE in eigene Webseiten =====
===== A. Mittels iframe-Tag =====
Die Integration mittels ''iframe''-Tag ist sehr einfach. Alle Dateien, die Sie dazu auf Ihrem Server hosten müssen, [[https://www.embed.learnj.de/createwrapper.html|finden Sie hier zum Download]].
- Laden Sie die Dateien auf Ihren Server in ein Verzeichnis ''include'' hoch, das dann z.B. unter https://www.meineseite.de/include erreichbar ist.
- Das ''iframe''-Tag zum Einfügen auf Ihrer Seite können Sie einfach mit dem [[https://www.embed.learnj.de/createwrapper.html|Wrapper-Generator von Christoph Gräßl]] erstellen.
- Ersetzen Sie die Adresse ''https://embed.learnj.de'' im generierten Tag durch die Adresse Ihres Servers, z.B. ''https://www.meineseite.de''.
Wenn das ''iframe''-Tag auf einer anderen Domain integriert wird als der, auf der die include-Dateien liegen (z.B. in einem Mebis-Kurs) wird i.d.R. das Laden der eingebundenen Schriftarten vom Server, auf dem die include-Dateien liegen, blockiert. Das beeinträchtigt die IDE kaum. Falls Sie eine perfekte Lösung anstreben können Sie das Nachladen der Schriften erlauben, indem Sie Ihren Server so konfigurieren, dass er einen entsprechenden Access-Control-Origin-Header liefert. Im Falle eines Apache-Webservers lautet die entsprechende Konfigurationszeile für ''iframe''-Tags in Mebis beispielsweise:
Header Set Access-Control-Allow-Origin "https://lernplattform.mebis.bayern.de"
===== B. Ohne iframe-Tag =====
Sie finden alle benötigten Dateien im [[https://github.com/martin-pabst/Online-IDE|Github-Repository]].
Im ''''-Element der HTML-Seite werden die Online-IDE sowie die von ihr benutzten Bibliotheken mittels ''
Die Datei ''Spritelibrary.js'' im Git-Repository etwas versteckt. Sie finden sie unter ''src/client/runtimelibrary/graphics/Spritelibrary.js''.
Nach dem vollständigen Aufbau der Seite sucht die Online-IDE alle DIV-Tags mit der Klasse "java-online" und baut sie zu Online-IDEs um. Beispiel:
===== Bedeutung der Konfigurationsparameter =====
Das ''div''-Element, das zur Online-IDE umgebaut werden soll, kann durch durch ein Attribut ''data-java-online'' konfiguriert werden. Die darin enthaltenen Einstellungen bedeuten:
^Einstellung mit Beispielwert^Bedeutung^
|'id': 'Beispiel_1'|Eindeutige id innerhalb der Seite. Sie wird benutzt, um Änderungen des Schülers am Quelltext in der Datenbank des Browsers zu speichern, so dass sie beim nächsten Seitenaufruf am selben Browser wieder vorhanden sind.|
|'withBottomPanel': true |Blendet den Fensterteil unterhalb des Programmtextes ein/aus |
|'withFileList': true|Falls ''withBottomPanel'' den Wert true hat, kann hiermit die Dateiliste (linker Teil des bottom panels) ein- oder ausgeblendet werden.|
|'withPCode': true|Falls ''withBottomPanel'' den Wert true hat, kann hiermit das PCode-Panel ein- oder ausgeblendet werden.|
|'withConsole': true|Falls ''withBottomPanel'' den Wert true hat, kann hiermit das Console-Panel ein- oder ausgeblendet werden.|
|'withErrorList': true|Falls ''withBottomPanel'' den Wert true hat, kann hiermit das Fehler-Panel ein- oder ausgeblendet werden.|
|'speed': 2000 | Ausführungsgeschwindigkeit des Programms in Steps/s. Als Wert kann auch 'max' angegeben werden. |
===== Einfachste Variante: =====
===== Einbinden eines eigenen Spritesheets: =====
====== Offline-Version ======
Die Embedded-Version kann auch offline aus dem Dateisystem heraus betrieben werden, wenn ein kleiner Webserver mitgeliefert wird. Hier ein Beispielarchiv mit Startdateien für Windows und Mac OS X:
{{ :onlineide:integration:offlinetest.zip |}} (Version vom 20.09.2022) \\ \\
[[.offline:opensource:start|Von der Offline-Version verwendete Software]]