Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Nächste Überarbeitung | Vorhergehende ÜberarbeitungLetzte ÜberarbeitungBeide Seiten der Revision | ||
wiki:syntax [2008/05/05 19:10] – Externe Bearbeitung 127.0.0.1 | wiki:syntax [2021/07/06 12:12] – cg301 | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ====== Wiki-Guide====== | ||
+ | |||
+ | Sie können diesen Guide gerne kopieren und in Ihr Wiki einfügen bzw. die englisch-sprachige Syntax (Seitensuche: | ||
+ | \\ | ||
+ | ====== Regeln fürs Mitmachen ====== | ||
+ | |||
+ | - Bitte regen Sie größere **Veränderungsvorschläge** / Korrekturen - wie z. B. in der Wikipedia üblich - zunächst auf den jeweiligen **Diskussionsseiten**, | ||
+ | * Auf den Diskussionsseiten können zudem fachliche Differenzen und Unklarheiten sachlich diskutiert werden. | ||
+ | * Jeden Diskussionsbeitrag bitte " | ||
+ | * Antworten / Reaktionen auf Beiträge [[# | ||
+ | - Machen Sie die von Ihnen vorgenommenen **Änderungen** deutlich: | ||
+ | * Sofern Sie nur kleine Änderungen in einem Artikel vornehmen (sprich: Komma ergänzt, Tippfehler korrigiert), | ||
+ | * Bei allen anderen Änderungen bitte unter dem Artikel unter " | ||
+ | - Artikel bitte sachlich formulieren und sparsam formatieren. Hierzu bitte die [[# | ||
+ | |||
+ | |||
+ | <note tip>**{{ : | ||
+ | |||
+ | \\ | ||
+ | ===== Seite erstellen ===== | ||
+ | |||
+ | |||
+ | Verlinken Sie auf einer bestehenden Seite ein Wort mit doppelten eckigen Klammern < | ||
+ | |||
+ | \\ | ||
+ | ===== Seite bearbeiten ===== | ||
+ | |||
+ | * Um eine Seite zu bearbeiten, klicken an der oberen Leiste auf " | ||
+ | * Nutzen Sie beim Bearbeiten der Seite den " | ||
+ | |||
+ | \\ | ||
+ | ===== Formatierungshinweise ===== | ||
+ | |||
+ | Bitte orientieren Sie sich an den bestehenden Seiten. | ||
+ | |||
+ | * Wählen Sie eine aussagekräftige Überschrift. | ||
+ | * Artikel beginnen mit der Überschrift 1 (H1). Diese ist gleichzeitig der Seitenname und wird so in den Index übernommen | ||
+ | * Den Artikel sinnvoll mit Überschriften ab H2 strukturieren | ||
+ | * Möglichst sparsam mit Hervorhebungen aller Art umgehen (fett, unterstrichen, | ||
+ | * Bilder möglichst in einen Rahmen setzen und mit einer Bildbeschriftung versehen (s.u. [[# | ||
+ | * Bilder zuerst links im Menü unter Werkzeuge in den passenden Bereich hochladen, dann in den Artikel einfügen. | ||
+ | * Verlinken Sie den Artikel möglichst mit bereits bestehenden Seiten (wie das geht: [[# | ||
+ | * Fügen Sie in den Artikel __nicht__ manuell ein Änderungsdatum (" | ||
+ | * Ordnen Sie jedem Artikel die passenden Schlagwörter zu. Dies erleichtert die Navigation im Wiki, denn die verschlagworteten Seiten erscheinen automatisch auf einer Übersichtseite. Wählen Sie unter jedem Artikel die passenden Stichwörter aus. | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ===== Ältere Versionen ===== | ||
+ | |||
+ | * Über den Reiter " | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ===== Wiki-Syntax ===== | ||
+ | |||
+ | |||
+ | ==== Textformatierung ==== | ||
+ | |||
+ | \\ | ||
+ | === Schrift === | ||
+ | |||
+ | ^Syntax^Ergebnis^ | ||
+ | |%%**fett**%%|**fett**| | ||
+ | |%%// | ||
+ | |%%__unterstrichen__%%|__unterstrichen__| | ||
+ | |%%'' | ||
+ | |%%< | ||
+ | |%%< | ||
+ | |%%< | ||
+ | |%%\+%%| | ||
+ | |||
+ | \\ | ||
+ | ===Absätze === | ||
+ | Ein Absatz wird erzeugt durch | ||
+ | * eine leere Zeile oder | ||
+ | * %%\\%% am Ende einer Zeile oder | ||
+ | * %%\\%% plus ein Leerzeichen | ||
+ | |||
+ | \\ | ||
+ | === Überschriften ==== | ||
+ | Überschriften werden mit maximal sechs " | ||
+ | ====== Überschrift Ebene 1 ====== | ||
+ | ===== Überschrift Ebene 2 ===== | ||
+ | ==== Überschrift Ebene 3 ==== | ||
+ | === Überschrift Ebene 4 === | ||
+ | == Überschrift Ebene 5 == | ||
+ | |||
+ | Innerhalb von Überschriften können keine weiteren Formatierungen vorgenommen werden! | ||
+ | |||
+ | Überschrift 1 steht am Anfang eines Artikels. Wenn in einer Seite mehr als 3 Überschriften vorkommen, wird automatisch ein Inhaltsverzeichnis erstellt, welches alle Überschriften auflistet. | ||
+ | |||
+ | Soll kein Inhaltsverzeichnis erstellt werden, muss der Befehl: ''< | ||
+ | |||
+ | \\ | ||
+ | === Unformatierte Abschnitte === | ||
+ | |||
+ | Um Text unformatiert in einer Box erscheinen zu lassen, beginnt man jede Zeile mit zwei Leerzeichen oder verwendet %%< | ||
+ | |||
+ | Um Text unformatiert in einer Box erscheinen zu lassen, beginnt man jede Zeile mit zwei Leerzeichen | ||
+ | |||
+ | %%< | ||
+ | |||
+ | < | ||
+ | |||
+ | Um jegliche Umwandlung durch DokuWiki abzustellen, | ||
+ | |||
+ | \\ | ||
+ | === Zitat / Kommentar === | ||
+ | Zitate oder Kommentar werden mit dem " | ||
+ | |||
+ | %%> Zitat 1%% | ||
+ | |||
+ | %%>> Antwort auf Zitat 1%% | ||
+ | |||
+ | %%>>> | ||
+ | |||
+ | ergibt: | ||
+ | |||
+ | > Zitat 1 | ||
+ | |||
+ | >> Antwort auf Zitat 1 | ||
+ | |||
+ | >>> | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ==== Links ==== | ||
+ | |||
+ | Mit DokuWiki können 5 unterschiedliche Arten von Links benutzt werden: | ||
+ | |||
+ | ^Externe Links|Externe Links (Verweise auf andere Webseiten oder Dateien) werden automatisch erkannt: %%http:// | ||
+ | ^ |Links können auch hinter Begriffen versteckt werden: %%[[http:// | ||
+ | ^E-Mail-Adressen|%%< | ||
+ | ^ |oder ebenfalls hinter Begriffen versteckt %%[[andi@splitbrain.org|Mail an Andi]]%%|[[andi@splitbrain.org|Mail an Andi]]| | ||
+ | ^Interne Links|%%[[syntax]]%% Namen für neue Seiten werden automatisch in Kleinbuchstaben umgewandelt. Umlaute sind genauso wie Sonderzeichen nicht erlaubt!|[[syntax]]| | ||
+ | ^ |Interne Links können ebenfalls hinter Beschreibungen versteckt werden %%[[syntax|Hilfe zur Wiki-Syntax]]%%|[[syntax|Hilfe zur Wiki-Syntax]]| | ||
+ | ^ |Links zu [[syntax|existierenden Seiten]] werden anders angezeigt als Links zu [[nicht-existierenden]] Seiten.| | | ||
+ | ^Links zu anderen Wikis|%%[[doku> | ||
+ | |||
+ | \\ | ||
+ | ==== Benannte Anker ==== | ||
+ | |||
+ | Um innerhalb einer Seite an bestimmte Textstelle positionieren zu können, finden benannte Anker Anwendung. | ||
+ | Da die Wiki-Syntax diese nicht direkt unterstützt, | ||
+ | |||
+ | Hier zwei Beispiele: | ||
+ | |||
+ | < | ||
+ | [[# | ||
+ | |||
+ | [[# | ||
+ | |||
+ | bla bla bla bla bla | ||
+ | ... | ||
+ | bla bla bla bla bla | ||
+ | |||
+ | Das ist ein **unsichtbarer Anker**: | ||
+ | < | ||
+ | <a name=" | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | <a name=" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | |||
+ | **Überschriften** werden vom Wiki-System automatisch mit Anker versehen. Sie werden z.B. in der Inhaltsangabe am Seitenanfang verwendet. Den Namen des Ankers bildet man einfach nach folgenden Regeln aus der Überschrift: | ||
+ | |||
+ | - Alles wird in Kleinbuchstaben übersetzt | ||
+ | - Die Leerzeichen werden durch ein ' | ||
+ | - Die Umlaute/ | ||
+ | |||
+ | Um z.B. den aktuellen Abschnitt zu adressieren, | ||
+ | |||
+ | < | ||
+ | [[# | ||
+ | </ | ||
+ | |||
+ | |||
+ | Übrigens können solche Ankerpunkte auch von anderen Wiki-Seiten... | ||
+ | [[syntax# | ||
+ | |||
+ | < | ||
+ | [[syntax# | ||
+ | </ | ||
+ | |||
+ | ... oder von außerhalb adressiert werden: | ||
+ | |||
+ | < | ||
+ | [[http:// | ||
+ | </ | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ==== Bilder und andere Dateien ==== | ||
+ | * Bilder zuerst links im Menü unter Werkzeuge in den passenden Bereich hochladen, dann in den Artikel einfügen. | ||
+ | * Laden Sie nur Bilder und Medien auf das RZ-Wiki hoch, die Sie selbst gemacht haben oder die unter einer Freien Lizenz veröffentlicht wurden (Lizenzbedingungen beachten, z. B. Nennung des/der Autoren. | ||
+ | * Nur Bilder verwenden, die jeweils zum Thema passen. | ||
+ | * Größe Bilder vor dem Hochladen verkleinern. | ||
+ | |||
+ | Bilder werden mit geschweiften Klammern in Texte eingebunden werden. Optional kann deren Größe angegeben werden: | ||
+ | |||
+ | ^Original Größe|%%{{wiki: | ||
+ | ^Breite vorgeben|%%{{wiki: | ||
+ | ^Breite und Höhe vorgeben|%%{{wiki: | ||
+ | |||
+ | \\ | ||
+ | === Ausrichten von Bildern === | ||
+ | Mit Leerzeichen zur Rechten und/oder Linken innerhalb der Klammern kann ein Bild horizontal ausgerichtet werden(links, | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | {{wiki: | ||
+ | {{ wiki: | ||
+ | |||
+ | <note tip> | ||
+ | Wenn Bilder links oder rechts angeordnet werden, fließt der Text um das Bild herum.\\ | ||
+ | Will man das verhindern und den nachfolgenden Text unter den Elementen anordnen, kann man folgenden kurzen HTML-Code einfügen: | ||
+ | </ | ||
+ | < | ||
+ | <br clear=" | ||
+ | </ | ||
+ | |||
+ | \\ | ||
+ | === Tooltipps === | ||
+ | Auch Titel, in den meisten Browsern als Tooltip angezeigt, können angegeben werden. | ||
+ | |||
+ | %%{{ wiki: | ||
+ | |||
+ | \\ | ||
+ | === Bilderrahmen === | ||
+ | Mit einfachen eckigen Klammern wird ein Bilderrahmen erzeugt. Hier wird der Titel nicht als Tooltipp, sondern im Rahmen als Bilduntertitel angezeigt: | ||
+ | |||
+ | %%[{{ wiki: | ||
+ | |||
+ | \\ | ||
+ | === Dateidownload ==== | ||
+ | |||
+ | Alle Dateien außer Bilder ('' | ||
+ | |||
+ | %%{{ wiki: | ||
+ | |||
+ | \\ | ||
+ | === Automatische Verlinkung === | ||
+ | |||
+ | Bilder werden automatisch mit einer Verlinkung zur Ihren [[wp> | ||
+ | %%{{wiki: | ||
+ | |||
+ | Dieses Verhalten kann über die Option ? | ||
+ | |||
+ | %%{{wiki: | ||
+ | |||
+ | Außerdem kann mit ?direct das Bild, z.Bsp. als Vollansicht, | ||
+ | |||
+ | %%{{wiki: | ||
+ | |||
+ | \\ | ||
+ | ==== Listen ==== | ||
+ | Um einen Listeneintrag zu erzeugen, beginne eine Zeile mit 2 Leerzeichen. Diesen Leerzeichen folgt dann ein " | ||
+ | |||
+ | < | ||
+ | |||
+ | * Ein zweiter Eintrag | ||
+ | |||
+ | * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen</ | ||
+ | |||
+ | |||
+ | * Dies ist ein Eintrag einer unsortierten Liste | ||
+ | * Ein zweiter Eintrag | ||
+ | * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
+ | |||
+ | |||
+ | < | ||
+ | |||
+ | - Ein zweiter Eintrag | ||
+ | |||
+ | - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen</ | ||
+ | |||
+ | |||
+ | - Dies ist ein Eintrag einer nummerierte Liste | ||
+ | - Ein zweiter Eintrag | ||
+ | - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
+ | |||
+ | \\ | ||
+ | ==== Tabellen ==== | ||
+ | |||
+ | Tabellenfelder werden mit senkrechten Stricken erzeugt. Felder einer Tabelle starten mit " | ||
+ | |||
+ | |||
+ | ^ hervorgehoben | ||
+ | | Zeile 1 Spalte 1 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
+ | | Zeile 2 Spalte 1 | doppelte Spaltenbreite (beachte den doppelten senkrechten Strich) || | ||
+ | | Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | | ||
+ | |||
+ | |||
+ | ^ hervorgehoben | ||
+ | | Zeile 1 Spalte 1 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
+ | | Zeile 2 Spalte 1 | doppelte Spaltenbreite (beachte den doppelten senkrechten Strich) || | ||
+ | | Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | | ||
+ | |||
+ | |||
+ | Zellen über mehrere Spalten werden erzeugt, wenn man am Ende einer solchen Spalte soviele " | ||
+ | Alle Zeilen einer Tabelle müssen die gleiche Anzahl an Feldtrennern " | ||
+ | |||
+ | Hervorgehobene Felder in Vertikaler Ausrichtung sind auch möglich. | ||
+ | |||
+ | | ^ hervorgehoben 1 ^ hervorgehoben 2 ^ | ||
+ | ^ hervorgehoben 3 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
+ | ^ hervorgehoben 4 | Zeile 2 Spalte 2 | | | ||
+ | ^ hervorgehoben 5 | Zeile 3 Spalte 2 | Zeile 3 Spalte 3 | | ||
+ | |||
+ | |||
+ | | ^ hervorgehoben 1 ^ hervorgehoben 2 ^ | ||
+ | ^ hervorgehoben 3 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
+ | ^ hervorgehoben 4 | Zeile 2 Spalte 2 | | | ||
+ | ^ hervorgehoben 5 | Zeile 3 Spalte 2 | Zeile 3 Spalte 3 | | ||
+ | |||
+ | Anmerkung: Felder über mehrere Zeilen werden nicht unterstützt. | ||
+ | |||
+ | *Der Inhalt einer Zelle kann horizontal ausgerichtet werden. Füge 2 Leerzeichen hinzu:\\ | ||
+ | * 2 Leerzeichen Links vom Text: rechtsbündig | ||
+ | * 2 Leerzeichen Rechts vom Text: linksbündig | ||
+ | * 2 Leerzeichen Links und Rechts vom Text: zentriert | ||
+ | |||
+ | ^ Tabelle mit Ausrichtung | ||
+ | | Rechts| | ||
+ | |Links | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | So sieht die Formatierung aus: | ||
+ | |||
+ | ^ Tabelle mit Ausrichtung | ||
+ | | Rechts| | ||
+ | |Links | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | <note tip>Den senkrechten Strich erhält man folgendermaßen: | ||
+ | </ | ||
+ | |||
+ | \\ | ||
+ | ==== Sonstige Formatierungen ==== | ||
+ | |||
+ | \\ | ||
+ | === Fußnoten === | ||
+ | |||
+ | Fußnoten ((dies ist eine Fußnote)) werden durch eine doppelte runde Klammer dargestellt: | ||
+ | |||
+ | \\ | ||
+ | === horizontale Linie === | ||
+ | Mit 4 aufeinander folgenden Minuszeichen (alleine in einer Zeile) kann eine horizontale Linie erzeugt werden: | ||
+ | |||
+ | < | ||
+ | |||
+ | ---- | ||
+ | |||
+ | \\ | ||
+ | === Smileys === | ||
+ | |||
+ | Dokuwiki verwandelt oft genutzte [[wp> | ||
+ | |||
+ | |||
+ | ^ 8-) ^ 8-O ^ :-( ^ :-) ^ =) ^ :-/ ^ :-\ ^ :-? ^ :-D ^ :-P ^ :-O ^ :-X ^ :-| ^ ;-) ^ :?: ^ :!: ^ '' | ||
+ | | %% 8-) %% | %% 8-O %% | %% :-( %% | %% :-) %% | %% =) | ||
+ | |||
+ | \\ | ||
+ | === Typografie === | ||
+ | Einfache Textzeichen werdem in ihre typografischen Entsprechungen umgewandelt.\\ | ||
+ | |||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "He thought ' | ||
+ | |||
+ | < | ||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "He thought ' | ||
+ | </ | ||
+ | |||
+ | \\ | ||
+ | ====Kontroll Makros ==== | ||
+ | |||
+ | Manche Syntax Befehle beeinflussen, | ||
+ | ^Macro^ Description^ | ||
+ | |%%~~NOTOC~~%%|Wenn dieses Makro im in eine Seite eingebunden ist, wird das [[: | ||
+ | |%%~~NOCACHE~~%%|Dokuwiki Seiten werden standardgemäß in einen Zwischenspeicher gesichert. Manchmal ist das aber nicht gewollt ( z.B. bei <php> Syntax Befehlen). Beim einfügen dieses Makros wird Dokuwiki gezwungen bei jedem Aufruf die Seite neu einzulesen.| | ||
+ | |||
+ | \\ | ||
+ | ====== Backgroundinfos zu dieser Seite====== | ||
+ | Grundlage für diese Seite war die [[http:// | ||
+ | Für das RZ-Wiki wurde sie grundlegend überarbeitet von --- // | ||
+ | |||