Versionshistorie

Neu in Version 2.5 (vom 27.11.2011)

• Variablen werden komplett anders ersetzt:
  Der Vorgang des Ersetzens der Variablen wurde komplett geändert. Die Template-Klasse durchsucht den Template-Text nun Zeichen für Zeichen und ersetzt Variablen durch Text. Der Sinn hinter ist, dass auf diese Weise keine Variablen in Variablen mehr ersetzt werden können.
  Dieses neue Verfahren ist deaktivierbar, d.h. man kann bei Problemen auf das alte Verfahren, das einfach nur Zeichenketten ersetzt, zurückgreifen.
• set_vars() und add_vars():
  Mit den neuen Methoden set_vars() und add_vars() ist es nun möglich, die interne Variablenliste komplett zu überschreiben oder mit mehreren Variablen und Werten auf einmal zu ergänzen.
• {TRIM}-Blöcke in der Perl-Version funktionieren jetzt:
  Das Verarbeiten der {TRIM}-Blöcke hat in der Perl-Version nicht funktioniert, da eine falsche Variable verwendet wurde. Dieser Fehler wurde behoben.
• Anderer Programmierstil:
  Der Programmierstil wurde geändert. Dies betrifft vor allem die Einrückungen.
• Dokumentation korrigiert:
  In der Dokumentation war die Beschreibung für die reset()- und die save_state()-Methode unvollständig.
• Neue Lizenz:
  Die Template-Klasse ist nun unter den Bedingungen der Artistic License 2.0 lizenziert.

Neu in Version 2.0 (vom 9.8.2006)

• get_var(), set_var() und parse():
  Um die Arbeit mit der Template-Klasse etwas zu vereinfachen, wurde ein neues Interface für die Haupt-Arbeit eingeführt. Es besteht im Wesentlichen aus den drei neuen Methoden get_var(), set_var() und parse().
  • get_var() gibt den Wert einer Variablen zurück. Wenn kein Name angegeben wurde, gibt get_var() die Namen aller definierten Variablen zurück.
  • set_var() weist einer Variablen einen Wert zu.
  • parse() setzt die Variablen ein, verarbeitet die {IF}-Blöcke, verarbeitet die Schleifen und liest die in der Template definierten Variablen aus.
• Variablen direkt in der Template-Datei definieren:
  Man kann nun mit Hilfe der neuen {DEFINE}-Blöcke Variablen direkt in der Template-Datei definieren, so als hätte man sie mit set_var() definiert.
  Es gibt hierbei zwei Möglichkeiten:
  1. {DEFINE Name "Wert"}:
     Hierbei erhält die Variable "Name" den Wert "Wert". Innerhalb des Blockes dürfen keine Zeilenumbrüche vorkommen, ansonsten wird er ignoriert. Der Name der Variable darf keine Zeilenumbrüche oder Leerzeichen enthalten. Wenn der Wert ausgelesen wird, so wird \n durch einen Zeilenumbruch ersetzt.
  2. {DEFINE Name}Wert{ENDDEFINE}:
     Auch hier erhält die Variable "Name" den Wert "Wert". Der Name darf ebenfalls keine Zeilenumbrüche oder Leerzeichen enthalten, der Wert allerdings schon.
  Die direkt mit set_var() haben allerdings Vorrang gegenüber den erst über {DEFINE} definierten. Zusätzlich werden zweitere erst von parse() abgearbeitet, wenn erstere abgearbeitet wurden.
• Schleifen:
  Es wurde eine einfache Möglichkeit zur Realisierung von Schleifen in einer Template-Datei hinzugefügt.
  Man kann einen Block jetzt in {LOOP}...{ENDLOOP}-Blöcke einschließen. Dieser Block bekommt einen Namen, diesem Namen werden dann über die Methoden add_loop_data() und/oder set_loop_data() Variablen zugewiesen. Der Block wird dann für jeden Durchgang mit neuen Werten ausgegeben.
  Der Vorteil hiervon ist, dass man so für sich wiederholende Blöcke keine separate Template-Dateien erstellen muss.
  Es ist zur Zeit leider noch nicht möglich, Schleifen zu verschachteln!
• {TRIM}-Blöcke:
  Man kann jetzt Textstellen in {TRIM}-Blöcke einschließen. Beim Inhalt werden vorangestellte und abschließendende Leerzeichen und Zeilenumbrüche entfernt.
• Verhalten der {INCLUDE}-Anweisungen verändert:
  Das Verhalten der {INCLUDE}-Anweisungen wurde in einigen Fällen geändert:
  • Wenn man bei einer {INCLUDE}-Anweisung einen relativen Pfad angibt, so gilt dieser Pfad nun relativ zur Template-Datei und nicht mehr zum Script.
    So wollte ich das eigentlich immer haben. Das alte Verhalten war eine Notlösung, weil ich mir nicht anders zu helfen wusste...
  • Die Dateinamen, die bei einer {INCLUDE}-Anweisung angegeben werden, können nun auch Leerzeichen oder das }-Zeichen enthalten. In diesem Fall muss man den Dateinamen aber in doppelte Anführungszeichen setzen.
• Template zurücksetzen:
  Mit Hilfe der neuen reset()-Methode können Sie den Template-Text in den Zustand zurückversetzen, den er nach dem Auslesen der Template-Datei hatte. Zusätzlich können Sie mit save_state() den aktuellen Zustand des Template-Textes sichern und diesen dann bei Bedarf eben mit reset() wiederherstellen.
• Alias-Funktionen entfernt:
  In der Perl- und in der PHP-Version wurden die alten Alias-Funktionen addtext(), as_string(), condtag() und readin() entfernt.
• Kleine Korrekturen:
  Es wurden verschiedene, unterschiedliche kleine Korrekturen durchgeführt:
  • Die Perl-Version verwendet jetzt nicht mehr split(), um eine Zeichenkette aufzuteilen. Stattdessen verwendet sie nun meine Portierung der explode()-Funktion von PHP. Die Grund hierfür ist ein Problem von split(), welches auch auf der verlinkten Seite beschrieben wird.
  • Die Python-Version verwendet jetzt die Objektmethoden des String-Datentyps anstatt der Methoden aus dem string-Modul.
  • Die Python-Version kommt jetzt vollständig ohne reguläre Ausdrücke aus.
• Dokumentation neu strukturiert:
  Die Dokumentation wurde komplett neu strukturiert. Sie befindet sich nun im Unterverzeichnis doc und besteht aus mehreren Dateien.

Neu in Version 1.5a (vom 6.6.2005)

• PHP-Version nun ohne "Notices":
  Die PHP-Version der Template-Klasse hat eine "Notice" erzeugt, wenn für error_reporting der Wert E_ALL eingestellt war.
• Fehlermeldung bei komplett leerer Template-Datei:
  Wenn die PHP-Version der Klasse eine Template-Datei mit einer Größe von 0 Bytes hätte einlesen sollen, hatte fread() eine Fehlermeldung erzeugt. Das ist nun behoben.

Neu in Version 1.5 (vom 5.5.2005)

• {IF}-Blöcke verneinen:
  Man kann {IF}-Blöcke nun verneinen, indem man vor den Namen des Blockes ein ! stellt. Die Methode parse_if_block() verarbeitet diese Blöcke automatisch, es sei denn man setzt den neuen dritten Parameter dieser Routine auf true.
• Fehlende {INCLUDE}-Dateien:
  Wenn eine Datei über eine {INCLUDE}-Anweisung eingebunden werden soll und die Datei existiert nicht, so wird diese Anweisung nicht mehr aus dem Vorlagentext entfernt.
• Python-Version:
  Es existiert nun ebenfalls eine Python-Version der Template-Klasse. Von den Perl- und PHP-Versionen unterscheidet sie sich lediglich dadurch, dass sie nicht die Alias-Methoden bereitstellt (Methodennamen vor Version 1.2).

Neu in Version 1.4a (vom 21.3.2005)

• Mehrere {ENDIF} am Ende des Vorlagentextes:
  Wenn der Vorlagentext mit mehr als einem {ENDIF} endete, hat der {IF}-Parser der Perl-Version diese nicht gefunden und das Script wegen eines Verschachtelungsfehlers beendet.
• (Mal wieder) Nicht funktionierender Alias in PHP-Fassung:
  Für die Methode add_text() existiert aus Kompatibilitätsgründen ein Alias namens addtext(). In der PHP-Version der Klasse wurden die Argumente, die addtext() übergeben wurden, nicht an add_text() weitergegeben.

Neu in Version 1.4 (vom 5.2.2005)

• Verschachtelungsfehler bei {IF}-Blöcken:
  Bisher geriet der {IF}-Parser immer in eine Endlosschleife, wenn die {IF}-Blöcke nicht korrekt verschachtelt waren.
  Das dürfte jetzt behoben sein. Der Parser prüft jetzt, ob intern das letzte {ENDIF} überschritten wurde. In diesem Fall wird das Script sofort mit einer Fehlermeldung beendet.
• Suchen von {IF}-Blöcken in {IF}-Blöcken:
  Um einen weiteren {IF}-Block in einem {IF}-Block zu erkennen, wird jetzt nicht mehr nach {IF, sondern nach {IF  gesucht.
  Das ist zwar immer noch nicht das, was ich eigentlich will, aber es ist etwas besser als die alte Methode. Ich würde es ja gerne mit einem regulären Ausdruck lösen, der nach \{IF .+?\} oder so sucht, aber das hat nur noch mehr Probleme bereitet.
• Einfache Anführungszeichen statt doppelter:
  Es wurden, wo es angebracht war, alle doppelten Anführungszeichen durch einfache ersetzt. Das bringt hoffentlich einen Geschwindigkeitsgewinn.
• Name der Template-Datei in den Objekteigenschaften:
  Der Name der von read_file() eingelesenen Template-Datei wird jetzt in den Objekteigenschaften gespeichert.

Neu in Version 1.3 (vom 20.5.2004)

• {INCLUDE}-Anweisungen:
  Es ist nun möglich, in einer Vorlage {INCLUDE Dateiname}-Anweisungen einzubauen. Die Anweisungen werden beim Einlesen der Vorlagen-Datei durch den Inhalt der angegebenen Datei ersetzt.
  Das Verarbeiten der {INCLUDE}-Anweisungen lässt sich auch von Hand durchführen und das automatische Verarbeiten beim Lesen einer Datei lässt sich auch verhindern.
• to_file():
  Mit der neuen Methode to_file() ist es möglich, den kompletten Vorlagentext in eine zuvor geöffnete Datei zu schreiben.
• Nicht funktionierender Alias in PHP-Fassung:
  Für die Methode add_text() existiert aus Kompatibilitätsgründen ein Alias namens addtext(). In der PHP-Version der Klasse rief dieser Alias jedoch nicht add_text() auf, sondern die nicht existierende Methode add_template().

Neu in Version 1.2a (vom 12.9.2003)

• Fehler in substr_count():
  Die von der Perl-Version der Klasse emulierte PHP-Funktion substr_count() enthielt einen Fehler. Wenn sich der zu suchende am Ende des zu durchsuchenden Strings befand, wurde er nicht gefunden.
  Die richtige Methode, Strings in Strings zu zählen, wurde perlfaq4 entnommen.

Neu in Version 1.2 (vom 9.9.2003)

• Methoden umbenannt:
  (Fast) Alle Methoden dieser Klasse haben neue, intelligentere Namen erhalten. Hier die neuen Namen im Einzelnen:
  addtext() => add_text()
as_string() => get_template()
condtag() => parse_condtag()
readin() => read_file()
  Die alten Namen lassen sich selbstverständlich weiterhin verwenden. Das könnte sich aber irgendwann ändern.
• ELSE hinzugefügt:
  Die IF-Syntax versteht nun auch {ELSE}-Abschnitte, die angezeigt werden, wenn die Bedingung nicht erfüllt ist.
• Variablen durch Array ersetzen:
  Mit der neuen Funktion fillin_array() ist es nun möglich, Variablen durch Arrays zu ersetzen.
• get_template() und set_template():
  Mit Hilfe der neuen Methoden get_template() und set_template() ist es viel leichter geworden, auf den in den Objekt-Eigenschaften gespeicherten Vorlagentext zuzugreifen.
• Emuliertes substr_count() überarbeitet:
  Die von der Perl-Fassung der Klasse emulierte PHP-Funktion substr_count() wurde ein wenig verbessert. Sie teilt zunächst die Zeichenkette mit der zu zählenden Zeichenkette auf. Anschließend zählt sie von der Anzahl der so entstandenen Array-Elemente 1 ab und gibt das Ergebnis zurück.
• Keine reguläre Ausdrücke mehr in der PHP-Version:
  Die PHP-Version der Klasse verwendet nun keine reguläre Ausdrücke mehr, was hoffentlich zu einer Geschwindigkeitsverbesserung führt.

Neu in Version 1.1 (vom 21.7.2003)

• Neue IF-Syntax:
  Es wird jetzt eine viel übersichtlichere Syntax für bedingte Abschnitte verwendet. Diese Abschnitte werden mit einem {IF} eingeleitet und von einem {ENDIF} abgeschlossen.
• CondTag am Anfang:
  Wenn ein CondTag-Abschnitt am Anfang eines Textes war, hat die PHP-Version diesen nicht erkannt, da die 0 als false interpretiert wurde.

Neu in Version 1.0 (vom 3.6.2003)

• Erste Version:
  Dies ist die erste Version der Template-Klasse. Sie erschien mit der Version 1.3 des Guestbook und wurde nicht offiziell zum Download angeboten.

Zur Übersicht

© 2002-2011 Patrick Canterino