Soraxdesign » Webentwicklung

Auf die Farbe kommt es an

rené — Sat, 24 Apr 2010 09:36:57 +0000

Wer schon immer mal vor der Frage stand, wie man gute Farbkombinationen findet, dem kann ich einige Webseiten ans Herz legen, welche ich während meiner täglichen Arbeit gefunden habe oder als sehr inspirierend empfinde.

Da hätten wir zuerst eine (nicht vollständige) Ausarbeitung in diesem Blog zu Farbmodellen, der Auswahl von Komplementärfarbe(n) im Farbkreis oder auch Farbvarianten durch Abstufungen zu finden.

Ein schönes Tool, welches sicherlich einigen bekannt sein sollte, hat Adobe schon länger im Portfolio, es geht aber immer wieder etwas unter: Kuler. Dort können Farbvarianten in einem Flexclient entweder selbst zusammengestellt oder aus einem großen Pool der Community ausgewählt werden. Ich finde es sehr intuitiv und auch grafisch ansprechend.

Auch Tools umgesetzt mit Adobe AIR sind zu finden. So bietet der COLOURlovers Desktop Color Finder von Adobe die Möglichkeit, nahezu 1 Mio. fertige und ca. 300 000 nutzergenerierte Farbzusammenstellungen zu finden. Auch der colorbrowser bietet eine Möglichkeit Farbzusammenstellungen zu verwalten. Jedoch ist hier keine Datenbank mit fertigen Vorlagen verknüpft, der Nutzen ist eher als Archiv für persönliche Farbkombinationen zu sehen. Definitiv ein ausgezeichnetes Tool ist auch der Colorschemedesigner.

Projekt fertig: Kinnstützen und mechanische Vorrichtungen

rené — Sun, 07 Feb 2010 15:06:20 +0000

Heute wurde die Internetseite für das Unternehmen Gerald Kann – Kinnstützen und mechanische Vorrichtungen fertiggestellt. Das Unternehmen in Magdeburg hat sich auf die Entwicklung und Fertigung von Kinnstützen und Kopfstützen zur Perimetrie innerhalb der Neurologie spezialisiert. Weiterhin können allgemeine Vorrichtungen, technische Hilfsmittel und Spezialkonstruktionen auf Anfrage gefertigt werden. Vor allem für das Gesichtsfeldtraining, bei Sehstörungen oder auch zur ambulanten Behandlung von Augenoperationen und Laserbehandlungen können spezielle Geräte (Kinnstützen, Kopfstützen, sowohl mobil und stationär, auch in Verbindung mit einem Monitor) konstruiert und angefragt werden.
Feinmechanische Spezialkonstruktionen und Vorrichtungsbau gehören ebenso zum Leistungsbereich.
Die Internetseite wurde mit PHP und W3C kompatibel in XHTML 1.0 erstellt, nutzt mod_rewrite sowie dynamische Titel um eine verbesserte Suchmaschinenindexierung zu gewährleisten. An Bibliotheken kommen PHPMailer, jQuery und Lightbox zum Einsatz.

Link: www.kinnstuetzen.de

Auffrischungskur für Soraxdesign PHP Gästebuch

rené — Thu, 10 Dec 2009 09:05:08 +0000

Das Soraxdesign PHP Gästebuch wirde demnächst eine Auffrischungskur in Form von Bugfixes und kleinen Neuerungen erhalten. Diese liegen schon eine Weile in meiner digialen Schublade, ich bin bisher leider nicht dazu gekommen, diese auszupacken.
Zum einen werden einige Fehler beim include() und im Internet Explorer, welche Funktionen hinzukommen, kann ich zum jetzigen Zeitpunkt noch nicht sagen. Wahrscheinlich werden auch die Sprachdateien an einigen Stellen verbessert.
Bis dahin könnt ihr gerne das aktuelle in der Version 3.2.5. nutzen, die 3.2.6 wird dann zeitnah erscheinen.

Tutorial und Tips: Dokumentation von Quelltext mit Doxygen

rené — Wed, 25 Nov 2009 23:43:43 +0000

Nicht nur wenn ein Projekt größer wird, sondern prinzipiell immer sollten sowohl Quellcode als auch das Projekt an sich dokumentiert werden, damit spätere Entwickler weniger Einarbeitungszeit benötigen und nicht erst den Quellcode durcharbeiten müssen, um das Projekt zu verstehen.
Heute möchte ich auf einen Teil der Dokumentation eingehen, manchmal auch als technische Dokumentation bezeichnet (obwohl sich darüber die Geister streiten, was eine technische Dokumentation genau definiert, wie man hier [1], hier [2] oder hier [3] nachlesen kann.), dem Quellcode.

Unterstützung erhält man dabei durch eine Software namen Doxygen. Diese kann anhand der Projektstruktur mit Bibliotheken, Klassen und Verzeichnissen eine ansehliche Dokumentation erstellen.
Wichtig ist, dass der Quellecode im Javadoc [4] Stil kommentiert wird. Ein Beispiel:

/**
Addiert zwei Zahlen und gibt deren Summe zurück.
@param $number1 erster Summand
@param $number2 erster Summand
@return Summe der beiden Zahlen
@see subtract() subtrahiert zwei Zahlen voneinander
*/
private function calc($number1, $number2) {
return $number1 + $number2;
}

Schnell erkennt man, dass ich die Parameter eine Funktion calc mit @param beschreibe, davor kommt eine allgemeine Funktionsbeschreibung, um die Aufgabe der Funktion zu verdeutlichen. Sollte die Funktion keinen Rückgabewert haben, lässt man @return einfach weg. Der Parameter @see beschreibt einen Verweis auf eine andere Funktion, die evtl. mit dieser im Zusammenhang steht oder ähnliche Funktionalität aufweist.

Der Kopf einer Klasse sollte immer folgendes Format besitzen (die meisten IDEs wie z.B. Eclipse generieren diesen automatisch):

/**
* Ein Hello-World-Programm in Java.
* Dies ist ein Javadoc-Kommentar.
*
* @author René
* @version 1.0
*/

Nachdem ihr jetzt grundlegend wisst, wie eure Klassen “lesbar” gemacht werden, geht es daran, Doxygen [5] zu konfiguieren. Ich arbeit selbst am Mac und werde daher hier auf die Macversion eingehen, habe aber auch mit der Windowsversion gearbeitet und es gibt keinen Unterschied.
Öffnet Doxygen und startet den Wizard. Viele Sachen sollten selbsterklärend sein, hier aber einige Tips oder Fallstricke:

Step 1
Gebt hier den Pfad zum Installationsordner (!) von Doxygen an.

Project version or id
Hier müsst ihr immer manuell eine neue Version der Doku eingeben, kann ich nur empfehlen, wenn ihr an einem Projekt arbeitet, dass sich kontinuierlich (im Team) entwickelt.

Specify the directory to scan for sourcecode
Hier wird der eigentliche Projektordner mit euren Klassen, Bibliotheken usw. angegeben.

Doxygen Wizard erster Schritt

-> Nächster Schritt

Select the desired extraction mode
Ich wähle fast immer “Documented entities only”, dann erkennt ihr schnell, ob noch Klassen dokumentiert werden müssen, wenn diese nicht in der Doku auftauchen. Der Haken bei “Include cross-referenced source code in the output” gefällt mir, denn dann werden in der Doku alle Funktion aufgelistet die auf die aktuelle Funktion zugreifen.

Select programming language to optimize the results for
Hier die entsprechende Sprache wählen oder eine ähnliche. Für Objective-C habe ich z.B. mit “Java or C#” gute Erfahrungen gemacht. Einfach auch etwas ausprobieren.

Zweiter Schritt im Wizard von Doxygen

-> Nächster Schritt

Select the output format(s) to generate
Ich möchte in meinen Dokus immer links einen Frame mit Baumnavigation (“with frames and a navigation tree”) haben. Auf die Suchfunktion verzichte ich meistens, hat teilweise Probleme beim Generieren der Doku erzeugt. Ausgabe als Latex ist sehr toll, es entsteht anschließend einer verlinkte refman.tex, welche auf dem Mac z.B. mit MacTeX [6] und der eingabe “make” im Terminal in eine PDF umgewandelt werden kann.

Dritter Schritt im Wizard von Doxygen

-> Nächster Schritt

Im letzten Schritt kann man sich entscheiden, ob Diagramme der Klassenstrukturen erzeugt werden sollen. Lohnt sich prinzipiell nur, wenn es viele Klassenabhängigkeiten im Projekt gibt. Daher Punkt 2 oder, falls dem nicht so ist, Punkt 1 wählen.
Nachdem der Wizard durchgestanden ist, kann gerne im Reiter “Run” auf den Button “Run Doxygen” gedrückt werden. Vergesst nicht, eure Profildatei zu speichern!
Geht nichts schief, bekommt ihr, wenn ihr den Button “Show HTML Output” mit eurer Maus malträtiert, eine HTML-Seite eurer Doku im Browser präsentiert. Das sieht dann so aus:

Ausgabe der HTML Doku

Kommen wir nun zu einigen Experteneinstellungen, die ihr im zweiten Reiter findet. Dort sind einige Einstellungen versteckt, die teilweise sehr wichtig sind.

-> Project

OUTPUT_LANGUAGE
Sprachumstellung auf Deutsch, so dass einige Standardbegriffe in der Doku auf Deutsch erscheinen (“File List” -> “Auflistung der Dateien”). Es sind aber noch nicht alle Begriffe übersetzt.

STRIP_FROM_PATH
Wollt ihr in eurer Doku nicht immer my/project/with/long/path/to/the/classes/Hello.java zu stehen habe, dann gebt dort den Pfad ein, der abgeschnitten werden soll. (in diesem Falle “my/project/with/long/path/to/the/classes”).

SEPARATE_MEMBER_PAGES
Seid ihr ein eifriger Kommentator und schreibt auch was zu euren Klassenvariablen, könnt ihr eure Romane auf einzelnen Seiten ausgeben lassen.

-> Build

EXTRACT_ALL
Soll wirklich alles und nicht nur dokumentierte Klassen bearbeitet werden, setzt ihr hier einfach einen Haken. Dann werden aber wirklich alle (!) Dateien, Variablen und Methoden in die Doku aufgenommen. Das kann auch noch verfeinert werden, indem ihr EXTRACT_PRIVATE explizit auswählt, so dass auch private Klassenvariablen ausgelesen werden.

-> Input

INPUT_ENCODING
Hier tragt ihr am besten “ISO-8859-1″ ein, wenn eure Dateien nicht im UTF-8 Format abgespeichert sind, sonst bekommt ihr in eurer Doku nur Zeichensalat.

EXCLUDE
Sehr wichtige Einstellunge. Oftmals liegen in einem Projekt Testdateien oder -klassen, die man ungern in der Doku haben möchte. Klar kann man anwählen, dass man nur dokumentierte Dateien aufnehmen möchte, aber die Holzhammermethode ist das explizite ausschliessen bestimmter Dateien.

-> HTML

HTML_HEADER, HTML_FOOTER, HTML_STYLESHEET
Über HTML_HEADER kann eine eigene HTML-Datei für den Kopf festgelegt werden, das gleiche gilt für den Footer. HTML_STYLESHEET bietet die Möglichkeit, die Standard-CSS von Doxygen zu verändern bzw. zu überschreiben. Vergesst nicht, eure verlinkten Dateien aus externen HTML-Dateien bzw. die CSS in den Zielordner eurer Doku zu kopieren.

TREEVIEW_WIDTH
Hier könnt ihr die Breite des linken Frames mit der Baumstruktur festlegen. Oftmals sind 250px einfach zu schmal und bei heutigen Auflösungen auch unnötig klein.

So sähe dann übrigens die PDF Datei aus, wenn ihr sie durch MacTeX jagt:
Dokumentation

Was heisst “technische Dokumentation” für euch? Womit dokumentiert ihr eure Projekte und habt ihr Tips für Doxygen oder was man anders machen könnte? Womit bildet ihr eure Datenbankmodelle ab und was habt ihr für Erfahrungen damit? Über einen Kommentar würde ich mich freuen!

Quellen

[1] Die Technische Dokumentation im Wandel: http://www.transline.de/transline-tecNews/technische-dokumentation-im-wandel-anforderungen-redaktionssysteme-docuglobe
[2] Was ist Technische Dokumentation?: http://www.comet.de/technische_redaktion/technische_dokumentation.php
[3] Checkliste zur Qualitätssicherung Technischer Dokumentation: http://www.indoition.com/de/qualitaet-software-dokumentation.htm
[4] Javadoc - was ist das und wie nutze ich es?: http://de.wikipedia.org/wiki/Javadoc
[5]
Source code documentation generator tool: http://www.stack.nl/~dimitri/doxygen/
[6] The MacTeX-2009 Distribution: http://www.tug.org/mactex/2009/

Betas von Adobe Air 2 und Flash Player 10.1

rené — Wed, 18 Nov 2009 20:47:39 +0000

Adobe hat gestern die beiden Betas zu Flash Player 10.1 [1] und AIR 2 [2] veröffentlich. Ist der Flash Player mit einer Nebenversionsnummer nur geringfügig erhöht wurden, hat Air mit der Version 2 einen deutlichen Sprung gemacht.

Beim Flash Player 10.1 sind die wohl wesentlichsten und auch spannendsten Neuerungen, dass er komplett unter der Prämisse des Open-Screen-Projects veröffentlich wird. Dieses sieht vor, dass es prinzipiell egal ist, für welches Endgerät eine Anwendung in Flash oder Flex entworfen und entwickelt wird, denn durch dieses Projekt soll sichergestellt werden, dass die Anwendung auf einem Mobiltelefon, Netbook, Desktoprechner und auch Mediacenter absolut identisch funktioniert und erscheint.
Und das ohne individuelle Anpassungen oder spezielle Versionen. Daher hat Adobe auch einen schone lange nötigen Schritt vollzogen: der Flash Player 10.1 erscheint für alle modernen Smartphones, Netbooks und Desktoprechner mit den absolut identischen Funktionen. Beendet sind die Zeiten vom Flash Player Lite (solange das Smartphone eine CPU hat, die stärker ist als 500Mhz) . Nur Apple und Adobe sind sich noch nicht ganz grün, so dass der Flash Player 10.1 nicht für das iPhone erscheinen wird [3].
Weiterer tolle Funktionen sind eine globale Fehlerbehandlung (endlich keine nichtsagenden und unglaublich nervenden Alertfenster mit Warnmeldungen mehr), Multitouch und DRM.

Mit AIR 2 [4] führt Adobe Neuerungen ein, die zu spannenden und vorher nicht möglichen Applikationen führen werden. Die wichtigsten Funktionen sind:

Erkennung von Massenspeichern
Erweiterte Netzwerkfunktionen (SSL, UDP Unterstützung, Socketverbindungen)
Native Codeunterstützung
Öffnen einer Datei mit der Standardanwendung
Multitouch und Gestensteuerung
APIs für die Manipulation von Mikrofondaten
WebKit mit HTML5 und CSS3 Unterstützung
Globale Fehlerbehandlung
Verbesserte Druckfunktion auf unterschiedlichen Plattformen
Erhöhte Sicherheit und Unterstützung von gebräuchlichen Standards von Unternehmen und öffentlichen Einrichtungen

Hier könnt ihr euch einige Neuerungen als Demo [5] anschauen:

Demo für Flash Player 10.1 Beta:
http://labs.adobe.com/downloads/flashplayer10.html
Demo für AIR 2 Beta
http://labs.adobe.com/downloads/air2.html

Quellen

[1] Beta Flash Player 10.1: http://labs.adobe.com/technologies/flashplayer10/
[2] Adobe AIR 2 Beta: http://labs.adobe.com/technologies/air2/
[3] Für alle Handys außer iPhone: Adobe stellt Flash 10.1 vor: http://www.areamobile.de/news/13168-fuer-alle-handys-ausser-iphone-adobe-stellt-flash-10-1-vor
[4] Introducing Adobe AIR 2 beta: http://www.adobe.com/devnet/logged_in/rchristensen_air_2.html
[5] Whats coming with AIR 2: http://tv.adobe.com/watch/max-2009-develop/whats-coming-in-adobe-air-2-/