inhalt der datei MarkupLang.wiki.2013-11-26-11-43-46

Letzte Änderung: 26.Nov.2013, 11:43:46

Einfache Markup-Regeln

eine Kurzzusammenfassung der wichtigsten Elemente bietet markup.

Zur Tabelle

Allgemeine Anmerkungen

  1. Kursive geschriebener Text in den Spalten Wiki-Markup und Erzeugtes HTML-Markup ist nicht literal, sondern beschreibend gemeint (Zeilenumbruch steht für einen Zeilenumbruch im Wiki-Quelltext, nicht für die Zeichenfolge Zeilenumbruch).
  2. text steht für ein beliebiges Stück Text innerhalb eines Absatzes oder eines Nummerierungs- oder Aufzählungspunktes.
  3. Ein Zeilenumbruch im Wiki-Quelltext führt zu einem Zeilenumbruch im Browser; innerhalb des Wiki-Codes für Tabellen, Listen oder Ähnliches kann ein Zeilenumbruch zu Fehlern führen. Wenn der Editor, mit dem der Wiki-Quelltext geschrieben wird, Zeilenumbrüch erzeugt, kann man deren Wirkung mit einem Backslash am Zeilenende aufheben. Damit wirkt allerdings der Zeilenumbruch auch nicht mehr als Leerzeichen. Wenn also ein Leerzeichen erwünscht ist, sollte am Zeilenende "Leerzeichen Backslash" getippt werden.
  4. Wikicodes, die am Anfang einer Quelltext-Zeile stehen und eine besondere Absatzart kennzeichnen (wie + für Überschrift, * und # für Listenelemente) müssen mit einem Leerzeichen vom folgenden Text getrennt werden. Sonst werden sie nicht als Markup interpretiert.
  5. Ein On-Page-Link auf einer Wiki-Seite (also ein Link zu einer als Anker gekennzeichneten Stelle auf der aktuellen Seite) geht offenbar nur so, als ob man von außerhalb des Dokuments auf die Anker-Stelle im Dokument verweist: ((page|text#anchor)).

Tabelle der Markups

Wiki-Markup Erzeugtes HTML-Markup Darstellung im Browser Anmerkungen
Zeilenumbruch Einfügen eines <br />-Tags Erzwingt Zeilenumbruch siehe oben, Anmerkung 3
Zeilenumbrüche innerhalb von Tabellen- oder Listenelementen sind mit "Leerzeichen_Zeilenumbruch" zu erzeugen, siehe unten
Leerzeile Neuer Absatz: </p><p> Neuer Absatz Zusätzlich zum Zeilenumbruch wird vertikaler Leerraum eingefügt
//text// <em>text</em> text wird hervorgehoben (kursiv dargestellt) text soll keine Leerzeilen enthalten. Einfache Zeilenümbrüche sind möglich.
**text** <strong>text</strong> text wird stark hervorgehoben (fett dargestellt) text soll keine Leerzeilen enthalten. Einfache Zeilenümbrüche sind möglich.
{{text}} <tt>text</tt> text wird in einem "monospaced font" (nichtproportional) dargestellt text soll keine Leerzeilen enthalten. Einfache Zeilenümbrüche sind möglich.
* text <li> text</li> innerhalt von <ul> ... </ul> Listenelement einer Aufzählung (ungeordneten Liste) Nur die Listenelemente angeben, keinen speziellen Code für Beginn und Ende der Liste.
Zwischen * und text muss ein Leerzeichen stehen.
# text <li> text</li> innerhalt von <ol> ... </ol> Listenelement einer Nummerierung (geordneten Liste) Nur die Listenelemente angeben, keinen speziellen Code für Beginn und Ende der Liste.
Zwischen # und text muss ein Leerzeichen stehen.
+ text
++ text
+++ text
++++ text
<h1>text</h1>
<h2>text</h2>
<h3>text</h3>
<h4>text</h4>
Überschrift erster bis vierter Ordnung Die Zahl der Pluszeichen gibt die Ordnung der Überschrift an.
Zwischen dem (den) Pluszeichen und text muss ein Leerzeichen stehen.
text, dem zwei Backquotes vorangehen und zwei Backquotes folgen text
Wiki-Markup innerhalb von text wird nicht in HTML-Markup transformiert
Wiki-Markup innerhalb von text wird nicht interpretiert Ein Backquote ist dieses Zeichen: ` (auf deutschen Tastaturen rechts neben dem ß, und zwar "oben", also mit der Umschalttaste für Großbuchstaben zu erreichen)
((page)) <a href="view.php5?page=page">page</a> Anzeige als Link auf die Wiki-Seite page, angezeigter Text ist ebenfalls page Das funktioniert so nur für Wiki-Seiten desselben Wiki-Systems.
Diese Art von Links sind sogenannte "Freelinks" in der Wiki-Terminologie. Die andere Variante von systeminternen Links werden aus !CamelCase-Wörtern generiert, siehe Anmerkung 5 und LinkExamples.
((page|text)) <a href="view.php5?page=page">text</a> Anzeige als Link auf die Wiki-Seite page, angezeigter Text ist text Das funktioniert so nur für Wiki-Seiten desselben Wiki-Systems.
Das ist auch ein "Freelink", siehe vorige Zeile, Anmerkung 5 und und LinkExamples.
((page#anchor)) ... href="view.php5?page=page#anchor" ...
sonst wie Freelink ohne gesonderten Link-Text
Anzeige als Link auf eine spezielle Stelle (einen Anker) auf der Wiki-Seite page. Der angezeigte Link-Text ist page Ohne Leerzeichen sind # und der Name des Ankers an den Namen der Seite anzufügen. Der Seitenname ohne Anker wird als Linktext angezeigt. Siehe Anmerkung 6.
((page|text#anchor)) Wie voriges, aber mit Link-Text text anstelle von page. Anzeige als Link auf eine spezielle Stelle (einen Anker) auf der Wiki-Seite page. Der angezeigte Link-Text ist text # und der Name des Ankers sind an den Link-Text anzuschließen, nicht an den Seitennamen. Siehe Anmerkung 6.
((:dateiname:)) wie die vorigen, aber fuer (pdf-)dateien im Verzeichnis files/ Link direkt auf die betreffende (pdf-)datei was beim Verfolgen des Links passiert liegt am Browser (zB speichern, öffnen in separatem pdf Leseprogramm, ...)
[[# anchor]] <a id="anchor"></a> Fügt einen Anker in die Seite ein Bitte das Leerzeichen zwischen # und dem Anker-Text beachten.
url <a href="url">url</a> Anzeige als Link auf die externe Internet-Seite url, angezeigter Text ist ebenfalls url Externer Link
url muss vollständig (mit Protokoll, also http:// ...) angegeben werden.
Der Link wird in einem neuen Fenster angezeigt.
[url text] <a href="url">url</a> Anzeige als Link auf die externe Internet-Seite url, angezeigter Text ist text Externer Link
url muss vollständig (mit Protokoll, also http:// ...) angegeben werden.
Der Link wird in einem neuen Fenster angezeigt.
[[image image-file-name]] <img src="image-file-name" alt="image-file-name"> fügt das Bild aus der Datei image-file-name ein Die image-Datei muss im Subdirectory images des aktuellen Directories sein. Der Dateiname muss die Erweiterung gif, jpg oder png haben.
Beispiele
---- <hr /> Horizontale Linie (Vier aufeinanderfolgende Minus-Zeichen)
Leerzeichen _Zeilenumbruch <br /> Zeilenumbruch, ohne das Tabellen - oder Listenelement zu verlassen (Leerzeichen, underscore, Zeilenumbruch)
Innerhalb eines Tabellen- oder Listenelements verwenden
[[toc]] Fügt HTML-Code für ein Inhaltsverzeichnis ein Ein klickbares Inhaltsverzeichnis wird angezeigt Das Inhaltsverzeichnis wird aus den Überschriften (mit +, ++, ... gekennzeichnet) erzeugt
~~ &nbsp; Non-breaking space Zwei aufeinanderfolgende Tilden (~~)


Weitere Markups

Beispiele


alte versionen muessen erst restored werden, bevor sie editiert werden koennen.
bei aktuellen versionen fuehrt der edit link direkt zur angezeigten zelle.