DokuWiki: Artikel erstellen

Die wichtigste Funktion des DokuWikis ist das Bereitstellen von Informationen in Artikeln. Das Erstellen eines neuen Artikels im DokuWiki funktioniert im Detail wie folgt:

Seite anlegen

Als Erstes muss ein Link zur geplanten Seite angelegt werden.

Dies erfolgt auf der Ausgangsseite, von welcher die neue Seite später direkt aufrufbar sein soll. Ist die direkte Aufrufbarkeit durch einen festen Link nicht erwünscht und wird stattdessen - wie etwa auf der Hauptseite zur Dokumentation oder bei den FAQ - mit Tags gearbeitet, dann kann der Link auf dieser extra dafür angelegten Seite erstellt werden. Eine weitere Zugriffsmöglichkeit auf die neu erstellte Seite bietet außerdem das Übersichtsmenü.

Zunächst ist also die entsprechende Ausgangsseite zu öffnen. Diese muss nun bearbeitet werden, indem entweder auf eine der Schaltflächen „Bearbeiten “ auf der Seite geklickt wird, um ein einzelnes, durch Überschriften abgetrenntes Kapitel zu bearbeiten oder indem im Drop-down-Menü die Option „Diese Seite bearbeiten “ ausgewählt wird um die gesamte Seite bearbeiten zu können.

Es öffnet sich daraufhin der Editor und der neue Link kann erstellt werden.

Dazu muss entweder ein vorhandener Link kopiert und die Adresse angepasst oder ein neuer Link erstellt werden. Zum Erstellen eines neuen Links muss als Erstes der Ausgangstext markiert und dann durch einen Klick auf die entsprechende Schaltfläche des Editors der Rumpf der neuen Verlinkung erstellt wird.

Im so erzeugten Rumpf der Verlinkung muss nun als Zieladresse des Links der Speicherort der geplanten Seite angegeben werden.

Neue Artikel sollten zuerst in dem eigens dafür vorgesehenen, nicht öffentlich einsehbaren Namensraum lernstatt-todo angelegt und erst später für die Benutzer des DokuWikis freigegeben werden. Dazu muss - wie unten gezeigt - im Fenster einfach die Bezeichnung des Namensraums gefolgt von einem Doppelpunkt und dann dem Namen der neu zu erzeugenden Seite eingegeben werden. Alternativ kann, falls gewünscht, mit der Schaltfläche „Server durchsuchen“ auch eine bereits vorhandene Seite als Ziel der Verlinkung ausgewählt werden. Bestätigt wird die Auswahl anschließend mit einem Klick auf die Schaltfläche „OK“.

Der gerade erstellte Link zum neuen Artikel ist nun auf der Ausgangsseite zu sehen. Die rötliche Färbung des Links symbolisiert, dass bisher keine Seite unter der angegebenen Adresse angelegt ist. Um diese neue Seite anzulegen muss der gerade erstellte Link angeklickt und dann durch einen Klick auf die Schaltfläche „Seite anlegen“ im Drop-down-Menü erneut der Editor geöffnet werden.

Ist der Editor geöffnet kann nun der eigentliche Inhalt des neuen Artikels erstellt und der Artikel danach gespeichert werden.

Inhalte erstellen und bearbeiten im Editor

Im Editor des DokuWikis können einfach Inhalte für neue Artikel erstellen oder vorhandene Inhalte bearbeitet werden. Es besteht die Möglichkeit, den speziellen, etwas vereinfachten Editor des ckgedit-Plug-ins oder den originären DokuWiki Editor zu benutzen.

Für die erste Variante gibt es im Folgenden eine kleine Einführung in die grundlegende Bedienung des Editors. Im Falle der zweiten Möglichkeit müssen stattdessen sämtliche Aktionen wie Layout- und Format-Angaben oder das Einfügen von Mediendateien wie Bildern und Dokumenten in der offiziellen DokuWiki-Syntax vorgenommen werden.

Die verschiedenen Bereiche des Editors enthalten Schaltflächen, mit denen einfach vielfältige Inhalte für einen DokuWiki-Artikel erstellt und gestaltet werden können. Die Bereiche bieten dabei unter anderem folgende Funktionalitäten:

  • a) Layout-Bereich zum Beispiel für fette, kursive oder hochgestellte Schrift
  • b) Auswahloptionen wie Suchen und Ersetzen
  • c) Einfügen von Objekten wie Bilder, Tabellen oder Sonderzeichen
  • d) Einfügen und Entfernen von Links zu internen DokuWiki-Seiten, externen Webseiten, E-Mail-Adressen oder Medieninhalten wie Bildern oder PDF-Dokumenten
  • e) Änderungen zum Beispiel des Formats, der Schriftart oder der Schriftfarbe
  • f) Erstellen von Listen und Einzügen
  • g) Weitere Operationen auf dem Text
  • h) Anzeigen des HTML-Quelltextes des Artikels
  • i) Button-Leiste unter anderem zum Speichern und Löschen des Artikels, zum Umstellen des Editors zwischen dem ckgedit Editor und dem original DokuWiki Editor oder zum Erstellen einer vorläufigen Sicherung der aktuellen Seite
  • j) Textfeld zum Einfügen einer Bearbeitungsnotiz um später Veränderungen besser nachvollziehen zu können

Seite speichern

Sobald alle gewünschten Inhalte für die neue Seite erstellt wurden muss der Artikel durch einen Klick auf die Schaltfläche „Speichern“ gesichert werden.

Vor dem Speichern sollten noch später eventuell benötigte Tags wie dokumentation oder faq korrekt gesetzt werden.

Die Seite ist nun erfolgreich angelegt und jederzeit für weitere Bearbeitungen aufrufbar.

Artikel freigeben

Ist ein Artikel inhaltlich finalisiert und abschließend überarbeitet kann er vom nicht öffentlichen Bereich lernstatt-todo in den öffentlichen Bereich lernstatt verschoben und somit freigegeben werden. Ist dies geschehen kann der Artikel standardmäßig von jedem Benutzer, der die entsprechende URL kennt, angesehen werden. Es sollte also vorher die Fehlerfreiheit sowie das Vorhandensein der Veröffentlichungsgenehmigungen etwaiger verwendeter Bilder und Dokumente sichergestellt worden sein!