faq-database.de

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Zuletzt angesehen:
de:wiki:syntax

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

de:wiki:syntax [2025/06/19 20:18] – Automatic push translation domelede:wiki:syntax [2026/08/03 17:57] (aktuell) – Externe Bearbeitung 127.0.0.1
Zeile 1: Zeile 1:
-====== Formatierungssyntax ======+====== Formatting Syntax ======
  
-[[doku>DokuWiki]] unterstützt eine einfache Auszeichnungssprache, die versucht, die Datendateien so lesbar wie möglich zu machen. Diese Seite enthält alle möglichen Syntaxen, die Sie beim Bearbeiten der Seiten verwenden können. Schauen Sie sich einfach den Quelltext dieser Seite an, indem Sie auf "Diese Seite bearbeiten" klicken. Wenn Sie etwas ausprobieren wollen, benutzen Sie einfach die [[playground:playground|Spielplatzseite]]. Das einfachere Markup ist leicht zugänglich über [[doku>toolbar|Quickbuttons]] zugänglich.+[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
  
-===== Grundlegende Textformatierung =====+===== Basic Text Formatting =====
  
-DokuWiki unterstützt **Fettdruck**, //kursiv//, __unterstrichen__ und ''einzeilig'' Texte. Natürlich können Sie **__//''kombinieren''//__** kombinieren.+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
  
-  DokuWiki unterstützt **fett**, //kursiv//, __unterstrichen__ und ''einzeilig'' Texte. +  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. 
-  Natürlich können Sie **__//''kombinieren''//__** kombinieren.+  Of course you can **__//''combine''//__** all these.
  
-Sie können <sub>tiefgestellt</sub> und <sup>hochgestellte</sup>auch verwenden.+Note that the formatting markers have to directly enclose the text, so ''%%** bold **%%'' with spaces inside the markers will not be formatted.
  
-  Sie können <sub>tiefgestellt</sub> und <sup>hochgestellte</sup>auch verwenden.+You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-Sie können etwas markieren als <del>gelöscht</del> markieren.+  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-  Sie können etwas markieren als <del>gelöscht</del> markieren.+You can mark something as <del>deleted</del> as well.
  
-**Absätze** werden aus Leerzeilen erstellt. Wenn Sie **einen Zeilenumbruch erzwingen** ohne Absatz erzwingen wollen, können Sie zwei Backslashes gefolgt von einem Leerzeichen oder dem Zeilenende verwenden.+  You can mark something as <del>deleted</del> as well.
  
-Dies ist ein Text mit einigen Zeilenumbrüchen\\ Beachten Sie, dass die +**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
-zwei Backslashes nur am Ende einer Zeile erkannt werden\\ +
-oder gefolgt von\\ einem Whitespace \\dies geschieht ohne sie.+
  
-  Dies ist ein Text mit einigen Zeilenumbrüchen\\ Beachten Sie, dass die +This is some text with some linebreaks\\ Note that the 
-  zwei Backslashes nur am Ende einer Zeile erkannt werden\\ +two backslashes are only recognized at the end of a line\\ 
-  oder gefolgt von\\ einem Whitespace \\dies geschieht ohne sie.+or followed by\\ a whitespace \\this happens without it.
  
-Sie sollten erzwungene Zeilenumbrüche nur verwenden, wenn sie wirklich notwendig sind.+  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. 
 + 
 +You should use forced newlines only if really needed.
  
 ===== Links ===== ===== Links =====
  
-DokuWiki unterstützt mehrere Möglichkeiten, Links zu erstellen.+DokuWiki supports multiple ways of creating links.
  
-==== Extern ====+==== External ====
  
-Externe Links werden automatisch erkannt: http://www.google.com oder einfach www.google.com - Sie können auch den Linktext festlegen: [[http://www.google.com|This Link zeigt auf google]]. E-Mail-Adressen wie diese: <[email protected]> werden ebenfalls erkannt.+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: <[email protected]> are recognized, too.
  
-  DokuWiki unterstützt mehrere Möglichkeiten, Links zu erstellen. Externe Links werden erkannt +  DokuWiki supports multiple ways of creating links. External links are recognized 
-  automatisch erkannt: http://www.google.com oder einfach www.google.com - Sie können einen +  automagically: http://www.google.com or simply www.google.com - You can set 
-  auch einen Linktext setzen: [[http://www.google.com|This Link zeigt auf google]]. E-Mail +  link text as well: [[http://www.google.com|This Link points to google]]. Email 
-  Adressen wie diese: <[email protected]> werden ebenfalls erkannt.+  addresses like this one: <[email protected]> are recognized, too.
  
-==== Intern ====+==== Internal ====
  
-Interne Links werden durch die Verwendung eckiger Klammern erstellt. Sie können entweder nur ein [[en:wiki:pagename]] angeben oder einen zusätzlichen [[en:wiki:pagename|Linktext]] verwenden.+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
-  Interne Links werden mit Hilfe von eckigen Klammern erstellt. Sie können entweder nur +  Internal links are created by using square brackets. You can either just give 
-  ein [[en:wiki:pagename]] oder einen zusätzlichen [[en:wiki:pagename|Linktext]].+  a [[pagename]] or use an additional [[pagename|link text]].
  
-[[doku>pagename|Wiki-Paginennamen]] werden automatisch in Kleinbuchstaben umgewandelt, Sonderzeichen sind nicht erlaubt.+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
  
-Sie können [[some:namespaces]] verwenden, indem Sie einen Doppelpunkt im Seitennamen einsetzen.+You can use [[some:namespaces]] by using a colon in the pagename.
  
-  Sie können [[some:namespaces]] verwenden, indem Sie einen Doppelpunkt im Seitennamen verwenden.+  You can use [[some:namespaces]] by using a colon in the pagename.
  
-Einzelheiten zu Namensräumen finden Sie unter [[doku>namespaces]] .+For details about namespaces see [[doku>namespaces]].
  
-Die Verknüpfung mit einem bestimmten Abschnitt ist ebenfalls möglich. Fügen Sie einfach den Namen des Abschnitts hinter einem Rautenzeichen ein, wie es aus HTML bekannt ist. Dies verweist auf [[en:wiki:syntax#internal|diesen Abschnitt]].+Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
  
-  Dies verweist auf [[en:wiki:syntax#internal|diesen Abschnitt]].+  This links to [[syntax#internal|this Section]].
  
-Anmerkungen:+Notes:
  
-  * Links zu [[en:wiki:syntax|bestehende Seiten]] werden in einem anderen Stil angezeigt als [[en:wiki:nonexisting]] . +  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. 
-  * DokuWiki verwendet [[wp>CamelCase]] nicht, um automatisch Links zu erstellen, aber dieses Verhalten kann in der Datei [[doku>config]] aktiviert werden. Hinweis: Wenn DokuWiki ein Link ist, dann ist er aktiviert. +  * 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. 
-  * Wenn die Überschrift eines Abschnitts geändert wird, ändert sich auch das Lesezeichen. Verlassen Sie sich also nicht zu sehr auf Abschnittsverknüpfungen.+  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
  
 ==== Interwiki ==== ==== Interwiki ====
  
-DokuWiki unterstützt [[doku>Interwiki]] Links. Dies sind schnelle Links zu anderen Wikis. Zum Beispiel ist dies ein Link zur Wikipedia-Seite über Wikis: [[wp>Wiki]] .+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]].
  
-  DokuWiki unterstützt [[doku>Interwiki]] Links. Dies sind schnelle Links zu anderen Wikis. +  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. 
-  Dies ist zum Beispiel ein Link zur Wikipedia-Seite über Wikis: [[wp>Wiki]] .+  For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
  
-==== Windows-Freigaben ====+==== Windows Shares ====
  
-Windows-Freigaben wie [[\\server\share|wie diese]] werden ebenfalls erkannt. Bitte beachten Sie, dass diese nur in einer homogenen Benutzergruppe wie z.B. einem Unternehmen [[wp>Intranet]] sinnvoll sind.+Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]].
  
-  Windows-Freigaben wie [[\\server\share|diese]] werden ebenfalls erkannt.+  Windows Shares like [[\\server\share|this]] are recognized, too.
  
-Hinweise:+Notes:
  
-  * Aus Sicherheitsgründen funktioniert das direkte Durchsuchen von Windows-Freigaben standardmäßig nur im Microsoft Internet Explorer (und nur in der "lokalen Zone"). +  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). 
-  * Für Mozilla und Firefox kann es durch verschiedene Workarounds aktiviert werden, die in der [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. Es wird jedoch weiterhin eine JavaScript-Warnung angezeigt, wenn versucht wird, eine Windows-Freigabe zu öffnen. Um diese Warnung (für alle Benutzer) zu entfernen, fügen Sie die folgende Zeile in ''conf/lang/de/lang.php'' (weitere Details unter [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|Lokalisierung]]): <code - conf/lang/en/lang.php>+  * 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>
 <?php <?php
 /** /**
Zeile 93: Zeile 95:
 </code> </code>
  
-==== Bild-Links ====+==== Image Links ====
  
-Sie können auch ein Bild als Link zu einer anderen internen oder externen Seite verwenden, indem Sie die Syntax für Links und [[en:wiki:syntax#images_and_other_files|Bilder]] (siehe unten) wie folgt kombinieren:+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:
  
   [[http://php.net|{{wiki:dokuwiki-128.png}}]]   [[http://php.net|{{wiki:dokuwiki-128.png}}]]
Zeile 101: Zeile 103:
 [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-Bitte beachten Sie: Die Bildformatierung ist die einzige Formatierungssyntax, die in Linknamen akzeptiert wird.+Please note: The image formatting is the only formatting syntax accepted in link names.
  
-Das gesamte [[en:wiki:syntax#images_and_other_files|Bild]] und [[en:wiki:syntax#links|Link]] Syntax wird unterstützt (einschließlich Größenänderung der Bilder, interne und externe Bilder und URLs und Interwiki-Links).+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).
  
-===== Fußnoten =====+===== Footnotes =====
  
-Sie können Fußnoten ((Dies ist eine Fußnote)) hinzufügen, indem Sie doppelte Klammern verwenden.+You can add footnotes ((This is a footnote)) by using double parentheses.
  
-  Sie können Fußnoten ((Dies ist eine Fußnote)) hinzufügen, indem Sie doppelte Klammern verwenden.+  You can add footnotes ((This is a footnote)) by using double parentheses.
  
-===== Gliederung =====+===== Sectioning =====
  
-Sie können bis zu fünf verschiedene Ebenen von Überschriften verwenden, um Ihren Inhalt zu strukturieren. Wenn Sie mehr als drei Überschriften haben, wird automatisch ein Inhaltsverzeichnis erstellt - dies kann durch Einfügen der Zeichenkette ''<nowiki>~~NOTOC~~~</nowiki>'' in das Dokument einfügen.+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.
  
-==== Überschrift Ebene 3 ==== +==== Headline Level 3 ==== 
-=== Überschrift Ebene 4 === +=== Headline Level 4 === 
-== Überschrift Ebene 5 ==+== Headline Level 5 ==
  
-  ==== Schlagzeile Ebene 3 ==== +  ==== Headline Level 3 ==== 
-  === Schlagzeile Ebene 4 === +  === Headline Level 4 === 
-  == Überschrift Ebene 5 ==+  == Headline Level 5 ==
  
-Durch die Verwendung von vier oder mehr Strichen können Sie eine horizontale Linie erzeugen:+By using four or more dashes, you can make a horizontal line:
  
 ---- ----
  
-===== Medien-Dateien =====+===== Media Files =====
  
-Sie können externe und interne [[doku>images|Bilder, Videos und Audiodateien]] mit geschweiften Klammern einbinden. Optional können Sie die Größe der Dateien angeben.+You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-Echte Größe:       {{wiki:dokuwiki-128.png}}+Real size:                        {{wiki:dokuwiki-128.png}}
  
-Auf die angegebene Breite skalieren:         {{wiki:dokuwiki-128.png?50}}+Resize to given width:            {{wiki:dokuwiki-128.png?50}}
  
-Größenänderung auf die angegebene Breite und Höhe (wenn das Seitenverhältnis der angegebenen Breite und Höhe nicht mit dem des Bildes übereinstimmt, wird es vor der Größenänderung auf das neue Verhältnis zugeschnitten): {{wiki:dokuwiki-128.png?200x50}}+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}}
  
-Größenänderung eines externen Bildes:           {{https://www.php.net/images/php.gif?200x50}}+Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
-  Echte Größe:       {{wiki:dokuwiki-128.png}} +  Real size:                        {{wiki:dokuwiki-128.png}} 
-  Größe auf angegebene Breite ändern:       {{wiki:dokuwiki-128.png?50}} +  Resize to given width:            {{wiki:dokuwiki-128.png?50}} 
-  Größe auf die angegebene Breite und Höhe anpassen: {{wiki:dokuwiki-128.png?200x50}} +  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}} 
-  Größe des externen Bildes ändern:           {{https://www.php.net/images/php.gif?200x50}}+  Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
  
-Durch die Verwendung von linken oder rechten Whitespaces können Sie die Ausrichtung wählen.+By using left or right whitespaces you can choose the alignment.
  
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
Zeile 153: Zeile 155:
 {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
  
- {{ wiki:dokuwiki-128.png}} +  {{ wiki:dokuwiki-128.png}} 
- {{wiki:dokuwiki-128.png }} +  {{wiki:dokuwiki-128.png }} 
- {{ wiki:dokuwiki-128.png }}+  {{ wiki:dokuwiki-128.png }}
  
-Natürlich können Sie auch einen Titel hinzufügen (der von den meisten Browsern als Tooltip angezeigt wird).+You can also set the alignment explicitly with a ''?left'', ''?right'' or ''?center'' parameter. This takes precedence over the whitespace alignment above and can be combined with a size.
  
-{{ wiki:dokuwiki-128.png |Dies ist die Überschrift}}+{{wiki:dokuwiki-128.png?100&right}}
  
-  {{ wiki:dokuwiki-128.png |Dies ist die Beschriftung}}+  {{wiki:dokuwiki-128.png?100&right}}
  
-Für die Verknüpfung eines Bildes mit einer anderen Seite siehe [[en:wiki:syntax#Image Links]] oben.+Of course, you can add a title (displayed as a tooltip by most browsers), too.
  
-==== Unterstützte Medienformate ====+{{ wiki:dokuwiki-128.png |This is the caption}}
  
-DokuWiki kann die folgenden Medienformate direkt einbetten.+  {{ wiki:dokuwiki-128.png |This is the caption}}
  
-| Bild | ''gif'', ''jpg'', ''png''  |+For linking an image to another page see [[#Image Links]] above. 
 + 
 +==== Supported Media Formats ==== 
 + 
 +DokuWiki can embed the following media formats directly. 
 + 
 +| Image | ''gif'', ''jpg'', ''png''  |
 | Video | ''webm'', ''ogv'', ''mp4'' | | Video | ''webm'', ''ogv'', ''mp4'' |
 | Audio | ''ogg'', ''mp3'', ''wav''  | | Audio | ''ogg'', ''mp3'', ''wav''  |
 | Flash | ''swf''                    | | Flash | ''swf''                    |
  
-Wenn Sie einen Dateinamen angeben, der nicht zu den unterstützten Medienformaten gehört, wird er stattdessen als Link angezeigt.+If you specify a filename that is not a supported media format, then it will be displayed as a link instead.
  
-Durch Hinzufügen von ''?linkonly'' geben Sie einen Link zu den Medien an, ohne sie inline anzuzeigen+By adding ''?linkonly'' you provide a link to the media without displaying it inline
  
- {{wiki:dokuwiki-128.png?linkonly}}+  {{wiki:dokuwiki-128.png?linkonly}}
  
-{{wiki:dokuwiki-128.png?linkonly}} Dies ist nur ein Link auf das Bild.+{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
  
-==== Fallback-Formate ====+==== Fallback Formats ====
  
-Leider verstehen nicht alle Browser alle Video- und Audioformate. Um das Problem zu entschärfen, können Sie Ihre Datei in verschiedenen Formaten hochladen, um maximale Browserkompatibilität zu erreichen.+Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.
  
-Betrachten Sie zum Beispiel dieses eingebettete mp4-Video:+For example consider this embedded mp4 video:
  
-  {{en:wiki:video.mp4|Ein lustiges Video}}+  {{video.mp4|A funny video}}
  
-Wenn Sie eine ''video.webm'' und ''video.ogv'' neben der referenzierten ''video.mp4''hinzufügen, fügt DokuWiki sie automatisch als Alternativen hinzu, so dass Ihr Browser eine der drei Dateien versteht.+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.
  
-Zusätzlich unterstützt DokuWiki ein "Poster"-Bild, das vor dem Start des Videos angezeigt wird. Dieses Bild muss denselben Dateinamen wie das Video haben und entweder eine jpg- oder png-Datei sein. Im obigen Beispiel ist eine ''video.jpg'' Datei funktionieren.+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.
  
-===== Listen =====+===== Lists =====
  
-Dokuwiki unterstützt geordnete und nicht geordnete Listen. Um ein Listenelement zu erstellen, rücken Sie Ihren Text um zwei Leerzeichen ein und verwenden ein ''*'' für nicht geordnete Listen oder ein ''-'' für geordnete Listen.+Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.
  
-  * Dies ist eine Liste +  * This is a list 
-  * Der zweite Eintrag +  * The second item 
-    * Sie können verschiedene Ebenen haben +    * You may have different levels 
-  * Ein weiterer Punkt+  * Another item
  
-  - Die gleiche Liste, aber geordnet +  - The same list but ordered 
-  - Ein weiterer Punkt +  - Another item 
-    - Verwenden Sie einfach Einrückungen für tiefere Ebenen +    - Just use indention for deeper levels 
-  - Das war's+  - That's it
  
 <code> <code>
Zeile 220: Zeile 228:
 </code> </code>
  
-Werfen Sie auch einen Blick auf die [[doku>faq:lists|FAQ zu Listeneinträgen]].+Also take a look at the [[doku>faq:lists|FAQ on list items]].
  
-===== Text-Konvertierungen =====+===== Text Conversions =====
  
-DokuWiki kann bestimmte vordefinierte Zeichen oder Zeichenketten in Bilder oder anderen Text oder HTML umwandeln.+DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.
  
-Die Umwandlung von Text in Bilder wird hauptsächlich für Smileys verwendet. Die Text-zu-HTML-Konvertierung wird für die Ersetzung von Typografie verwendet, kann aber auch so konfiguriert werden, dass anderes HTML verwendet wird.+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.
  
-==== Text zu Bild Konvertierungen ====+==== Text to Image Conversions ====
  
-DokuWiki konvertiert häufig verwendete [[wp>emoticon]] s in ihre grafischen Entsprechungen. Diese [[doku>Smileys]] und andere Bilder können konfiguriert und erweitert werden. Hier finden Sie eine Übersicht über die in DokuWiki enthaltenen Smileys:+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:
  
-  * 8-) %% 8-) %% +  * 8-) %%  8-)  %% 
-  * 8-O %% 8-O %% +  * 8-O %%  8-O  %% 
-  * :-( %% :-( %% +  * :-( %%  :-(  %% 
-  * :-) %% :-) %% +  * :-) %%  :-)  %% 
-  * =) %% =) %% +  * =)  %%  =)   %% 
-  * :-/ %% :-/ %% +  * :-/ %%  :-/  %% 
-  * :-\ %% :-\ %% +  * :-\ %%  :-\  %% 
-  * :-? %% :-? %% +  * :-? %%  :-?  %% 
-  * :-D %% :-D %% +  * :-D %%  :-D  %% 
-  * :-P %% :-P %% +  * :-P %%  :-P  %% 
-  * :-O %% :-O %% +  * :-O %%  :-O  %% 
-  * :-X %% :-X %% +  * :-X %%  :-X  %% 
-  * :-| %% :-|  %% +  * :-| %%  :-|  %% 
-  * ;-) %% ;-) %%+  * ;-) %%  ;-)  %%
   * ^_^ %%  ^_^  %%   * ^_^ %%  ^_^  %%
-  * m( %% m( %% +  * m(  %%  m(   %% 
-  * :?: %% :?: %% +  * :?: %%  :?:  %% 
-  * :!: %% :!: %% +  * :!: %%  :!:  %% 
-  * LOL %% LOL %% +  * LOL %%  LOL  %% 
-  * FIXME %% FIXME %%+  * FIXME %%  FIXME %%
   * DELETEME %% DELETEME %%   * DELETEME %% DELETEME %%
  
-==== Text-zu-HTML-Konvertierungen ====+==== Text to HTML Conversions ====
  
-Typografie: [[de:wiki:dokuwiki]] kann einfache Textzeichen in ihre typografisch korrekten Einheiten umwandeln. Hier ist ein Beispiel für erkannte Zeichen.+Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.
  
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
Zeile 266: Zeile 274:
 </code> </code>
  
-Das Gleiche kann für jede Art von HTML gemacht werden, es muss nur in der [[doku>entities|Musterdatei]] hinzugefügt werden.+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
  
-Es gibt drei Ausnahmen, die nicht aus dieser Musterdatei stammen: Multiplikationseinheit (640x480), "einfache" und "doppelte Anführungszeichen". Sie können durch eine [[doku>config:typography|Konfigurationsoption]] ausgeschaltet werden.+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]].
  
-===== Anführungszeichen =====+===== Quoting =====
  
-Manchmal möchte man einen Text markieren, um zu zeigen, dass es sich um eine Antwort oder einen Kommentar handelt. Sie können die folgende Syntax verwenden:+Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
  
 <code> <code>
Zeile 288: Zeile 296:
 </code> </code>
  
-Ich denke, wir sollten es tun+I think we should do it
  
-> Nein, wir sollten es nicht tun.+> No we shouldn't
  
->> Nun, ich sage, wir sollten+>> Well, I say we should
  
-> Wirklich?+> Really?
  
->> Ja!+>> Yes!
  
->>> Dann lass es uns tun!+>>> Then lets do it!
  
-===== Tische =====+===== Tables =====
  
-DokuWiki unterstützt eine einfache Syntax, um Tabellen zu erstellen.+DokuWiki supports a simple syntax to create tables.
  
-^ Überschrift 1   ^ Überschrift 2   ^ Überschrift 3   ^ +^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-| Zeile 1 Spalte 1   | Zeile 1 Spalte 2   | Zeile 1 Spalte 3   | +| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-| Zeile 2 Spalte 1   | etwas colspan (beachten Sie die doppelte Pipe) || +| Row 2 Col 1    | some colspan (note the double pipe) || 
-| Zeile 3 Spalte 1   | Zeile 3 Spalte 2   | Zeile 3 Spalte 3   |+| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
  
-Tabellenzeilen beginnen und enden mit einem ''|'' für normale Zeilen oder einem ''^'' für Kopfzeilen.+Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.
  
-  ^ Überschrift 1   ^ Überschrift 2   ^ Überschrift 3   ^ +  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-  | Zeile 1 Spalte 1   | Zeile 1 Spalte 2   | Zeile 1 Spalte 3   | +  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-  | Zeile 2 Spalte 1   | etwas colspan (beachten Sie die doppelte Pipe) || +  | Row 2 Col 1    | some colspan (note the double pipe) || 
-  | Zeile 3 Spalte 1   | Zeile 3 Spalte 2   | Zeile 3 Spalte 3   |+  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
  
-Um Zellen horizontal zu verbinden, lassen Sie einfach die nächste Zelle komplett leer, wie oben gezeigt. Achten Sie darauf, dass Sie immer die gleiche Anzahl von Zellentrennern haben!+To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!
  
-Vertikale Tabellenköpfe sind ebenfalls möglich.+Vertical tableheaders are possible, too.
  
-|              ^ Überschrift 1   ^ Überschrift 2   ^ +|              ^ Heading 1            ^ Heading 2          ^ 
-^ Überschrift 3   | Zeile 1 Spalte 2   | Zeile 1 Spalte 3   | +^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-^ Überschrift 4   | Diesmal kein Colspan |                    | +^ Heading 4    | no colspan this time |                    | 
-^ Überschrift 5   | Zeile 2 Spalte 2   | Zeile 2 Spalte 3   |+^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
  
-Wie Sie sehen, ist es das Trennzeichen vor einer Zelle, das über die Formatierung entscheidet:+As you can see, it's the cell separator before a cell which decides about the formatting:
  
-  |              ^ Überschrift 1   ^ Überschrift 2   ^ +  |              ^ Heading 1            ^ Heading 2          ^ 
-  ^ Überschrift 3   | Zeile 1 Spalte 2   | Zeile 1 Spalte 3   | +  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-  ^ Überschrift 4   | Diesmal kein Colspan |                    | +  ^ Heading 4    | no colspan this time |                    | 
-  ^ Überschrift 5   | Zeile 2 Spalte 2   | Zeile 2 Spalte 3   |+  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
  
-Sie können Zeilenabstände (vertikal verbundene Zellen) haben, indem Sie Folgendes hinzufügen ''%%:::%%'' in die Zellen unter der Zelle einfügen, mit der sie verbunden werden sollen.+You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect.
  
-^ Überschrift 1   ^ Überschrift 2   ^ Überschrift 3   ^ +^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
-| Zeile 1 Spalte 1   | diese Zelle erstreckt sich vertikal | Zeile 1 Spalte 3   | +| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
-| Zeile 2 Spalte 1   | :::                        | Zeile 2 Spalte 3   | +| Row 2 Col 1    | :::                        | Row 2 Col 3        | 
-| Reihe 3 Spalte 1   | :::                        | Reihe 2 Spalte 3   |+| Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-Abgesehen von der Zeilensyntax sollten diese Zellen nichts anderes enthalten.+Apart from the rowspan syntax those cells should not contain anything else.
  
-  ^ Überschrift 1   ^ Überschrift 2   ^ Überschrift 3   ^ +  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
-  | Zeile 1 Spalte 1   | diese Zelle erstreckt sich vertikal | Zeile 1 Spalte 3   | +  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
-  | Zeile 2 Spalte 1   | :::                        | Zeile 2 Spalte 3   | +  | Row 2 Col 1    | :::                        | Row 2 Col 3        | 
-  | Reihe 3 Spalte 1   | :::                        | Zeile 2 Spalte 3   |+  | Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-Sie können auch den Inhalt der Tabelle ausrichten. Fügen Sie einfach mindestens zwei Leerzeichen an den gegenüberliegenden Enden des Textes hinzu: Fügen Sie zwei Leerzeichen auf der linken Seite hinzu, um den Text rechts auszurichten, zwei Leerzeichen auf der rechten Seite, um ihn links auszurichten und mindestens zwei Leerzeichen an beiden Enden, um den Text zu zentrieren.+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.
  
-^           Tabelle mit Ausrichtung           ^^^ +^           Table with alignment           ^^^ 
-|         rechts|    Mitte    |links       | +|         right|    center    |left          | 
-|links       |         rechts|    Mitte    |+|left          |         right|    center    |
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-So sieht es in der Quelle aus:+This is how it looks in the source:
  
-  ^           Tabelle mit Ausrichtung           ^^^ +  ^           Table with alignment           ^^^ 
-  |         rechts|    Mitte    |links       | +  |         right|    center    |left          | 
-  |links       |         rechts|    Mitte    |+  |left          |         right|    center    |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-Hinweis: Die vertikale Ausrichtung wird nicht unterstützt.+Note: Vertical alignment is not supported.
  
-===== Keine Formatierung =====+===== No Formatting =====
  
-Wenn Sie den Text genau so anzeigen wollen, wie er geschrieben ist (ohne jegliche Formatierung), schließen Sie den Bereich entweder mit ''%%<nowiki>%%'' Tags oder, noch einfacher, mit doppelten Prozentzeichen ''<nowiki>%%</nowiki>''.+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>''.
  
 <nowiki> <nowiki>
-Dies ist ein Text, der Adressen wie diese enthält: http://www.splitbrain.org und **Formatierung**enthält, aber nichts damit gemacht wird.+This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
 </nowiki> </nowiki>
-Das Gleiche gilt für %%//__diese__ Text// mit einem Smiley ;-)%%.+The same is true for %%//__this__ text// with a smiley ;-)%%.
  
   <nowiki>   <nowiki>
-  Dies ist ein Text, der Adressen wie diese enthält: http://www.splitbrain.org und **Formatierung**enthält, aber nichts damit gemacht wird.+  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
   </nowiki>   </nowiki>
-  Das Gleiche gilt für %%//__diese__ Text// mit einem Smiley ;-)%%.+  The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-===== Code-Blöcke =====+===== Code Blocks =====
  
-Sie können Codeblöcke in Ihre Dokumente einfügen, indem Sie sie entweder um mindestens zwei Leerzeichen einrücken (wie in den vorangegangenen Beispielen) oder indem Sie die Tags ''%%<code>%%'' or ''%%<file>%%''.+You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''%%<code>%%'' or ''%%<file>%%''.
  
   This is text is indented by two spaces.   This is text is indented by two spaces.
Zeile 390: Zeile 398:
 </file> </file>
  
-Diese Blöcke wurden mit dieser Quelle erstellt:+Those blocks were created by this source:
  
-    Dieser Text ist um zwei Leerzeichen eingerückt.+    This is text is indented by two spaces.
  
   <code>   <code>
Zeile 402: Zeile 410:
   </file>   </file>
  
-==== Syntax-Hervorhebung ====+==== Syntax Highlighting ====
  
-[[de:wiki:dokuwiki]] kann den Quellcode hervorheben, wodurch er leichter zu lesen ist. Es verwendet den [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- daher wird jede von GeSHi unterstützte Sprache unterstützt. Die Syntax verwendet dieselben Code- und Dateiblöcke, die im vorherigen Abschnitt beschrieben wurden, aber dieses Mal wird der Name der hervorzuhebenden Sprachsyntax innerhalb des Tags eingefügt, z.B. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.+[[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 tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
  
 <code java> <code java>
Zeile 436: Zeile 444:
 </file> </file>
  
-Wenn Sie keine Hervorhebung wünschen, aber eine herunterladbare Datei wünschen, geben Sie einen Bindestrich (''-'') als Sprachcode an: ''%%<code - myfile.foo>%%''.+If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.
  
 ===== RSS/ATOM Feed Aggregation ===== ===== RSS/ATOM Feed Aggregation =====
-[[de:wiki:dokuwiki]] kann Daten aus externen XML-Feeds integrieren. Zum Parsen der XML-Feeds, [[http://simplepie.org/|SimplePie]] verwendet. Alle von SimplePie verstandenen Formate können auch in DokuWiki verwendet werden. Sie können das Rendering durch mehrere zusätzliche, durch Leerzeichen getrennte Parameter beeinflussen:+[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
  
-^ Parameter  ^ Beschreibung ^ +^ Parameter  ^ Description ^ 
-| beliebige Zahl | wird als maximale Anzahl der anzuzeigenden Elemente verwendet, Standardwert ist 8 | +| any number | will be used as maximum number items to show, defaults to 8 | 
-| Rückwärts    | zeigt die letzten Einträge im Feed zuerst an | +| reverse    | display the last items in the feed first | 
-| Autor     | zeigt die Namen der Autoren der Artikel an | +| author     | show item authors names | 
-| Datum       | Artikeldaten anzeigen | +| date       | show item dates | 
-| description| zeigt die Artikelbeschreibung an. Alle HTML-Tags werden entfernt. | +| description| show the item description. All HTML tags will be stripped | 
-| nosort     | sortiert die Artikel im Feed nicht | +| nosort     | do not sort the items in the feed | 
-| //n//[dhm] | Aktualisierungszeitraum, wobei d=Tage, h=Stunden, m=Minuten. (z.B. 12h = 12 Stunden). |+| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
  
-Der Standardwert für den Aktualisierungszeitraum beträgt 4 Stunden. Jeder Wert unter 10 Minuten wird als 10 Minuten behandelt. [[de:wiki:dokuwiki]] versucht in der Regel, eine im Cache gespeicherte Version einer Seite bereitzustellen, was natürlich unangebracht ist, wenn die Seite dynamische externe Inhalte enthält. Der Parameter weist [[de:wiki:dokuwiki]] an, die Seite neu zu rendern, wenn sie länger als //Aktualisierungszeitraum// seit dem letzten Rendering der Seite vergangen ist.+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 a page, obviously 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.
  
-Standardmäßig wird der Feed nach Datum sortiert, die neuesten Einträge zuerst. Sie können ihn nach dem ältesten zuerst sortieren, indem Sie den Parameter ''umkehren'' Parameter sortieren, oder den Feed so anzeigen wie er ist mit ''nosort''.+By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.
  
-**Beispiel:**+**Example:**
  
   {{rss>http://slashdot.org/index.rss 5 author date 1h }}   {{rss>http://slashdot.org/index.rss 5 author date 1h }}
Zeile 461: Zeile 469:
  
  
-===== Makros steuern =====+===== Control Macros =====
  
-Einige Syntax beeinflusst, wie DokuWiki eine Seite rendert, ohne selbst eine Ausgabe zu erzeugen. Die folgenden Kontrollmakros stehen zur Verfügung:+Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:
  
-^ Makro       ^ Beschreibung | +^ Macro           ^ Description | 
-| %%~~NOTOC~~%%   | Wenn dieses Makro auf der Seite gefunden wird, wird kein Inhaltsverzeichnis erstellt | +| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | 
-| %%~~NOCACHE~~%% | DokuWiki zwischenspeichert standardmäßig alle Ausgaben. Manchmal ist dies nicht erwünscht (z.B. wenn die %%<php>%%-Syntax verwendet wird), wird DokuWiki durch Hinzufügen dieses Makros gezwungen, eine Seite bei jedem Aufruf neu zu berechnen |+| %%~~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 a page on every call |
  
-===== Syntax-Plugins =====+===== Syntax Plugins =====
  
-Die Syntax von DokuWiki kann erweitert werden durch [[doku>plugins|Plugins]] erweitert werden. Wie die installierten Plugins verwendet werden, ist auf den entsprechenden Beschreibungsseiten beschrieben. Die folgenden Syntax-Plugins sind in dieser speziellen DokuWiki-Installation verfügbar:+DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
  
de/wiki/syntax.1750364285.txt.gz · Zuletzt geändert: von domele