Hilfe:WikiSyntax

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>

• mehr in der Hilfe:Symbolleisten

Verlinkungen

externe Links

Link auf ein Verzeichnis/Datei

Hinweis: (Funktioniert grundsätzlich nur im IE) im Firefox müsssen die Sicherheitseinstellungen geändert werden
 Mehr über „file URI scheme“ bei Wikipedia

interne Links

auf (Artikel-)Seiten verlinken

auf Kategorien verlinken

auf ein Bild verlinken

auf Seiten in anderen Namensräumen verlinken

Ü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.

• mehr in der Hilfe:Variablen#Magic_Words

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.

Tabellen

• Hilfe für Tabellen
• Sortierbare 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.

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.

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.

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.

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:

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

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

Ein weiteres Beispiel:

erstellt folgende Tabelle:

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.

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:

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.

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

• Media-Wiki Handbuch

• Mehr über „Wikipedia - Textgestaltung“ bei Wikipedia.