Knuddels-Wiki:Handbuch08/7

< Knuddels-Wiki:Handbuch08
Version vom 30. April 2017, 18:13 Uhr von Piet1987 (Diskussion | Beiträge) (Tags neu eingefügt.)

Vorlage:KWTut

Tags

Ein charakteristisches Merkmal der Knuddels-Wiki Texte sind die Tags. Sie sind den Auszeichnungssprachen XML und HTML verfasst. In diesem Artikel wird dir nun ein vollständiger Überblick zur Anwendung in Knuddels-Wiki-Projekten gegeben.

Syntax

Die Syntax entspricht derjenigen von XML und HTML; zwischen beiden Sprachen gibt es minimale Unterschiede. Ein Tag hat im einfachsten Fall die Form <name> – nach der öffnenden spitzen Klammer < steht der Bezeichner. Er soll kleingeschrieben werden, wird aber auch mit Großbuchstaben verstanden. Die schließende spitze Klammer > beendet das Tag.

Grundsätzlich gibt es mehrere Fälle:

Anfang und Ende:

Ein Textabschnitt wird von zwei Tags eingeschlossen, die den gleichen Bezeichner tragen. Das abschließende Tag führt zu Beginn einen Schrägstrich:<name>………</name>

  • Dem eingeschlossenen Bereich sollen dadurch bestimmte Eigenschaften zugewiesen werden.
  • Die gesamte Einheit aus Anfang, Ende und Inhalt nennt man Element.
  • Elemente können ineinander verschachtelt sein; allerdings muss ein inneres Element dann vollständig in einem äußeren Element enthalten sein.

unary tag wie <references /> (alleinstehend):

  • Sie haben keinen Inhalt; können aber steuernd wirken.
  • In Texten, die auch gelegentlich von Menschen gelesen werden (wie das regelmäßig bei Wikitexten der Fall ist), schreibt man zur besseren Lesbarkeit ein Leerzeichen vor den Schrägstrich, um das Tag sicher und fehlerfrei von der binary-Variante unterscheiden zu können, z. B. bei vs. </references>.

Leeres Element (etwa <div></div>):

  • Bei den Wiki-Extensionen kann dies immer durch das kürzere und schneller erfassbare unary tag ersetzt werden, wie das auch in XML vorgesehen ist.
  • In HTML wird immer noch eine Unterscheidung getroffen zwischen Tags, die nie Inhalt enthalten können (void), und solchen, die prinzipiell Inhalt enthalten könnten, nur jetzt gerade leer sind. Im ersten Fall muss ein unary tag verwendet werden, im zweiten Fall (empty) darf kein unary tag benutzt werden. Dies kann insbesondere bei leerem <div> zu Schwierigkeiten führen.

Vorlagenprogrammierung:

  • Hier können Tags mittels der Funktion #tag: der normalen Verarbeitung zunächst entzogen werden.