Anleitung zur Erstellung einer interaktiven Wikiseite

Herzlich Willkommen,

in dieser Anleitung möchten wir Ihnen die grundlegenden Funktionen von Programming-Wiki erklären.

Programming Wiki

Erstellen einer interaktiven Wikiseite

Das Programming-Wiki bietet eine Reihe von speziellen Sprachelementen, um interaktive Programmelemente in eine normale Wikiseite einzubauen. Hierfür wird in der Editieransicht der Seite eine zusätzliche Toolbar angezeigt:

Als wichtigste Funktion dient diese Toolbar zur Auswahl der Programmiersprache, in der Programmelemente innerhalb dieser Wikiseite verarbeitet werden sollen. Die Programmiersprache wird global für die ganze Seite bestimmt (es ist also nicht möglich sowohl Java als auch Pascal Programme in der gleichen Seite zu verwenden). Wenn Sie in der aktuellen Seite hingegen keine interaktiven Elemente verwenden, wählen Sie das leere Element in der Sprachliste aus. Die weiteren Schaltflächen dieser Toolbar dienen vorallem der einfacheren Bedienung und erstellen an der aktuellen Cursorposition die von Programming-Wiki unterstützten Spezialtags.

Programming-Wiki Sprachelemente

Eval Element

Dieses Element erstellt eine Codebox und eine Ausführen Schaltfläche.

Sie können Vorgabeprogrammtexte hinterlegen

 <eval> System.out.println("Hallo Welt"); </eval>

Code Element

Erstellt eine Codebox. Diese kann selbst nicht ausgeführt werden. Bei jedem Eval-Element wird aber der Quelltext alle Codeboxen bei jeder Ausführung vorangestellt. Ein Schreibfehler in einer Codebox am Ende der Seite wirkt sich also auch auf ein Eval Element am Anfang der Seite aus! Weitere Informationen finden Sie in der Beschreibung zur Ausführungsreihenfolge.

Besonders hilfreich sind versteckte Codeboxen, die dem Betrachter der Wikiseite nicht angezeigt werden, jedoch bei einer Evalbox mit ausgeführt werden. Um eine Codebox zu verstecken, geben Sie das Attribut hidden oder versteckt mit an.

 <code> function add(a,b) { return a+b} </code>
 <code hidden> ... </code><code versteckt> ... </code>

Check Element

Erstellt eine Prüfschaltfläche und ist für einfache Kontrollzwecke gedacht.

Es muss eine Prüffunktion angegeben werden, die einen Wahrheitswert zurückliefert. Diese ist abhängig von der verwendeten Programmiersprache.

Es wir beim Klick auf die Prüfschaltfläche der gesamte Quellcode, der in allen Codeboxen definiert wurde ausgeführt.

 <check> return fibonacci(11)==89 && fibonacci(12)==144; </check>

Canvas Element

Erstellt eine Zeichenfläche für verschiedene Zeichenfunktionen und Turtlegrafiken.

Alle Canvas Elemente einer Seite werden nummeriert. Das erste Element wird etwa in Java über canvas oder canvas1 angesprochen. Das zweite Element mit canvas2 usw.

Über die Parameter lässt sich die Dimension der Zeichenfläche bestimmen.

 <canvas></canvas> 
 <canvas width=500 hight=300></canvas> 
 <canvas w=500 h=300></canvas> 

Element IDs

Programming-Wiki speichert die Eingaben von angemeldeten Benutzern in Code- und Evalboxen in einer Datenbank ab. Damit können Benutzer ihren Arbeitsplatz wechseln und sofort wieder auf ihren aktuellen Arbeitsstand zurückgreifen ohne Dateien auf einen anderen Rechner überspielen zu müssen. Der Inhalt einer Code-/Evalbox wird bei jedem Ausführen gespeichert und beim erneuten Betrachten der Wikiseite wieder geladen.

Achtung: Es wird immer nur die aktuelle Version gespeichert. Ein "Undo" gibt es derzeit nicht.

Jedes Code/Eval Element bekommt im Wiki eine ID. Beim Copy&Paste verwenden Sie deshalb nicht die gleiche ID, löschen Sie diese einfach. Das Wiki wird beim Speichern jedem Element automatisch eine ID zuordnen. Es ist auch möglich eine ID selbst festzulegen wie ID="CodeFib". Das ist besonders dann sinnvoll, wenn man dieses Element auf einer anderen Wikiseite referenzieren möchte.

Einsatzszenarien

Es gibt allgemein zwei Szenarien zum Einsatz von diesem Wiki:

1. Die Schülerinnen und Schüler erstellen selbst Wikiseiten und schreiben ihre Quelltexte in den Wikicode der Seite.
2. Die Schülerinnen und Schüler bearbeiten nur die vorgegebenen interaktiven Wikiseiten ohne den Wikicode zu bearbeiten.

Lehreransicht

Wenn Sie das Szenario 2 verwenden wollen, bietet das Wiki eine zusätzliche Lehreransicht. Mit dieser können Sie die Ergebnisse Ihrer Schülerinnen und Schülern anschauen, kommentieren und/oder verbessern. Als Lehrer haben Sie am Beginn jeder Seite einen speziellen Bereich wie hier gezeigt:

Sie sind eine Lehrperson und wollen diese Funktionalität nutzen? Nennen Sie uns einfach Ihren Benutzernamen hier im Wiki per Email.

Zusätzliche Funktionen

Hier folgen einige Beispiele zu Funktionen innerhalb dieses Wikis, die nicht zu einer Standardinstallation eines Mediawikis gehören.

• Videos einbinden
• Bildschirmvideos erstellen
• Gnuplot
• Pinwand

Über den Befehl:

<popup name="Beispiel">
  Text der aufgeklappt und zugeklappt werden kann. 
 </popup>

können Elemente erst bei Bedarf vom Leser angezeigt werden. Dies ermöglicht es etwa längere Quelltexte auszublenden, da diese den Lesefluss behindern können. Der Text kann auch Bilder und Tabellen enthalten. Könnte interessant für die Lösung von Aufgaben sein. Es folgt ein Beispiel

der ausgeklappt werden kann.