Aktion 23 Wniki

Diese Seite ist nicht editierbar. Du kannst den Quelltext sehen, jedoch nicht verändern. Kontaktiere den Administrator, wenn du glaubst, dass hier ein Fehler vorliegt.
====== Syntax ======

[[DokuWiki]] zeichnet sich u. a. durch einfache Textformatierungen aus. Dadurch bleiben die Dateien, die den Inhalt enthalten, gut lesbar. 
In den nachfolgenden Abschnitten sind die möglichen Formatierungsarten aufgelistet, die innerhalb des Editors verwendet werden können. Einige der hier vorgestellten Formatierungen sind auch direkt über die [[doku>de:toolbar|Quickbuttons]] erreichbar.
Ein erstes Beispiel, wie der Aufbau einer Seite aussehen kann, findest du, wenn du dir diese Seite im Quelltext-Modus anzeigen lässt. Klicke dazu auf den Button "Vorschau". 

Zum  Ausprobieren oder Üben kann die [[/wiki/playground/playground|Spielwiese]] verwendet werden.


====== 1 Texte ======
===== 1.1 Formatierungen =====

DokuWiki unterstützt **fetten**, //kursiven//, __unterstrichenen__ und ''dicktengleichen'' ([[wpde>Dickte|Dickte]]) Text. Natürlich kann auch alles **__//''kombiniert''//__** werden.

  DokuWiki unterstützt **fetten**, //kursiven//, __unterstrichenen__ und ''dicktengleichen'' Text. 
  Natürlich kann auch alles **__//''kombiniert''//__** werden.

Ebenso gibt es <sub>tiefgestellten</sub> und <sup>hochgestellten</sup> Text.

  Ebenso gibt es <sub>tiefgestellten</sub> und <sup>hochgestellten</sup> Text.

Text kann als <del>gelöscht</del>((wer das Tag "eingefügt" (%%<ins>%%) benötigt. kann dies über Plugins realisieren. Siehe ganz unten!)) markiert werden.

  Text kann als <del>gelöscht</del> markiert werden.

Text kann auch mit <color red>Vordergrund</color>- und <color /yellow>Hintergrundfarben</color> oder <color blue/lightgrey>beidem</color> versehen werden. Auch <color #FFCC00>Hex-Farbwerte</color> sind möglich.

  Text kann auch mit <color red>Vordergrund</color>- und <color /yellow>Hintergrundfarben</color> oder <color blue/lightgrey>beidem</color> versehen werden. Auch <color #FFCC00>Hex-Farbwerte</color> sind möglich.

===== 1.2 Absätze =====

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.

===== 1.3 Ü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. 

Es ist __sinnvoll__, wenn immer eine Level 1 Überschrift am Anfang eines Artikels steht.

Wenn in einer Seite mehr als drei Überschriften vorkommen, wird automatisch ein Inhaltsverzeichnis erstellt, welches alle Überschriften auflistet.
Soll dieses Inhaltsverzeichnis nicht erstellt werden, muss der Befehl: ''<nowiki>~~NOTOC~~</nowiki>'' mit in die Seite aufgenommen werden.

  ====== Ü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! (s. [[faq:headerlinks|FAQ - Headerlinks]])

===== 1.4 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 (so wie es in dieser Seite angewendet wurde) oder einen der Bezeichner "code" bzw. "file" benutzen:

<code>
Mit "code": In diesem Text werden keine überflüssigen Leerzeichen entfernt: wie hier              <-- zwischen
</code>


  <file plain Beispiel.txt>
  Mit dem Bezeichner "file" kann ein bestimmter Abschnitt als einzelner Bestandteil 
  auf einer Seite zum Download angeboten werden.
  </file>

Innerhalb von "file" ist auch die im Abschnitt weiter unten beschriebene [[#Syntax-Hervorhebung|Syntax-Hervorhebung]] aktivierbar.

<file perl HelloWorld.pl>
#!/usr/bin/perl
print "Hello World!\n";
</file>

  <file perl HelloWorld.pl>
  #!/usr/bin/perl
  print "Hello World!\n";
  </file>

Um jegliche Umwandlung durch DokuWiki abzustellen, umschließe den entsprechenden Bereich mit "nowiki" Bezeichnern oder kürzer mit doppelten Prozentzeichen ''<nowiki>%%</nowiki>''.

<nowiki>
Dieser Text enthält Links wie: http://www.splitbrain.org und **Formatierungen** aber sie werden nicht umgesetzt und erscheinen als normaler Text.
</nowiki>

%%Dieser Text ist nun mit %%''<nowiki>%%</nowiki>''%% markiert und hat die gleiche Wirkung wie "nowiki".

"Dieser Text enthält links wie: http://www.splitbrain.org und **Formatierungen** aber sie werden nicht umgesetzt und erscheinen als normaler Text."%%

Einfach den Quelltext dieser Seite anschauen (den Knopf "Edit" drücken) um zu sehen, wie diese Blöcke angewendet werden.

===== 1.5 Syntax-Hervorhebung =====

[[DokuWiki]] kennt Syntax-Highlighting für Quellcode, um dessen Lesbarkeit zu erhöhen. Dafür wird [[http://qbnz.com/highlighter/|GeSHi]] "**Ge**neric **S**yntax **Hi**ghlighter" benutzt. Somit wird jede Programmiersprache unterstützt, die GeSHi kennt.
Es wird der gleiche Bezeichner wie im vorherigen Abschnitt benutzt, nur dass er nun auch den Namen der Sprache enthält:
''<nowiki><code java> Quelltext </code></nowiki>''

<code java>
/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}
</code>

Es werden folgende Sprachen unterstützt: //actionscript, actionscript-french, ada, apache, applescript, arduino, asm, asp, autoit, bash, brainfuck, caddcl, cadlisp, **c**, c_mac, cpp, csharp, css, **delphi**, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, intercal, **java**, javascript, latex, lisp, lua, matlab, mpasm, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, **php**, python, qbasic, scheme, sdlbasic, smarty, **sql**, r((als //rsplus//)), ruby, vb, vbnet, vhdl, visualfoxpro, **xml**//

===== 1.6 Zitat / Kommentar =====
Um einen Text als Zitat oder Kommentar zu kennzeichnen, wird das "größer als" - Zeichen folgendermaßen verwendet:

  Ich denke wir sollten es tun.
  
  > Nein, sollten wir nicht.
  
  >> Doch!
  
  > Wirklich?
  
  >> Ja!
  
  >>> Dann lass es uns tun!
  
  >>> Kommentare oder Zitate können auch über mehrere Zeilen gehen, wie dieser völlig unsinnige Text zeigt. Um einen Text als Zitat oder Kommentar zu kennzeichnen, wird das "größer als"-Zeichen folgendermaßen verwendet

Ich denke wir sollten es tun

> Nein, sollten wir nicht.

>> Doch!

> Wirklich?

>> Ja!

>>> Dann lass es uns tun

>>> Kommentare oder Zitate können auch über mehrere Zeilen gehen, wie dieser völlig unsinnige Text zeigt. Um einen Text als Zitat oder Kommentar zu kennzeichnen, wird das "größer als"-Zeichen folgendermaßen verwendet

Eine andere Möglichkeit ist, ein Zitat als Zitatblock zu kennzeichnen (inklusive Quellangabe):

  <blockquote>Jeder versteht Micky Maus. Wenige verstehen Hermann Hesse. Kaum jemand versteht Albert Einstein. Und niemand versteht Kaiser Norton.
  <cite>Malaclypse der Jüngere</cite>
  </blockquote>

<blockquote>Jeder versteht Micky Maus. Wenige verstehen Hermann Hesse. Kaum jemand versteht Albert Einstein. Und niemand versteht Kaiser Norton.
<cite>Malaclypse der Jüngere</cite>
</blockquote>

Um Zitate im Fließtext zu kennzeichnen, bietet sich das "quote"-Element (auch kurz nur "q") an:

  Schulterzuckend sagte er <quote>Muss wohl Synchronizität sein</quote>.

Schulterzuckend sagte er <quote>Muss wohl Synchronizität sein</quote>.

Die beiden letzten Varianten lassen sich auch wie [[#formatierungs-container|Container]] formatieren:

  Der Satz von <cite hi>Sri Syadasti</cite> lautet:
  
  <blockquote column 30% :de>
  "All affirmations are true in some sense, false in some sense, meaningless in some sense, true and false in some sense, true and meaningless in some sense, false and meaningless in some sense, and true and false and meaningless in some sense."
  </blockquote>

  Sie schreib auf den Apfel <q :el>καλλίστῃ</q> und warf ihn.

Der Satz von <cite hi>Sri Syadasti</cite> lautet:

<blockquote column 30% :en>
"All affirmations are true in some sense, false in some sense, meaningless in some sense, true and false in some sense, true and meaningless in some sense, false and meaningless in some sense, and true and false and meaningless in some sense."
</blockquote>

Sie schreib auf den Apfel <q :el>καλλίστῃ</q> und warf ihn.
===== 1.7 Escapezeichen =====
Will man verhindern, dass DokuWiki irgendwelche Formatierungen am bzw. Umwandlungen im Text vornimmt so kann man die Prozentzeichen benutzen
<code>%%[[wiki:testseite|Testseite]]%%</code>
Die Ausgabe würde dann folgendermaßen aussehen %%[[wiki:testseite|Testseite]]%%

===== 1.8 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))

====== 2 Links ======

Mit DokuWiki können fünf unterschiedliche Arten von Links benutzt werden:

===== 2.1 Extern =====

Externe Links (Verweise auf andere Webseiten oder Dateien) werden automatisch erkannt: http://www.google.com oder einfach www.google.com.
Verweise können auch hinter eigenen Begriffen versteckt werden: [[http://www.google.com|hier ist google]].
E-Mail Adressen werden in spitze Klammern gesetzt: <andi@splitbrain.org>.

  Externe Links werden automatisch erkannt: http://www.google.com oder einfach www.google.com.
  Verweise können auch hinter eigenen Begriffen versteckt werden: [[http://www.google.com|hier ist google]].
  E-Mail Adressen werden in spitze Klammern gesetzt: <andi@splitbrain.org>.

===== 2.2 Intern =====

Interne Links, also Verweise auf Seiten innerhalb von DokuWiki, werden in doppelten eckigen Klammern gesetzt ("Alt Gr+8" bzw. Alt Gr+9 unter Windows bzw. Wahltaste+5 und Wahltaste+6 bei Apple-Betriebssystemen):
[[doku>pagename]]

Ein Link kann auch hinter einem Begriff oder einer Beschreibung versteckt werden:
[[pagename|Beschreibung für einen Link]].

  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:namespaces]] 

  Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst:[[de:namespaces]] 

Weitere Informationen zu Namensbereichen: [[doku>de:namespaces]].

Die Verlinkung zu einem speziellen Abschnitt innerhalb des Dokuments (Anker) ist auch möglich. Der Abschnittsnamen wird getrennt durch ein Doppelkreuz (#) an den Seitennamen gehängt. 

Dieses Beispiel verlinkt zu [[de:wiki:syntax#intern|diesem Abschnitt]].

  Dieses Beispiel verlinkt zu [[de:wiki:syntax#intern|diesem Abschnitt]].


Anmerkungen:

  * Links zu [[syntax|existierenden Seiten]] werden anders angezeigt als Links zu [[nicht-existierenden]] Seiten.
  * DokuWiki verwendet standardmäßig keine [[wpde>CamelCase]] für Links. In der Einstellungsdatei: [[doku>config]] kann das aber geändert werden. **Hinweis**: wenn das Wort "DokuWiki" als Link angezeigt wird, dann ist diese Option eingeschaltet.
  * Ändert sich eine Überschrift im Zieldokument, führt der Anker ins Leere ohne dass der Link dabei als fehlerhaft angezeigt wird.
  * Anker werden klein geschrieben, es werden Leerzeichen mit Unterstrichen und Umlaute mit ihren Umschreibungen (ä = ae) verwendet.

===== 2.3 Interwiki =====

DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links.
Ein Link zur Wikipedia Seite über Wikis:[[wpde>Wiki]]

  DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links.
  Ein Link zur Wikipedia Seite über Wikis:[[wpde>Wiki]]

===== 2.4 Windows-Freigaben =====

DokuWiki kennt auch Links auf Windows-Freigaben: [[\\server\freigabe|freigegebener-Ordner]].
Dies ist allerdings nur in einer homogenen Benutzergruppe sinnvoll (siehe [[wpde>Intranet]]).

  [[\\server\freigabe|this]].

Hinweis:
  * Aus Sicherheitsgründen funktioniert direktes Navigieren durch die Freigaben standardmäßig nur mit dem Internet Explorer (und das nur in der "lokalen Zone")!
  * Für Mozilla und Firefox kann es durch die Option [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] eingeschaltet werden, was aber nicht empfohlen wird! (Weitere Informationen: [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Links to local pages do not work]])
  * Opera ignoriert als Sicherheitsfeature seit [[http://www.opera.com/windows/changelogs/754/|Version 7.54]] alle Links auf //file:// in Webseiten.
  * Für weitere Informationen siehe: [[bug>151]]

===== 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://www.php.net|{{wiki:dokuwiki-128.png}}]]

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Bitte beachte: Bildformatierungen sind die einzigen Formatierungen, die in Linknamen benutzt werden können!

====== 3 Bilder und andere Dateien ======

===== 3.1 Bilder im DokuWiki speichern =====

Um Bilder im DokuWiki speichern zu dürfen, muss der Benutzer die entsprechende Berechtigung besitzen ([[de:acl|ACL]]). Zum Hochladen ist mindestens die Berechtigung "Hochladen" (engl. "Upload"), zum Löschen "Entfernen" (engl. "Delete") für den [[de:namespaces|Namensraum]] erforderlich.

===== 3.2 Größe von Bildern  =====
Mit geschweiften Klammern können sowohl externe als auch interne [[doku>images|Bilder]] eingebunden werden. Das Bild heißt in diesem Beispiel "dokuwiki-128.png". Optional kann deren Größe angegeben werden:

Originalgröße:                      {{wiki:dokuwiki-128.png}}

Eine Breite vorgeben:                {{wiki:dokuwiki-128.png?50}}

Breite und Höhe vorgeben:            {{wiki:dokuwiki-128.png?200x50}}

Größe für externe Bilder vorgeben:   {{http://de3.php.net/images/php.gif?200x50}}

  Originalgröße:                        {{wiki:dokuwiki-128.png}}
  Eine Breite vorgeben:                  {{wiki:dokuwiki-128.png?50}}
  Breite und Höhe vorgeben:              {{wiki:dokuwiki-128.png?200x50}}
  Größe für externe Bilder vorgeben:     {{http://de3.php.net/images/php.gif?200x50}}

===== 3.3 Ausrichten von Bildern =====
Mit Leerzeichen zur Rechten und/oder Linken innerhalb der Klammern kann ein Bild horizontal ausgerichtet werden (Links, Zentriert, Rechts).

{{ wiki:dokuwiki-128.png|Rechts}}

{{wiki:dokuwiki-128.png |Links}}

{{ wiki:dokuwiki-128.png |Zentriert}}

  
  {{wiki:dokuwiki-128.png }}
  {{ wiki:dokuwiki-128.png }}
  {{ wiki:dokuwiki-128.png}}

Bei Ausrichtung und der Verwendung eines Titels sollte man drauf achten dass der Titel nach dem Leerzeichen kommt:
  
  {{wiki:dokuwiki-128.png |Linksbündig}}
  {{ wiki:dokuwiki-128.png |Zentriert }}
  {{ wiki:dokuwiki-128.png|Rechtsbündig}}
===== 3.4 Tooltips =====
Auch Titel, in den meisten Browsern als Tooltip angezeigt, können angegeben werden.

{{ wiki:dokuwiki-128.png |Dies ist ein Titel}}

  {{ wiki:dokuwiki-128.png |Dies ist ein Titel}}

===== 3.5 Dateidownload =====

Wenn eine Datei angegeben wird, die kein Bild (''gif, jpeg, png'') ist, so wird sie als Link angezeigt und so zum Download angeboten.

{{ wiki:dokuwiki-128.txt |Beispiel}}
<code>{{ wiki:dokuwiki-128.txt |Beispiel}}</code>

===== 3.6 Automatische Verlinkung =====

Bilder werden automatisch mit einer Verlinkung zur Ihren [[wpde>Metadaten]] erstellt - Bsp.: {{wiki:dokuwiki-128.png?15}}

Dieses Verhalten kann über die Option ?nolink((ggf. mit einem "&" mit anderen Optionen wie der Größenangabe kombinieren)) unterbunden werden((Standardmäßig lässt sich [[tips:image_nolink|dieses, oft unerwünschte, Verhalten]] momentan (13.03.2009) nicht für das komplette DokuWiki deaktivieren)):

{{wiki:dokuwiki-128.png?15&nolink}}
  {{wiki:dokuwiki-128.png?15&nolink}}

Außerdem kann mit ?direct das Bild, z.Bsp. als Vollansicht, direkt verlinkt werden:

{{wiki:dokuwiki-128.png?15&direct}}
  {{wiki:dokuwiki-128.png?15&direct}}

====== 4 Listen ======

DokuWiki kennt unsortierte und nummerierte Listen. Um einen Listeneintrag zu erzeugen, beginne eine Zeile mit zwei Leerzeichen. Diesen Leerzeichen folgt dann ein "*" für unsortierte oder ein "-" für nummerierte Listen.  

  * Dies ist ein Eintrag einer unsortierten Liste
  * Ein zweiter Eintrag
    * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen
  * Noch ein Eintrag

  - Dies ist ein Eintrag einer nummerierte Liste
  - Ein zweiter Eintrag
    - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen
  - Noch ein Eintrag

<code>
  * Dies ist ein Eintrag einer unsortierten Liste
  * Ein zweiter Eintrag
    * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen
  * Noch ein Eintrag

  - Dies ist ein Eintrag einer nummerierte Liste
  - Ein zweiter Eintrag
    - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen
  - Noch ein Eintrag
</code>

====== 5 Tabellen ======

===== 5.1 Grundlegender Aufbau =====

Mit DokuWiki können Tabellen ganz einfach erstellt werden: 

^ hervorgehoben       ^ zum Beispiel für                                                  ^ eine Titelzeile         ^
| 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    | Zeile 2 Spalte 2                                                   | Zeile 2 Spalte 3        |
| Zeile 4 Spalte 1    |   {{wiki:dokuwiki-128.png?400x500}}           | Zeile 4 Spalte 3        |

Felder einer Tabelle starten mit "|" für ein normales Feld oder mit einem "^" für hervorgehobenes Feld.

  ^ hervorgehoben       ^ zum Beispiel für                                                  ^ eine Titelzeile         ^
  | 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    | Zeile 2 Spalte 2                                                   | Zeile 2 Spalte 3        |

===== 5.2 Formatierung/Ausrichtung =====

=== Leerzellen ===

Zellen über mehrere Spalten werden erzeugt wenn man, wie oben gezeigt, am Ende einer solchen Spalte so viele "|" oder "^" ohne Leerzeichen dazwischen hintereinander setzt, wie Spalten überbrückt werden sollen.
Kurz gesagt: Alle Zeilen einer Tabelle müssen die gleiche Anzahl an Feldtrennern "|" oder "^" haben.

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        |

Wie wir sehen, entscheidet der Feldtrenner ("|" oder "^") vor einer Zelle über ihr Aussehen:

  |                    ^ 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        |

=== Zellen verbinden ===

Felder über mehrere Zeilen (**vertikal verbundene Zellen**) lassen sich durch hinzufügen von '':::'' in der zu verbindenden Zelle zusammenfügen.\\
:!: Zum Stand der //Release 2015-08-10a "Detritus"// können __Zellen der ersten Zeile nicht in vertikal verbundene Zellen einbezogen werden__.


^ Titelzeile 1        ^ Titelzeile 2                       ^ Titelzeile 3            ^
| Zeile 1 Spalte 1    | Diese Zelle ist vertikal verbunden | Zeile 1 Spalte 3        |
| Zeile 2 Spalte 1    | :::                                | Zeile 2 Spalte 3        |
| Zeile 3 Spalte 1    | :::                                | Zeile 3 Spalte 3        |

Außer den drei Doppelpunkten darf die zu verbindende Zelle keine weiteren Inhalte haben.

  ^ Titelzeile 1        ^ Titelzeile 2                       ^ Titelzeile 3            ^
  | Zeile 1 Spalte 1    | Diese Zelle ist vertikal verbunden | Zeile 1 Spalte 3        |
  | Zeile 2 Spalte 1    | :::                                | Zeile 2 Spalte 3        |
  | Zeile 3 Spalte 1    | :::                                | Zeile 3 Spalte 3        |


Felder über mehrere Spalten (**horizontal verbundene Zellen**) lassen sich durch hinzufügen von ''^'' bzw. ''|'' in der zu verbindenden Zelle zusammenfügen.

^ Titelzeile 1        ^ Titelzeile 2                       ^ Titelzeile 3            ^
| Zeile 1 Spalte 1    | Diese Zelle ist horizontal verbunden                        ||
| Zeile 2 Spalte 1    | Zeile 2 Spalte 2                   | Zeile 2 Spalte 3        |
| Zeile 3 Spalte 1    | Zeile 3 Spalte 2                   | Zeile 3 Spalte 3        |

  ^ Titelzeile 1        ^ Titelzeile 2                       ^ Titelzeile 3            ^
  | Zeile 1 Spalte 1    | Diese Zelle ist horizontal verbunden                         ||
  | Zeile 2 Spalte 1    | Zeile 2 Spalte 2                   |    Zeile 2 Spalte 3      |
  | Zeile 3 Spalte 1    | Zeile 3 Spalte 2                   | Zeile 3 Spalte 3         |

=== Textausrichtung ===

Der Inhalt einer Zelle kann horizontal innerhalb der Zelle ausgerichtet werden:
  * Rechtsbündig - zwei Leerzeichen links vom Text
  * Linksbündig - Leerzeichen rechts vom Text
  * Zentriert - zwei Leerzeichen links und rechts vom Text

^  Tabelle mit Ausrichtung                                |||
|                    Rechts |  Mitte        | Links         |
| Links                     |        Rechts |  Mitte        |
| xxxxxxxxxxxx              | xxxxxxxxxxxx  | xxxxxxxxxxxx  |

So sieht die Formatierung aus:

  ^          Tabelle mit Ausrichtung         ^^^
  |        Rechts|    Mitte     |Links         |
  |Links         |        Rechts|    Mitte     |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

| Hinweis zu dem senkrechten Balken-Zeichen: dieses Zeichen ist auf einer PC-Tastatur erreichbar über die Taste "<" bei zusätzlich gedrückter "AltGr"-Taste. Ist dort auch aufgedruckt. Apple-Nutzer erreichen das Zeichen mit der Wahltaste ("Alt") und der "7".  |

=== Hintergrundfarbe ===

Angaben zu Hintergrundfarben beginnen mit ''@'' und enden auf '':''. Alle HTML-Farbnamen und -Codes sind gültig. Ohne Angabe eines Farbwertes wird die Tabellenzelle gelb gefärbt.

^  Überschrift 1    ^  Überschrift 2     ^  Überschrift 3    ^
|  @lightgreen:**Verbundene Zelle**     ||                   |
|  @#6495ed:Zeile 1 |  Ja                |  Ja, OK           |
|  Zeile 2          |  Ja                |  @orange: Ja      |
|  @:Zeile 3        |  Ja                | @red:Nein         |

<code>
^  Überschrift 1    ^  Überschrift 2     ^  Überschrift 3    ^
|  @lightgreen:**Verbundene Zelle**     ||                   |
|  @#6495ed:Zeile 1 |  Ja                |  Ja, OK           |
|  Zeile 2          |  Ja                |  @orange: Ja      |
|  @:Zeile 3        |  Ja                | @red:Nein         |
</code>

|  @palegreen:OK |  @orange:Warnung |  @red:Fehler  |

<code>
|  @palegreen:OK |  @orange:Warnung |  @red:Fehler  |
</code>

====== 6 Formatierungs-Container ======

<WRAP center round info 60%>
Ich muss das mal übersetzen, Quelle ist [[http://demo.selfthinker.org/plugin:wrap|hier]].
</WRAP>



===== 6.1 Basic syntax =====

An uppercase **%%<WRAP>%%** (or alternatively **%%<block>%%** or **%%<div>%%**) creates a **''div''** and should be used for **"big"** containers, **surrounding** paragraphs, lists, tables, etc.

  <WRAP classes width :language>
  "big" content
  </WRAP>
  
  or
  <block classes width :language>
  "big" content
  </block>
  
  or
  <div classes width :language>
  "big" content
  </div>

A lowercase **%%<wrap>%%** (or alternatively **%%<inline>%%** or **%%<span>%%**) creates a **''span''** and should be used for **"small"** containers, **inside** paragraphs, lists, tables, etc.

  <wrap classes width :language>"small" content</wrap>
  
  or
  <inline classes width :language>"small" content</inline>
  
  or
  <span classes width :language>"small" content</span>

:!: Please note, some things **won't work with lowercase spans**:
  * **alignments** (including alignments generated by changing the text direction)
  * **multi-columns**
  * and **widths**
if the according wrap isn't floated as well.


===== 6.2 Classes and Styles =====


==== Columns and Floats ====

You can have columns easily by adding the class ''column'' and a width, e.g.
  <WRAP column 30%>...content...</WRAP>

<WRAP column 30%>
//**__Emulated Big Headline__**//

You can emulate a big headline with italic, bold and underlined text, e.g.
<code>//**__Emulated Big Headline__**//</code>

//**Emulated Small Headline**//

A smaller headline uses no underlining, e.g.
<code>//**Emulated Small Headline**//</code>

If you need text that is bold and italic, simply use it the other way around:
<code>**//No Headline//**</code>
</WRAP>

<WRAP column 30%>
//**__Different Floating Options__**//

Normally you would only need the class ''column'', but for more sophisticated uses (not only for columns, but for any other classes, like [[#boxes and notes]] as well) you can have several kinds of "floats":

  * **''column''** is the same as ''left'' in LTR languages and the same as ''right'' in RTL languages
  * **''left''** will let you float your wrap on the left
  * **''right''** will let the wrap float right
  * **''center''** will position the wrap in the horizontal center of the page

</WRAP>

<WRAP column 30%>
//**__Widths__**//

You can set any valid widths (but only on divs): ''%, px, em, ex, pt, pc, cm, mm, in'', but most of the time you'd only want either

^type^e.g.^note^
^''%''|''30%''|makes sense in a liquid layout|
^''px''|''420px''|makes sense if your layout has a fixed pixel width or if your container contains images with a certain width|
^''em''|''20em''|makes sense if you like your wrap container to grow and shrink with the font size or if your layout is em-based|

A **table** inside a column or box will always be **100% wide**. This makes positioning and sizing tables possible.

</WRAP>

<wrap em>After using any of the float classes, you might come across something like this, where the following text protrudes into the space where only the floating containers should be ...</wrap>

<WRAP clear></WRAP>

... to prevent that, you should simply add
  <WRAP clear></WRAP>
after your last column.

You **can** use the same options with spans (as each element that floats is automatically a block level element), but it probably doesn't make too much sense. :!: Widths on spans normally do not work (by design), but can make sense, when it is floating.

:!: Attention: Widths can cause problems and will often look different and break in some browsers. If you're not a web developer, you might not understand any problems regarding the [[http://en.wikipedia.org/wiki/Internet_Explorer_box_model_bug|box model]]. Just try to test your columns in all major browsers and make your widths smaller than you initially think they should be.

All of those options will also work in the [[#boxes and notes]] wraps (see below).

=== Multi-columns ===

<WRAP col3>
For modern browsers (Firefox, Chrome and Safari) you can use multi-columns. Just use **''%%col2%%''** for 2 columns, **''%%col3%%''** for 3 columns, **''%%col4%%''** for 4 columns and **''%%col5%%''** for 5 columns.

:!: Note: Multi-columns don't make sense for spans.
</WRAP>


==== Alignments ====

You can use these different text alignments:

  * ''leftalign''
  * ''rightalign''
  * ''centeralign''
  * ''justify''

<WRAP centeralign>
Center aligned text ...
</WRAP>

<WRAP rightalign>
... and right aligned.
</WRAP>

<code>
<WRAP centeralign>
Center aligned text ...
</WRAP>

<WRAP rightalign>
... and right aligned.
</WRAP>
</code>

:!: You cannot add alignments to spans.


==== Boxes and Notes ====

<WRAP round box 570px center>
//**__round box 570px center__**//

  * ''box'' creates a box around the container and uses the colours from the template's ''style.ini'' as default colours (''%%__background_alt__%%'' and ''%%__text__%%'')
  * any of the classes ''info'', ''tip'', ''important'', ''alert'', ''help'', ''download'', ''todo'' will add a special note container with a corresponding icon
  * the classes ''danger'', ''warning'', ''caution'', ''notice'', ''safety'' use safety colours (and no icons)
  * ''round'' can be added to anything with a background colour or a border and will only work in modern browsers (no Internet Explorer)
</WRAP>


<WRAP info 220px left>
//**Info**//
  <WRAP info></WRAP>
</WRAP>


<WRAP tip 220px left>
//**Tip**//
  <WRAP tip></WRAP>
</WRAP>


<WRAP important 220px left>
//**Important**//
  <WRAP important></WRAP>
</WRAP>


<WRAP alert 220px left>
//**Alert**//
  <WRAP alert></WRAP>
</WRAP>


<WRAP round help 220px left>
//**Help**//
  <WRAP round help></WRAP>
</WRAP>


<WRAP download 220px left>
//**Download**//
  <WRAP download></WRAP>
</WRAP>


<WRAP todo 220px left>
//**Todo**//
  <WRAP todo></WRAP>
</WRAP>


<WRAP clear></WRAP>


**Safety Notes:**

<WRAP danger 27% left>
//**Danger**//
  <WRAP danger></WRAP>
</WRAP>

<WRAP warning 27% left>
//**Warning**//
  <WRAP warning></WRAP>
</WRAP>

<WRAP caution 27% left>
//**Caution**//
  <WRAP caution></WRAP>
</WRAP>

<WRAP round notice 27% left>
//**Notice**//
  <WRAP round notice></WRAP>
</WRAP>

<WRAP round safety 27% left>
//**Safety**//
  <WRAP round safety></WRAP>
</WRAP>

<WRAP clear></WRAP>


You can use notes and boxes also inside text with spans like this:
<wrap info>info</wrap>, <wrap help>help</wrap>, <wrap alert>alert</wrap>, <wrap important>important</wrap>, <wrap tip>tip</wrap>, <wrap download>download</wrap>, <wrap todo>todo</wrap> and <wrap round box>round box</wrap> and <wrap danger>danger</wrap>, <wrap warning>warning</wrap>, <wrap caution>caution</wrap>, <wrap notice>notice</wrap>, <wrap safety>safety</wrap>.
  <wrap info>info</wrap>, <wrap help>help</wrap>, ...

==== Marks ====

You can mark text as <wrap hi>highlighted</wrap>, <wrap lo>less significant</wrap> and <wrap em>especially emphasised</wrap>.

  You can mark text as <wrap hi>highlighted</wrap>, <wrap lo>less significant</wrap> and <wrap em>especially emphasised</wrap>.

:!: This might look ugly in some templates and should be adjusted accordingly.

==== Miscellaneous ====

=== Indent ===

<wrap indent>This text will appear indented.</wrap>

  <wrap indent>This text will appear indented.</wrap>

=== Outdent ===

<wrap outdent>This text will appear "outdented".</wrap>

  <wrap outdent>This text will appear "outdented".</wrap>

=== Prewrap ===

<WRAP prewrap 250px>
<code>
Inside this code block the words will wrap to a new line although they are all in one line.
</code>
</WRAP>

  <WRAP prewrap 250px>
  <code>
  Inside this code block the words will wrap to a new line although they are all in one line.
  </code>
  </WRAP>

=== Spoiler ===

Here follows a spoiler: <wrap spoiler>Darth Vader is Luke's father.</wrap>

  Here follows a spoiler: <wrap spoiler>Darth Vader is Luke's father.</wrap>

Just select the text in the spoiler box to be able to read its content.

=== Hide ===

The following text is hidden: <wrap hide>John, please revise that sentence.</wrap>

  The following text is hidden: <wrap hide>John, please revise that sentence.</wrap>

:!: Warning: The text will still appear in the source code, in non-modern browsers and is searchable. Do not hide any security risky secrets with it!

=== Pagebreak ===

The following will add a pagebreak: <WRAP pagebreak></WRAP>

  The following will add a pagebreak: <WRAP pagebreak></WRAP>

This has no effect on the browser screen. A [[http://reference.sitepoint.com/css/page-break-after|pagebreak]] will force a new page in printouts.

=== Nopagebreak ===

The following will try to avoid a pagebreak: <WRAP nopagebreak>much content, belonging together (like a long table)</WRAP>

  The following will try to avoid a pagebreak: <WRAP nopagebreak>much content, belonging together (like a long table)</WRAP>

This also has no effect on the browser screen. It will try to [[http://reference.sitepoint.com/css/page-break-inside|avoid a page break]] in printouts.

=== Noprint ===

<wrap noprint>This text appears on the screen, but not in print.</wrap>

  <wrap noprint>This text appears on the screen, but not in print.</wrap>

=== Onlyprint ===

<wrap onlyprint>This text does not appear on the screen, but only in print.</wrap>

  <wrap onlyprint>This text does not appear on the screen, but only in print.</wrap>

==== Typography ====

I advice against using the following typography classes. It's better to create semantic classes that reflect their meaning instead.

  * font family: ''sansserif'', ''serif'', ''monospace''
  * font size: ''bigger'', ''muchbigger'', ''smaller''
  * font colour: ''fgred'', ''fggreen'', ''fgblue'', ''fgcyan'', ''fgviolet'', ''fgyellow'', ''fggrey'', ''fgwhite'', ''fgblack''
  * background colour: ''bgred'', ''bggreen'', ''bgblue'', ''bgcyan'', ''bgviolet'', ''bgyellow'', ''bggrey'', ''bgwhite'', ''bgblack''


==== Combining and Nesting ====

You can combine and nest all classes and types of boxes, e.g.

<WRAP box bggreen fgblack 350px right :en>
//**__Outer green box floats right__**//

<WRAP 165px left>
Inner nested box floats left and is partly <wrap em hi>__em__phasized and __hi__ghlighted with nested <wrap bigger>__bigger__ text</wrap> inside</wrap>.
</WRAP>

Text inside outer right box, but beneath inner left box.

<WRAP clear></WRAP>

<WRAP round tip>
Round tip box underneath, after a ''clear''.
</WRAP>

</WRAP>


<code>
<WRAP box bggreen fgblack 350px right :en>
//**__Outer green box floats right__**//

<WRAP 165px left>
Inner nested box floats left and is partly <wrap em hi>__em__phasized and __hi__ghlighted with nested <wrap bigger>__bigger__ text</wrap> inside</wrap>.
</WRAP>

Text inside outer right box, but beneath inner left box.

<WRAP clear></WRAP>

<WRAP round tip>
Round tip box underneath, after a ''clear''.
</WRAP>

</WRAP>
</code>


===== 6.3 Language and Text Direction =====

You can change the language and the reading direction of a wrap container by simply adding a colon followed by the language code, like this:

<code>
<WRAP :he>
זה עברית. ((<wrap :en>This means "This is Hebrew.", at least according to [[http://translate.google.com/|Google Translate]].</wrap>))
</WRAP>
</code>

<WRAP :he>
זה עברית. ((<wrap :en>This means "This is Hebrew.", at least according to [[http://translate.google.com/|Google Translate]].</wrap>))
</WRAP>

The text direction (''rtl'', right to left or ''ltr'', left to right) will get inserted automatically and is solely dependent on the language. The list of currently supported languages is taken from: http://meta.wikimedia.org/wiki/Template:List_of_language_names_ordered_by_code
(If you specify a language not listed there, it simply won't do anything.)

====== 7 sonstige Formatierungen ======

===== 7.1 horizontale Linie =====
Mit vier aufeinander folgenden Minuszeichen (alleine in einer Zeile) kann eine horizontale Linie erzeugt werden:
----
<nowiki>----</nowiki>


===== 7.2 Smileys =====

DokuWiki verwandelt oft genutzte [[wpde>Emoticon]]s zu kleinen Smiley-Grafiken.
Weitere Smiley-Grafiken können im Ordner "smily" abgelegt und dann in der Datei ''conf/smileys.conf'' bzw. für benutzereigene Smileys unter ''conf/smileys.local.conf'' eingetragen werden.
Hier ist nun eine Übersicht der standardmäßig in DokuWiki enthaltenen Smileys:

^  8-)  ^  8-O  ^  :-(  ^  :-)  ^  =)  ^  :-/  ^  :-\  ^  :-?  ^  :-D  ^  :-P  ^  :-O  ^  :-X  ^  :-|  ^  ;-)  ^  :?:  ^  :!:  ^  ''^_^''  ^  LOL  ^  FIXME  ^  DELETEME  ^
|  %%  8-)  %%  |  %%  8-O  %%  |  %%  :-(  %%  |  %%  :-)  %%  |  %%  =)   %%  |  %%  :-/  %%  |  %%  :-\  %%  |  %%  :-?  %%  |  %%  :-D  %%  |  %%  :-P  %%  |  %%  :-O  %%  |  %%  :-X  %%  |  %%  :-|  %%  |  %%  ;-)  %%  |  %%  :?:  %%  |  %%  :!:  %%  |  %%  ^_^  %%  |  %%  LOL  %%  |  %%  FIXME  %%  |  %% DELETEME  %%  |

===== 7.3 Typografie =====

[[DokuWiki]] kann einfache Textzeichen in ihre typografischen Entsprechungen umwandeln.
Hier eine Liste aller Zeichen, die DokuWiki kennt:

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
</code>

Bitte beachtet: Diese Umwandlungen können in der Konfigurationsdatei abgestellt werden

===== 7.4 HTML und PHP einbinden =====

In einer Seite kann sowohl HTML als auch PHP direkt benutzt werden.

<html>
This is some <font color="red" size="+1">HTML-Code</font>
</html>

<code>
<html>
This is some <font color="red" size="+1">HTML-Code</font>
</html>
</code>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

<code>
<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
</code>

**Achtung**: Das Einbinden von HTML und PHP in einer Seite kann in der Konfigurationsdatei ausgeschaltet werden((Konfigurationsoptionen [[config:htmlok]] bzw. [[config:phpok]])). Ist diese Option aktiviert, wird der Quellcode dieser Abschnitte als Text angezeigt und nicht ausgeführt.

**Achtung**: Das Einbinden von HTML und PHP auf einer Seite im Internet ist gewöhnlich ein schweres Sicherheitsrisiko! Diese Funktion ist nur für das Intranet gedacht!

====== 8 Kontroll-Makros ======

Einige Syntax-Befehle beeinflussen wie Dokuwiki eine Seite beim Aufruf ausgibt. Die folgenden Kontroll-Makros sind verfügbar:

^ Makro          ^ Beschreibung ^
| %%~~NOTOC~~%%   | Wenn dieses Makro in eine Seite eingebunden ist, wird das automatische Inhaltsverzeichnis (//Table of Content// - TOC) nicht erstellt.|
| %%~~NOCACHE~~%% | Alle Seiten werden aus Performancegründen zwischengespeichert. Unter bestimmten Umständen ist dieses Verhalten aber nicht gewollt. Beim Einfügen dieses Makros wird DokuWiki angewiesen, den Inhalt der Seite neu aufzubauen. |

----
====== 9 Syntax-Plugins ======
Die Syntax von DokuWiki kann durch [[doku>plugins|Plugins]] erweitert werden. Wie die einzelnen Plugins benutzt werden, steht auf den zugehörigen Beschreibungsseiten. Die folgenden Plugins sind auf dieser DokuWiki Installation verfügbar:

~~INFO:syntaxplugins~~
Aktion 23 Wniki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
