meta data for this page
  •  

This is an old revision of the document!


Hilfeseite für Autoren

Dokuwiki - was ist anders, was ist zu beachten

Gegenüber der bisherigen Plattform auf Wikidot.com nutzt der neue NIR die Plattform DokuWiki. Diese unterscheidet sich auch abseits der technischen Aspekte von der Insellösung Wikidot.com.

Aussehen

Wir ihr auf Anhieb seht hat der neue IIR ein ganz anderes Design, aber auch komplett neue Funktionen.

Links ist (je nach Bildschirmauflösung ein- oder augegklappt) eine Navigation zu finden (der sog. Sidebar), diese ermöglicht ein zielgenaues Ansteuern der Unterkapitel. Darunter findet ihr unter dem Punkt Site Tools auch weitere Möglichkeiten das Wiki zu navigieren bzw. die letzten Änderungen anzusehen.

Ein- und Ausloggen ist wie bisher oben rechts zu finden (aber auch im Sidebar links unter User Tools), wenn ihr eingeloggt seid seht ihr dort auch euren Benutzernamen und die Einstellungen.

Aber auch die einzelnen Seiten sehen etwas anders aus als im alten Wiki. Alle Seiten mit Überschriften generieren (so man es nicht ausschaltet) ein Inhaltsverzeichnis, dieses ist oben rechts unter Table of Contents per Mausklick aufklappbar. Über der Seite seht ihr neben dem kleinen Haus auch die Position der Seite in der Struktur des Wiki (dem sog. Namespace).

Rechts neben der Seite befindet sich eine Spalte mit Optionen, dort findet ihr alle Funktionen zur gesamten Seite (bearbeiten, exportieren usw.). Wer genau hin guckt erkennt auch nach jedem durch Überschriften definierte Abschnitt einen kleinen Stift rechts, damit kann ein einzelner Abschnitt bearbeitet werden, der Rest bleibt dann unangetastet. An Tabellen seht ihr auch eine kleine Fahne unten mit der Funktion EDIT, damit könnt ihr Tabellen in einem separaten Editor bearbeiten.

Syntax

DokuWiki hat eine etwas andere Art Text während der Bearbeitung zu formatieren. Dazu gibt es eine allgemeine Hilfeseite direkt im Wiki: Syntax. Für besondere Formatierungen gibt es Befehls-Erweiterungen, die wichtigsten findet ihr auch in der Syntax-Hilfeseite am Ende unter Syntax Plugins, die Links dort führen auf die externen Hilfeseiten zu den Funktionen.

Erweiterungen deren Syntax ggf. für euch interessant sind:

  • Include - damit kann man die Seiten oder teile von Seiten in andere Seite einbinden, z.B. sinnvoll wenn man Elemente öfter als einmal verwenden möchte
  • Gallery - damit kann man Grafiken in einer kleinen Galerie zusammenfassen statt sie direkt einzubetten
  • Hidden - damit lassen sich einzelne Elemente ausklappbar gestalten (z.B. Legenden)
  • Wrap - Wem die vorgegebenen Layout-Funktionen nicht ausreichen der findet mit Wrap einen Baukasten der Größe eines Baumarktes.
  • Math - wie der Name sagt kann man hier mathematische Gleichungen erstellen, das ist nicht unbedingt einfach aber sehr elegant.

Namespaces - Struktur des WIKI

Im Gegensatz zu Wikidot nutzt dieses Wiki einen Namespace, ein Art Ordnerstruktur in der die einzelnen Inhalte (Seiten, Medien) hirarchisch abgelegt sind. Diese Struktur bildet sich teilwise selbstständig wenn ihr z.B. neue Seiten anlegt, aber sie wird auch generiert wenn man beim Setzen von internen Links die Struktur angibt. Gebt ihr bei einem internen Link keine extra Struktur an so verbleibt ihr in der Struktur der Seite von der ihr aus verlinkt.

Dies seht ihr z.B. auf der Seite Sidebar, dort habe ich die Ebenen bereits im Link vorgeplant, sobald die Seite Start erstellt wird bildet sich die Struktur General > Key Categories :

 [[General:Key Categories:Start | 1.5 Key Categories]]

Inhalte & Strukturen lassen sich auch nachträglich mit dem Werkzeug Move in der Struktur verscheiben. Bitte meldet euch falls dies notwendig wird

Komfort-Funktionen

Wie schon angesprochen bietet die Plattform DokuWiki eine etwas komfortablere Arbeitsumgebung als Wikidot. Hier noch mal zusammengefasst:

  • Bearbeiten einzelner Abschnitte einer Seite (kleiner Stift recht nach einem durch eine Überschrift definierten Abschnitt).
  • Viel einfacheres Bearbeiten von Tabellen im Tabellen-Editor, inkl. Copy & Paste der Daten aus Excel-, Word- oder HTML-Tabellen.
  • Komfortables Einfügen von internen Links mit Hilfe eines Auswahl-Assistenten (via Linksymbol ∞ in der Menüzeile über dem Editor-Fenster).
  • Die Hierarchische Struktur des Wiki erübrigt das manuelle Benennen von übergeordneten Seiten (breadcrumbs).
  • Anständiger Medienmanager (links in der Navigation unter Site Tools > media Manager) der alle Medien des ganzen Wiki zentral & hierarchisch aufführt. Diese sind dort dann auch einfach austauschbar.

Migration von Wikidot.com

Da die Syntax der beiden Wikisysteme sehr unterschiedlich ist bringt es wenig den Quelltext der alten Wikiseite in das neue System zu kopieren. daher hier ein Vorgehen wie ich es bereits erprobt habe.

Texte

Einfacher ist es den Inhalt der HTML-Seite per Copy & Paste als reinen Text in die leere Seite im neuen Wiki zu kopieren und die Formatierungen (Überschriften, Aufzählungen etc.) händisch nach zu pflegen.

Medien

Viele Medien werden jedes Jahr aktualisiert, für diese braucht ja keine Migration stattzufinden, es reicht die aktualisierte Datei ins neue Wiki hochzuladen. Für zu migrierende Medien sind diese im alten Wiki herunterzuladen und dann bei der Bearbeitung über das Menü (Bilderrahmen - Add images and other files) im Medienmanager hochzuladen.

Tabellen

Hier hat sich bei mir bewährt eine leere Tabelle über das Menü anzulegen, die notwendige Anzahl Zeilen & Spalten einzufügen, ggf. zusammengefasste Zellen anzulegen so dass ein Copy & Paste-Vorgang aus Excel-, Word- oder HTML-Tabellen einfach möglich ist. Das erfordert ggf. beim ersten mal etwas Übung, die Aktualisierung später ist dann aber komfortabel möglich.

Im Zweifel gerne nachfragen, geben gerne Hilfestellung.

Erstellung neuer Inhalte

Neue Seiten, Bilder oder Tabellen lassen sich dank Komfort-Funktionen recht einfach erstellen.

Neue Seiten

Neue Tabellen

Neue Medien

Bearbeitung von Inhalten