dokumentation:dokuwiki:dokuwiki_artikel_erstellen [Lernstatt Dokumentation]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== DokuWiki: Artikel erstellen ======

{{tag>[faq]}}

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 [[:lernstatt:dokumentation:index#artikel|Dokumentation]] oder bei den [[:lernstatt:faq|FAQ]] - mit [[dokumentation:dokuwiki:dokuwiki_tags|Tags]] gearbeitet, dann kann der Link auf [[dokumentation:dokuwiki:index_doku|dieser]] extra dafür angelegten Seite erstellt werden. Eine weitere Zugriffsmöglichkeit auf die neu erstellte Seite bietet außerdem das [[dokumentation:dokuwiki:dokuwiki_namespaces#betrachten_von_seiten_und_namensraeumen|Übersichtsmenü]].

Zunächst ist also die entsprechende Ausgangsseite zu öffnen. Diese muss nun bearbeitet werden, indem entweder auf eine der Schaltflächen "{{:lernstatt:dokumentation:dokuwiki:img:button_bearbeiten.png?linkonly|Bearbeiten}} " auf der Seite geklickt wird, um ein einzelnes, durch Überschriften abgetrenntes Kapitel zu bearbeiten oder indem im Drop-down-Menü die Option "{{:lernstatt:dokumentation:dokuwiki:img:button_seite_bearbeiten.png?linkonly|Diese Seite bearbeiten}} " ausgewählt wird um die gesamte Seite bearbeiten zu können.

Es öffnet sich daraufhin der [[dokumentation:dokuwiki:dokuwiki_artikel_erstellen#inhalte_erstellen_und_bearbeiten_im_editor|Editor]] und der neue Link kann erstellt werden.

Dazu muss entweder ein vorhandener Link kopiert und die [[dokumentation:dokuwiki:dokuwiki_namespaces#aufbau_von_namensraeumen_und_adressen|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.

{{:lernstatt:dokumentation:dokuwiki:img:button_link.png}}

Im so erzeugten Rumpf der Verlinkung muss nun als [[dokumentation:dokuwiki:dokuwiki_namespaces#aufbau_von_namensraeumen_und_adressen|Zieladresse]] des Links der Speicherort der geplanten Seite angegeben werden.

Neue Artikel sollten zuerst in dem eigens dafür vorgesehenen, nicht öffentlich einsehbaren [[dokumentation:dokuwiki:dokuwiki_namespaces|Namensraum]] //lernstatt-todo// angelegt und erst später für die Benutzer des DokuWikis [[dokumentation:dokuwiki:dokuwiki_artikel_erstellen#artikel_freigeben|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".

{{:lernstatt:dokumentation:dokuwiki:img:neue_seite_linkadresse.png}}

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.

{{:lernstatt:dokumentation:dokuwiki:img:button_seite_anlegen.png}}

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 {{:lernstatt:dokumentation:dokuwiki:img:editor_blank.png?linkonly|Editor des ckgedit-Plug-ins}} oder den {{:lernstatt:dokumentation:dokuwiki:img:editor_dw_blank.png?linkonly|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 [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_verlinken|Einfügen von Mediendateien wie Bildern und Dokumenten]] in der [[https://www.dokuwiki.org/wiki:syntax|offiziellen DokuWiki-Syntax]] vorgenommen werden.

{{:lernstatt:dokumentation:dokuwiki:img:editor_blank_description.png}}

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 [[dokumentation:dokuwiki:dokuwiki_tags|Tags]] wie [[dokumentation:dokuwiki:dokuwiki_tags#beispiele_fuer_den_einsatz_von_tags|dokumentation]] oder [[dokumentation:dokuwiki:dokuwiki_tags#beispiele_fuer_den_einsatz_von_tags|faq]] korrekt gesetzt werden.

{{:lernstatt:dokumentation:dokuwiki:img:seite_speichern.png}}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 [[dokumentation:dokuwiki:dokuwiki_artikel_freigeben|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!