staging.inyokaproject.org

Basisformatierung

Dieser Artikel dient als Ergänzung zu Wiki/Tabellen. Beschrieben wird die Umsetzung von Tabellen in die von der Portalsoftware Inyoka erwartete Syntax. Auch wenn die Realisierung mit der neueren Tabellenvorlage aufgrund der besseren Lesbarkeit und Wartbarkeit vorzuziehen ist, kann es unter Umständen nötig sein, bei komplexen (verschachtelten) Tabellen oder Sonderwünschen die im Folgenden beschriebenen Schreibweisen zu verwenden, die die Grundlage der neueren Tabellenvorlage bilden.

Es sind alle Formatierungsmöglichkeiten möglich, die im Hauptartikel genauer beschrieben sind. Daher werden diese hier nicht weiter behandelt.

Grundlegender Aufbau

Zelle 1 Zelle 2 Zelle 3
Zelle über drei Spalten

Das Einführungsbeispiel lässt sich z.B. mit diesem Code erzeugen:

|| Zelle 1 || Zelle 2 || Zelle 3 ||
|| <-3> Zelle über drei Spalten ||

Zum selben Ergebnis führt aber auch folgender Code:

|| Zelle 1


|| Zelle 2 || Zelle 3 ||
|| <-3> Zelle über drei Spalten ||

Diese Freiheit bezüglich Zeilenumbrüchen hat den unmittelbaren Vorteil, auch mehrzeilige Elemente (z.B. Vorlagen oder Listen) direkt einzugliedern.

Prinzip

Jeder vertikale Strich einer Tabelle zum Trennen der Tabellenspalten wird durch den Marker || ausgedrückt. Eine neue Tabellenzeile wird durch einen Zeilenumbruch nach abschließendem || und wieder einleitendem || angefangen. Zusätzliche Attribute lassen sich in spitzen Klammern <> direkt nach einer neuen Spalte ausdrücken.

Verschachtelung

Auf eine Verwendung der Tabellenbasisformatierung kann in der Regel verzichtet werden, da durch Inline-Vorlagen mit der üblichen Tabellenvorlage Syntaxelemente ebenfalls verschachtelt dargestellt werden können.

Inline-Vorlagen

Folgendes Beispiel lässt sich äquivalent (und deutlich lesbarer) mit der Tabellenvorlage darstellen. Beispiel:

Zelle 1:
echo "Hi!"' 
Zelle 2:

Hinweis:

Dies ist ein Hinweis

Zelle 3
Zelle über drei Spalten

Basisformatierung

||
Zelle 1:
{{{#!vorlage Befehl
echo "Hi!"'
}}}
|| Zelle 2:
{{{#!vorlage Hinweis
Dies ist ein Hinweis
}}} || Zelle 3 ||
|| <-3> Zelle über drei Spalten ||

Tabellenvorlage

{{{#!vorlage Tabelle
Zelle 1: [[Vorlage (Befehl, 'echo "Hi!"')]]
Zelle 2: [[Vorlage (Hinweis, "Dies ist ein Hinweis")]]
Zelle 3
+++
<-3> Zelle über drei Spalten
}}}

Inline-Vorlagen (mehrzeilig)

Sobald sich allerdings Inline-Vorlagen über mehrere Zeilen erstrecken, kann nur die Basisformatierung verwendet werden. Beispiel:

Zelle 1:
echo "Hi!"
echo "Wie geht's?" 
Zelle 2:

Hinweis:

Dies ist ein Hinweis.

  • Punkt 1

  • Punkt 2

Zelle 3
Zelle über drei Spalten

Basisformatierung

Mit Standardvorlagen ({{{...}}}):

||
Zelle 1:
{{{#!vorlage Befehl
echo "Hi!"
echo "Wie geht's?"
}}}
|| Zelle 2:
{{{#!vorlage Hinweis
Dies ist ein Hinweis
 * Punkt 1
 * Punkt 2
}}} || Zelle 3 ||
|| <-3> Zelle über drei Spalten ||

Mit Inline-Vorlage:

||
Zelle 1:
[[Vorlage (Befehl, 'echo "Hi!"
echo "Wie geht\'s?"')]]
|| Zelle 2:
[[Vorlage (Hinweis, 'Dies ist ein Hinweis
 * Punkt 1
 * Punkt 2')]]
|| Zelle 3 ||
|| <-3> Zelle über drei Spalten ||

Außerdem sollte beachtet werden, dass nicht alle Vorlagen als Inline-Vorlagen existieren (z.B. existieren keine Inline-Vorlagen für hervorgehobenen Code).

Verwendung

Sobald innerhalb von Tabellen mehrzeilige Syntaxelemente eingefügt werden sollen, ist eine Realisierung ausschließlich mit der Basisformatierung möglich. Darunter fallen folgende Elemente:

  • Listen

  • Mehrzeilige Vorlagen, also alle Vorlagen, die durch den Marker {{{ eingeleitet werden. Dazu gehören beispielsweise Tabellen in Tabellen.

  • Zeilenumbrüche

Experten-Info:

Der Vorlagenmarker {{{ und insbesondere der schließende Teil }}} lässt sich mit einem vorangestellten Backslash \ als unwirksam definieren ("escapen"), sodass der Inyoka-Parser den entsprechenden Teil im entsprechenden Schritt nicht auswertet. Da die Tabellenvorlage allerdings selbst eine Vorlage ist und bei jeder neuen Zeile einen Tabellenmarker || setzt, hilft bei der Tabellenvorlage kein Escapen.

Diese Revision wurde am 20. Dezember 2012 13:14 von aasche erstellt.
Die folgenden Schlagworte wurden dem Artikel zugewiesen: Wiki