Wir haben gerade für einen Kunden ein kleine Übersicht zum Aufbau seiner Joomla! Internetseite zusammengestellt.
Um die Code-Schnipsel anzeigen zu lassen, haben wir die Informationen in <pre>-Tags gepackt. Für das Syntax Highlighting muss das Geshi Plugin aktiviert sein.
Dabei sind wir auf zwei Stolperfallen gestoßen:
1. Sprache des Code
Dem <pre>-Tag muss mitgeteilt werden, um welche Sprache (PHP, HTML) es sich bei dem Code handelt. Vergisst man das oder verwendet eine veraltete Syntax, wird der Code als PHP behandelt. Das schaut etwas seltsam aus, wenn man das Wörtchen „die“ verwendet. Geshi denkt, dass man den PHP-Befehl die() meint und hebt das Wort hervor. Möchte man das nicht, (und wer möchte den Besucher seiner Seite schon nachdrücklich zum Ableben auffordern…) sollte die korrekte Syntax verwendet werden:
<pre xml:lan="html">Hier kommt der Text</pre>
2. Plugin vor <pre>-Tag
Möchte man zeigen, wie eine Bildergalerie, in unserem Fall die Simple Image Galerie eingebunden wird, steht vor dem Problem, dass das Plug-In aktiv wird, bevor das <pre>-Tag als solches ausgewertet wird. Zwar wird nicht direkt die Galerie angezeigt, aber anstelle
{gallery}Pfadname{/gallery}
wird der Befehl ausgeführt und das Ergebnis steht in Textform da.
Da hilft nur, den kompletten Codeschnipsel in Unicode Werte umzuwandeln. Die Google-Suche „ascii unicode converter“ liefert hier einige Konverter Tools.
Dann übernimmt erst der Browser die Umwandlung in „normale“ Satzzeichen und alles sieht so aus, wie es soll.