Ausgabeformate

Wenn Sie einen Platzhalter direkt in einem Template verwenden (und nicht als Parameter für eine andere Funktion), wird im Normalfall eine einfache HTML-Codierung auf den ausgegebenen Text angewendet: Zeilenumbrüche werden durch <br>-Tags ersetzt, Umlaute und Sonderzeichen durch entsprechende HTML-Entitäten (z. B. ä durch ä). Wenn Sie keine oder eine andere Codierung wünschen, können Sie dies in den meisten Fällen durch einen zusätzlichen Parameter angeben. Dabei stehen folgende Formatangaben zur Verfügung:

raw: Der Text wird exakt so ausgegeben, wie er in der Datenbank gespeichert ist, die standardmäßige HTML-Codierung wird abgeschaltet.
escaped: Allen einfachen Anführungszeichen wird ein umgekehrter Schrägstrich (\) vorangestellt. Dies ermöglicht die Verwendung des Platzhalters innerhalb von PHP-Ausdrücken, zum Beispiel in vtCalc und vtEcho.
styled: Zusätzlich zu der standardmäßigen HTML-Codierung werden verschiedene Ersetzungen und Ergänzungen vorgenommen (siehe unten). Bei Verwendung dieses Formats sollte der Platzhalter immer in ein <p>-Element eingeschlossen werden, damit insgesamt eine korrekte HTML-Syntax entsteht.
mdown/markdown: Der Text wird als Markdown-Code interpretiert und in HTML-Code umgewandelt. Einzelheiten hierzu finden Sie in der Dokumentation der PHP-Markdown-Bibliothek. Einige Besonderheiten, die nur in Virthos gelten, sind weiter unten beschrieben.
html: Im Text enthaltene virthos-spezifische URLs werden in gewöhnliche URLs umgewandelt. Dies gilt insbesondere für URLs in der Form vt:123 oder vt:/Pfad/zur/Seite.
edit_html: Wie html, aber HTML-spezifische Sonderzeichen (wie <, > und &) werden durch entsprechende Entitäten ersetzt. Dies ermöglicht es, HTML-Code so in eine Seite einzubinden, dass der Code nicht vom Browser interpretiert, sondern als Code dargestellt wird.
rawhtml: HTML-spezifische Sonderzeichen (wie <, > und &) werden durch entsprechende Entitäten ersetzt. Dies ermöglicht es, HTML-Code so in eine Seite einzubinden, dass der Code nicht vom Browser interpretiert, sondern als Code dargestellt wird.
csv: Alle doppelten Anführungszeichen werden verdoppelt, ansonsten wird der Text so ausgegeben, wie er in der Datenbank gespeichert ist.
rtf: Umlaute und andere Sonderzeichen werden gemäß Rich-Text-Format-Spezifikation codiert. Dies ermöglicht die Verwendung in Spezialmethoden, die zum Erzeugen von RTF-Dateien dienen.

Die styled-Codierung

Bei Verwendung der styled-Codierung werden anhand des Textinhalts bestimmte HTML-Auszeichnungen automatisch erzeugt. Dies geschieht nach folgenden Regeln:

Mehrere aufeinanderfolgende Zeilen, die mit einem Spiegelstrich beginnen, werden in entsprechende <li>-Elemente mit einem umschließenden <ul>-Element umgesetzt.

Internet- und E-Mail-Adressen werden automatisch in anklickbare Verweise umgesetzt. Damit Virthos eine Internet-Adresse als solche erkennt, muss diese allerdings entweder mit www. beginnen oder vollständig notiert werden, also beginnend mit http://, https:// oder ftp://. E-Mail-Adressen werden zusätzlich in HTML-Entitäten umgewandelt, um es Spam-Robotern zu erschweren, die Adressen auszulesen.

Internet- und E-Mail-Adressen, die in doppelte Klammern eingeschlossen sind, machen aus dem davorstehenden Wort einen anklickbaren Link. Dabei werden folgende spezielle Schreibweisen berücksichtigt:

Schreibweise	wird umgesetzt in
ein_Wort `((`Internetadresse`))`	`<a href="`Internetadresse`" target="_blank">`ein_Wort`</a>`
ein_Wort `((vt:` Seitenangabe `))`	`<a href="`Virthos-Seiten-URL`">ein_Wort``
ein_Wort `((vt: $Datei1))`	`<a href="`Virthos-Datei-URL`">ein_Wort``
ein_Wort `((js:` JavaScript-Code `))`	`<a href="javascript:void(0)" onclick="`JavaScript-Code`">`ein_Wort`</a>`

Zwei Punkte zwischen zwei Wörtern werden in geschützte Leerzeichen umgesetzt, so dass zwischen diesen Wörtern kein Zeilenumbruch erfolgt. In Verbindung mit der vorigen Regel, lassen sich auf diese Weise auch mehrere aufeinanderfolgende Wörter zu einem anklickbaren Link machen.

auf dieser..Seite ((vt:315)) finden Sie weitere Informationen

Bestimmte Auszeichnungen werden in HTML-Inline-Elemente umgesetzt:

Auszeichnung	wird umgesetzt in
`_!`beliebiger Text`!_`	`<strong>`beliebiger Text`</strong>`
`_/`beliebiger Text`/_`	`<i>`beliebiger Text`</i>`
`__`beliebiger Text`__`	`<u>`beliebiger Text`</u>`
`_$`beliebiger Text`$_`	`<var>`beliebiger Text`</var>`
`_:`beliebiger Text`:_`	`<kbd>`beliebiger Text`</kbd>`
`_#`beliebiger Text`#_`	`<code>`beliebiger Text`</code>`

Bezeichnungen in doppelten eckigen Klammern werden in Bildelemente umgesetzt. Dabei entscheidet die Art der Klammerung darüber, welche Klasse dem Element zugewiesen wird.

Schreibweise	wird umgesetzt in
`[[Bild1]]`	`<img src="`Virthos-Bild-URL`" class="vtmedia_default">`
`[[Bild1[[`	`<img src="`Virthos-Bild-URL`" class="vtmedia_left">`
`]]Bild1]]`	`<img src="`Virthos-Bild-URL`" class="vtmedia_right">`

Die markdown-Codierung

Um die Arbeit innerhalb von Virthos möglichst einfach zu gestalten, wurde die

Markdown-Variante von Michel Fortin in einigen Punkten erweitert:

Hyperlinks

Verweise auf andere Webseiten werden gemäß Markdown-Syntax folgendermaßen geschrieben:

Klicken Sie [hier](http://meinedomain.de/infos.html) für weitere Informationen.

Dies funktioniert so auch in Virthos. Zusätzlich lassen sich interne Verweise (also Verweise auf andere Seiten innerhalb derselben Virthos-Umgebung) mit folgender Schreibweise einbinden:

Klicken Sie [hier](vt:123) für weitere Informationen.

Oder so:

Klicken Sie [hier](vt:/Produkte) für weitere Informationen.

Im ersten Beispiel wird ein Verweis auf die Seite mit der Nummer 123 erstellt, im zweiten Fall ein Verweis auf die Seite mit dem Namen "Produkte", die der Startseite untergeordnet ist.

Ein Verweis auf eine Datei, die auf der aktuellen Seite hochgeladen wurde, lässt sich zum Beispiel so schreiben:

Hier finden Sie unsere [AGBs](datei1).

Dabei steht datei1 für den in Virthos festgelegten Namen des Dateielements.

Bilder

Nach der üblichen Markdown-Syntax lassen sich Bilder auf folgende Weise in den Fließtext einbinden:

![Alternativer Bildtext](/pfad/zum/bild)

In Virthos kann man außerdem eine Kurzschreibweise verwenden, beispielsweise so:

![Screenshot der Startseite](bild1)

Dabei steht bild1 für den in Virthos festgelegten Namen des Bildes.

Weitere Hinweise

Wenn Sie in Virthos eine Datei oder ein Bild hochladen und den automatisch vorgeschlagenen Namen ("datei1", "datei2", "bild1", "bild2" etc.) ändern wollen, müssen Sie darauf achten, dass der Name keinen Punkt enthält. Ansonsten wird er innerhalb eines Markdown-Feldes als URL interpretiert, und der betreffende Verweis funktioniert nicht.

Markdown stellt neben der oben genannten noch eine andere Schreibweise zur Verfügung, um Bilder und Hyperlinks in den Fließtext einzubinden. Hierbei werden die URLs nicht direkt hinter dem jeweiligen Element angegeben, sondern weiter unten im Text, quasi als Fußnote. Diese als Referenzstil bezeichnete Schreibweise funktioniert auch in Virthos, allerdings stehen dabei nicht die oben beschriebenen Kurzschreibweisen für Bild- und Dateipfade zur Verfügung.