Anleitung zur Installation von Calendar

Version dieser Lieferung: v1.0.2b

Übersicht

Inhalt

Die Calendar - Lieferung besteht aus der Zip - Datei calendar.zip, die folgende Dateien und Verzeichnisse enthält:

Installation 

1. Entpacken Sie diese Dateien in ein Verzeichnis auf Ihrer Webseite (z.B. /calendar)
2. Öffnen  Sie die Seite calendar.html im Browser. Das Applet sollte bereits mit den mitgelieferten Beispieloptionen starten.
3. Je nach gewünschtem Anwendungsfall können Sie entweder diese Seite verlinken oder den Applet - Tag aus calendar.htm an die gewünschte Stelle in Ihrer HTML - Seite kopieren.
4. Passen Sie den Applet - Tag an Ihre Webseite an. Insbesondere ist es wichtig, dass Sie den korrekten Pfad zu calendar.jar und den Property - Dateien, ausgehend von der einbindenden HTML - Seite, angeben.
   Beachten Sie hierzu bitte auch die Ausführungen im Abschnitt Parameter.
5. Passen Sie die übrigen Parameter in den Dateien lexasoft.properties und calendar.properties an.

Zum Anfang

 Parameter

Alle Parameter ( mit wenigen Ausnahmen ) können in jeder beliebigen Property - Datei oder als Parameter der HTML - Seite angegeben werden. Welche Property - Dateien vom Applet ausgelesen werden, muss im Applet Tag als Parameter "propertyfiles" angegeben werden ( s.a. Beispieldatei calendar.html). 

Die Angabe der Dateien muss ausgehend von der einbindenden HTML - Seite erfolgen. Mehrere Property - Dateien sind durch ";" zu trennen. 

Parameter dürfen auch mehrfach angegeben werden. Welcher Wert dann verwendet wird, richtet sich nach folgender Reihenfolge:

• Parameter in der HTML Seite ( hat Vorrang )
• Letzte angegebene Property - Datei
• ...
• Erste angegebene Property - Datei

Die Form der Parameter in Property - Dateien oder als Parameter im Applet Tag ist den gelieferten Beispieldateien zu entnehmen.

Nachfolgend eine Aufstellung aller relevanten Parameter.

Besonderheiten bei mehrfachem Einsatz / mehreren Lexasoft - Applets

Natürlich kann Calendar grundsätzlich an unterschiedlichen Stellen in Ihrem Webauftritt eingesetzt werden. Ebenso ist eine Kombination mehrerer Lexasoft - Applets möglich. 

Aus diesem Grunde hat Lexasoft die Möglichkeit geschaffen, Parameter Ihrer Applets hierarchisch zu ordnen. Weiter oben wurde die Rangfolge der Auswertung bereits erläutert.

Sie sollten so vorgehen, dass Sie grundsätzlich sowohl das jar - File als auch die allgemeinen Properties ( lexasoft.properties ) nur einmal auf Ihrem Server halten und von den einbindenden HTML - Seiten darauf verweisen.

Die Datei lexasoft.properties definiert auch Parameter, die von Calendar nicht verwendet werden. Diese können sie auskommentieren ( bzw. auskommentiert lassen ), falls Sie nur Calendar einsetzen. 

Sie können diese Datei dazu benutzen, allgemeine Properties zu beschreiben, die default für alle Ihre Applets  gelten sollen. Damit können Sie diese perfekt an das Aussehen Ihrer Webseite anpassen.

Da alle URLs relativ zum Verzeichnis der einbindenden HTML - Seite angegeben werden, würden in lexasoft.properties getroffene Angaben zu Resourcen ( z.B. Hintergrundbild ) nicht immer funktionieren, da die einbindenden HTML - Seiten nicht immer im gleichen Verzeichnis stehen.

Deswegen kann mittels des Parameters "ResourceBase" ( nur als Parameter der einbindenden HTML - Seite ) ein spezielles Ressourcen - Verzeichnis angegeben werden. Diese wird vom Applet zusätzlich zum Verzeichnis der einbindenden HTML - Seite ausgewertet. URLs zu Bildern können dann sowohl relativ zu diesem Verzeichnis als auch relativ zum Verzeichnis der einbindenden HTML - Seite angegeben werden.

Die ResourceBase wird aber nur verwendet, wenn relativ zum Verzeichnis der HTML - Seite kein Bild gefunden wurde.

Beispiel:

/applets
  |
  + res
  |  + image1.gif
  + calendar.jar  
/inhalt
  + calendarseite.htm
  + image2.gif

In diesem Falle ist das Verzeichnis /applets/res/ als globales Ressourcenverzeichnis gedacht. Um dies zu erreichen, muss im Applet - Tag in calendarseite.htm ( ausgehend vom eigenen Verzeichnis ) angegeben sein:

...
<param name="ResourceBase" value="../applets/res/.">
...

Um das Bild image1.gif als Hintergrundbild zu verwenden, definiert lexasoft.properties:

IMG_background : image1.gif

Anders ausgedrückt: Alle Applets, die einen analogen Verweis auf das Ressourcenverzeichnis erhalten und lexasoft.properties verwenden, benutzen image1.gif automatisch als Hintergrundbild.

Um, abweichend davon, das Bild image2.gif als Hintergrundbild zu verwenden, könnte in einer anderen ( später aufgeführten ) Property - Datei dieser Wert wie folgt überschrieben werden:

IMG_background : image2.gif

oder als Parameter im Applet - Tag:

...
<param name="IMG_background" value="image2.gif">
...

Dies ist möglich, weil die Ressourcen auch ausgehend vom Verzeichnis der einbindenden HTML - Seite aus angegeben werden dürfen.

Empfehlung: Verwenden Sie in lexasoft.properties nur Verweise relativ zum globalen Ressourcenverzeichnis. In den Property - Files der einzelnen Java - Applets bzw. in den Parametern, mit denen sie aufgerufen werden, verwenden Sie nur Verweise ausgehend vom Verzeichnis der einbindenden HTML - Seite.

Auf diese Weise nutzen Sie die flexible Ressourcenverwaltung der Lexasoft - Applets optimal aus.

Zum Anfang

Anhang

Farbkodierungen

Farben in Lexasoft - Applets können als englische Farbbezeichnungen oder, wie in HTML Seiten üblich, in freier Codierung angegeben werden. Folgende Farbbezeichnungen sind zulässig:

• "#RRGGBB", wobei RR, GG und BB für Hexadezimalzahlen stehen, die den Rot, Grün bzw. Blauanteil der Farbe bedeuten. Diese Darstellung entspricht der Codierung in HTML, sodass in HTML - Seiten enthaltene Farbdefinitionen gleichbedeutend verwendet werden können.
• "black" - Standardfarbe schwarz
• "blue" - Standardfarbe blau
• "cyan" - Standardfarbe cyan
• "darkgray" - Standardfarbe dunkelgrau
• "gray" - Standardfarbe grau
• "green" - Standardfarbe grün
• "lightgray" - Standardfarbe hellgrau
• "magenta" - Standardfarbe magenta
• "orange" - Standardfarbe orange
• "pink" - Standardfarbe rosa
• "red" - Standardfarbe rot
• "white" - Standardfarbe weiß
• "yellow" - Standardfarbe gelb
• "bluegreen" - Standardfarbe blaugrün
• "ochre" - Standardfarbe ocker
• "darkblue" - Standardfarbe dunkelblau

Zum Anfang

Datumsformate

Hier finden Sie eine Aufstellung der Formatstrings, die zur Formatsteuerung der Datumsangaben verwendet werden können.

Tag	dd	Tag als Tag im Monat, also z.B. "17" für den 17. August. Dies ist die Default - Einstellung
	DD	Tag als Tag im Jahr, also z.B. "229" für den 17. August ( wenn das Jahr kein Schaltjahr ist :-) )
Monat	MMMM	Monat als vollständiges Wort, also z.B. "August" oder "März". Dies ist die Default - Einstellung
	MMM	Monat als abgekürztes Wort, also z.B. "Aug" für August oder "Jan" für Januar
	MM	Monat als zweistellige Zahl, z.B.: "08" für August
	M	Monat als Zahl mit variabler Länge, z.B.: "8" für August oder "11" für November
Jahr	yyyy	Jahr als vierstellige Zahl, also z.B.: "2001". Dies ist die Default - Einstellung
	yy	Jahr als zweistellige Zahl, also z.B.: "01" für 2001.
Wochentag	EEEE	Wochentag vollständig ausgeschrieben, also z.B.: "Mittwoch" oder "Samstag". Dies ist die Default - Einstellung
	EE	Wochentag als Abkürzung, also z.B.: "Sa" für Samstag oder "Mo" für Freitag.

Die Gross- Kleinschreibung muss beachtet werden. Allso Formatstrings können mit freiem Text kombiniert werden. Dieser muss in Quotes ( "'") eingefasst werden. Um z.B. einen Punkt an die Abkürzung eines Wochentags anzuhängen, muss der Formatstring lauten: EE'.'

Das führt am Freitag zur Ausgabe von: Fr.

Zum Anfang