====== Einführung zur Bearbeitung des Wikis ====== Hier ist eine Sammlung der wichtigsten Mechaniken des Wikis, damit ihr so schnell wie möglich mitmachen könnt. Ein ausführliches Handbuch von DokuWiki findest du [[https://www.dokuwiki.org/de:manual|hier]]. **Allgemeines:** * Seid euch beim Bearbeiten des Wikis bewusst, dass dies ein öffentliches Wiki ist. * Wie bei jedem Wiki gibt es auch hier eine vollständige Versionsgeschichte (inklusive vom wem die Änderungen vorgenommen wurden!). Versehentliche Änderungen können also relativ einfach rückgängig gemacht werden (sidebar rechts, "Ältere Versionen"). * Seid ihr euch noch unsicher mit dem Umgang des Wikis: Nutzt vor dem endgültigem Speichern die Vorschau-Funktion. Zum allgemeinen Herumexperimentieren und bekannt werden mit dem Syntax solltet ihr den [[playground:playground|Spielplatz benutzen]]. ===== Bereits existierenden Artikel bearbeiten ===== - Geht auf die Seite die Ihr bearbeiten wollt. - Ihr könnt sowohl die vollständige Seite bearbeiten (sidebar rechts, "Diese Seite bearbeiten") als auch nur einzelne Bereiche der Seite. DokuWiki unterteilt jede Seite anhand der Überschriften in Abschnitte, am Ende jedes Abschnitts findet ihr rechts den jeweiligen "Bearbeiten"-Button. - Bearbeitet die Seite. - Zur Überprüfung, ob ihr den Syntax eingehalten habt und alles richtig angezeigt wird, könnt ihr vor dem Speichern die Vorschau-Funktion benutzen. - Hinterlasst vor dem Speichern einen kurzen Kommentar, welche Änderungen vorgenommen wurden, im zugehörigen Textfeld "Zusammenfassung" neben den "Speichern"-, "Vorschau"- und "Abbrechen"-Buttons (zB: "neu angelegt", "Daten aktualisiert", "Neues HowTo XXX ergänzt", ...). - Speichern. ===== Neuen Artikel erstellen ===== - Geht auf die Seite https://fakofu.de/doku.php?id=Name der Seite und erstellt die neue Seite (sidebar rechts "Seite anlegen"). DokuWiki wandelt Seitennamen (engl. Pagenames) automatisch in kleingeschriebene (engl. lowercase) Namen um. An Sonderzeichen sind nur ., - und _ erlaubt, alle anderen Sonderzeichen (inkl. Leerzeichen) werden zu Unterstrichen umgewandelt. Doppelpunkte : werden zum Erzeugen von [[https://www.dokuwiki.org/de:pagename|Namensräumen]] verwendet, welches beeinflusst, in welche Kategorie die neue Seite in der [[https://fakofu.de/doku.php?id=start&do=index|Übersichtsseite]] einsortiert wird (für dieses Wiki nicht relevant). - Schreibt den neuen Artikel. - Zur Überprüfung, ob ihr den Syntax eingehalten habt und alles richtig angezeigt wird, könnt ihr vor dem Speichern die Vorschau-Funktion benutzen. - Speichern. - Verlinkt den Artikel, damit ihn andere wiederfinden und er nicht nur auf der [[https://fakofu.de/doku.php?id=start&do=index|Übersichtsseite]] erscheint. Verlinkt den Artikel dabei unter der geeigneten Kategorie auf der [[start|Startseite]], im worst-case unter dem Abschnitt [[start#weitere Informationen und Links]]. Links werden in doppelten eckigen Klammern gesetzt: [[name_der_seite]] und können auch hinter Beschreibungen versteckt werden: [[name_der_seite|Beschreibung für einen Link]] . ====== Einführung in das Wiki-Syntax ====== Dies hier stellt die wichtigsten Regeln zur Textformatierung im Wiki vor, die vollständige Syntax findet ihr [[https://www.dokuwiki.org/de:wiki:syntax|hier]]. ===== Text ===== ==== Formatierungen ==== DokuWiki unterstützt //kursiven//, **fetten**, __unterstrichenen__ und ''dicktengleichen'' Text, inklusive allen möglichen **__//''Kombinition''//__**. //kursiv//, **fett**, __unterstrichen__, ''dicktengleich'', **__//''Kombinition''//__** Ebenso gibt es tiefgestellten, hochgestellten und durchgestrichenen Text. tiefgestellt, hochgestellt und durchgestrichen ==== Absätze und Zeilenumbrüche ==== Ein Absatz wird durch eine leere Zeile erzeugt. Eine neue Zeile (Zeilenumbruch) kann durch zwei "Backslashes" (umgekehrte Schrägstriche: %%\\%%) gefolgt von einem Leerzeichen erzeugt werden. Dies ist ein Beispieltext mit einigen Zeilenumbrüchen.\\ Beachte: Die zwei umgekehrten Schrägstriche werden nur erkannt, wenn sie am Zeilenende stehen\\ oder wenn ihnen ein\\ Leerzeichen folgt.\\ So\\sieht es ohne Leerzeichen aus. Dies ist ein Beispieltext mit einigen Zeilenumbrüchen.\\ Beachte: Die zwei umgekehrten Schrägstriche werden nur erkannt, wenn sie am Zeilenende stehen\\ oder wenn ihnen ein\\ Leerzeichen folgt.\\ So\\sieht es ohne Leerzeichen aus. Zeilenumbrüche durch zwei "Backslashes" (umgekehrte Schrägstriche: %%\\%%) sollten nur verwendet werden, wenn sie unbedingt notwendig sind. ==== Querlinie ==== Durch vier oder mehr Bindestriche bzw. Minuszeichen „-“ wird eine horizontale Linie erzeugt: ---- ==== Überschriften ==== Mit fünf unterschiedlichen Ebenen, getrennt durch Überschriften, kann der Inhalt einer Seite strukturiert werden. Die Überschriften werden mit maximal sechs "=" eingerahmt, je nach Größe. H1 ist die Überschrift auf höchster Ebene. Am einfachsten ist es zur Erzeugung der Überschriften, die Symbolleiste zu verwenden. Das Einfügen der Überschriften erfolgt über die Buttons, die ein "H" anzeigen. Wenn in einer Seite mehr als drei Überschriften vorkommen, wird automatisch ein Inhaltsverzeichnis erstellt, welches alle Überschriften auflistet. ====== Überschrift Ebene 1 ====== ===== Überschrift Ebene 2 ===== ==== Überschrift Ebene 3 ==== === Überschrift Ebene 4 === == Überschrift Ebene 5 == Innerhalb von Überschriften können standardmäßig keine weiteren Formatierungen vorgenommen werden! ==== Listen ==== DokuWiki kennt unsortierte (zwei Leerzeichen, gefolgt von *) und nummerierte Listen (zwei Leerzeichen, gefolgt von -). * Eintrag einer unsortierten Liste - Eintrag einer nummerierte Liste - Ein zweiter Eintrag - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen * Eintrag einer unsortierten Liste - Eintrag einer nummerierte Liste - Ein zweiter Eintrag - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen ==== unformatierte Abschnitte ==== Um Text so anzuzeigen, wie er geschrieben wurde, egal ob er DokuWiki Formatierungen oder andere Formatierungen enthält, kann man jede Zeile mit zwei Leerzeichen beginnen, oder den entsprechenden Teil mit umschließen (Code kleinschreiben, damit es funktioniert). ===== Links ===== Links werden in doppelten eckigen Klammern gesetzt: [[name_der_seite]] und können auch hinter Beschreibungen versteckt werden: [[name_der_seite|Beschreibung für einen Link]]. Links werden in doppelten eckigen Klammern gesetzt: [[name_der_seite]] und können auch hinter Beschreibungen versteckt werden: [[name_der_seite|Beschreibung für einen Link]]. Bei externen Links auf Seiten außerhalb dieses Wikis die jeweilige URL anstatt name_der_seite einfügen. Bei internen Links kann man auf spezielle Abschnitte bzw Unterüberschriften verlinken, indem man den Abschnittsnamen getrennt durch # an den Seitennamen anhängt. Dieses Beispiel verlinkt zu [[anleitung_wiki#links|diesem Abschnitt "Links"]]. Dieses Beispiel verlinkt zu [[anleitung_wiki#links|diesem Abschnitt "Links"]]. ===== Bilder und andere Dateien ===== Mit einem FaKo-Account hat man die Berechtigung, Bilder und andere Dokumente im Wiki hochzuladen. Lade mit Klick auf das Symbol {{:media-button.png}} in der Symbolleiste ein Bild oder anderere Datei in die jeweilige Seite hoch. Mit geschweiften Klammern kann dann das Bild oder Dokument dann in den Artikeltext eingebunden werden, die richtige Datei kann wieder mit Klick auf das Symbol {{:media-button.png}} in der Symbolleiste gesucht werden: {{:bildname.png}} {{:dateienname.pdf}} Bilder werden dabei angezeigt, Dateien können mit Klick auf den Link heruntergeladen werden. ===== Tabellen ===== Siehe [[https://www.dokuwiki.org/de:wiki:syntax#tabellen|Syntax für Tabellen im DokuWiki-Handbuch]].