Hilfeseite für Autoren

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.

Zugangsdaten sollten alle bekommen haben, wenn nicht einfach fragen. Bitte ändert das Passwort so schnell wie möglich.

Da das System keine Mails verschicken kann experimentiere ich gerade mit einem Plugin dass für beliebige Namespace-Ebenen und Nutzer die letzten Änderungen zeigt.

Changes for all NFR-Codes (under construction)

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.

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.

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]]

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.

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.

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.

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.

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.

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

Wie auch im alten Wiki ist die Erstellung neuer Seiten am einfachsten wenn auf einer Seite (in gleicher Hierarchiestufe) ein interner Link auf die zu erstellende Seite gesetzt wird. Diesen roten Link klickt man an und kann gleich loslegen. Dabei ist es sinnvoll die neuen Seiten so zu benennen dass sie sich in die vorgegebene Struktur (siehe Ebenen im Sidebar) einpasst.

Im Editor fügt man eine neue Tabelle über das Symbol Insert a new table ein. Dann erscheint der Tabellen-Editor in dem ihr einige Formatierungsoptionen im Menü und eine Reihe von weiteren Funktionen wie das Einfügen oder Löschen von Zellen im Kontextmenü (per Rechtsklick auf zellen) habt. Eine wichtige Funktion ist die oberste im Kontextmenü: H Toggle Header State die einstellt ob die ausgewählten Zellen Kopfzeile sind (fett und leicht grau hinterlegt). Damit markiert ihr bitte die Zeilen (bzw. Spalten) die die Datenkategorien & Einheiten enthalten.

Neue Medien könnt ihr im Editor-Menü mit Klick auf das entsprechende Symbol (grünes Bild mit braunem Bilderrahmen) hochladen oder auswählen. Das erscheinende Fenster ist der Mediamamanger, dort könnt ihr auswählen wo die Datei stehen soll (im Zweifel nichts ändern, voreingestellt ist dies immer die Hierarchieebene der bearbeiteten Seite), Optionen zum hochladen und im Anschluss umbenennen der Datei wenn nötig.

Für Quellen bietet das Wiki eine ähnliche Herangehensweise wie bisher: Die Erweiterung RefNotes bietet die Möglichkeit die Quellen einfach mit entsprechender Syntax im Text zu benennen, jeder Eintrag wird dann eine Fußnote die unter dem Text steht und auch erscheint wenn man über der Fußnote mit der Maus verweilt. Dies ist ein gutes Vorgehen wenn man wenig Quellen zitiert und diese auch nicht mehrfach zitiert werden.

Mehr Optionen findet ihr auf der Hilfeseite zur RefNotes-Syntax.

Eine einfache Aufwertung bieten z.B. Named Notes, d.h. man gibt jedem Zitat einen Namen und kann die Einträge dann mehrfach zitieren.

Die Bearbeitung funktioniert prinzipiell wie die Neuerstellung. Seiten könnt ihr wie gesagt abschnittsweise bearbeiten, dies erhöht v.a. auf langen Seiten die Übersicht. Tabellen könnt ihr aus der normalen Ansicht über das Fähnchen EDIT direkt bearbeiten. Medien lassen sich auch komfortabel über den Medienmanager bearbeiten, diesen findet ihr wie gesagt im Sidebar unter Site Tools.

Änderungen in der Namespace-Struktur der angelegten Inhalte können nur Admins vornehmen, dafür gibt es ein Werkzeug welches auch die Links zwischen den Inhalten korrigiert.