Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
wiki:syntax [2009/08/27 17:10] – cg301 | wiki:syntax [2009/08/31 12:33] – cg301 | ||
---|---|---|---|
Zeile 4: | Zeile 4: | ||
===== Seite erstellen ===== | ===== Seite erstellen ===== | ||
- | Um einen neuen Artikel zu erstellen, klicken Sie im Navigationskasten links auf "[[intern: | + | Um einen neuen Artikel zu erstellen, klicken Sie im Navigationskasten links auf " |
===== Seite bearbeiten ===== | ===== Seite bearbeiten ===== | ||
Zeile 30: | Zeile 30: | ||
|%%__unterstrichen__%%|__unterstrichen__| | |%%__unterstrichen__%%|__unterstrichen__| | ||
|%%'' | |%%'' | ||
- | |%%< | + | |%%< |
|%%< | |%%< | ||
|%%< | |%%< | ||
Zeile 56: | Zeile 56: | ||
+ | === unformatierte Abschnitte === | ||
- | ===== 1.4 unformatierte Abschnitte ===== | + | Um Text unformatiert in einer Box erscheinen zu lassen, beginnt man jede Zeile mit zwei Leerzeichen oder verwendet %%< |
- | 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 | + | |
- | <code> | + | oder %%<file></file>%% |
- | Mit " | + | |
- | </code> | + | |
- | < | + | < |
- | Mit "file": Eigentlich das Gleiche wie oben, sieht nur etwas anders aus. \\ | + | |
- | Vielleicht um Zitate zu kennzeichnen oder ähnliches. | + | |
- | </ | + | |
- | Um jegliche Umwandlung durch DokuWiki abzustellen, | + | Um jegliche Umwandlung durch DokuWiki abzustellen, |
- | + | ||
- | < | + | |
- | Dieser Text enthält links wie: http:// | + | |
- | </ | + | |
- | + | ||
- | Einfach den Quelltext dieser Seite anschauen (den Knopf " | + | |
- | + | ||
- | ===== 1.5 Syntax-Hervorhebung ===== | + | |
- | + | ||
- | [[DokuWiki]] kennt Syntax highlighting für Quellcode, um dessen Lesbarkeit zu erhöhen. Dafür wird [[http:// | + | |
- | Es wird der gleiche Bezeichner wie im vorherigen Abschnitt benutzt, nur dass er nun auch den Namen der Sprache enthält: | + | |
- | ''< | + | |
- | + | ||
- | <code java> | + | |
- | /** | + | |
- | * The HelloWorldApp class implements an application that | + | |
- | * simply displays "Hello World!" | + | |
- | */ | + | |
- | class HelloWorldApp { | + | |
- | public static void main(String[] args) { | + | |
- | System.out.println(" | + | |
- | } | + | |
- | } | + | |
- | </ | + | |
- | Es werden folgende Sprachen unterstützt: | ||
- | ===== 1.6 Zitat / Kommentar | + | === Zitat / Kommentar === |
- | Um einen Text als Zitat oder Kommentar | + | Zitate |
- | Ich denke wir sollten es tun. | + | %%> Zitat 1%% |
- | + | ||
- | | + | |
- | + | ||
- | >> Doch! | + | |
- | + | ||
- | > Wirklich? | + | |
- | + | ||
- | >> Ja! | + | |
- | + | ||
- | >>> | + | |
- | + | ||
- | >>> | + | |
- | Ich denke wir sollten es tun | + | %%>> Antwort auf Zitat 1%% |
- | > Nein, sollten wir nicht. | + | %%>>> Antwort auf Antwort%% |
- | >> Doch! | + | ergibt: |
- | > Wirklich? | + | > Zitat 1 |
- | >> | + | >> |
- | >>> | + | >>> |
- | >>> | ||
- | ====== 2 Links ====== | + | ==== Links ==== |
Mit DokuWiki können 5 unterschiedliche Arten von Links benutzt werden: | Mit DokuWiki können 5 unterschiedliche Arten von Links benutzt werden: | ||
- | ===== 2.1 Extern ===== | + | ^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|%%[[start]]%% Namen für neue Seiten werden automatisch in Kleinbuchstaben umgewandelt. Umlaute sind genauso wie Sonderzeichen nicht erlaubt!|[[start]]| | ||
+ | ^ |Interne Links können ebenfalls hinter Beschreibungen versteckt werden %%[[start|Startseite]]%%|[[start|Startseite]]| | ||
+ | ^ |Links zu [[: | ||
+ | ^Links zu anderen Wikis|%%[[doku> | ||
+ | ^Bilder als Links|BEs ist möglich, auf interne oder externe Bilddateien zu verlinken. Dazu wird die Syntax zur Anzeige von Links einfach mit der zur Anzeige von Bildern kombiniert: %%[[http:// | ||
- | Externe Links (Verweise auf andere | + | ==== Bilder und andere Dateien |
- | Verweise können auch hinter eigenen Begriffen versteckt werden: [[http:// | + | |
- | E-mail Adressen werden in spitze Klammern gesetzt: < | + | |
- | Externe Links werden automatisch erkannt: http:// | + | Mit geschweiften Klammern |
- | Verweise | + | |
- | E-mail Adressen | + | |
- | ===== 2.2 Intern ===== | + | ^Original Größe|%%{{wiki: |
+ | ^Breite vorgeben|%%{{wiki: | ||
+ | ^Breite und Höhe vorgeben|%%{{wiki: | ||
+ | ^Größe für externe Bilder vorgeben|%%{{http:// | ||
- | Interne Links, also Verweise auf Seiten innerhalb von DokuWiki, werden in doppelten eckigen Klammern gesetzt(" | + | === Ausrichten von Bildern === |
- | [[doku> | + | |
- | + | ||
- | Ein Link kann auch hinter einem Begriff oder einer Beschreibung versteckt werden:\\ | + | |
- | [[doku> | + | |
- | + | ||
- | Interne Links werden in doppelten eckigen Klammern gesetzt: | + | |
- | [[pagename]] | + | |
- | + | ||
- | Ein Link kann auch hinter einem Begriff oder einer Beschreibung versteckt werden: | + | |
- | [[pagename|Beschreibung für einen Link]]. | + | |
- | + | ||
- | Dateinamen für neue Seiten im Wiki werden automatisch in Kleinbuchstaben umgewandelt!\\ | + | |
- | Umlaute sind genauso wie Sonderzeichen nicht erlaubt! | + | |
- | + | ||
- | Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst: [[de: | + | |
- | + | ||
- | Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst: | + | |
- | + | ||
- | Weitere Informationen zu Namensbereichen: | + | |
- | + | ||
- | Anmerkungen: | + | |
- | + | ||
- | * Links zu [[syntax|existierenden Seiten]] werden anders angezeigt als Links zu [[nicht-existierenden]] Seiten. | + | |
- | * DokuWiki verwendet standardmäßig keine [[wp> | + | |
- | + | ||
- | ===== 2.3 Interwiki ===== | + | |
- | + | ||
- | DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku> | + | |
- | Ein Link zur Wikipedia Seite über Wikis: | + | |
- | + | ||
- | DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku> | + | |
- | Ein Link zur Wikipedia Seite über Wikis: | + | |
- | + | ||
- | ===== 2.4 Windows-Freigaben ===== | + | |
- | + | ||
- | DokuWiki kennt auch Links auf Windows-Freigaben: | + | |
- | Dies ist allerdings nur in einer homogenen Benutzergruppe sinnvoll (siehe [[wp> | + | |
- | + | ||
- | DokuWiki kennt auch Links auf Windows-Freigaben: | + | |
- | + | ||
- | Hinweis: | + | |
- | * Aus Sicherheitsgründen funktioniert direktes Navigieren durch die Freigaben standardmäßig nur mit dem Internet Explorer (und das nur in der " | + | |
- | * Für Mozilla und Firefox kann es durch die Option [[http:// | + | |
- | * Opera ingnoriert als Sicherheitsfeature seit [[http:// | + | |
- | * Für weitere Informationen siehe: [[bug> | + | |
- | + | ||
- | ===== 2.5 Bilder als Links ===== | + | |
- | + | ||
- | Bilder können für einen Link auf eine interne oder externe Datei verwendet werden. Dazu wird die Syntax zur Anzeige von Links einfach mit der zur Anzeige von Bildern (siehe unten) kombiniert: | + | |
- | + | ||
- | | + | |
- | + | ||
- | [[http:// | + | |
- | + | ||
- | Bitte beachte: Bildformatierungen sind die einzigen Formatierungen, | + | |
- | + | ||
- | ====== 3 Bilder und andere Dateien ====== | + | |
- | + | ||
- | ===== 3.1 Bilder per Dialogfeld einbauen ===== | + | |
- | Das Hochladen von Bildern muss in der Konfigurationsdatei eingeschaltet sein. Zusätzlich kann der Seitenbetreiber diese Funktion per [[acl|ACL]] beschränken. Zum Hochladen ist mindestens die Berechtigung " | + | |
- | FIXME | + | |
- | + | ||
- | ===== 3.2 Größe von Bildern | + | |
- | Mit geschweiften Klammern können sowohl externe als auch interne [[doku> | + | |
- | + | ||
- | Original Größe: | + | |
- | + | ||
- | Eine Breite vorgeben: | + | |
- | + | ||
- | Breite und Höhe vorgeben: | + | |
- | + | ||
- | Größe für externe Bilder vorgeben: | + | |
- | + | ||
- | Original Größe: | + | |
- | Eine Breite vorgeben: | + | |
- | Breite und Höhe vorgeben: | + | |
- | Größe für externe Bilder vorgeben: | + | |
- | + | ||
- | ===== 3.3 Ausrichten von Bildern | + | |
Mit Leerzeichen zur Rechten und/oder Linken innerhalb der Klammern kann ein Bild horizontal ausgerichtet werden(links, | Mit Leerzeichen zur Rechten und/oder Linken innerhalb der Klammern kann ein Bild horizontal ausgerichtet werden(links, | ||
Zeile 239: | Zeile 124: | ||
{{ wiki: | {{ wiki: | ||
- | bei Ausrichtung und der Verwendung eines Titels sollte man drauf achten dass der Titel nach dem Leerzeichen kommt | ||
- | {{ wiki: | ||
- | {{wiki: | ||
- | {{ wiki: | ||
- | ===== 3.4 Tooltips ===== | + | === Tooltipps |
Auch Titel, in den meisten Browsern als Tooltip angezeigt, können angegeben werden. | Auch Titel, in den meisten Browsern als Tooltip angezeigt, können angegeben werden. | ||
- | {{ wiki: | + | %%{{ wiki: |
- | {{ wiki: | + | === Bilderrahmen === |
+ | Mit einfachen eckigen Klammern wird ein Bilderrahmen erzeugt. Hier wird der Titel nicht als Tooltipp, sondern im Rahmen als Bilduntertitel angezeigt: | ||
- | ===== 3.5 Dateidownload ===== | + | %%[{{ wiki: |
- | Wenn eine Datei angegeben wird, die kein Bild ('' | ||
- | {{ wiki: | + | === Dateidownload ==== |
+ | |||
+ | Alle Dateien außer Bilder ('' | ||
+ | |||
+ | %%{{ wiki: | ||
===== 3.6 Automatische Verlinkung ===== | ===== 3.6 Automatische Verlinkung ===== | ||
- | Bilder werden automatisch mit einer Verlinkung zur Ihren [[wp> | + | Bilder werden automatisch mit einer Verlinkung zur Ihren [[wp> |
+ | %%{{wiki: | ||
- | Dieses Verhalten kann über die Option ? | + | Dieses Verhalten kann über die Option ? |
- | {{wiki: | + | %%{{wiki: |
- | | + | |
- | Ausserdem | + | Außerdem |
- | {{wiki: | + | %%{{wiki: |
- | | + | |
- | ====== 4 Listen ====== | + | ==== Listen ==== |
+ | Um einen Listeneintrag zu erzeugen, beginne eine Zeile mit 2 Leerzeichen. Diesen Leerzeichen folgt dann ein " | ||
- | DokuWiki kennt unsortierte und nummerierte Listen. Um einen Listeneintrag zu erzeugen, beginne eine Zeile mit 2 Leerzeichen. Diesen Leerzeichen folgt dann ein "*" für unsortierte oder ein " | + | < |
- | * Dies ist ein Eintrag einer unsortierten Liste | ||
* Ein zweiter Eintrag | * Ein zweiter Eintrag | ||
- | * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
- | * Noch ein Eintrag | ||
- | - Dies ist ein Eintrag einer nummerierte Liste | + | |
- | - Ein zweiter Eintrag | + | |
- | - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | + | |
- | - Noch ein Eintrag | + | |
- | < | ||
* Dies ist ein Eintrag einer unsortierten Liste | * Dies ist ein Eintrag einer unsortierten Liste | ||
* Ein zweiter Eintrag | * Ein zweiter Eintrag | ||
* Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | * 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 | - Dies ist ein Eintrag einer nummerierte Liste | ||
- Ein zweiter Eintrag | - Ein zweiter Eintrag | ||
- Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
- | - Noch ein Eintrag | ||
- | </ | ||
- | ====== 5 Tabellen ====== | ||
- | Mit DokuWiki können Tabellen ganz einfach erstellt werden: | ||
- | ^ hervorgehoben | + | ==== Tabellen ==== |
- | | Zeile 1 Spalte 1 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | + | |
- | | Zeile 2 Spalte 1 | doppelte Spaltenbreite (beachte den doppelten | + | Tabellenfelder werden mit senkrechten |
- | | Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | + | |
- | Felder einer Tabelle starten mit " | ||
^ hervorgehoben | ^ hervorgehoben | ||
Zeile 312: | Zeile 193: | ||
| Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | | | Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | | ||
- | Zellen über mehrere Spalten werden erzeugt, wenn man, wie oben gezeigt, | + | |
- | Kurz gesagt: | + | ^ 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. | Hervorgehobene Felder in Vertikaler Ausrichtung sind auch möglich. | ||
Zeile 322: | Zeile 210: | ||
^ hervorgehoben 5 | Zeile 3 Spalte 2 | Zeile 3 Spalte 3 | | ^ hervorgehoben 5 | Zeile 3 Spalte 2 | Zeile 3 Spalte 3 | | ||
- | Wie wir sehen, entscheidet der Feldtrenner (" | ||
| ^ hervorgehoben 1 ^ hervorgehoben 2 ^ | | ^ hervorgehoben 1 ^ hervorgehoben 2 ^ | ||
Zeile 348: | Zeile 235: | ||
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | |Hinweis zu dem senkrechten | + | <note tip> |
+ | </ | ||
+ | ==== sonstige Formatierungen ==== | ||
- | ====== 6 sonstige Formatierungen ====== | + | === Fußnoten |
- | ===== 6.1 Fußnoten | + | Fußnoten |
- | Fußnoten ((dies ist eine Fußnote)) werden durch eine doppelte runde Klammer dargestellt ((eine zweite Fußnote)). Der Text zwischen den Klammern wird an das Ende der Seite geschrieben. Die Reihenfolge und somit die Nummerierung übernimmt DokuWiki. | ||
- | Fußnoten ((dies ist eine Fußnote)) werden durch eine doppelte runde Klammer dargestellt ((eine zweite Fußnote)) | + | === horizontale Linie === |
- | + | ||
- | ===== 6.2 horizontale Linie ===== | + | |
Mit 4 aufeinander folgenden Minuszeichen (alleine in einer Zeile) kann eine horizontale Linie erzeugt werden: | Mit 4 aufeinander folgenden Minuszeichen (alleine in einer Zeile) kann eine horizontale Linie erzeugt werden: | ||
- | ---- | + | |
< | < | ||
- | ===== 6.3 Smileys | + | ---- |
+ | |||
+ | === Smileys === | ||
Dokuwiki verwandelt oft genutzte [[wp> | Dokuwiki verwandelt oft genutzte [[wp> | ||
- | Weitere Smiley-Grafiken können im Ordner " | + | |
- | Hier ist nun eine Übersicht der standardmäßig in DokuWiki enthaltenen Smileys: | + | |
^ 8-) ^ 8-O ^ :-( ^ :-) ^ =) ^ :-/ ^ :-\ ^ :-? ^ :-D ^ :-P ^ :-O ^ :-X ^ :-| ^ ;-) ^ :?: ^ :!: ^ '' | ^ 8-) ^ 8-O ^ :-( ^ :-) ^ =) ^ :-/ ^ :-\ ^ :-? ^ :-D ^ :-P ^ :-O ^ :-X ^ :-| ^ ;-) ^ :?: ^ :!: ^ '' | ||
| %% 8-) %% | %% 8-O %% | %% :-( %% | %% :-) %% | %% =) | | %% 8-) %% | %% 8-O %% | %% :-( %% | %% :-) %% | %% =) | ||
- | ===== 6.4 Typografie | + | ===Typografie === |
- | + | Einfache | |
- | [[DokuWiki]] kann einfache | + | |
- | Hier eine Liste aller Zeichen, die DokuWiki kennt: | + | |
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
Zeile 385: | Zeile 270: | ||
</ | </ | ||
- | Bitte beachtet: Diese Umwandlungen können in der Konfigurationsdatei abgestellt werden | ||
- | ===== 6.5 HTML und PHP einbinden | + | ====Kontroll Makros |
- | In einer Seite kann sowohl HTML als auch PHP direkt benutzt werden : | + | Manche Syntax Befehle beeinflussen, wie Dokuwiki eine Seite bei jedem Aufruf ausgibt. Die folgenden Kontroll Makros sind verfügbar: |
- | + | ||
- | < | + | |
- | This is some <font color=" | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | < | + | |
- | This is some <font color=" | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | Oder hier PHP: | + | |
- | + | ||
- | < | + | |
- | echo 'A logo generated by PHP:'; | + | |
- | echo '< | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | < | + | |
- | echo 'A logo generated by PHP:'; | + | |
- | echo '< | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | **Achtung**: | + | |
- | + | ||
- | **Achtung**: | + | |
- | + | ||
- | ====== 8 Kontroll Makros ====== | + | |
- | + | ||
- | Manche Syntax Befehle beeinflussen wie Dokuwiki eine Seite bei jedem Aufruf ausgibt. Die folgenden Kontroll Makros sind verfügbar: | + | |
^Macro^ Description^ | ^Macro^ Description^ | ||
|%%~~NOTOC~~%%|Wenn dieses Makro im in eine Seite eingebunden ist, wird das [[: | |%%~~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.| | |%%~~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.| | ||
- | ====== 7 Syntax-Plugins ====== | ||
- | DokuWikis Syntax kann durch [[doku> | ||
- | |||
- | ~~INFO: | ||
====== Backgroundinfos zu dieser Seite====== | ====== Backgroundinfos zu dieser Seite====== | ||
- | Diese Seite ist eine Übersetzung der [[http:// | + | Grundlage für diese Seite war die [[http:// |
- | Sie ist keine wortgleiche Übersetzung. Einige Beschreibungen sind etwas ausführlicher ausgefallen. Fachbegriffe werden nur dort verwendet, wo eine Umschreibung mehr Verwirrung stiftet als nützt.\\ | + | Für das RZ-Wiki wurde sie grundlegend überarbeitet von --- //[[wiki: |
- | Ähnliches gilt auch für Begriffe, die dem Englischen entspringen, | + | |
- | Der Übersetzer ist sich selbst nicht sicher, ob er lieber den Begriff " | + | |
- | + | ||
- | An einigen Stellen befindet sich ein FIXME - hier gibt es etwas, was im Sinne des Übersetzers noch nicht gut umgesetzt | + | |
- | * Anregungen, Bemerkungen oder Hinweise auf Fehler sind willkommen. | + | |
- | * euer Sebastian Koch => mr_snede *at* web ~dot~ de | + | |
- | + | ||
- | Seite grundlegend überarbeitet von --- //[[dokuwiki.20.baucki@spamgourmet.com|Konrad Bauckmeier]] 2005-12-02 09:05// | + | |
{{tag> | {{tag> |