Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
Nächste ÜberarbeitungBeide Seiten der Revision
wiki:syntax [2009/08/11 10:29] – cg301wiki:syntax [2009/08/31 09:53] – cg301
Zeile 1: Zeile 1:
-====== Syntax (deutsch) ======+====== Wiki-Hilfe======
  
  
-===== Einleitung =====+===== Seite erstellen =====
  
-[[DokuWiki]] zeichnet sich durch einfache Formatierungen aus. Dadurch bleiben die Dateien, die den Inhalt enthalten, gut lesbar. \\+Um einen neuen Artikel zu erstellen, klicken Sie im Navigationskasten links auf "[[intern:neueseite|neue Seite anlegen]]", wählen Sie die Kategorie "Allgemein" (für alle lesbar) oder "intern" (nur für RZ-Mitglieder einsehbar) und geben Sie in das Textfeld den Namen des neuen Artikels ein. 
  
-**Hier wird die Syntax beschrieben um Seiten zu bearbeiten.**+===== Seite bearbeiten =====
  
-Schau dir zum **Beispiel** diese Seite an, indem du den "Diese Seite bearbeiten" Knopf oben oder unten drückst. \\ +Um eine Seite zu bearbeiten, klicken an der oberen Leiste auf "Seite bearbeiten" und editieren Sie den Text im Textfeld. Bitte beachten Sie beim Erstellen und Editieren von Artikeln die Wiki-Syntax (s. unten).
-Zum  Ausprobieren oder Üben kannst du den [[playground:playground|Spielplatz]] verwenden. \\  +
-Einfache Formatierungen sind direkt durch [[doku>de:toolbar|Quickbuttons]] in der "Menüleiste" über dem Editor erreichbar. \\+
  
-===== zur Übersetzung =====+    * Wählen Sie eine aussagekräftige Überschrift. 
 +    * Mit Hervorhebungen aller Art (fett, kursiv, bunt etc.) bitte sparsam umgehen. 
  
-Diese Seite ist eine Übersetzung der [[http://www.splitbrain.org/dokuwiki/wiki:syntax|Syntax-Seite aus DokuWiki (2005-07-13)]].\\ 
-Sie ist keine wortgleiche Übersetzung. Einige Beschreibungen sind etwas ausführlicher ausgefallen. Fachbegriffe werden nur dort verwendet, wo eine Umschreibung mehr Verwirrung stiftet als nützt.\\ 
-Ähnliches gilt auch für Begriffe, die dem Englischen entspringen, für manche gibt es keine direkte Übersetzungen. Oder sie sind schon so bekannt, dass eine Übersetzung unsinnig ist.\\ 
-Der Übersetzer ist sich selbst nicht sicher, ob er lieber den Begriff "Link" oder "Verweis" benutzen soll.\\ 
  
-An einigen Stellen befindet sich ein FIXME - hier gibt es etwas, was im Sinne des Übersetzers noch nicht gut umgesetzt wurde. +===== Schlagwörter / Tags =====
-  * Anregungen, Bemerkungen oder Hinweise auf Fehler sind willkommen. +
-  * euer Sebastian Koch => mr_snede *at* web ~dot~ de+
  
-====== 1 Texte ======+Jedem Artikel können Schlagwörter zugeordnet werden. Dies erleichtert die Navigation im Wiki, denn die verschlagworteten Seiten erscheinen automatisch auf einer Übersichtseite. Wählen Sie unter jedem Artikel die passenden Stichwörter aus. 
  
-===== 1.1 Formatierungen =====+===== Wiki-Syntax =====
  
-DokuWiki unterstützt **fetten**, //kursiven//, __unterstrichenen__ und ''dicktengleichen'' Text. Natürlich kann auch alles **__//''kombiniert''//__** werden. \\ 
  
-  DokuWiki unterstützt **fetten**, //kursiven//, __unterstrichenen__ und ''dicktengleichen'' Text.  +==== Textformatierung ====
-  Natürlich kann auch alles **__//''kombiniert''//__** werden.+
  
-Ebenso gibt es <sub>tiefgestellten</sub> und <sup>hochgestellten</sup> Text.+=== Schrift ===
  
-  Ebenso gibt es <sub>tiefgestellten</sub> und <sup>hochgestellten</sup> Text.+^Syntax^Ergebnis^ 
 +|%%**fett**%%|**fett**| 
 +|%%//kursiv//%%|//kursiv//| 
 +|%%__unterstrichen__%%|__unterstrichen__| 
 +|%%''dicktengleich''%%|''dicktengleich''| 
 +|%%<sub>tiefgestellt</sub>%%|<sub>tiefgestellt</sub>| 
 +|%%<sup>hochgestellt</sup>%%|<sup>hochgestellt</sup>| 
 +|%%<del>gelöscht</del>%%|<del>deleted</del>|
  
-Text kann als gelöscht <del>deleted</del>((wer eingefügt %%<ins>%% braucht. kann dies über Plugins realisieren. Siehe ganz unten!)) markiert werden. 
  
-  Text kann als gelöscht <del>deleted</del> markiert werden. +===Absätze === 
- +Ein Absatz wird erzeugt durch  
-===== 1.2 Absätze ===== +  * eine leere Zeile oder 
-Ein Absatz wird durch eine leere Zeile erzeugt. \\ +  * %%\\%% am Ende einer Zeile oder 
-<nowiki>Eine neue Zeile (Zeilenumbruch) kann durch zwei "backslashes" (umgekehrte Schrägstriche: \\) </nowiki>gefolgt von einem Leerzeichen erzeugt werden.\\  +  * %%\\%% plus ein Leerzeichen
- +
-Dies ist ein Beispieltext mit einigen Zeilenumbrüchen.\\ Beachte: Die zwei umgekehrten Schrägstriche +
-werden nur erkannt, wenn sie am Zeilenende stehen\\ +
-oder wenn ihnen ein\\ Leerzeichen folgt.\\ So\\sieht es ohne Leerzeichen aus. +
- +
-  Dies ist ein Beispieltext mit einigen Zeilenumbrüchen.\\ Beachte: Die zwei umgekehrten Schrägstriche +
-  werden nur erkannt, wenn sie am Zeilenende stehen\\ +
-  oder wenn ihnen ein\\ Leerzeichen folgt.\\ So\\sieht es ohne Leerzeichen aus. +
- +
-Zeilenumbrüche durch zwei "backslashes" (umgekehrte Schrägstriche: \\) sollten nur verwendet werden, wenn sie unbedingt gebraucht werden. +
- +
-===== 1.3 Überschriften ===== +
-Mit fünf unterschiedlichen Ebenen, getrennt durch Überschriften, kann der Inhalt einer Seite strukturiert werden.\\ +
-Die Überschriften werden mit maximal sechs "=" eingerahmt, je nach Größe.  H1 ist die Überschrift auf höchster Ebene. Am einfachsten zur Erzeugung der Überschriften die Symbolleiste verwenden und hier auf die Buttons ''H1'', ''H2'' oder ''H3'' klicken. +
- +
-Es ist __sinnvoll__, wenn immer eine Level 1 Überschrift am Anfang eines Artikels steht. +
- +
-Wenn in einer Seite mehr als 3 Überschriften vorkommen, wird automatisch ein Inhaltsverzeichnis erstellt, welches alle Überschriften auflistet.\\ +
-Soll dieses Inhaltsverzeichnis nicht erstellt werden, muß der Befehl: ''<nowiki>~~NOTOC~~</nowiki>'' mit in die Seite aufgenommen werden.+
  
 +=== Überschriften ====
 +Überschriften werden mit maximal sechs "=" eingerahmt. Es gibt fünf unterschiedliche Ebenen. 
   ====== Überschrift Ebene 1 ======   ====== Überschrift Ebene 1 ======
   ===== Überschrift Ebene 2 =====   ===== Überschrift Ebene 2 =====
Zeile 71: Zeile 51:
 Innerhalb von Überschriften können keine weiteren Formatierungen vorgenommen werden! Innerhalb von Überschriften können keine weiteren Formatierungen vorgenommen werden!
  
 +Überschrift 1 steht am Anfang eines Artikels. Wenn in einer Seite mehr als 3 Überschriften vorkommen, wird automatisch ein Inhaltsverzeichnis erstellt, welches alle Überschriften auflistet.
  
 +Soll kein Inhaltsverzeichnis erstellt werden, muss der Befehl: ''<nowiki>~~NOTOC~~</nowiki>'' mit in die Seite aufgenommen werden.
  
-===== 1.4 unformatierte Abschnitte ===== 
  
-Um Text so anzuzeigen, wie er geschrieben wurde, egal ob er DokuWiki Formatierungen oder andere Formatierungen enthält, kann man jede +=== unformatierte Abschnitte ===
-Zeile mit zwei Leerzeichen beginnen (so wie es in dieser Seite angewendet wurde) oder einen der Bezeichner "code" bzw "file" benutzen:+
  
-<code> +Um Text unformatiert in einer Box erscheinen zu lassen, beginnt man jede Zeile mit zwei Leerzeichen oder verwendet %%<code></code>%%:
-Mit "code": In diesem Text werden keine überflüssigen Leerzeichen entfernt: wie hier              <-- zwischen +
-</code>+
  
-<file> +  Um Text unformatiert in einer Box erscheinen zu lassen, beginnt man jede Zeile mit zwei Leerzeichen
-Mit "file": Eigentlich das Gleiche wie oben, sieht nur etwas anders aus. \\  +
-Vielleicht um Zitate zu kennzeichnen oder ähnliches. +
-</file>+
  
-Um jegliche Umwandlung durch DokuWiki abzustellen, umschließe den entsprechenden Bereich mit "nowiki" Bezeichnern oder kürzer mit doppelten Prozentzeichen ''<nowiki>%%</nowiki>''.+oder %%<file></file>%%
  
-<nowiki> +<file>mit file sieht es etwas anders aus .. </file>
-Dieser Text enthält links wie: http://www.splitbrain.org und **Formatierungen** aber sie werden nicht umgesetzt und erscheinen als normaler Text. +
-</nowiki>+
  
-Einfach den Quelltext dieser Seite anschauen (den Knopf "edit" drücken) um zu sehen, wie diese Blöcke angewendet werden.+Um jegliche Umwandlung durch DokuWiki abzustellen, umschließe den entsprechenden Bereich mit %%<nowiki></nowiki>%% oder mit doppelten Prozentzeichen ''<nowiki>%%</nowiki>''.
  
-===== 1.5 Syntax-Hervorhebung ===== 
  
-[[DokuWiki]] kennt Syntax highlighting für Quellcode, um dessen Lesbarkeit zu erhöhen. Dafür wird [[http://qbnz.com/highlighter/|GeSHi]] "**Ge**neric **S**yntax **Hi**ghlighter" benutzt. Somit wird jede Programmiersprache unterstützt, die GeSHi kennt.\\ +=== Zitat / Kommentar === 
-Es wird der gleiche Bezeichner wie im vorherigen Abschnitt benutzt, nur dass er nun auch den Namen der Sprache enthält:\\ +Zitate oder Kommentar werden mit dem  "größer als" - Zeichen gekennzeichnet
-''<nowiki><code java> Quelltext </code></nowiki>''+
  
-<code java> +%%> Zitat 1%%
-/**  +
- * The HelloWorldApp class implements an application that +
- * simply displays "Hello World!" to the standard output. +
- */ +
-class HelloWorldApp { +
-    public static void main(String[] args) { +
-        System.out.println("Hello World!"); //Display the string. +
-    } +
-} +
-</code>+
  
-Es werden folgende Sprachen unterstützt: \\ //actionscript, actionscript-french, ada, apache, applescript, 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**//+%%>> Antwort auf Zitat 1%%
  
-===== 1.6 Zitat / Kommentar ===== +%%>>> Antwort auf Antwort%%
-Um einen Text als Zitat oder Kommentar zu kennzeichen, wird das "größer als" - Zeichen folgendermaßen verwendet:+
  
-  Ich denke wir sollten es tun. +ergibt: 
-   +
-  > 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 kennzeichen, wird das "größer als" - Zeichen folgendermaßen verwendet+
  
-Ich denke wir sollten es tun+> Zitat 1
  
-> Nein, sollten wir nicht.+>> Antwort auf Zitat 1
  
->> Doch!+>>> Antwort auf Antwort
  
-> 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 kennzeichen, wird das "größer als" - Zeichen folgendermaßen verwendet 
    
  
-====== 2 Links ======+==== Links ====
  
 Mit DokuWiki können 5 unterschiedliche Arten von Links benutzt werden: Mit DokuWiki können 5 unterschiedliche Arten von Links benutzt werden:
  
-===== 2.1 Extern ===== +^Externe Links|Externe Links (Verweise auf andere Webseiten oder Dateien) werden automatisch erkannt: %%http://www.google.com%% oder einfach %%www.google.com%%|http://www.google.com bzw. www.google.com| 
- +^ |Links können auch hinter Begriffen versteckt werden: %%[[http://www.google.com|hier ist google]]%%|[[http://www.google.com|hier ist google]]| 
-Externe Links (Verweise auf andere Webseiten oder Dateien) werden automatisch erkannt: http://www.google.com oder einfach www.google.com\\ +^E-Mail-Adressen|%%<andi@splitbrain.org>%%|<andi@splitbrain.org>| 
-Verweise können auch hinter eigenen Begriffen versteckt werden: [[http://www.google.com|hier ist google]] \\ +^ |oder ebenfalls hinter Begriffen versteckt %%[[andi@splitbrain.org|Mail an Andi]]%%|[[andi@splitbrain.org|Mail an Andi]]| 
-E-mail Adressen werden in spitze Klammern gesetzt: <andi@splitbrain.org> +^Interne Links|%%[[Seitenname]]%% Namen für neue Seiten werden automatisch in Kleinbuchstaben umgewandelt. Umlaute sind genauso wie Sonderzeichen nicht erlaubt!|[[Seitenname]]| 
- +^ |Interne Links können ebenfalls hinter Beschreibungen versteckt werden %%[[Seitenname|Beschreibung des Links]]%%|[[Seitenname|Beschreibung des Links]]| 
-  Externe Links werden automatisch erkannt: http://www.google.com oder einfach  www.google.com\\ +^ |Links zu [[:start|existierenden Seiten]] werden anders angezeigt als Links zu [[nicht-existierenden]] Seiten.| | 
-  Verweise können auch hinter eigenen Begriffen versteckt werden: [[http://www.google.com|hier ist google]] \\ +^Links zu anderen Wikis|%%[[doku>de:interwiki]]%% oder %%[[wp>Wiki]]%%|[[doku>de:interwiki]] oder [[wp>Wiki]]|
-  E-mail Adressen werden in spitze Klammern gesetzt: <andi@splitbrain.org> +
- +
-===== 2.2 Intern ===== +
- +
-Interne Links, also Verweise auf Seiten innerhalb von DokuWiki, werden in doppelten eckigen Klammern gesetzt("altgr+8" bzw. altgr+9 auf einer win-tastatur bzw Wahltaste+5 und Wahltaste+6 bei Apple) auf:\\ +
-[[doku>pagename]]\\ +
- +
-Ein Link kann auch hinter einem Begriff oder einer Beschreibung versteckt werden:\\ +
-[[doku>pagename|Beschreibung für einen Link]]. +
- +
-  Interne Links werden in doppelten eckigen Klammern gesetzt: +
-  [[pagename]]  +
-   +
-  Ein Link kann auch hinter einem Begriff oder einer Beschreibung versteckt werden: +
-  [[pagename|Beschreibung für einen Link]]. +
- +
-Dateinamen für neue Seiten im Wiki werden automatisch in Kleinbuchstaben umgewandelt!\\ +
-Umlaute sind genauso wie Sonderzeichen nicht erlaubt! +
- +
-Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst: [[de:namespaces]]  +
- +
-  Durch einen Doppelpunkt werden Namensbereiche im Wiki aufgelöst:[[de:namespaces]]  +
- +
-Weitere Informationen zu Namensbereichen: [[doku>de:namespaces]]. +
- +
-Anmerkungen: +
- +
-  * Links zu [[syntax|existierenden Seiten]] werden anders angezeigt als Links zu [[nicht-existierenden]] Seiten. +
-  * DokuWiki verwendet standardmäßig keine [[wp>CamelCase]] für Links. \\ In der Einstellungsdatei: [[doku>config]] kann das aber geändert werden. \\ **Hinweis**: wenn das Wort: DokuWiki als Link angezeigt wird, dann ist diese Option eingeschaltet. +
- +
-===== 2.3 Interwiki ===== +
- +
-DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links. \\ +
-Ein Link zur Wikipedia Seite über Wikis:[[wp>Wiki]] +
- +
-  DokuWiki unterstützt auch Links in andere Wikis, sogenannte [[doku>de:interwiki]] Links. \\ +
-  Ein Link zur Wikipedia Seite über Wikis:[[wp>Wiki]] +
- +
-===== 2.4 Windows-Freigaben ===== +
- +
-DokuWiki kennt auch Links auf Windows-Freigaben: [[\\server\freigabe|freigegebener-Ordner]]. \\ +
-Dies ist allerdings nur in einer homogenen Benutzergruppe sinnvoll (siehe [[wp>Intranet]]). +
- +
-  DokuWiki kennt auch Links auf Windows-Freigaben: [[\\server\freigabe|this]].+
  
-Hinweis: 
-  * Aus Sicherheitsgründen funktioniert direktes Navigieren durch die Freigaben standardmäßig nur mit dem Internet Explorer (und das nur in der "lokalen Zone")! 
-  * Für Mozilla und Firefox kann es durch die Option [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] eingeschaltet werden, was aber nicht empfohlen wird! 
-  * Opera ingnoriert 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 ===== ===== 2.5 Bilder als Links =====
Zeile 446: Zeile 338:
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
  
-====== Diskussion ======+====== Backgroundinfos zu dieser Seite====== 
 +Diese Seite ist eine Übersetzung der [[http://www.splitbrain.org/dokuwiki/wiki:syntax|Syntax-Seite aus DokuWiki (2005-07-13)]].\\ 
 +Sie ist keine wortgleiche Übersetzung. Einige Beschreibungen sind etwas ausführlicher ausgefallen. Fachbegriffe werden nur dort verwendet, wo eine Umschreibung mehr Verwirrung stiftet als nützt.\\ 
 +Ähnliches gilt auch für Begriffe, die dem Englischen entspringen, für manche gibt es keine direkte Übersetzungen. Oder sie sind schon so bekannt, dass eine Übersetzung unsinnig ist.\\ 
 +Der Übersetzer ist sich selbst nicht sicher, ob er lieber den Begriff "Link" oder "Verweis" benutzen soll.\\ 
 + 
 +An einigen Stellen befindet sich ein FIXME - hier gibt es etwas, was im Sinne des Übersetzers noch nicht gut umgesetzt wurde. 
 +  * Anregungen, Bemerkungen oder Hinweise auf Fehler sind willkommen. 
 +  * euer Sebastian Koch => mr_snede *at* web ~dot~ de 
 Seite grundlegend überarbeitet von  --- //[[dokuwiki.20.baucki@spamgourmet.com|Konrad Bauckmeier]] 2005-12-02 09:05// Seite grundlegend überarbeitet von  --- //[[dokuwiki.20.baucki@spamgourmet.com|Konrad Bauckmeier]] 2005-12-02 09:05//
 +{{tag>intern}}

Zuletzt angesehen:

QR-Code
QR-Code Formatting Syntax (erstellt für aktuelle Seite)