Arten und Aufbau  von templates

Arten:
Welche Arten von templates gibt es?
Das Programm unterscheidet verschiedene Arten von templates:

gesternTemplate - Tagestemplate - Wochentemplate - Monatstemplate -  Jahrestemplate
anhand des Dateinamens:
template_yest.txt - template_d.txt - template_w.txt - template_m.txt - template_y.txt

Aufbau:
1. Allgemeine Hinweise
Templates enthalten in der 1. Zeile einen Hinweis, wie die auszugebende Datei heißen soll:

<!-- %customfile=.txt% -->
bei diesem Beispiel bildet WSWIN den Namen selbst, z.B. "y2003.txt" bei einem Jahrestemplate.
Dies hat den Vorteil, dass man sich um die Namensgebung keine Gedanken zu machen braucht, für jedes neue Jahr wird der richtige Name gebildet.

<!-- %customfile=jahr.txt% --> 
hier wird vom Benutzer der Name der zu erzeugenden Datei vorgegeben: "jahr.txt"
Dies ist dann von Vorteil, wenn ich aus bestimmten Gründen jedes Jahr denselben Namen benötige.

Ansonsten gibt es zunächst keine Vorschriften, d.h. an jeder Stelle kann

Beispiel:
Standortkoordinaten 
Längengrad: %ws_longitude% - Breitengrad: %ws_latitude%

Nach diesen allgemeinen Angaben ist es wichtig zu wissen, dass sich templates durch ihre Art grundlegend unterscheiden (zu erkennen am Namen)

2. Unterschiede, die durch die Art des templates (Monats- Jahrestemplate) bedingt sind
Welche Variable in den templates steht, ist insofern egal, als die meisten Variablen sowieso für mehrere templates geeignet sind. (es sind nicht spezielle Monatsvariable oder Jahresvariable)
Anders ausgedrückt:
Welcher Wert durch eine Variable ausgegeben wird, hängt davon ab, ob es sich um ein Monatstemplate (template_m.txt) oder ein Jahrestemplate (template_y.txt) handelt.
Die Variable %ws_avgmintemp% wird im Monatstemplate die durchschnittliche Minimaltemperatur des Monats ausgeben, dagegen im Jahrestemplate die durchschnittliche Minimaltemperatur des Jahres.
Dies schafft zwar beim Anfänger Verwirrung, sorgt aber für die unglaubliche Flexibilität von WSWIN. Man bedenke, wieviel mehr Variable man bräuchte, wenn eine Variable z.B. nur für den Monat geeignet wäre.

3. Unterschiede innerhalb eines templates:
Beispiel:
Nehmen wir an, dass ein Teil eines Monatstemplates folgendermaßen lautet:

%templatebegin%%minvalday[2]% %minvaltime[2]%
---------------------------------------------------------------------------
gesamt: %minvalday[2]% %minvaltime[2]%

In Zeile 1 und Zeile 3 kommen dieselben Variablen vor, aber:
Hier liefert die 1. Zeile die Minimaltemperaturen. und Minimalzeiten für jeden Tag des Monats (wegen %templatebegin%), die 3. Zeile die Minimaltemperatur des gesamten Monats und die dazugehörige Zeit.

Stünde dasselbe dagegen in einem Jahrestemplates, so zeigt es sich folgendermaßen:
Hier liefert die 1. Zeile die Minimaltemperaturen. und Minimalzeiten für jeden Monat des Jahres, die 3. Zeile die Minimaltemperatur des gesamten Jahres und die dazugehörige Zeit.

Anders ausgedrückt:
Welchen Wert eine Variable ausgibt, hängt nicht nur von ihrem Namen ab, sondern

Diese Zeile - beginnend mit %templatebegin% - ist eigentlich die wichtigste Zeile in einem template, denn dadurch werden fortlaufende Ausgaben ermöglicht. (fortlaufende Monats- oder Jahresdaten)