imported>PerfektesChaos: lf

2022-04-17T19:15:49Z

Neue Seite

{{Hilfe}}
Auf dieser Hilfeseite werden Hintergründe zur Kodierung und Entschlüsselung von [[Wikitext]]en dargestellt.

Für schnelle Hilfe bei konkreten Anwendungsfällen ist [[Hilfe:Textgestaltung]] gedacht.

== Ziele ==
Die Ausgangspunkte bei der Definition der Wikisyntax um 2000 waren:
* Quelltext soll ''ohne zusätzliche Software'' von jedem geschrieben werden können.
* Quelltext soll mit wenigen, einfachen und kurzen Mitteln das erforderliche „[[Auszeichnungssprache|Markup]]“ – also die Formatierung dauerhaft verständlicher Texte – ermöglichen.

Das ist teilweise bis heute möglich, als oft der Quelltext problemlos gelesen und verstanden werden kann.

In Teilen mancher Seiten wird versucht, eine komplexe grafische Darstellung herzustellen, die nur noch wenige Fachleute im Quelltext verstehen und schreiben können. Für sichere Bearbeitung ausgefeilter Strukturen wie in [[Hypertext Markup Language|HTML]] wären fortgeschrittene Software-Werkzeuge erforderlich. Dies widerspricht den Ausgangszielen, und auch mit Hilfsmitteln bedarf es intensiver Einarbeitung in deren Bedienung und schafft ebenso eine Hürde.

Die Situation ist vergleichbar mit der Entwicklungsgeschichte von HTML. In den ersten Jahren bis etwa 1995 war diese Sprache dafür vorgesehen, mit einfacher Syntax normale Texte aufzubereiten und wesentliche Gliederungselemente, Hervorhebungen und vor allem [[Hyperlink]]s zu ermöglichen.<ref>{{RFC-Internet |RFC=1866 |Titel=Hypertext Markup Language – 2.0 |Datum=1995-11}}</ref> Später kam es dann zur Einführung umfangreicher grafischer Gestaltungsmöglichkeiten, Multimedia-Elemente und dynamisch generierte Funktionalitäten entfernten sich weit von den schlichten Notizen der Wissenschaftler um 1990.

== Formale Sprache? ==
Es ist offenbar bislang noch niemandem gelungen, die Wikisyntax in einer operational nutzbaren [[Formale Sprache|formalen Beschreibung]] (wie [[Backus-Naur-Form|BNF]]) darzustellen. Das liegt an der Vieldeutigkeit der wenigen Sonderzeichen.
* Die Beschränkung auf wenige und einfache Syntaxelemente führt zu vielfachen Interpretationsmöglichkeiten.
* Die Interpretation kann nicht in allen Fällen dem Wikitext selbst entnommen werden, sondern hängt von Faktoren außerhalb des Projekts ab sowie von der Konfiguration des momentanen Projekts und der Lokalisierung für diese Sprache.
* Erst eine Transformation mittels Parsoid ermöglicht eine derartige Struktur; siehe [[mw:Parsoid/MediaWiki DOM spec]] (englisch).

''Beispiele:''
* <code>[[[[Nd:YAG-Laser]]]]</code>   oder   <code>[[[[CSI: Miami]]]]</code>
** Dies sind zurzeit Wikilinks auf Artikel im selben Projekt.
** Sobald ein Wikiprojekt in ''[[IsiNdebele]]'' oder ''Coast [[Miwok]]'' existieren würden (<code>nd</code> und <code>csi</code> sind Sprachcodes nach [[ISO 639]]), wären es dort die Artikel „YAG-Laser“ oder „Miami“.
* <code>re</code> ist zurzeit kein Sprachcode in ISO 639 – wenn es das einmal wird und es ein Wiki in dieser Sprachversion gibt, wären die Artikel [[re:publica]] und [[Re:konstruKt]] im anderen Wiki zu finden.
* In der schwedischsprachigen Wikipedia gibt es einen Artikel [[:sv:S:t Eriksplan (tunnelbanestation)|S:t Eriksplan (tunnelbanestation)]].
** Nach landläufigem Verständnis würde <code>S:</code> das [[Hilfe:Interwiki-Links|Projektkürzel]] für [[Wikisource]] sein, wobei die Groß- und Kleinschreibung des „s“ keine Bedeutung hat. Hier schon.

== Grundlegende Syntaxelemente ==

{| class="wikitable"
! Syntaxelement !! Interpretation
|-
| <code><</code> … <code>></code>
|
* [[Hilfe:Tags|Tag]] (HTML oder Erweiterung)
|-
| <code>&</code> … <code>;</code>
|
* [[Hilfe:Tags#Entities|Zeichen-Entität]]
|-
| <code>[[</code> … <code>]]</code>
|
* [[Hilfe:Links#Wikilink|Wikilink]]; gleiches oder externes Projekt, ggf. mit Titel Doppelpunkte <code>:</code> zur Gliederung nach Projekt, Sprache, [[Hilfe:Namensräume|Namensraum]] einzusetzen
* [[Hilfe:Medieneinbindung|Medieneinbindung]], ggf. mit Parametern
* [[Hilfe:Kategorien|Kategorisierung]], ggf. mit Sortierschlüssel
* [[Hilfe:Internationalisierung|Interlanguage]]
Pipe-Symbole <code>|</code> ggf. zur inneren Gliederung
|-
| <code>[</code> … <code>]</code>
|
* [[Hilfe:Links#Weblinks|Weblink]]; [[Uniform Resource Locator|URL]] mit mindestens <code>//</code>
|-
| <code>{{{</code> … <code>}}}</code>
|
* Parameterwert in der [[Hilfe:Vorlagen/Programmierung|Vorlagenprogrammierung]]
|-
| <code>{{</code> … <code>}}</code>
|
* [[Hilfe:Parserfunktionen|Parserfunktion]] auf Projekt-Ebene
** Keine Leerzeichen in Funktionsnamen.
** Bei Parserfunktionsaufrufen wird ein möglicher erster Parameter durch Doppelpunkt <code>:</code> vom Funktionsnamen abgetrennt, bei [[Hilfe:Seiten einbinden|Vorlageneinbindungen]] steht schon vor dem ersten Parameter das Pipe-Symbol.
* [[Hilfe:Vorlagen|Vorlageneinbindung]] (allgemeiner: „[[Hilfe:Seiten einbinden|Seiteneinbindungen]]“) Pipe-Symbole <code>|</code> zur inneren Gliederung.
|-
|Zeilenanfänge: <code>{|</code> … <code>|}</code>
|
* [[Hilfe:Tabellen|Tabellensyntax]],<ref><code>:</code> vor <code>{|</code> zurzeit technisch möglich, aber nicht zu empfehlen; könnte langfristig zu Schwierigkeiten führen.</ref> mit inneren Elementen Pipe-Symbole am Zeilenanfang <code>|</code> zur inneren Strukturierung, auch <code>!</code><ref>Leerzeichen werden zurzeit ignoriert; doppelte Leerzeilen werden der Tabellenzelle zugerechnet.</ref>
|-
| <code>_</code> <code>_ </code>''key''<code>_</code> <code>_ </code>
|
* [[Hilfe:Schalterfunktionen|Schalterfunktion]]; meist keine an derselben Stelle sichtbare Wirkung
|-
| <code>ISBN PMID RFC</code>
|
* [[Hilfe:Magische Wörter#RFC, PMID, ISBN|Magisches Wort]], wenn Schlüsselnummer angegeben
|-
| <code>~~~</code> / <code>~~~~~</code>
|
* [[Hilfe:Magische Wörter#Tilden|Magisches Wort]]: Zeit, Benutzer, kombiniert
|-
| ''[[Uniform Resource Locator|URL]]''
|
* [[Hilfe:Links#Weblinks|Weblink]], wenn offen im Wikitext mit Protokoll (<code>http://</code> usw.), das als [[Hilfe:Magische Wörter#URL|Magisches Wort]] wirkt.
|-
| <code>=</code> … <code>=</code>
|
* [[Hilfe:Überschrift|Überschrift]]; Abschnittsbegrenzung
|-
|
''Leerzeile'' Zeilenanfang: <code>----</code> <code>* # ; :</code> ''Leerzeichen''
|
* Textformatierung, Block-Ebene
** Trennzeile, Absatz
** Linie
** [[Hilfe:Listen|Liste]]
** vorformatierter Text
|-
| <code>''</code> … <code>''</code>
|
* Textformatierung, Zeichen-Ebene (Kursiv- und Fettschrift)
|-
| <code>#REDIRECT</code>
|
* Beginn der ersten Zeile:<ref>[[Leerraum|Whitespace]] am Seitenbeginn möglich</ref> [[Hilfe:Magische Wörter#redirect|Magisches Wort]] Klassifizierung der gesamten Seite als [[Hilfe:Weiterleitung|Weiterleitung]]; weiterer Text nach dem ersten Wikilink möglich.
|-
| <code>-{</code> … <code>}-</code>
| LanguageConverter (für mehrsprachige Texte)
|}

Diese Syntaxkonstrukte werden vom [[Parser]] in ein [[Hypertext Markup Language|HTML]]-Dokument (oder einen Bereich davon) umgewandelt, was dann im Browser darstellbar ist.

{{Hilfe/Weitere Informationen|Liste=
{{MediaWiki|Parsoid|suffix=Wikitext Parser (englisch)}}
* [[mw:Wikitext standard]] auf Mediawiki (englisch) – erfolglose Forderung einer formalen Standardisierung; um 2006
* [[mw:Markup spec]] auf Mediawiki (englisch) – erfolgloser Versuch einer formalen Spezifikation; um 2011 aufgegeben
* [[mw:Alternative parsers]] auf Mediawiki (englisch) – Parser mit Versuchen einer Syntaxbeschreibung; weiterführende Links
* [http://meatballwiki.org/wiki/WikiMarkupStandard WikiMarkupStandard] auf meatballwiki.org (englisch)
}}

== Anmerkungen ==
<references />
<noinclude>
[[Kategorie:Hilfe:Wikisyntax| +]]
</noinclude>

Hilfe:Wikisyntax/Hintergrund - Versionsgeschichte

imported>PerfektesChaos: lf