Übersicht

Wozu Tag-Dateien?

Ist es Euch schon mal passiert, daß Ihr 10 HTML-Dokumente erstellt habt, und später, nach Fertigstellung der Seiten, haben Euch die horizontalen Trennlinien nicht mehr gefallen die Ihr für die Trennung der einzelnen Kapitel benutzt habt?

Bei phpCMS könnt Ihr solche Situationen vermeiden, wenn Ihr phpCMS richtig einsetzt.

Ihr definiert einfach Eure eigenen Tags in der Tag-Datei und benutzt diese Tags dann als Platzhalter in den Content-Dateien. Wollt Ihr später diese Tags durch andere HTML-Tags ersetzen, könnt Ihr einfach die Definition in der Tag-Datei ändern und schon werden automatisch alle Tags Eurer Site durch die neue Definition ersetzt.

Erstellen einer Tag-Datei

Eine Tag-Datei ist ein ganz normales Text-File, das Ihr mit jedem beliebigen Text-Editor bearbeiten oder erstellen könnt. Ich habe mir angewöhnt, wegen der Übersicht nur eine Tag-Datei pro Site anzulegen, Ihr könnt aber natürlich Eure Site in mehrere Projekte gliedern und in der jeweiligen Projekt-Datei die entsprechende Tag-Datei anführen.

Innerhalb der Tag-Datei beginnen Kommentarzeilen mit einem Semikolon (;). Solche Semikolone können nur am Anfang der Zeile stehen. Semikolone in der mitte der Zeile werden nicht als Kommentar interpretiert. Leerzeichen und Tabulatoren werden nicht interpretiert. Ihr könnt also Eure Tag-Dateien übersichtlich formatieren indem Ihr reichlich Gebrauch von Tabulatoren macht.

In Definitionszeilen steht erst das Tag, welches Ihr in der Content-Datei oder im Template als Platzhalter einsetzt. Danach kommt das Zuweisungszeichen ":=" (ohne Anführungszeichen). Dahinter folgt jene(s) HTML-Tag(s) mit dem(nen) die Platzhalter ersetzt werden sollen. Ich mußte für das Trennzeichen leider diese Kombination wählen, weil in manchen HTML-Tags das "=" - Zeichen benutzt wird und der Parser dann das Trennzeichen nicht erkannt hätte. Eine Definitionszeile kann also so aussehen:

<BILDERRAHMEN>    :=   <table border="0" cellspacing="0" cellpadding="2">

Tipp: Ich habe mir angewöhnt, in jeder Tag-Datei die deutschen Umlaute durch die HTML-Maskierungen ersetzen zu lassen. Seitdem kann ich meine eigenen Content-Dateien auch selbst lesen. :-)

Es können auch beliebig viele Parameter in Tags verwendet werden. Das kann z.B. so aussehen:

<a "$url,$target,$text">    :=  <a href="$url" target="$target">$text</a>

Dabei wird jeweils der dem Tag übergebene Wert in den HTML-Code eingesetzt.

Achtung: Als Trennzeichen bei Tags wird das Komma benutzt. Wenn Ihr also innerhalb der Parameter ein Komma habt, dann wird dieses Komma als Trennzeichen zu weiteren Parametern interpretiert. Auch Hochkomma werden als Begrenzer benutzt und dürfen nicht innerhalb von TAG-Parametern benutzt werden.

Einbinden von Tags in Content-Dateien oder Templates.

Ihr habt bereits Eure Platzhalter in der Tag-Datei definiert. Jetzt geht es an die Erstellung der Content-Datei oder des Templates.

Ihr notiert einfach dort, wo das entsprechende HTML-Tag stehen soll, den Platzhalter, den Ihr für dieses HTML-Tag in der Tag-Datei definiert habt. phpCMS ersetzt diesen Platzhalter dann beim parsen durch das entsprechende HTML-Tag. Am besten seht Ihr Euch das Beispiel an!

Ein Beispiel für eine Tag-Datei

Da ich selbst am besten anhand von Beispielen lerne, hier ein Auszug aus meiner Tag-Datei:
 

Angenommen ich möchte Euch einen Tipp geben und will, daß das Wort "Tipp:" hervorgehoben dargestellt wird. Der Satz lautet: "Tipp: Benutzt möglichst oft Tags!". In der Content-Datei würde ich den Satz dann so notieren:

<WICHTIG>Tipp:</WICHTIG>Benutzt möglichst oft Tags!

phpCMS ersetzt dann das Tag "<WICHTIG>" durch das in der Tag-Datei definierte Zeichen "<strong>" und das Tag "</WICHTIG>" durch das Zeichen "</strong>". Außerdem wird das Zeichen "ö" durch "&ouml;" ersetzt. Im Browser sieht der Satz dann so aus:

Tipp: Benutzt möglichst oft Tags!

Weiters angenommen, Ihr habt jetzt Eure Semesterarbeit über phpCMS ins Internet gestellt und geht noch einmal über die Formatierung. Jetzt fällt Euch ein, daß Ihr eigentlich alle Tipp's nicht nur im Fettdruck haben wollt, sondern daß die Tipps außerdem kursiv dargestellt werden sollen. In phpCMS ganz einfach: Ihr ändert einfach die Tag-Datei in dieser Art:
 

Und schon wird der im Beispiel angeführte Satz wie folgt ausgegeben:

Tipp: Benutzt möglichst oft Tags!

So einfach ist das mit phpCMS!