NewMonthGadget - ein neues cooles Kalender Gadget fr WPSWizard
=============================================================== 

Inhaltsverzeichnis:
^^^^^^^^^^^^^^^^^^^

    -> Voraussetungen
    -> Was ist das NewMonthGadget?
    -> Warum die optionalen Voraussetungen?
    -> Installation
    -> Upgrade
    -> Ich mchte das Gadget anpassen!!
    -> Wie erreichen Sie Transparenz?
    -> nderungsliste
    -> Links
    -> Danksagungen
    
    
Voraussetungen
^^^^^^^^^^^^^^
- WPSWizard 0.5.1+ 
- (optional) Innotek Font Engine 
- (optional) Arial Black Font vom "MS Core Web Fonts" Paket.


Was ist das NewMonthGadget? 
^^^^^^^^^^^^^^^^^^^^^^^^^^^
NewMonthGadget ist ein Gadget fr WPSWizard 0.5.1+. Ein Gadget zeigt 
Displayinformationen an, die im Desktop eingebettet sind.

Verglichen mit dem normalen MonthGadget, das im WPSWizard Paket enthalten ist, 
sieht dieses Gadget besser aus. Sie knnen einen Eindruck davon haben, wenn 
Sie eines der Screenshots in diesem Paket ansehen (newcalendar1.png und newcalendar2.png). 
Ich hatte die Inspiration, dieses Gadget anzufertigen, von einem der Gadgets, die 
im Object Desktop benutzt wurden (Sie knnen das Vorbild im odnt-july03.jpg Bild sehen).


Warum die optionalen Voraussetungen? 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sie knnen das Aussehen des Gadgets (und das Aussehen Ihres kompletten OS/2 
oder eCS Desktops) sehr verbessern, indem Sie die Innotek Font Engine  installieren. 
Dies stellt antialiased Schriften fr OS/2-eCS zur Verfgung.Ich empfehle es Ihnen in hohem 
Mae fr die verbesserte  Lesbarkeit der Schriften (weiter unten ist der Download Link).

Bitte beachten Sie, wenn Ihr Gadget geglttete Fonts haben soll, dass Sie "PMSHELL.EXE" 
in die Liste der ermglichten Anwendungen in der Font Engine hinzufgen mssen (weiter 
unten ist ein Download Link zum Feffer Utility). Dies wird NICHT von Innotek UNTERSTTZT 
und kann zu Instabilitt fhren (aber ich habe nie Probleme damit gehabt).

Ich empfehle auch, die M$ Core Web Fonts fr das verbesserte Schriften rendering und 
lesbarkeit zu verwenden (weiter unten ist ein Download Link). Sie finden viele 
Webseiten im Internet, die diese Schriftarten verwenden, so haben Sie dann eine bessere 
Darstellung dieser Seiten.

Wenn Sie  die Core Web Fonts nicht benutzen mchten, knnen Sie den "Arial black" Font, 
der im Gadget benutzt wird, durch "Arial Bold" ersetzen (aber der Gadgetcode muss von 
Ihnen editiert werden).


Installation
^^^^^^^^^^^^ 
Kopieren Sie einfach die folgenden Dateien zum WPSWizard Gadgetverzeichnis (auf meinem 
System ist dieses: G:\WPSWizard\bin\gadgets):

- NewMonthGadget.cmd
- NewMonthGagdet.xl8
- gcalendar.gif 
- (optional) CleanIni.cmd

Dann erzeugen Sie ein Programmobjekt fr NewMonthGadget.cmd und legen es in Ihren 
Systemstart Ordner ab.

Die CleanIni.cmd Datei kann ntzlich sein, wenn Sie Ihr Gadget individuell verndern mchten 
(siehe unten). Wenn Sie whrend der nderungen etwas falsch gemacht haben, das Sie dann 
wieder rckgngig machen mchten: CleanIni subert die WPSWizard INI Datei, damit das Gadget 
zum ursprnglichen Zustand zurckkehrt. Beachten Sie, da normalerweise sich die WPSWIZZ.INI Datei 
in Ihrem Home Verzeichnis befindet.


Upgrade
^^^^^^^ 
Kopieren Sie einfach die neuen Dateien ber die alten. Sie mssen vermutlich CleanIni.cmd 
laufen lassen, um den neuen Font zu erhalten (siehe nderungsliste unten vom 2006-02-21).

Sie knnen jetzt den Wochenanfang am Sonntag anstatt am Montag haben: siehe Installation 
und die nderungsliste unten vom 2006-03-13. 

Wenn Sie  die Wochenzahl Anzeigespalte nicht mgen, eingefhrt am 2006-02-21, knnen Sie die
"- noweek" Version des Gadget (Sie mssen die in Verbindung stehende xl8 Datei auch kopieren) verwenden.


Ich mchte das Gadget anpassen!!
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sie knnen das Gadget anpassen, auch ohne rexx und/oder Gadgets Kenntnisse zu haben, indem 
Sie einfach drag and drop fr Fonts und Farben verwenden.

Als erstes mchten Sie vermutlich das Gadget auf Ihrem Desktop verschieben, aber Sie knnen 
es nicht einfach verschieben, weil das Gadget in den Desktop eingebettet ist.
Um es zu verschieben: CTRL+Click (linke Maustaste) auf das Gadget. Sie sehen dann das Quadrat 
des Gadgets, das Sie mit der Maus verschieben knnen. Sobald Sie mit der Position zufrieden 
sind, drcken Sie wieder CTRL+Click (linke Maustaste) um zu seinem eingebetteten Zustand 
zurck zu kehren. 

Wenn Sie andere Einstellungen fr das Gadget machen mchten, CTRL+Click (linke Maustaste) und 
dann die rechte Maustaste auf das Gadget. Dies ffnet ein Kontextmenue mit einigen Eintragungen:

- Beende Gadget: dies schliet das Gadget (und speichert nderungen)
- entsperre Kinder: (siehe unten) 
- kein Rand, Rand, eingesunkener Rand, farbiger Rand: dies verndert oder entfernt den Rand 
  um das Gadget. (Sie knnen einen farbigen Rand im newcalendar1.png Bild sehen)
- vorheriger Monat, aktueller Monat, nchster Monat: dies ndert den anzeigenden Monat

Lassen Sie mich den Kontextmenue-Eintrag "entsperre Kinder" erklren: ein Gadget kann mit 
einigen Unter-Gadgets (oder "Kindern" erstellt werden), das ist bei dem NewMonthGadget der Fall, 
das mit sechs Kindern erstellt wurde. Wir erklren sie nun von links oben beginnend: 

- die Tageszahl
- der Monats Name
- der Schatten des Monatsnamens
- das Jahr
- der Schatten der Jahreszahl
- der Monatskalender

Sobald Sie die Kinder entsperrt haben, wieder CTRL-Click (linke Maustaste) auf das Gadget, um 
es zu seinem eingebetteten Zustand zurck zu bringen. Wenn Sie jetzt CTRL+Click (linke Maustaste) 
auf einen Kindbereich machen, kann das einzelne Kind editiert werden, NICHT das vollstndige Gadget.

Sie knnen nun jedes einzelne Kind jetzt verschieben oder die Groe verndern und mit drag and drop 
lassen sich ein anderer Font oder -farbe auf das Gadgetkind werfen. Sobald Sie mit den Resultaten 
zufrieden sind, CTRL+Click (linke Maustaste) auf das Gadgetkind, um es zum eingebetteten Zustand 
zurck zu bringen, dann CTRL+Click (linke Maustaste) auf einem Bereich ausserhalb von irgendwelchen 
Gadgetkindern (der einfachste Punkt ist unten links), um das Haupt-Gadget (Container) zu erreichen. 
Sie knnen nun im Kontextmen mit "sperre Kinder" schlieen, um zu seinem Ausgangszustand zurck 
zu kehren. An diesem Punkt empfehle ich, das Gadget zu beenden und wieder zu ffnen, um die 
Speicherung Ihrer genderten Einstellungen zu erzwingen.


Wie erreichen Sie Transparenz?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Kurze Erklrung: Es gibt sie nicht ;-) 

Lange Erklrung: In der newcalendar2.png Bild knnen Sie ein scheinbar transparentes Gadget sehen. 
Das gcalendar.gif Bild hat wirklich Transparentinformationen, aber das Verfahren der 
OS/2-eCS Multimedia I/O, die fr die Messwerte und das Anzeigen von GIF Bildern verantwortlich sind 
(oder von irgendeinem anderen untersttzten transparenten Bildformat) sind nicht zum Verwenden 
dieser Informationen geeignet. Der Entwickler des PNGIO I/O proc (auf der eComStation BetaZone) sagt 
in der "readme", da er Untersttzung fr Transparentz im nchsten Hauptrelease einbauen mchte, 
also knnten wir ein transparentes Gadget in der Zukunft haben.
Das newcalendar2.png Bild wird erreicht, indem man den Hintergrund des Kalenderbilds (gcalendar.gif) 
so ndert, dass es die gleiche Hintergrundfarbe wie der Desktop hat. Sie knnen es auch mit einem 
Bildbearbeitungs-Programm und etwas Phantasie verndern.


nderungsliste
^^^^^^^^^^^^^^ 
2006-05-15
- Bug behoben: das Gadget wurde nicht richtig nach Monat nderung aktualisiert.
- hinzugefgt das "noweek" Gadget fr diejenigen, die die Wochenzahl Anzeigespalte nicht mgen.

2006-03-21
- bersetzungs-Kid hinzugefgt: alle sprachabhngigen Zeichen sind in der Datei NewMonthGadget.xl8 
  enthalten. Wenn Sie eine Sprache hinzufgen mchten, folgen Sie einfach der Struktur und fgen 
  Ihre bersetzten Bezeichnungen hinzu. 
- das Gadget pat sich automatisch, der Sprache des Systems an, wenn vorhanden, indem es die
  LANG variablen liest; es fllt sonst ins Englische zurck.
- italienische bersetzung hinzugefgt.
- deutsche bersetzung fr das neue kit gendert.
- "german" Ordner  in "intl_docs" Ordner gendert: Es enthlt nun die bersetzten "readme" Dateien.
- die editierbaren Variablen an den Anfang des Gadget Codes verschoben, um nderungen zu vereinfachen.

2006-03-13
- Option zum ndern des Wochenanfangs (Sonntag oder Montag) hinzugefgt. Sie mssen den Wert fr 
  den Wochenanfang im Script ndern (Zeile 60).
- BuildLevel Information zum Gadget hizugefgt.
- Den "backgrounds" Ordner hinzugefgt, um vom User erzeugte Hintergrundbilder fr das Gadget 
  abzulegen. Zur Zeit enthlt es nur einen neuen Hintergrund von David Graser.
  Wenn Sie es verwenden mchten, dann benennen Sie es in gcalendar.gif um und berschreiben das 
  Orginal.
- "german" Ordner hinzugefgt, in der sich die deutsche bersetzung befindet. Es enthlt die deutsche 
  bersetzung von Rudolf Hger. Das bersetzte Gadget ist die 2006-02-21 Version, aber ich denke nicht, 
  da dies ein Problem ist, da deutsche Benutzer sich mit der Woche wohl fhlen sollten, die am Montag 
  beginnt ;-) Zuknftig mchte ich eine bequemere Art zum bersetzen des Gadget zur Verfgung stellen, 
  durch Entkoppeln des Codes von den strings. 

2006-02-21
- Wochenzahl zum Kalender hinzugefgt (gewnschtes Feature).
- genderter Grundkalender Font, um eine neuen Spalte unterzubringen.
- aktualisierte screenshots, um die neuen Eigenschaft zu zeigen.
- 'Upgrade' Abschnitt in der readme.txt Datei hinzugefgt.

2006-02-09
- gendertes popup Men, um intuitiver zu sein.
- gendert "childs" "Children" ;-)

2006-02-07
- erstes ffentliches Release.

2004-03-24
- erstes internes Release.


Links
^^^^^ 
Innotek Font-Engine:
 http://download.innotek.de/ft2lib/InnoTek_FT2LIB_260_Beta1.exe 

MS Core Web Fonts Downloader:
 http://www.ecomstation.org/vitalfiles/MSFONTPACK1_2-fixed.zip

Feffer (Front-End For Font Engine Registry): 
 http://www.os2world.com/forum/Public/Uploads/Post-83-68-feffer_0_9_2.zip (Unterseite) 
 http://www.os2world.com/forum/Public/Uploads/Post-83-94-FFR093.ZIP (Update)


Danksagungen
^^^^^^^^^^^^
Dank an Chris Wohlgemuth fr sein groartiges WPSWizard und fr all seine ganze unermdliche 
Arbeit an Erweiternungen von OS/2 und dessen Verbesserungen. Dieses kleine Gadget ist 
ein Zeichen der Anerkennung und es ist als das erste, einer Reihe weiterer Gadgets beabsichtigt. 
Ich hoffe, da dies die Leute anspornt, das gleiche zu tun... WPSWizard hat ein grosses Potential. 
Chris, Sie knnen dieses Gadget in einem folgenden Release von WPSWizard gerne mitverwenden, 
wenn Sie mgen. 

Dank an David Graser fr seine Mhe an einem neuen Hintergrundbild fr das Gadget.

Dank an Rudolf Hger fr die deutsche bersetzung des Gadget.

Dank an Serenity-Systeme fr die  eComStation und fr das lebendig halten und die 
Weiterentwicklung von OS/2. 

Dank an alle, die dieses kleine Gadget benutzen und mgen. Schreiben Sie mir bitte, 
wenn Sie es verwenden, ich wrde es gern wissen!


Viel Freude damit! 
                
                
                
                Cris 
                
                (criguada _am_ libero .dot. it)

