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 einfache Codebox. Diese kann selbst nicht ausgeführt werden. Wird eine folgende Evalbox ausgeführt, werden auch alle Codebox Elemente bis zur vorherigen Evalbox mit ausgeführt.

Besonders hilfreich sind versteckte Codeboxen, die dem Betrachter der Wikiseite nicht angezeigt werden, jedoch bei einer darauffolgenden 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> 

Speicherung von Benutzereingaben in Codeelemente

Programming-Wiki speichert die Eingaben von 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.

Wird eine Wikiseite mit Eval- und/oder Codeboxen gespeichert, werden automatisch id's eingefügt. Über diese id's kann jede Box eindeutig zugeordnet werden. Verändern Sie diese IDs deshalb nicht.