Benutzer-Werkzeuge


Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
wiki:syntax [2019/10/01 13:55] cbuehlerwiki:syntax [2025/01/07 16:26] (aktuell) – Externe Bearbeitung 127.0.0.1
Zeile 1: Zeile 1:
-====== Syntax ======+====== Formatting Syntax ======
  
-[[DokuWiki]] zeichnet sich uadurch einfache Textformatierungen ausDadurch bleiben die Dateiendie den Inhalt enthalten, gut lesbar +[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possibleThis page contains all possible syntax you may use when editing the pagesSimply have a look at the source of this page by pressing "Edit this page"If you want to try somethingjust use the [[playground:playground|playground]] pageThe simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
-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 duwenn du dir diese Seite im Quelltext-Modus anzeigen lässt. Klicke dazu auf den Button "Vorschau"+
  
-Zum  Ausprobieren oder Üben kann die [[playground:playground|Spielwiese]] verwendet werden.+===== Basic Text Formatting =====
  
 +DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
  
-====== 1 Texte ====== +  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. 
-===== 1.1 Formatierungen =====+  Of course you can **__//''combine''//__** all these.
  
-DokuWiki unterstützt **fetten**, //kursiven//, __unterstrichenen__ und ''dicktengleichen'' ([[wpde>Dickte|Dickte]]) Text. Natürlich kann auch alles **__//''kombiniert''//__** werden.+You can use <sub>subscript</sub> and <sup>superscript</sup>too.
  
-  DokuWiki unterstützt **fetten**, //kursiven//, __unterstrichenen__ und ''dicktengleichen'' Text.  +  You can use <sub>subscript</sub> and <sup>superscript</sup>too.
-  Natürlich kann auch alles **__//''kombiniert''//__** werden.+
  
-Ebenso gibt es <sub>tiefgestellten</subund <sup>hochgestellten</sup> Text.+You can mark something as <del>deleted</delas well.
  
-  Ebenso gibt es <sub>tiefgestellten</subund <sup>hochgestellten</sup> Text.+  You can mark something as <del>deleted</delas well.
  
-Text kann als <del>gelöscht</del>((wer das Tag "eingefügt" (%%<ins>%%) benötigtkann dies über Plugins realisieren. Siehe ganz unten!)) markiert werden.+**Paragraphs** are created from blank linesIf you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
  
-  Text kann als <del>gelöscht</del> markiert werden.+This is some text with some linebreaks\\ Note that the 
 +two backslashes are only recognized at the end of a line\\ 
 +or followed by\\ a whitespace \\this happens without it.
  
-===== 1.2 Absätze =====+  This is some text with some linebreaks\\ Note that the 
 +  two backslashes are only recognized at the end of a line\\ 
 +  or followed by\\ a whitespace \\this happens without it.
  
-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.+You should use forced newlines only if really needed.
  
-Dies ist ein Beispieltext mit einigen Zeilenumbrüchen.\\ Beachte: Die zwei umgekehrten Schrägstriche +===== Links =====
-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 +DokuWiki supports multiple ways of creating links.
-  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.+==== External ====
  
-===== 1.3 Überschriften ===== +External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <andi@splitbrain.org> are recognizedtoo.
-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 EbeneAm einfachsten ist es zur Erzeugung der Überschriften, die Symbolleiste zu verwendenDas Einfügen der Überschriften erfolgt über die Buttonsdie ein "H" anzeigen+
  
-Es ist __sinnvoll__wenn immer eine Level 1 Überschrift am Anfang eines Artikels steht.+  DokuWiki supports multiple ways of creating links. External links are recognized 
 +  automagically: http://www.google.com or simply www.google.com - You can set 
 +  link text as well: [[http://www.google.com|This Link points to google]]. Email 
 +  addresses like this one: <andi@splitbrain.org> are recognizedtoo.
  
-Wenn in einer Seite mehr als drei Überschriften vorkommen, wird automatisch ein Inhaltsverzeichnis erstellt, welches alle Überschriften auflistet. +==== Internal ====
-Soll dieses Inhaltsverzeichnis nicht erstellt werden, muss der Befehl: ''<nowiki>~~NOTOC~~</nowiki>'' mit in die Seite aufgenommen werden.+
  
-  ====== Überschrift Ebene 1 ====== +Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
-  ===== Ü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]])+  Internal links are created by using square bracketsYou can either just give 
 +  a [[pagename]] or use an additional [[pagename|link text]].
  
-===== 1.4 unformatierte Abschnitte =====+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
  
-Um Text so anzuzeigen, wie er geschrieben wurde, egal ob er DokuWiki Formatierungen oder andere Formatierungen enthält, kann man jede +You can use [[some:namespaces]] by using a colon in the pagename.
-Zeile mit zwei Leerzeichen beginnen (so wie es in dieser Seite angewendet wurde) oder einen der Bezeichner "code" bzw"file" benutzen:+
  
-<code> +  You can use [[some:namespaces]] by using a colon in the pagename.
-Mit "code"In diesem Text werden keine überflüssigen Leerzeichen entfernt: wie hier              <-- zwischen +
-</code>+
  
 +For details about namespaces see [[doku>namespaces]].
  
-  <file plain Beispiel.txt> +Linking to a specific section is possible, tooJust add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
-  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.+  This links to [[syntax#internal|this Section]].
  
-<file perl HelloWorld.pl> +Notes:
-#!/usr/bin/perl +
-print "Hello World!\n"; +
-</file>+
  
-  <file perl HelloWorld.pl> +  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones
-  #!/usr/bin/perl +  * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled. 
-  print "Hello World!\n"; +  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
-  </file>+
  
-Um jegliche Umwandlung durch DokuWiki abzustellen, umschließe den entsprechenden Bereich mit "nowiki" Bezeichnern oder kürzer mit doppelten Prozentzeichen ''<nowiki>%%</nowiki>''.+==== Interwiki ====
  
-<nowiki> +DokuWiki supports [[doku>Interwiki]] linksThese are quick links to other WikisFor example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
-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".+  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. 
 +  For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
  
-"Dieser Text enthält links wie: http://www.splitbrain.org und **Formatierungen** aber sie werden nicht umgesetzt und erscheinen als normaler Text."%%+==== Windows Shares ====
  
-Einfach den Quelltext dieser Seite anschauen (den Knopf "Edit" drücken) um zu sehenwie diese Blöcke angewendet werden.+Windows shares like [[\\server\share|this]] are recognizedtoo. Please note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]].
  
-===== 1.5 Syntax-Hervorhebung =====+  Windows Shares like [[\\server\share|this]] are recognized, too.
  
-[[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. +Notes:
-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+  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). 
-/**  +  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php> 
- The HelloWorldApp class implements an application that +<?php 
- simply displays "Hello World!" to the standard output.+/** 
 + Customization of the english language file 
 + Copy only the strings that needs to be modified
  */  */
-class HelloWorldApp { +$lang['js']['nosmblinks'] = '';
-    public static void main(String[] args) { +
-        System.out.println("Hello World!")//Display the string. +
-    } +
-}+
 </code> </code>
  
-Es werden folgende Sprachen unterstützt: //actionscript, actionscript-french, ada, apache, applescript, asm, asp, bash, caddcl, cadlisp, **c**, c_mac, cpp, csharp, css, **delphi**, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, **java**, javascript, lisp, lua, matlab, mpasm, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, **php**, python, qbasic, scheme, sdlbasic, smarty, **sql**, ruby, vb, vbnet, vhdl, visualfoxpro, **xml**//+==== Image Links ====
  
-===== 1.6 Zitat / Kommentar ===== +You can also use an image to link to another internal or external page by combining the syntax for links and [[#images_and_other_files|images]] (see below) like this:
-Um einen Text als Zitat oder Kommentar zu kennzeichnen, wird das "größer als" - Zeichen folgendermaßen verwendet:+
  
-  Ich denke wir sollten es tun. +  [[http://php.net|{{wiki:dokuwiki-128.png}}]]
-   +
-  > 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+[[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-> Nein, sollten wir nicht.+Please note: The image formatting is the only formatting syntax accepted in link names.
  
->> Doch!+The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).
  
-> Wirklich?+===== Footnotes =====
  
->> Ja!+You can add footnotes ((This is a footnote)) by using double parentheses.
  
->>> Dann lass es uns tun+  You can add footnotes ((This is a footnote)) by using double parentheses.
  
->>> 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 +===== Sectioning =====
-  +
-===== 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 =====+You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document.
  
-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. +==== Headline Level 3 ==== 
 +=== Headline Level 4 === 
 +== Headline Level 5 ==
  
-  Fußnoten ((dies ist eine Fußnote)) werden durch eine doppelte runde Klammer dargestellt ((eine zweite Fußnote)) +  ==== Headline Level 3 ==== 
-   +  === Headline Level 4 === 
-===== 1.9 Linien =====+  == Headline Level 5 ==
  
-Durch vier oder mehr Bindestriche bzw. Minuszeichen "-" wird eine horizontale Linie erzeugt: +By using four or more dashes, you can make a horizontal line:
------+
  
 +----
  
 +===== Media Files =====
  
 +You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-====== 2 Links ======+Real size:                        {{wiki:dokuwiki-128.png}}
  
-Mit DokuWiki können fünf unterschiedliche Arten von Links benutzt werden:+Resize to given width           {{wiki:dokuwiki-128.png?50}}
  
-===== 2.1 Extern =====+Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}}
  
-Externe Links (Verweise auf andere Webseiten oder Dateien) werden automatisch erkannthttp://www.google.com oder einfach www.google.com. +Resized external image          {{https://www.php.net/images/php.gif?200x50}}
-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 erkannthttp://www.google.com oder einfach www.google.com+  Real size                       {{wiki:dokuwiki-128.png}} 
-  Verweise können auch hinter eigenen Begriffen versteckt werden[[http://www.google.com|hier ist google]]. +  Resize to given width:            {{wiki:dokuwiki-128.png?50}} 
-  E-Mail Adressen werden in spitze Klammern gesetzt: <andi@splitbrain.org>.+  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}} 
 +  Resized external image          {{https://www.php.net/images/php.gif?200x50}}
  
-===== 2.2 Intern ===== 
  
-Interne Links, also Verweise auf Seiten innerhalb von DokuWiki, werden in doppelten eckigen Klammern gesetzt ("Alt Gr+8" bzwAlt Gr+9 unter Windows bzw. Wahltaste+5 und Wahltaste+6 bei Apple-Betriebssystemen): +By using left or right whitespaces you can choose the alignment.
-[[doku>pagename]]+
  
-Ein Link kann auch hinter einem Begriff oder einer Beschreibung versteckt werden: +{{ wiki:dokuwiki-128.png}}
-[[pagename|Beschreibung für einen Link]].+
  
-  Interne Links werden in doppelten eckigen Klammern gesetzt: +{{wiki:dokuwiki-128.png }}
-  [[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! +{{ wiki:dokuwiki-128.png }}
-Umlaute sind genauso wie Sonderzeichen nicht erlaubt!+
  
-Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst[[de:namespaces]] +  {{ wiki:dokuwiki-128.png}} 
 +  {{wiki:dokuwiki-128.png }} 
 +  {{ wiki:dokuwiki-128.png }}
  
-  Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst:[[de:namespaces]] +Of course, you can add a title (displayed as a tooltip by most browsers), too.
  
-Weitere Informationen zu Namensbereichen[[doku>de:namespaces]].+{{ wiki:dokuwiki-128.png |This is the caption}}
  
-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+  {{ wiki:dokuwiki-128.png |This is the caption}}
  
-Dieses Beispiel verlinkt zu [[de:wiki:syntax#intern|diesem Abschnitt]].+For linking an image to another page see [[#Image Links]] above.
  
-  Dieses Beispiel verlinkt zu [[de:wiki:syntax#intern|diesem Abschnitt]].+==== Supported Media Formats ====
  
 +DokuWiki can embed the following media formats directly.
  
-Anmerkungen:+| Image | ''gif'', ''jpg'', ''png'' 
 +| Video | ''webm'', ''ogv'', ''mp4''
 +| Audio | ''ogg'', ''mp3'', ''wav'' 
 +| Flash | ''swf''                    |
  
-  * Links zu [[syntax|existierenden Seiten]] werden anders angezeigt als Links zu [[nicht-existierenden]] Seiten. +If you specify a filename that is not a supported media formatthen it will be displayed as a link instead.
-  * 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 wirddann 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 =====+By adding ''?linkonly'' you provide a link to the media without displaying it inline
  
-DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links. +  {{wiki:dokuwiki-128.png?linkonly}}
-Ein Link zur Wikipedia Seite über Wikis:[[wpde>Wiki]]+
  
-  DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links. +{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
-  Ein Link zur Wikipedia Seite über Wikis:[[wpde>Wiki]]+
  
-===== 2.4 Windows-Freigaben =====+==== Fallback Formats ====
  
-DokuWiki kennt auch Links auf Windows-Freigaben: [[\\server\freigabe|freigegebener-Ordner]]. +Unfortunately not all browsers understand all video and audio formatsTo mitigate the problem, you can upload your file in different formats for maximum browser compatibility.
-Dies ist allerdings nur in einer homogenen Benutzergruppe sinnvoll (siehe [[wpde>Intranet]]).+
  
-  [[\\server\freigabe|this]].+For example consider this embedded mp4 video:
  
-Hinweis: +  {{video.mp4|A funny video}}
-  * 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 =====+When you upload a ''video.webm'' and ''video.ogv'' next to the referenced ''video.mp4'', DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.
  
-Bilder können für einen Link auf eine interne oder externe Datei verwendet werdenDazu wird die Syntax zur Anzeige von Links einfach mit der zur Anzeige von Bildern (siehe unten) kombiniert:+Additionally DokuWiki supports a "poster" image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''video.jpg'' file would work.
  
-   [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+===== Lists =====
  
-[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+Dokuwiki supports ordered and unordered listsTo create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.
  
-Bitte beachte: Bildformatierungen sind die einzigen Formatierungen, die in Linknamen benutzt werden können!+  * This is a list 
 +  * The second item 
 +    * You may have different levels 
 +  * Another item
  
-====== 3 Bilder und andere Dateien ====== +  - The same list but ordered 
- +  - Another item 
-===== 3.1 Bilder im DokuWiki speichern ===== +    Just use indention for deeper levels 
- +  - That's it
-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, jpg, 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> <code>
-  * Dies ist ein Eintrag einer unsortierten Liste +  * This is a list 
-  * Ein zweiter Eintrag +  * The second item 
-    * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen +    * You may have different levels 
-  * Noch ein Eintrag+  * Another item
  
-  - Dies ist ein Eintrag einer nummerierte Liste +  - The same list but ordered 
-  - Ein zweiter Eintrag +  - Another item 
-    - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen +    - Just use indention for deeper levels 
-  - Noch ein Eintrag+  - That's it
 </code> </code>
  
-====== 5 Tabellen ======+Also take a look at the [[doku>faq:lists|FAQ on list items]].
  
-===== 5.1 Grundlegender Aufbau =====+===== Text Conversions =====
  
-Mit DokuWiki können Tabellen ganz einfach erstellt werden: +DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.
  
-^ hervorgehoben     ^ zum Beispiel für                                                   ^ eine Titelzeile   ^ +The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, but can be configured to use other HTML as well.
-| 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  |                                                                    | Zeile 4 Spalte 3  |+
  
-Felder einer Tabelle starten mit "|" für ein normales Feld oder mit einem "^" für hervorgehobenes Feld.+==== Text to Image Conversions ====
  
-  ^ hervorgehoben       ^ zum Beispiel für                                                  ^ eine Titelzeile         ^ +DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:
-  | 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 =====+  * 8-) %%  8-)  %% 
 +  * 8-O %%  8-O  %% 
 +  * :-( %%  :-(  %% 
 +  * :-) %%  :-)  %% 
 +  * =)  %%  =)   %% 
 +  * :-%%  :-/  %% 
 +  * :-\ %%  :-\  %% 
 +  * :-? %%  :-?  %% 
 +  * :-D %%  :-D  %% 
 +  * :-P %%  :-P  %% 
 +  * :-O %%  :-O  %% 
 +  * :-X %%  :-X  %% 
 +  * :-| %%  :-|  %% 
 +  * ;-) %%  ;-)  %% 
 +  * ^_^ %%  ^_^  %% 
 +  * m(  %%  m(   %% 
 +  * :?: %%  :?:  %% 
 +  * :!: %%  :!:  %% 
 +  * LOL %%  LOL  %% 
 +  * FIXME %%  FIXME %% 
 +  * DELETEME %% DELETEME %%
  
-=== Leerzellen ===+==== Text to HTML Conversions ====
  
-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. +Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entitiesHere is an example of recognized characters.
-Kurz gesagtAlle 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"+
- +
-====== 6 sonstige Formatierungen ====== +
- +
-===== 6.1 horizontale Linie ===== +
-Mit vier aufeinander folgenden Minuszeichen (alleine in einer Zeile) kann eine horizontale Linie erzeugt werden: +
----- +
-<nowiki>----</nowiki> +
- +
- +
-===== 6.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  %%  | +
- +
-===== 6.3 Typografie ===== +
- +
-[[DokuWiki]] kann einfache Textzeichen in ihre typografischen Entsprechungen umwandeln. +
-Hier eine Liste aller Zeichen, die DokuWiki kennt:+
  
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
Zeile 463: Zeile 266:
 </code> </code>
  
-Bitte beachtet: Diese Umwandlungen können in der Konfigurationsdatei abgestellt werden+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
  
-===== 6.4 HTML und PHP einbinden =====+There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]].
  
-In einer Seite kann sowohl HTML als auch PHP direkt benutzt werden.+===== Quoting =====
  
-<html> +Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
-This is some <font color="red" size="+1">HTML-Code</font> +
-</html>+
  
 <code> <code>
-<html> +I think we should do it
-This is some <font color="red" size="+1">HTML-Code</font> +
-</html> +
-</code>+
  
-<code> +No we shouldn't
-<php> +
-echo 'A logo generated by PHP:'; +
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +
-</php> +
-</code>+
  
-<code> +>> Well, I say we should
-<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.+> Really?
  
-**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!+>> Yes!
  
-====== 7 Kontroll-Makros ====== +>>> Then lets do it!
- +
-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 [[:toc|Table of Content]] 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. | +
- +
----- +
-====== 8 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~~ +
- +
-====== 9 Color Plugin ====== +
- +
-Platzieren Sie dieses Code-Beispiel auf Ihrer Testumgebung: +
- +
-<code> +
-<color green>Text</color> +
-<color blue/lightgrey>Text</color> +
-<color #FF0000>Text</color> +
-<color /#FFff00>Text</color> +
-<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>text</color> +
-<color hsl(120,100%,30%)/hsl(180,50%,90%)>text</color>+
 </code> </code>
  
-folgendes Ergebnis sollte dann zu sehen sein:+I think we should do it
  
-{{https://folk.ntnu.no/hanche/tmp/dokuwiki_color_plugin.png|Color Plugin in Aktion}}+> No we shouldn't
  
-Dieses Plugin unterstützt die [[wp>X11_color_names#Color_name_chart|X11 color names]], +>> Well, I say we should
-Hex-Dreifache (wie #123 oder #123456 für RGB), +
-Hex-Vierfach (#1234 oder #12345678 für RGBA), +
-[[https://developer.mozilla.org/en-US/docs/Web/CSS/color_value|rgb, rgba, hsl und hsla]] +
-Farbspezifikationen. +
-Dieses Plugin kann keine Syntaxfehler in Ihren Farbspezifikationen erkennen. +
-Wenn Sie diese Spezifikationen falsch verwenden, werden Sie nicht funktionieren. +
-Beachten Siedass nicht alle Farbspezifikationen auf allen Browsern funktionieren. +
-Überprüfen Sie im Zweifelsfall [[https://caniuse.com/|Can Use]].+
  
-====== 10 Zellen Hintergrund Plugin ======+> Really?
  
-===== 10.1 Syntax und Verwendung =====+>> Yes!
  
-Eine Hintergrundfarbe wird durch "@" eingeleitet und durch ":" beendet.  +>>> Then lets do it!
-Sie können alle Namen und Farbcodes aus HTML verwenden.  +
-Wenn Sie keine Farbe angeben, wird Gelb verwendet.  +
-Siehe Beispiele unten:+
  
-===== 10.2 Beispiele =====+===== Tables =====
  
-Dieser Code: +DokuWiki supports a simple syntax to create tables.
-<code> +
-^  Header 1          Header 2  ^  Header 3        ^ +
-|  @lightgreen:**Span**         ||                  | +
-|  @#6495ed:Ligne 1 |  Oui        Oui, à valider +
-|  Ligne 2          |  Oui        @orange: Oui    | +
-|  @:Ligne 3        |  Oui       | @red:Non         | +
-</code> +
-erzeugt folgendes: \\  +
-^  Header 1          Header 2  ^  Header 3        ^ +
-|  @lightgreen:**Span**         ||                  | +
-|  @#6495ed:Ligne 1 |  Oui        Oui, à valider +
-|  Ligne 2          |  Oui        @orange: Oui    | +
-|  @:Ligne 3        |  Oui       | @red:Non         |+
  
-Dieser Code: +^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-<code> +Row 1 Col 1    Row 1 Col 2     Row 1 Col 3        
- @palegreen:Validé   @orange:À valider   @red:Non fonctionnel  +| Row 2 Col 1    | some colspan (note the double pipe) || 
-</code> +Row 3 Col 1    Row 3 Col 2     Row 3 Col 3        |
-dieses Ergebnis: \\  +
- @palegreen:Validé   @orange:À valider   @red:Non fonctionnel  |+
  
-===== 10.3 Features ===== +Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.
-   * Uses HTML color codes and names [[http://html-color-codes.info/|HTML Color Code Chart]] +
-   * Works with other table formatting (alignment, bold, ...)+
  
-====== 11 Table Width Plugin ======+  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
 +  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
 +  | Row 2 Col 1    | some colspan (note the double pipe) || 
 +  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
  
-===== 11.1 Syntax =====+To connect cells horizontally, just make the next cell completely empty as shown aboveBe sure to have always the same amount of cell separators!
  
-The width has to be specified at the start of a line before the table. The first value is used as width of the tablethe rest is for columns. If you want to omit some value use a dash insteadThe widths can be specified in any CSS units:+Vertical tableheaders are possibletoo.
  
-<code> +             Heading 1            Heading 2          
-|< 100% 50px - 5em 10em 10% >| +^ Heading 3    Row Col          Row 1 Col        | 
-A    ^  C  ^  D  ^  E  +^ Heading    no colspan this time |                    
-| 1  |        5  +^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
-</code>+
  
-The relative units (percentage) for the table width refer to the width of the pageand when used for columns they refer for the table wight. For example, the width specification ''|< 50% 50% 50% >|'' makes the table half width of the page and two equal columns quarter of the page width each.+As you can seeit'the cell separator before a cell which decides about the formatting:
  
-If there are more columns in the table than there are values in the width specification, the width will be applied to the columns from left to right:+  |              ^ Heading 1            ^ Heading 2          ^ 
 +  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
 +  ^ Heading 4    | no colspan this time |                    | 
 +  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
  
-<code> +You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect.
-|< 50em 20>| +
-^ 20             ^ 80                         ^ +
-| Specified width  | The rest of the table width  | +
-</code>+
  
-====== 12 Wrap Plugin ======+^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +| Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +| Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-Universal plugin which combines the functionality of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.+Apart from the rowspan syntax those cells should not contain anything else.
  
-===== 12.One plugin to rule them all =====+  ^ Heading      ^ Heading 2                  ^ Heading 3          ^ 
 +  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +  | Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +  | Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-This plugin gives you the ability to wrap wiki text inside containers (divs or spans) and give them +You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.
-  - a certain class (with loads of useful preset classes) +
-  - a width +
-  - a language with its associated text direction+
  
-It potentially replaces a lot of other plugins and is IMHO the better alternative for many.+^           Table with alignment           ^^^ 
 +|         right|    center    |left          | 
 +|left          |         right|    center    | 
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-It fully replaces[[class]], [[clearfloat]], [[div_span_shorthand]], [[divalign2]], [[divalign]], [[emphasis]], [[hide]], [[important_paragraf]], [[importanttext]], [[lang]], [[ltr]], [[noprint]], [[pagebreak]], [[side_note]], [[tip]], [[wpre]]+This is how it looks in the source:
  
-It partly replaces: [[box]], [[button]], [[color]], [[columns]], [[fontcolor]], [[fontfamily]], [[fontsize2]], [[fontsize]], [[highlight]], [[layout]], [[note]], [[styler]], [[tab]], [[tablewidth]], [[typography]]+  ^           Table with alignment           ^^^ 
 +  |         right|    center    |left          | 
 +  |left          |         right|    center    | 
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-===== 12.2 Syntax =====+Note: Vertical alignment is not supported.
  
-Basic Syntax: +===== No Formatting =====
-  <WRAP classes #id width :language> +
-  "big" content +
-  </WRAP> +
-   +
-  **or** +
-  <block classes #id width :language> +
-  "big" content +
-  </block> +
-   +
-  or +
-  <div classes #id width :language> +
-  "big" content +
-  </div> +
-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 #id width :language>"small" content</wrap> +
-   +
-  or +
-  <inline classes #id width :language>"small" content</inline> +
-   +
-  or +
-  <span classes #id width :language>"small" content</span> +
-A lowercase **%%<wrap>%%** (or alternatively **%%<inline>%%** or **%%<span>%%**) creates a **''span''** and should be used for **"small"** containers, **inside** paragraphs, lists, tables, etc.+
  
-Since version 2013-06-13 there is also a shorthand syntax (for wraps without content):+If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.
  
-  <WRAP classes #id /or <block classes #id /> or <div classes #id />+<nowiki> 
 +This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. 
 +</nowiki> 
 +The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-and+  <nowiki> 
 +  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. 
 +  </nowiki> 
 +  The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-  <wrap classes #id /> or <inline classes #id /> or <span classes #id />+===== Code Blocks =====
  
-:!: Please note, some things **won't work with spans**: **alignments** (including alignments generated by changing the text direction), **multi-columns** and **widths** if the according wrap isn't floated as well.+You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examplesor by using the tags ''%%<code>%%'' or ''%%<file>%%''.
  
-==== 12.2.1 Examples ====+  This is text is indented by two spaces.
  
-The plugin comes with an example page, which should explain a lot and looks like this in the default template (see below).+<code> 
 +This is preformatted code all spaces are preserved: like              <-this 
 +</code>
  
-==== 12.2.2 Classes ====+<file> 
 +This is pretty much the same, but you could use it to show that you quoted a file. 
 +</file>
  
-The following classes are currently available:+Those blocks were created by this source:
  
-{{ :wrap_plugin_example10.png?300&direct}}+    This is text is indented by two spaces.
  
-^ class name  ^ description/notes +  <code
-^ __columns__ -- similar to [[columns]], [[side_note]], [[styler]], [[tip]]  || +  This is preformatted code all spaces are preserved: like              <-this 
-| **''column''**  | same as ''left'' in LTR languages and same as ''right'' in RTL languages +  </code>
-| **''left''**  | same as ''column'', will let you float your container on the left  | +
-| **''right''**  | will let the container float right  | +
-| **''center''**  | will position the container in the horizontal center of the page  | +
-| **''col2''**..**''col5''**  | will show the text in multiple columns determined by their amount (2, 3, 4 or 5), only works in modern browsers (no IE9 and below) +
-| **''colsmall''**, **''colmedium''**, **''collarge''**  | will also show the text in multiple columns but determined by their width (small, medium or large), only works in modern browsers (no IE9 and below) +
-^ __widths__ -- :!: **experimental**, might not work as expected, includes mobile support  || +
-| **''half''**  | fits two columns in a row, should be used in pairs  | +
-| **''third''**  | fits three or two columns in a row, should be used in triplets or together with ''twothirds'' +
-| **''twothirds''**  | fits two columns in a row when used together with ''third'', one 1/3 wide and another 2/3 wide  | +
-| **''quarter''**  | fits four columns in a row, should be used in quads  | +
-^ __alignments__ -- similar to [[divalign]], [[columns]], [[styler]] -- :!: don't work with spans!  || +
-| **''leftalign''**  | aligns text on the left  | +
-| **''rightalign''**  | aligns text on the right  | +
-| **''centeralign''**  | centers the text  | +
-| **''justify''**  | justifies the text  | +
-^ __boxes and notes__ -- similar to [[box]], [[note]], [[tip]]  || +
-| **''box''**  | creates a box around the container (uses colours from ''style.ini''+
-| **''info''** (was ''information'' in first version)  | creates a blue box with an info icon  | +
-| **''important''**  | creates an orange box with an important icon  | +
-| **''alert''** (:!: was ''warning'' in previous versions)  | creates a red box with an alert icon  | +
-| **''tip''**  | creates a yellow box with a tip icon  | +
-| **''help''**  | creates a violet box with a help icon  | +
-| **''todo''**  | creates a cyan box with an todo icon  | +
-| **''download''**  | creates a green box with a download icon  | +
-| **''round''**  | adds rounded corners to any container with a background colour or a border (only works in modern browsers, i.e. no IE)  | +
-| **''danger''**  | creates a red danger safety note  | +
-| **''warning''**  | creates an orange warning safety note  | +
-| **''caution''**  | creates a yellow caution safety note  | +
-| **''notice''**  | creates a blue notice safety note  | +
-| **''safety''**  | creates a green safety note  | +
-^ __marks__ -- similar to [[emphasis]], [[important_paragraf]], [[importanttext]]  || +
-| **''hi''**  | marks text as highlighted +
-| **''lo''**  | marks text as less significant +
-| **''em''**  | marks text as especially emphasised +
-^ __miscellaneous__  || +
-| **''clear''**  | similar to [[clearfloat]], should preferably be used with divs, i.e. uppercase ''%%<WRAP>%%'' | +
-| **''tabs''**  | if wrapped around a list of links, will show those as tabs  | +
-| **''hide''**  | hides the text per CSS (the text will still appear in the source code, in non-modern browsers and is searchable)  | +
-| **''noprint''**  | displays text on the screen, but not in print, similar to [[noprint]] +
-| **''onlyprint''**  | displays text only in print, but not on the screen +
-| **''pagebreak''**  | forces a new page in printouts (not visible on the screen), similar to [[pagebreak]] +
-| **''nopagebreak''**  | tries to avoid a pagebreak in printouts (not visible on the screen) +
-| **''spoiler''**  | shows white text on a white background, only to be revealed by highlighting it; similar to [[hide]] +
-| **''button''**  | when wrapped around a link, styles it like a button +
-| **''tablewidth''**  | sets widths of tables inside to whichever width the wrap gets, partly replaces [[tablewidth]] +
-| **''indent''**  | indents the text, could be used instead of [[tab]] +
-| **''outdent''**  | "outdents" the text, could partly be used instead of [[outdent]] +
-| **''prewrap''**  | wraps text inside pre-formatted code blocks, similar to [[wpre]]  |+
  
-=== 12.2.2.1 Known restrictions ===+  <file> 
 +  This is pretty much the same, but you could use it to show that you quoted a file. 
 +  </file>
  
-  * WRAPs export to ODT format but not everything works 100% +==== Syntax Highlighting ====
-  * Round corners only work in modern browsers (no IE8 and below). +
-  * Multiple columns only work in modern browsers (no IE9 and below). +
-  * Width classes are experimental and only work in modern browsers (no IE8 and below). +
-  * Normal DokuWiki Headlines used to not work and a work-around was added. Now that headlines do work, the work-around is not needed anymore but kept for backwards-compatibility. It was deprecated in version 2018-04-22 and disabled by default. They can be enabled by using the ''emulatedHeadlines'' [[#configuration_options|config option]]. The following syntax would then produce two different kinds of emulated headlines inside any wrap: +
-    * %%//**__Big Underlined Headline__**//%% (They will look a bit different in safety notes.) +
-    * %%//**Small Headline**//%%+
  
-You might need to adjust a few of the classes to your template's needsespecially ''hi'', ''lo'' and ''em''. If you have a dark or otherwise heavily coloured theme, please use the ''darkTpl'' [[#configuration_options|config option]].+[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tage.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
  
-The classes are easily adjustable and extensibleAny wishes are welcome.+<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>
  
-==== 12.2.3 Widths ====+The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic//
  
-You can set any valid widths on any uppercase %%<WRAP>%% container: ''%px, em, rem, ex, ch, vw, vh, pt, pc, cm, mm, in''. Just set the width before or after or with the classes, e.g. +There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlightingsuch as highlighting lines or adding line numbers.
-  <WRAP someclass 50% anotherclass>... +
-All except percentages will be reduced to have the maximum width available on smaller screens.+
  
-You can also use the width keywords ''half'', ''third'', ''twothirds'' and ''quarter''. To work correctly they need another wrap around them. E.g. +==== Downloadable Code Blocks ====
-  <WRAP group> +
-    <WRAP half column>...</WRAP> +
-    <WRAP half column>...</WRAP> +
-  </WRAP> +
-will result in two columns next to each other, which will wrap underneath each other on smaller screens and mobile devices.+
  
-==== 12.2.4 Languages and Text Directions ====+When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as wellYou can do this by specifying a file name after language code like this:
  
-You can change the language and the direction of a container by simply adding a colon followed by the language code, like this: +<code> 
- +<file php myexample.php
-  <wrap :en>This text is explicitly marked as English.</wrap+<?php echo "hello world!"; ?> 
- +</file>
-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 like to mark a text with a different text direction than the default one, you should use divs, i.e. uppercase ''%%<WRAP>%%''s. Otherwise the text alignment won't change as well. +
- +
-This makes it a better replacement of [[ltr]] (and [[lang]]). +
- +
-===== 12.3 Demo ===== +
- +
-You can see a demo of the plugin on [[http://demo.selfthinker.org/plugin:wrap|demo.selfthinker.org]]. +
- +
-[[https://yadi.sk/i/ycbENWFjWEduTA|“Examples” (demo) in Russian]] (for v2011-05-15). [[http://pastebin.com/C9xjaEH9|Source]]. +
- +
-===== 12.4 Configuration options ===== +
- +
-^ Option  ^ Description  ^ Default value ^ +
-|''noPrefix''  | Which (comma separated) class names should be excluded from being prefixed with "wrap_ (* and ? wildcards allowed) | tabs, group | +
-|''restrictedClasses'' | Restrict usage of plugin to these (comma separated) classes (* and ? wildcards allowed) | //(empty)// | +
-|''restrictionType''  | Restriction type, specifies if classes above shall be included or excluded | 0 | +
-|''syntaxDiv''  | Which syntax should be used in the toolbar picker for block wraps? | WRAP (other choices: div, block) | +
-|''syntaxSpan''  | Which syntax should be used in the toolbar picker for inline wraps? | wrap (other choices: span, inline) | +
-|''darkTpl''  | Optimise colours for dark templates? | 0 | +
-|''emulatedHeadlines''  | Use emulated headings? (deprecated) | 0 | +
- +
-===== 12.5 ODT Support ===== +
- +
-FIXME There have been more updates to the Wrap as well as the ODT plugin, so more stuff works. The below should be updated with what works and what doesn't. +
- +
-Since version 2015-06-13 the Wrap plugin supports exporting most of its functionality/styling to ODT when using at least version 2015-06-29 of the [[odt|ODT Plugin]]. By default, Wrap syntax will be exported to ODT using 'print' CSS styles. This means the exported Wrap elements will look the same when printing a wiki page. If you want to have the ODT exported Wrap elements look like displayed in the browser (i.e. with 'screen' CSS styles), then use the following ODT plugin configuration settings: +
- +
-  * add wrap to the 'usestyles' config setting +
-  * set the 'media_sel' setting to 'screen' +
- +
-If you prefer a user defined CSS style for the Wrap ODT export, then simply place a file 'odt.css' into the Wrap plugin folder with your own CSS code (and set config setting 'media_sel' to 'print'). +
- +
-Here is what is currently **not** supported: +
- +
-  * columns: left/right/center/column is partly supportedthey are positioned correctly, but content is not floating around them +
-  * widths are not supported except % and half/third/quarter +
-  * boxes and notes: hardly any formatting inside them is supported, therefore emulated headings also don't work +
-  * tabs will just show a list of links +
-  * noprint +
-  * nopagebreak +
-  * onlyprint only works on boxes +
-  * languages are set correctly but do not seem to affect text alignment +
-  * shorthand syntax +
-  * Not supported because not relevant in ODT: clear, prewrap +
- +
-===== 12.6 Toolbar picker ===== +
- +
-{{ :wrap_plugin_toolbar_picker.png?nolink}} +
- +
-The wrap picker in the editing toolbar adds the most common wrap syntaxes. +
- +
-  * "columns" creates a set of half columns +
-  * "simple centered box" creates a standard box (60% wide, centered) +
-  * "info, tip, important, alert, help, download, todo box" creates specifically themed boxes (also 60% wide, centered) +
-  * "clear floats" creates a ''%%<WRAP clear/>%%'' +
-  * "especially emphasised, highlighted, less significant" creates the respective marks +
- +
-===== 12.7 Extend with custom styles ===== +
- +
-If you like to add your own classes and styles to the plugin, you can simply add the styles for your class preceded by "''wrap_''" to your [[devel:css#user styles]]. Please note, any classes need to be **lower case**. +
- +
-E.g. if you need a ''%%<WRAP myclass>%%'', you edit (or create if it doesn't exist) your ''conf/userstyle.css'' and add your ''.wrap_myclass{}'' with its style definitions to it. (If necessary, edit ''conf/userprint.css''(( ''conf/printstyle.css'' in Anteater)) for the print view, ''conf/userrtl.css''(( ''conf/rtlstyle.css'' in Anteater)) for RTL languages and ''conf/userall.css''(( ''conf/allstyle.css'' in Anteater)) for all styles as well.) +
- +
-User permissions for every file used must be similar to original DokuWiki files. +
- +
- +
-Since version 2010-03-14 you have the possibility to exclude certain class names from being prefixed with "wrap_". Just add a comma separated list of class names into the config option "noPrefix" in the configuration manager. +
- +
-==== 12.7.1 Examples ==== +
- +
-in style.css +
- +
-<code css> +
-.dokuwiki div.wrap_note{ /* added */ +
-    background-color: #eee; +
-    color: #000; +
-    padding: .5em .5em .5em .5em; +
-    margin-bottom: 1em; +
-    overflow: hidden; +
-}+
 </code> </code>
  
-call in DW-page: +<file php myexample.php> 
-  <WRAP note>...</WRAP>+<?php echo "hello world!"; ?> 
 +</file>
  
-Here are some [[plugin:wrap:extensions|useful Wrap extensions]] created by users of this plugin. +If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code''%%<code - myfile.foo>%%''.
-==== 12.7.2 Add former typography classes ====+
  
-The old typography classes were removed in version 2011-05-15. If you need something similar, use the [[Block]] plugin instead. Or you can use your own and copy them to your own user styles (see [[#Extend with custom styles|above]]).+===== RSS/ATOM Feed Aggregation ===== 
 +[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is usedAll formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
  
-===== 12.8 How to use the helper =====+^ Parameter  ^ Description ^ 
 +| any number | will be used as maximum number items to show, defaults to 8 | 
 +| reverse    | display the last items in the feed first | 
 +| author     | show item authors names | 
 +| date       | show item dates | 
 +| description| show the item description. All HTML tags will be stripped | 
 +| nosort     | do not sort the items in the feed | 
 +| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h 12 hours). |
  
-From version 2011-05-15 on the plugin includes helper plugin which you can use to add classeswidth and lang/dir to any other plugin.+The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of pageobviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.
  
-==== 12.8.1 Example how to get just one kind of attribute ====+By default the feed will be sorted by date, newest items firstYou can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.
  
-<code php> +**Example:**
-// get lang from wrap helper plugin +
-$lang = ''; +
-if(!plugin_isdisabled('wrap')) { +
-    $wrap = plugin_load('helper', 'wrap'); +
-    $attr = $wrap->getAttributes($data); +
-    if($attr['dir']) $lang = ' lang="'.$attr['lang'].'" xml:lang="'.$attr['lang'].'" dir="'.$attr['dir'].'"'; +
-}+
  
-// add lang to your plugin's output +  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
-$renderer->doc .= '<span '.$lang.' class="foo">'; +
-</code>+
  
-''getAttributes()'' expects the string with "classes #id width :language"It returns an array with +{{rss>http://slashdot.org/index.rss 5 author date 1h }}
-  * ''$attr['class']'': CSS class(es) +
-  * ''$attr['id']'': CSS ID +
-  * ''$attr['width']'': width +
-  * ''$attr['lang']'' and ''$attr['dir']'': language and text direction+
  
-==== 12.8.2 Example how to get all attributes ==== 
  
-<code php> +===== Control Macros =====
-// get attributes from wrap helper plugin +
-$attr ''; +
-if(!plugin_isdisabled('wrap')) { +
-    $wrap plugin_load('helper', 'wrap'); +
-    $attr $wrap->buildAttributes($data, 'additionalClass'); +
-}+
  
-// add those attributes to your plugin'output +Some syntax influences how DokuWiki renders a page without creating any output it selfThe following control macros are availble:
-$renderer->doc .= '<div '.$attr.'">'; +
-</code>+
  
-''buildAttributes()'' expects the same string as above ("classes #id width :language"and an optional string for additional classesin case your plugin has CSS classes of its own which it needs to reuse. It returns string with all the attributes prepared for HTML.+^ Macro           ^ Description | 
 +| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | 
 +| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender page on every call |
  
-==== 2.5 Verwalten von Ansichten, Layouts und Ansichtennetzwerken ====+===== Syntax Plugins =====
  
-=== 2.5.1 Grundlegende Konzepte von Ansichten, Layouts und Ansichtennetzwerken ===+DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]How the installed plugins are used is described on their appropriate description pagesThe following syntax plugins are available in this particular DokuWiki installation:
  
-Im Rich Client wird eine Ansicht immer im Kontext einer Anwendungsperspektive angezeigt. In jeder Anwendungsperspektive werden immer eine oder mehrere Ansichten angezeigt. +~~INFO:syntaxplugins~~
- +
-{{  :teamcenterbasics_en_089.png?direct  }} +
- +
-Standardmäßig zeigt die Mein Teamcenter­Anwendung die Komponentenansicht **Persönliche Ablage** in einem Ansichtenordner rechts neben dem Navigationsfenster an. Die Ansichten **Übersicht**, **Details**, **Auswirkungsanalyse** und **Viewer** werden in einem Ansichtenordner rechts neben der Komponentenansicht **Persönliche Ablage** angezeigt. +
- +
-  * Ein //Layout// ist die Anordnung der Ansichten und Ansichtsordner in einer Anwendungsperspektive. Jede Anwendungsperspektive besitzt ein Standardlayout.\\ \\  +
-    * Sie können in einer Anwendungsperspektive die Ansichten neu anordnen und Ansichten hinzufügen oder entfernen, und so neue Layouts erstellen. +
-    * Sie können neue Layouts speichern und diese später wieder anzeigen.\\ Jedes Layout hat einen aktuellen und einen gespeicherten Zustand. +
- +
-  * Ein //Ansichtenordner// ist ein Satz aus einer oder mehreren Ansichten, die in einem bestimmten Bereich des Teamcenter­Fensters angezeigt werden.\\ \\ Die Mein Teamcenter­Anwendung zeigt z. B. standardmäßig Komponentenansichten in einem Ansichtenordner rechts des Navigationsfenster an. Ein zweiter Ansichtenordner enthält die Ansichten **Übersicht**, **Details**, **Auswirkungsanalyse** und **Viewer**.\\ \\ Wird eine Ansicht in einen neuen Bereich verschoben, z. B. zum unteren Fensterrand, dann wird an dieser Position ein neuer Ansichtenordner erstellt. Sie können Ansichten zwischen Ansichtenordnern hin und her verschieben. +
-  * Ein //Ansichtennetzwerk// setzt sich aus einer Primäransicht und einer oder mehreren Sekundäransichten zusammen, die alle //verbunden// sind. Ansichtennetzwerke können in einem einzelnen Ansichtenordner oder in mehreren Ansichtenordnern angeordnet sein. +
-  * Sie //verbinden// eine Sekundäransicht mit einer Primäransicht, indem Sie zuerst **Verbinden** aus dem Ansichtsmenü und dann eine Primäransicht auswählen.\\ <WRAP info><color blue>**Hinweis**</color>\\  +
-Ein Administrator kann die Voreinstellung **TCViewEnableResponseOnSelection** festlegen, um die Antwort auf die Auswahl in bestimmten primären Ansichten zu aktivieren, wenn ein Objekt in einer sekundären Ansicht im aktuellen Ansichtennetzwerk ausgewählt ist.</WRAP> +
-  * In einer //Primär//ansicht, z. B. Komponentenansicht, können Sie Auswahlen treffen. Die anderen Ansichten reagieren dann auf Ihre Auswahl.\\ \\ In einer Teamcenter­Komponentenansicht wird z. B. eine hierarchische Ansicht von Listen mit Objekten und deren Anhängen angezeigt. Wenn Sie ein Objekt auswählen, z. B. einen Elementänderungsstand, reagiert eine Sekundäransicht, indem sie relevante Informationen zur Auswahl in der Primäransicht anzeigt. Sekundäransichten können mit Primäransichten verbunden werden. +
-  * Eine //Sekundär//ansicht, wie **Details** oder **Übersicht** zeigt relevante Informationen zur Auswahl in der Primäransicht an.\\ \\  +
-    * Eine //verbundene// Sekundäransicht reagiert auf eine einzelne, bestimmte Primäransicht in einem //Ansichtennetzwerk//. Sie können eine Ansichtenverbindung ändern, indem Sie zuerst **Verbinden** aus dem Ansichtsmenü und dann **Keine** oder eine andere Primäransicht auswählen. +
-    * Eine mit einer bestimmten Primäransicht verbundene Sekundäransicht reagiert auf die aktuelle Auswahl in dieser Primäransicht. Die verbundene Sekundäransicht wird automatisch geschlossen, wenn die Primäransicht geschlossen wird. +
-    * Abhängig von den beteiligten Ansichten kann eine Sekundäransicht auch auf andere Sekundäransichten in ihrem Netzwerk reagieren. +
-    * Eine Sekundäransicht, die nicht mit einer bestimmten Primäransicht verbunden ist, reagiert auf die Auswahl in der zuletzt ausgewählten Primäransicht.+
  
-<WRAP info><color blue>**Hinweis**</color>\\  
-Die Quickinfos der Ansichtsregisterkarte zeigen Folgendes an: 
-  * Die Hauptauswahl in der Primäransicht 
-  * Die Ausgangsprimäransicht der Sekundäransicht 
-{{  :teamcenterbasics_en_090.png?direct  }}</WRAP>