Hilfe:WikiSyntax

Aus DreamboxWIKI
Wechseln zu: Navigation, Suche

Einleitung

Wiki-Syntax - Was ist das?

Wiki-Syntax (engl.: wiki-markup) ist eine Auszeichnungsspache, ähnlich HTML. Sie dient dazu, Beiträge in Wikis zu erstellen und zu formatieren. Da es noch keinen allgemein gültigen Standart gibt, hängt die Syntax von der verwendeten Wiki-Software ab. Die im folgenden erklärete Syntax bezieht sich auf die Software des dieses Wikis.

Textgestaltung

Ein normaler Text wird so wiedergegeben, wie man ihn eingibt. Für einen Absatz fügt man einfach eine Leerzeile ein.

Um Texte hervorzuheben, kann man sie Fett, Kursiv oder Unterstrichen darstellen.

'''Fett'''
''Kursiv''
<u>Unterstrichen</u>

Verlinkungen

externe Links

Wiki-code Ergebnis Kommentar
http://dream.reichholf.net http://dream.reichholf.net "http"-Links werden automatisch umgewandelt
[http://dream.reichholf.net] [1] eigentliche Syntax für externe Links, automatisch durchnummeriert
[http://dream.reichholf.net Alternativname] Alternativname Der Link "Alternativname" führt zur jeweiligen Webseite
[http://dream.reichholf.net <span title="dream.reichholf.net im Internet">Alternativname</span>] Alternativname Der Link "Alternativname" mit Tooltip

Link auf ein Verzeichnis/Datei

Wiki-code Ergebnis
[file:///K:\PUBLIC\ K:\PUBLIC\] [file:///K:\PUBLIC\ K:\PUBLIC\]
[file:///K:\PUBLIC\pdf\barrierefreiePDF-Dokumente.pdf K:\PUBLIC\pdf\barrierefreiePDF-Dokumente.pdf] [file:///K:\PUBLIC\pdf\barrierefreiePDF-Dokumente.pdf K:\PUBLIC\pdf\barrierefreiePDF-Dokumente.pdf]
Hinweis: (Funktioniert grundsätzlich nur im IE) im Firefox müsssen die Sicherheitseinstellungen geändert werden
Fehler beim Erstellen des Vorschaubildes: Die Miniaturansicht konnte nicht am vorgesehenen Ort gespeichert werden
Mehr über file URI scheme bei Wikipedia

interne Links

auf (Artikel-)Seiten verlinken

Wiki-code Ergebnis Kommentar
[[Hauptseite]] Hauptseite Der Link "Hauptseite" führt zur wiki-internen Seite namens Hauptseite
[[Hauptseite#Überschrift]] Hauptseite#Überschrift "Hauptseite" führt zur Hauptseite und der Überschrift namens "Überschrift" (gibt es in diesem Falle nicht)
[[Hauptseite|Alternativname]] Alternativname Der Link "Alternativname" führt zur wiki-internen Seite namens Hauptseite
[[Hauptseite|<span title="Die Hauptseite aufrufen">Alternativname</span>]] Alternativname Der Link "Alternativname" führt zur Hauptseite mit Tooltip: "Die Hauptseite aufrufen"

auf Kategorien verlinken

Wiki-code Ergebnis Kommentar
Kategorie:Server Kategorie:Server "Kategorie:Server" bleibt unverlinkt
[[:Kategorie:Server]] Kategorie:Server Der Link führt zur Kategorie Server
[[:Kategorie:Server|Alternativname]] Alternativname Der Link "Alternativname" führt ebenfalls zur Kategorie Server

auf ein Bild verlinken

Wiki-code Ergebnis Kommentar
[[:Bild:Name des Bildes.png]] Titel Der Link führt zum Bild


auf Seiten in anderen Namensräumen verlinken

Wiki-code Ergebnis Kommentar
[[Namensraum:Titel|Titel]] Titel Der Link "Namensraum:Titel" führt zur Seite Titel im angegebenen Namensraum

Überschriften

Um einen Artikel übersichtlich zu gestalten, sollte er in verschiedene Abschnitte unterteilt werden. Diese werden mit Überschriften gegliedert.

Als erste Überschrift wird automatisch der Seitenname verwendet. Alle andern Überschriften setzt man, in dem man die Überschrift mit zwei = einklammert. Für Unterabschnitte erhöht man einfach die Anzahl der =.

Beispiel:

== Überschrift ==
=== Unterüberschrift ===
==== Unter-Unterüberschrift ====

Inhaltsverzeichnis

Ein der Übersicht dienendes Inhaltsverzeichnis wird von der Wiki-Software automatisch erzeugt, sobald mehr als drei Überschriften im Artikel vorhanden sind. Per Default steht dieses über der ersten Überschrift, es sei denn, man erzwingt mit __TOC__ ein Inhaltsverzeichnis an einer beliebigen Stelle.

Listen

Eine Liste mit einer kleinen Bullet-Grafik am Anfang erstellt man, indem man ein * an den Anfang der Zeile setzt. Für verschachtelte Listen erhöht man einfach die Anzahl der *.

Unnummerierte Liste

Syntax:

*Punkt 1
*Punkt 2
** Unterpunkt 1
  • Punkt 1
  • Punkt 2
    • Unterpunkt 2.1

Nummerierte Liste

Syntax:

# Punkt 1
# Punkt 2
## Unterpunkt 2.1
  1. Punkt 1
  2. Punkt 2
    1. Unterpunkt 2.1

Nummerierte + Unnummerierte Liste

Eine Mischung von nummerierte/unnummerierten Listen wird dadurch erreicht; das man ersetzt einfach # dem * voransetzt: #*. Syntax:

# Punkt 1
# Punkt 2
#* Unterpunkt 1
#* Unterpunkt 2
  1. Punkt 1
  2. Punkt 2
    • Unterpunkt 1
    • Unterpunkt 2

Aufzählungszeichen

Will man Aufzählungszeichen in einer Tabelle verwenden, so muss der erste Listeneintrag in einer neuen Zeile beginnen. Andernfalls wird beim ersten Eintrag anstatt eines Aufzählungszeichens ein Sternchen angezeigt.

Eingabe Ergebnis

{| border="1"
|* erster Eintrag
* zweiter Eintrag
|}

* erster Eintrag
  • zweiter Eintrag

{| border="1"
|
* erster Eintrag
* zweiter Eintrag
|}

  • erster Eintrag
  • zweiter Eintrag


Tabellen

Formatierungen

Farben, Ränder, Abstände und Spaltenbreiten können durch CSS]-Styles vielfältig beeinflusst werden. Bevor man sich dazu entschließt, sollte man über die Notwendigkeit des Unterfangens nachgedacht haben und auch Bestrebungen zur Vereinheitlichung berücksichtigen (siehe einbinden Wie sehen gute Artikel aus#Tabellen einbinden" in Wie sehen gute Artikel aus und Formatvorlagen).

Andere HTML-Formatierungen

Mit der neuen Wiki-Syntax ist es möglich, alte HTML-Formatierungen zu übernehmen, z.B. Zellen farbig zu hinterlegen (style="background:#ABCDEF;", HTML-Farben Farbtabelle bei Wikipedia) oder Rahmen andere Farben zu geben. Diese Vorgehensweise ist bei neuen Tabellen aber nicht empfohlen.

Eingabe Ergebnis

{|
| style="background:#ABCDEF;" | A
| B
|-
| C
| D
|}

A B
C D

Zellenabstände mit cellspacing und cellpadding

Mit cellspacing kann der Abstand zwischen den Zellen festgelegt werden. Je größer der Cellspacing-Wert, desto breiter wird der Steg zwischen den Zellen. Mit cellpadding bestimmt man den Abstand des Zellinhaltes vom Zellrahmen.

Eingabe Ergebnis

{|
| Alpha || Beta || Gamma
|-
| Delta || Epsilon || Zeta
|}

Alpha Beta Gamma
Delta Epsilon Zeta

{| border="1"
| Alpha || Beta || Gamma
|-
| Delta || Epsilon || Zeta
|}

Alpha Beta Gamma
Delta Epsilon Zeta

{| border="1" cellspacing="10" cellpadding="0"
| Alpha || Beta || Gamma
|-
| Delta || Epsilon || Zeta
|}

Alpha Beta Gamma
Delta Epsilon Zeta

{| border="1" cellspacing="0" cellpadding="10"
| Alpha || Beta || Gamma
|-
| Delta || Epsilon || Zeta
|}

Alpha Beta Gamma
Delta Epsilon Zeta

{| border="1" cellspacing="10" cellpadding="10"
| Alpha || Beta || Gamma
|-
| Delta || Epsilon || Zeta
|}

Alpha Beta Gamma
Delta Epsilon Zeta

{| border="1" cellspacing="0" cellpadding="10" style="border-collapse:collapse;"
| Alpha || Beta || Gamma
|-
| Delta || Epsilon || Zeta
|}

Alpha Beta Gamma
Delta Epsilon Zeta

Ausrichtung

Genau wie in HTML kann man den Inhalt von Zellen in der Tabelle unterschiedlich ausrichten. Dabei kann man die Attribute einzelnen Zellen oder auch ganzen Zeilen zuweisen. Das valign gilt jeweils für die ganze Zeile, das align nur für die jeweilige Zelle.

Eingabe Ergebnis

{| border="1" cellspacing="0"
!
! align="left" | Links
! align="center" | Zentriert
! align="right" | Rechts
|- valign="top"
! height="38" | Oben
| align="left" | xx
| align="center" | xxx
| align="right" | xx
|- valign="middle"
! height="38" | Mitte
| align="left" | x
| align="center" | x
| align="right" | x
|- valign="bottom"
! height="38" | Unten
| align="left" | x
| align="center" | x
| align="right" | x
|}

Links Zentriert Rechts
Oben xx xxx xx
Mitte x x x
Unten x x x

Andere HTML-Formatierungen

Mit der neuen Wiki-Syntax ist es möglich, alte HTML-Formatierungen zu übernehmen, z.B. Zellen farbig zu hinterlegen (style="background:#ABCDEF;", Farbtabelle) oder Rahmen andere Farben zu geben. Diese Vorgehensweise ist bei neuen Tabellen aber nicht empfohlen.

Eingabe Ergebnis

{|
| style="background:#ABCDEF;" | A
| B
|-
| C
| D
|}

A B
C D

Formatvorlagen

Die Wiki-Spezialisten haben Vorlagen erstellt, um die Formatierung zu vereinfachen. Anstatt sich an die Tabellenparameter erinnern zu müssen, kann eine Formatvorlage verwendet werden. Diese ist nach dem {| einzufügen. Die Verwendung ermöglicht ein konsistentes Tabellenlayout, eine Erleichterung beim Fehlerhandling, die Einhaltung der Konvention Farben verwenden (Farben) sowie einfache Anpassung des Layouts bei allen Tabellen.

Beispielsweise diese Tabelle:

Multiplikation
× A B C
1 I II III
2 IV V VI
3 VII VIII IX
4 x XI XII
5 XIII XIV XV

wird durch einfaches Ersetzen von border="1" cellpadding="2" durch class="prettytable" zu:

Multiplikation
× A B C
1 I II III
2 IV V VI
3 VII VIII IX
4 x XI XII
5 XIII XIV XV

Dies ist der Fall, wenn die class="prettytable" vorhanden ist.

Ein weiteres Beispiel:

{| class="prettytable"
! Treffpunkt Y- u. X-Achse
! Exempel
! Beispiel
! Muster
|-
| X1
| {{Hintergrundfarbe6}} | X2
| X3
| X4
|-
| Y1
| {{Hintergrundfarbe8}} | Y2
| Y4
| {{Hintergrundfarbe7}} | Y5
|-
| Y6
| Y7
| {{Hintergrundfarbe10}} | Y8
| {{Hintergrundfarbe2}} | Y9
|}

erstellt folgende Tabelle:

Treffpunkt Y- u. X-Achse Exempel Beispiel Muster
X1 X2 X3 X4
Y1 Y2 Y4 Y5
Y6 Y7 Y8 Y9

Siehe auch

Bei Page MetaWiki befindet sich ein Table englischer Artikel, der die Gestaltung mit Tabellen etwas ausführlicher behandelt.

Im Abschnitt Tabellen in Artikel_aussehen Wie gute Artikel aussehen wird auf die Bedeutung von Vorlagen zur Vereinheitlichung hingewiesen.

Hilfen

  • WPro ist ein Wikipedia-Editor für den Internet Explorer 6.0, der Tabellen per Knopfdruck einfügen und formatieren kann.
  • EXCEL-Tabellenumwandlung konvertiert den ausgewählten Tabellenbereich aus MS Excel direkt ins Wiki-Tabellenformat. Die wichtigsten Formatierungen wie Fett/Kursiv, Zellenhöhe und -breite, Schriftgröße, Farbinformation aus MS Excel bleiben erhalten.
  • Excel2Wiki Berücksichtigt verbundene Zellen, dazu auch ein Programm zur Umwandlung der Spalten in Zeilen und umgekehrt und ein Programm zur Zeilenumkehr, d.h. die letzte Zeile wird zur ersten usw.
  • csv2wp ist ein Werkzeug zum Umwandeln von CSV-Dateien in Wiki-Tabellenformat. Damit lassen sich z.B. Tabellen aus Microsoft Excel importieren.
  • Excel-Diagramm als JPG-Bild speichern

Text ausrichten

Standartmäßig ist der Text im Wiki linksbündig. Dies kann man mit einem div-Container ändern.

Syntax Ausrichtung
<div align="right">text</div> Rechtsbündig
<div align="center">text</div> Zentriert
<div align="justify">text</div> Blocksatz

Alles was zwischen den beiden <div> steht, wird entsprechend ausgerichtet.

Möchte man zwei Texte nebeneinander stehen haben, benutzt man wieder div mit dem Attribut style.

Syntax:

<div style="float:left;">
Dieser Text steht links.
</div>
<div style="float:right;">
Dieser Text steht rechts.
</div>

Ausgabe:

Dieser Text steht links.

Dieser Text steht rechts.


Kommentare und Diskussionen

Kommentare kann man mit in den Quellcode eines Artikels schreiben. Sie dienen zum besseren Verständnis ("Was zur Hölle hat der da gemacht?") und werden bei der Ausgabe des Artikels ignoriert.

Definiert werden sie so:

<!-- Hier steht der Kommentar-->

Diskussion dagegen dienen der Abstimmung über Inhalt und Layout eines Artikels. Um auf die Diskussionsseite eines Artikels zu kommen, klickt man ganz oben auf der Seite auf "Diskussion". Einen neuen Kommentar legt man mit dem + an. Sollte noch keine Diskussionsseite angelegt worden sein (Link zur Diskussionsseite ist rot), schreibst man seinen Kommentar einfach in das große Textfeld. Damit man weiß, von wem der Kommentar stammt, kann man seine Signatur + Uhrzeit/Datum hinterlassen.

Syntax Ausgabe
--~~~ --Benutzername
--~~~~ --Benutzername 10:57, 15. Okt. 2006 (CET)
--~~~~~ --10:57, 15. Okt. 2006 (CET)

Verknüpfungen

Verknüpfungen (Links) sind ein wichtiges Element von Wikis. Durch sie kann man zwischen verschiedenen, zusammenhängenden Artikeln hin- und herspringen.

Einem Link auf eine andere Wiki-Seite legt man mit [[Name_der_Seite]] an. Die Ausgabe ist dann Name_der_Seite.

Möchte man die Beschriftung des Links ändern, schreibt man [[Name_der_Seite|Titel]]. Die Ausgabe ist dann Titel.


Wenn man auf eine Seite außerhalb des Wikis verlinkt, wird nur eine eckige Klammer verwendet. Außerdem wird der | durch ein Leerzeichen ersetzt. Links ohne Beschreibung werden automatisch durchnummeriert.

https://wiki.stadt-muenster.de/index.php wird zu https://wiki.stadt-muenster.de/index.php

[https://wiki.stadt-muenster.de/index.php] wird zu [2].

[https://wiki.stadt-muenster.de/index.php dream.reichholf.net] wird zu dream.reichholf.net.


Um deutlich zu machen, in welcher Sprache ein externer Link ist, kann man diesen mit einer kleinen Flagge kennzeichnen.

Bilder

Bilder lassen sich mit [[Bild:Bildname|Beschreibung]] in das Wiki einbinden. Es erscheint dann in Orginalgröße.

Möchte man einen Rahmen um das Bild, fügt man einfach ein "framed" hinzu.

[[Bild:Bildname|framed|Beschreibung]]


Aus Rücksicht auf Modem-Besitzer sollte man allerdings ein Thumbnail erstellen. Dieses ist Standartmäßig 180 Pixel breit. Die Höhe wird aus dem Seitenverhältnis automatisch berechnet. Ein Klick auf das Thumbnail zeigt das Bild in Originalgröße.

[[Bild:Bildname|thumb|Beschreibung]]


Die Breite eines Thumbnails lässt sich auch manuell bestimmen.

[[Bild:Bildname|thumb|100px|Beschreibung]]


Außerdem lassen sich die Bilder noch mit left/ right/ none ausrichten.

[[Bild:Bildname|left|Beschreibung]]


Bilder als Links

Bilder können für einen Link auf eine interne oder externe Datei verwendet werden. Dazu wird die Syntax zur Anzeige von Links einfach mit der zur Anzeige von Bildern (siehe unten) kombiniert:

[[http:///DreamboxWIKI|{{wiki:wiki.jpg}}]]

Bilder untereinander

Bilder können untereinander dargestellt werden, indem man unterhalb des Bildes einen Absatz einfügt.

 [[Bild:eins.jpg|left|thumb|600px|Erstes Bild]]
 {{subst:Absatz}}
 [[Bild:zwei.jpg|left|thumb|300px|Zweites Bild]]
 {{subst:Absatz}}
 

Vorlagen

Vorlagen sind Wiki-Seiten, dessen Inhalt mit bestimmten Befehlen an beliebiger Stelle im Artikel eingebunden werden können. Das ist zum Beispiel dann sinnvoll, wenn man eine Vorlage anlegt, in der steht, dass ein Artikel noch ausbaufähig ist. Findet man einen solchen Artikel, lässt sich einfach die (einheitliche) Vorlage einbinden, statt dass man sich immer einen neuen Text aus den Fingern saugen muss.


Vorlagenseiten legt man wie jede andere Wiki-Seite auch an, nur dass der Namensraum ein anderer ist.

https://dream.reichholf.net/index.php/Vorlage:Testvorlage erzeugt die Vorlagenseite "Vorlage:Testvorlage". Diese lässt sich jetzt wie gewohnt über "bearbeiten" anlegen/ändern.


Ist die Vorlage fertiggestellt, kann man sie jederzeit mit dem Befehl {{Name_der_Vorlage}} in die Seite einbinden. D.h., {{Name_der_Vorlage}} wird durch den Inhalt der Seite Name_der_Vorlage ersetzt.

Für die Testvorlage müssten wir zum Einbinden also schreiben:

{{Testvorlage}}


Damit sich nicht jeder, der eine Vorlage betrachtet, fragt "Wozu ist die denn gut?", kann man eine kurze Erklärung abgeben, welche nicht mit eingebunden wird. Man verwendet dazu <noinclude></noinclude>.

Beispiel:

<noinclude>
Dieser Text wird beim Einbinden in einen Artikel ignoriert.
</noinclude>

Inhalt der Vorlage, welcher eingebunden wird.


Manchmal möchte man einer Vorlage noch einen Kommentar hinzufügen, z.B., um zu sagen, warum ein Artikel noch ausbaufähig ist. Für dieses Problem gibt es in der Wiki-Software sogenannte Parameter.

Parameter werden optional in den Code zum Einbinden einer Vorlage geschrieben, mit einem | vom Vorlagenname getrennt.

{{Testvorlage|Dies ist ein Parameter}}

Nun muss man in der Vorlage noch definieren, wo der Parameter eingefügt werden soll. Dazu verwendet man {{{1}}}. Das {{{1}}} wird beim Einbinden in einen Artikel durch den Inhalt des Parameters ersetzt.

Natürlich kann man auch mehrere Parameter verwenden.

{{Testvorlage|Parameter1|Parameter2}}
Testvorlage
{{{1}}}
{{{2}}}

Ausgabe:

Testvorlage
Parameter1
Parameter2


Zurzeit im diesem Wiki verfügbare Vorlagen

Weblinks