<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Soraxdesign</title>
	<atom:link href="http://www.soraxdesign.de/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.soraxdesign.de</link>
	<description>Softwareentwicklung, Rich Internet Applications und Blog</description>
	<lastBuildDate>Sun, 07 Feb 2010 15:07:22 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.1</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<xhtml:meta xmlns:xhtml="http://www.w3.org/1999/xhtml" name="robots" content="noindex" />
		<item>
		<title>Projekt fertig: Kinnstützen und mechanische Vorrichtungen</title>
		<link>http://www.soraxdesign.de/2010/02/07/kinnstuetzen-mechanische-vorrichtungen-perimetrie-augenheilkunde-vorrichtungsbau-spezialkonstruktionen-feinmechanik/</link>
		<comments>http://www.soraxdesign.de/2010/02/07/kinnstuetzen-mechanische-vorrichtungen-perimetrie-augenheilkunde-vorrichtungsbau-spezialkonstruktionen-feinmechanik/#comments</comments>
		<pubDate>Sun, 07 Feb 2010 15:06:20 +0000</pubDate>
		<dc:creator>rené</dc:creator>
				<category><![CDATA[Projekte]]></category>
		<category><![CDATA[Webentwicklung]]></category>
		<category><![CDATA[Magdeburg]]></category>

		<guid isPermaLink="false">http://www.soraxdesign.de/?p=484</guid>
		<description><![CDATA[Heute wurde die Internetseite für das Unternehmen Gerald Kann &#8211; 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 [...]


Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/10/06/projekt-fertig-magdeburger-weihnachtsmarkt/' rel='bookmark' title='Permanent Link: Projekt fertig: Magdeburger Weihnachtsmarkt'>Projekt fertig: Magdeburger Weihnachtsmarkt</a> <small>Heute wurde die Programmierung für ein lokales Projekt beendet. In...</small></li>
</ol>

Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p>Heute wurde die Internetseite für das Unternehmen <a href="http://www.kinnstuetzen.de">Gerald Kann &#8211; Kinnstützen und mechanische Vorrichtungen</a> fertiggestellt. Das Unternehmen in Magdeburg hat sich auf die Entwicklung und Fertigung von <a href="http://www.kinnstuetzen.de/produktuebersicht/Patientenkinnstuetze-spezial#bottom">Kinnstützen</a> und <a href="http://www.kinnstuetzen.de/produktuebersicht/Patientenkinnstuetze-spezial#bottom">Kopfstützen</a> zur Perimetrie innerhalb der Neurologie spezialisiert. Weiterhin können allgemeine Vorrichtungen, technische Hilfsmittel und <a href="http://www.kinnstuetzen.de/produktuebersicht/mobiler-Spezialtisch-medizinische-Psychologie-Perimetrie#bottom">Spezialkonstruktionen</a> 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.<br />
<a href="http://www.kinnstuetzen.de/produktuebersicht/mobile-Laptophalterung-Vermessungsarbeiten-GIS-Erfassung#bottom">Feinmechanische Spezialkonstruktionen</a> und Vorrichtungsbau gehören ebenso zum Leistungsbereich.<br />
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.</p>
<p>Link: <a href="http://www.kinnstuetzen.de">www.kinnstuetzen.de</a></p>


<p>Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/10/06/projekt-fertig-magdeburger-weihnachtsmarkt/' rel='bookmark' title='Permanent Link: Projekt fertig: Magdeburger Weihnachtsmarkt'>Projekt fertig: Magdeburger Weihnachtsmarkt</a> <small>Heute wurde die Programmierung für ein lokales Projekt beendet. In...</small></li>
</ol></p>
<p>Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p>]]></content:encoded>
			<wfw:commentRss>http://www.soraxdesign.de/2010/02/07/kinnstuetzen-mechanische-vorrichtungen-perimetrie-augenheilkunde-vorrichtungsbau-spezialkonstruktionen-feinmechanik/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Studie zur Nutzung digitaler Magazine auf tragbaren Geräten</title>
		<link>http://www.soraxdesign.de/2010/01/18/studie-nutzung-digitale-magazine-mobile-geraete-wie-tablets/</link>
		<comments>http://www.soraxdesign.de/2010/01/18/studie-nutzung-digitale-magazine-mobile-geraete-wie-tablets/#comments</comments>
		<pubDate>Mon, 18 Jan 2010 15:19:05 +0000</pubDate>
		<dc:creator>rené</dc:creator>
				<category><![CDATA[Studien]]></category>
		<category><![CDATA[User Interface]]></category>
		<category><![CDATA[Mobile Devices]]></category>
		<category><![CDATA[Studies]]></category>

		<guid isPermaLink="false">http://www.soraxdesign.de/?p=456</guid>
		<description><![CDATA[Bonnier R&#38;D [1] haben mit Ihrem Designpartner BERG eine spannende Studie zum Lesen digitaler Magazine auf tragbaren Geräten veröffentlicht. Gegenwärtig ist die Euphorie über eine mögliche Präsentation eines Tablets durch Apple in aller Munde, soll hier aber nicht im Vordergrund stehen. Aber schaut euch die Studie einmal an und beteiligt euch an den Diskussionen [2]. [...]


Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/10/14/die-zukunft-der-computereingabe-studie-uber-multitouch-mit-herkoemmlichen-desktops/' rel='bookmark' title='Permanent Link: Studie zur Nutzung von Multitouch auf Desktops'>Studie zur Nutzung von Multitouch auf Desktops</a> <small>Geräte mit Multitouch ist seit der erfolgreichen Einführung des iPhones...</small></li>
</ol>

Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p><a href="http://bonnier.com/en/next-chapter" title="Bonnier R&amp;D">Bonnier R&amp;D</a> <a href="#153760663">[1]</a> haben mit Ihrem Designpartner BERG eine spannende Studie zum Lesen digitaler Magazine auf tragbaren Geräten veröffentlicht. Gegenwärtig ist die Euphorie über eine mögliche Präsentation eines Tablets durch Apple in aller Munde, soll hier aber nicht im Vordergrund stehen. Aber schaut euch die Studie einmal an und beteiligt euch an den <a href="http://bonnier.com/en/content/digital-magazines-bonnier-mag-prototype" title="Digital Magazines: Bonnier Mag+ Prototype">Diskussionen</a> <a href="#153760664">[2]</a>. Ich bin sehr beeindruckt.</p>
<p><object width="500" height="281"><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="movie" value="http://vimeo.com/moogaloop.swf?clip_id=8217311&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=1&amp;show_portrait=0&amp;color=ffffff&amp;fullscreen=1" /><embed src="http://vimeo.com/moogaloop.swf?clip_id=8217311&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=1&amp;show_portrait=0&amp;color=ffffff&amp;fullscreen=1" type="application/x-shockwave-flash" allowfullscreen="true" allowscriptaccess="always" width="500" height="281"></embed></object>
<p><a href="http://vimeo.com/8217311" title="Bonnier Mag+">Mag+</a> <a href="#153760665">[3]</a></p>
<p><strong>Quellen:</strong><br />
<ul>	<li><a name="1537606631"></a>[1] Bonnier R&amp;D: <a href="http://bonnier.com/en/next-chapter">http://bonnier.com/en/next-chapter</a></li>	<li><a name="1537606642"></a>[2] Digital Magazines: Bonnier Mag+ Prototype: <a href="http://bonnier.com/en/content/digital-magazines-bonnier-mag-prototype">http://bonnier.com/en/content/digital-magazines-bonnier-mag-prototype</a></li>	<li><a name="1537606653"></a>[3] Bonnier Mag+: <a href="http://vimeo.com/8217311">http://vimeo.com/8217311</a></li></ul></p>


<p>Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/10/14/die-zukunft-der-computereingabe-studie-uber-multitouch-mit-herkoemmlichen-desktops/' rel='bookmark' title='Permanent Link: Studie zur Nutzung von Multitouch auf Desktops'>Studie zur Nutzung von Multitouch auf Desktops</a> <small>Geräte mit Multitouch ist seit der erfolgreichen Einführung des iPhones...</small></li>
</ol></p>
<p>Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p>]]></content:encoded>
			<wfw:commentRss>http://www.soraxdesign.de/2010/01/18/studie-nutzung-digitale-magazine-mobile-geraete-wie-tablets/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Vergleich der O2 Tarife hinsichtlich des Minutenverbrauchs</title>
		<link>http://www.soraxdesign.de/2010/01/04/vergleich-o2-tarife-hinsichtlich-minutenverbrauchs-mit-empfehlung/</link>
		<comments>http://www.soraxdesign.de/2010/01/04/vergleich-o2-tarife-hinsichtlich-minutenverbrauchs-mit-empfehlung/#comments</comments>
		<pubDate>Mon, 04 Jan 2010 16:09:01 +0000</pubDate>
		<dc:creator>rené</dc:creator>
				<category><![CDATA[Allgemein]]></category>
		<category><![CDATA[Privates]]></category>
		<category><![CDATA[iPhone]]></category>
		<category><![CDATA[Tips]]></category>

		<guid isPermaLink="false">http://www.soraxdesign.de/?p=438</guid>
		<description><![CDATA[Wer, wie ich, demnächst zu o2 wechseln möchte, steht natürlich auch vor der Frage, welcher Tarif sich für ihn lohnt. o2 bietet gegenwärtig vier Tarifmodelle mit jeweils zwei Ausprägungen an: o2 o, o2 Prepaid, o2 Mobile Flat und o2 Inklusivpaket. In meine Betrachtungen ziehe ich nur o2 o und o2 Inklusivpaket für Studenten ein, da [...]


Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/10/12/adobe-bringt-photoshop-aus-iphone-aber-vorsicht/' rel='bookmark' title='Permanent Link: Adobe bringt Photoshop aufs iPhone. Aber Vorsicht!'>Adobe bringt Photoshop aufs iPhone. Aber Vorsicht!</a> <small>Adobe hat heute seine App Photoshop.com Mobile herausgebracht, mit welcher...</small></li>
</ol>

Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p>Wer, wie ich, demnächst zu o2 wechseln möchte, steht natürlich auch vor der Frage, welcher Tarif sich für ihn lohnt. o2 bietet gegenwärtig vier Tarifmodelle mit jeweils zwei Ausprägungen an: o2 o, o2 Prepaid, o2 Mobile Flat und o2 Inklusivpaket. In meine Betrachtungen ziehe ich nur o2 o und o2 Inklusivpaket für Studenten ein, da o2 Prepaid und o2 Mobile Flat für mich nicht in Frage kommen. Jedoch unterscheiden sich die anderen beiden teilweise deutlich, aber man muss genau hinschauen, was sich wirklich lohnt. Der Tarif o2 o unterscheidet sich als Studententarif nicht vom normalen Tarif, bei dem Inklusivpaket gibt es 150 Frei-SMS oder 20% Onlinevorteil.<br />
<span id="more-438"></span><br />
Ein aussagekräftiger Wert für diese Entscheidung ist der monatliche Minutenverbrauch, den man entweder schätzt oder direkt in seinem Telefon ablesen kann. Auch kommt die monatliche Nutzung von SMS hinzu.<br />
Die Tarife o2 o und o2 Inklusivpaket gibt es jeweils mit 15% und 20% Onlinevorteil. Im Paket o2 o zahlt man entweder 0,15€/Minute und SMS oder mit 15% Rabatt (bei Onlinebestellung) 0,13€/Minute und SMS. Grundgebühr gibt es keine. Das Inklusivpaket bietet 100 Freiminuten und 150 Frei-SMS oder 20% Rabatt bei Onlinebestellung. Die Grundgebühr beträgt entweder 10€ oder 8€ (bei 20% Rabatt). Sind die 100 Freiminuten und/oder 150 Frei-SMS verbraucht, kostet jede weitere SMS 0,19€ und jede Minute 0,29€ bzw. mit 20% Rabatt 0,16€/SMS und 0,24€/Minute. Soweit die Fakten.</p>
<p>Ich habe mit in Excel die Daten zusammengetragen und einige Beispiele für die Minutennutzung pro Monat aufgelistet. Anschließend die monatlichen Kosten mit Freiminuten und Frei-SMS berechnet und in zwei Diagrammen dargestellt. Den monatlichen SMS Verbrauch habe ich mit 50 angesetzt. In der angehängten Excel-Datei kann man gerne mit den Werten probieren. Herausgekommen ist folgendes:</p>
<p><a href="http://www.soraxdesign.de/wp-content/uploads/2010/01/01_liniendiegramm.png"><img src="http://www.soraxdesign.de/wp-content/uploads/2010/01/01_liniendiegramm-300x191.png" alt="O2 Tarife im Vergleich" title="01_liniendiagramm" width="300" height="191" class="size-medium wp-image-440" /></a></p>
<p><a href="http://www.soraxdesign.de/wp-content/uploads/2010/01/02_balkendiagramm.png"><img src="http://www.soraxdesign.de/wp-content/uploads/2010/01/02_balkendiagramm-300x205.png" alt="02_balkendiagramm" title="02_balkendiagramm" width="300" height="205" class="aligncenter size-medium wp-image-441" /></a></p>
<p>An den beiden Diagrammen ist deutlich zu erkennen, dass es einige Wendepunkte gibt.<br />
So sind die Grenzen grob bei 73 und 125 Minuten zu sehen. Telefoniert man weniger als 73 Minuten pro Monat, reicht der  Tarif o2 o mit 15% Onlinevorteil aus. Fällt die eigene Telefonleistung zwischen 73 und 132 Minuten, sollte man eventuell zum Inklusivpaket mit 20% Onlinevorteil greifen. Denn dieses wird erst wieder ab ca. 132 Minuten teurer als das o2 o Paket mit 15% Onlinevorteil. Nach 132 Minuten fährt man mit dem o2 o Paket mit 15% Onlinevorteil wieder preiswerter.</p>
<p>Möchte man den Vertrag ohne Onlinevorteil abschließen verschieben sich diese Grenzen um etwa 5 &#8211; 10 Minuten nach vorne und hinten (dann lohnt sich das Inklusivpaket nur zwischen den Minutenwerten von 80 und 122 Minuten &#8211; hier fehlt dann einfach der Onlinevorteil und somit steigt hier der Preis schneller an).<br />
Ich hoffe, ich habe einigen bei Ihrer Entscheidung etwas geholfen und muss zum Abschluss sagen, dass O2 hier recht feine Tarife anbietet.</p>
<p>Hier ist die Excel-Datei zum selbst ausprobieren:<br />
<a href='http://www.soraxdesign.de/wp-content/uploads/2010/01/Vergleich-o2-tarife.xlsx'>Excel Datei O2 Tarife (Office 2007)</a><br />
<a href='http://www.soraxdesign.de/wp-content/uploads/2010/01/Vergleich-o2-tarife.xls'>Excel Datei O2 Tarife (Office 2003)</a></p>
<p><em>Update: o2 Zero wurde in o2 o umbenannt, in den Grafiken ist aber noch von o2 Zero die Rede (gemeint aber o2 o)<br />
</em></p>


<p>Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/10/12/adobe-bringt-photoshop-aus-iphone-aber-vorsicht/' rel='bookmark' title='Permanent Link: Adobe bringt Photoshop aufs iPhone. Aber Vorsicht!'>Adobe bringt Photoshop aufs iPhone. Aber Vorsicht!</a> <small>Adobe hat heute seine App Photoshop.com Mobile herausgebracht, mit welcher...</small></li>
</ol></p>
<p>Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p>]]></content:encoded>
			<wfw:commentRss>http://www.soraxdesign.de/2010/01/04/vergleich-o2-tarife-hinsichtlich-minutenverbrauchs-mit-empfehlung/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Auffrischungskur für Soraxdesign PHP Gästebuch</title>
		<link>http://www.soraxdesign.de/2009/12/10/bald-update-soraxdesign-php-gastebuch/</link>
		<comments>http://www.soraxdesign.de/2009/12/10/bald-update-soraxdesign-php-gastebuch/#comments</comments>
		<pubDate>Thu, 10 Dec 2009 09:05:08 +0000</pubDate>
		<dc:creator>rené</dc:creator>
				<category><![CDATA[Projekte]]></category>
		<category><![CDATA[Webentwicklung]]></category>
		<category><![CDATA[Gästebuch]]></category>
		<category><![CDATA[JavaScript]]></category>
		<category><![CDATA[MySQL]]></category>
		<category><![CDATA[PHP]]></category>

		<guid isPermaLink="false">http://www.soraxdesign.de/?p=426</guid>
		<description><![CDATA[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. [...]


No related posts.

Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p>Das <a href="http://www.soraxdesign.de/projekte/php_gaestebuch_soraxdesign/">Soraxdesign PHP Gästebuch</a> 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.<br />
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.<br />
Bis dahin könnt ihr gerne das <a href="http://www.soraxdesign.de/projekte/php_gaestebuch_soraxdesign/">aktuelle</a> in der Version 3.2.5. nutzen, die 3.2.6 wird dann zeitnah erscheinen.</p>


<p>No related posts.</p>
<p>Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p>]]></content:encoded>
			<wfw:commentRss>http://www.soraxdesign.de/2009/12/10/bald-update-soraxdesign-php-gastebuch/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Tutorial und Tips: Dokumentation von Quelltext mit Doxygen</title>
		<link>http://www.soraxdesign.de/2009/11/26/dokumentation-quelltextdoxygen-objective-c-java/</link>
		<comments>http://www.soraxdesign.de/2009/11/26/dokumentation-quelltextdoxygen-objective-c-java/#comments</comments>
		<pubDate>Wed, 25 Nov 2009 23:43:43 +0000</pubDate>
		<dc:creator>rené</dc:creator>
				<category><![CDATA[Tutorials]]></category>
		<category><![CDATA[Webentwicklung]]></category>
		<category><![CDATA[Dokumentation]]></category>
		<category><![CDATA[Projekte]]></category>
		<category><![CDATA[Projektmanagement]]></category>
		<category><![CDATA[Tutorial]]></category>

		<guid isPermaLink="false">http://www.soraxdesign.de/?p=376</guid>
		<description><![CDATA[Nicht nur wenn ein Projekt größer wird, sondern prinzipiell immer sollten sowohl Quellcode als auch das Projekt ansich dokumentiert werden, damit spätere Entwickler weniger Einarbeitungszeit benötigen und nicht erst den Quellcode durcharbeiten müssen, um das Projekt zu verstehen.


Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/08/24/externalinterface-zusammenspiel-von-swf-und-javascript/' rel='bookmark' title='Permanent Link: Tutorial: ExternalInterface &#8211; Zusammenspiel von SWF und JavaScript'>Tutorial: ExternalInterface &#8211; Zusammenspiel von SWF und JavaScript</a> <small>Manchmal ist es nötig, SWF Dateien mit dem aktuellen Container...</small></li>
<li><a href='http://www.soraxdesign.de/2009/10/22/tutorial-mehrsprachige-anwendungen-in-flex-3-runtime-localization/' rel='bookmark' title='Permanent Link: Tutorial: Mehrsprachige Anwendungen in Flex 3'>Tutorial: Mehrsprachige Anwendungen in Flex 3</a> <small>Wer schon einmal vor der Aufgabe stand, eine Flex Projekt...</small></li>
</ol>

Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p>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.<br />
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 <em>technische Dokumentation</em> genau definiert, wie man <a href="http://www.transline.de/transline-tecNews/technische-dokumentation-im-wandel-anforderungen-redaktionssysteme-docuglobe" title="Die Technische Dokumentation im Wandel">hier</a> <a href="#782609739">[1]</a>,  <a href="http://www.comet.de/technische_redaktion/technische_dokumentation.php" title="Was ist Technische Dokumentation?">hier</a> <a href="#782609740">[2]</a> oder <a href="http://www.indoition.com/de/qualitaet-software-dokumentation.htm" title="Checkliste zur Qualitätssicherung Technischer Dokumentation">hier</a> <a href="#782609741">[3]</a> nachlesen kann.), dem Quellcode.<br />
<span id="more-376"></span></p>
<p>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.<br />
Wichtig ist, dass der Quellecode im <a href="http://de.wikipedia.org/wiki/Javadoc" title="Javadoc - was ist das und wie nutze ich es?">Javadoc</a> <a href="#782609742">[4]</a> Stil kommentiert wird. Ein Beispiel:</p>
<div class="codecolorer-container text default" style="overflow:auto;white-space:nowrap;border: 1px solid #9F9F9F;width:435px;"><div class="text codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">/**<br />
Addiert zwei Zahlen und gibt deren Summe zurück.<br />
@param $number1 erster Summand<br />
@param $number2 erster Summand<br />
@return Summe der beiden Zahlen<br />
@see subtract() subtrahiert zwei Zahlen voneinander<br />
*/<br />
private function calc($number1, $number2) {<br />
return $number1 + $number2;<br />
}</div></div>
<p>Schnell erkennt man, dass ich die Parameter eine Funktion <em>calc</em> mit <em>@param</em> 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.</p>
<p>Der Kopf einer Klasse sollte immer folgendes Format besitzen (die meisten IDEs wie z.B. Eclipse generieren diesen automatisch):</p>
<div class="codecolorer-container text default" style="overflow:auto;white-space:nowrap;border: 1px solid #9F9F9F;width:435px;"><div class="text codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">/**<br />
&nbsp;* Ein Hello-World-Programm in Java.<br />
&nbsp;* Dies ist ein Javadoc-Kommentar.<br />
&nbsp;*<br />
&nbsp;* @author René<br />
&nbsp;* @version 1.0<br />
&nbsp;*/</div></div>
<p>Nachdem ihr jetzt grundlegend wisst, wie eure Klassen &#8220;lesbar&#8221; gemacht werden, geht es daran, <a href="http://www.stack.nl/~dimitri/doxygen/" title="<br />
Source code documentation generator tool">Doxygen</a> <a href="#782609743">[5]</a> 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.<br />
Öffnet Doxygen und startet den Wizard. Viele Sachen sollten selbsterklärend sein, hier aber einige Tips oder Fallstricke:</p>
<p><strong>Step 1</strong><br />
Gebt hier den Pfad zum Installationsordner (!) von Doxygen an.</p>
<p><strong>Project version or id</strong><br />
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.</p>
<p><strong>Specify the directory to scan for sourcecode</strong><br />
Hier wird der eigentliche Projektordner mit euren Klassen, Bibliotheken usw. angegeben.</p>
<div id="attachment_381" class="wp-caption aligncenter" style="width: 310px"><a href="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-9.png" target="_blank"><img src="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-9-300x232.png" alt="Doxygen Wizard erster Schritt" title="Doxygen Wizard erster Schritt" width="300" height="232" class="size-medium wp-image-381" /></a><p class="wp-caption-text">Doxygen Wizard erster Schritt</p></div>
<p><em>-> Nächster Schritt</em></p>
<p><strong>Select the desired extraction mode</strong><br />
Ich wähle fast immer &#8220;Documented entities only&#8221;, dann erkennt ihr schnell, ob noch Klassen dokumentiert werden müssen, wenn diese nicht in der Doku auftauchen. Der Haken bei &#8220;Include cross-referenced source code in the output&#8221; gefällt mir, denn dann werden in der Doku alle Funktion aufgelistet die auf die aktuelle Funktion zugreifen.</p>
<p><strong>Select programming language to optimize the results for</strong><br />
Hier die entsprechende Sprache wählen oder eine ähnliche. Für Objective-C habe ich z.B. mit &#8220;Java or C#&#8221; gute Erfahrungen gemacht. Einfach auch etwas ausprobieren.</p>
<div id="attachment_385" class="wp-caption aligncenter" style="width: 310px"><a href="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-10.png"><img src="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-10-300x232.png" alt="Zweiter Schritt im Wizard von Doxygen" title="Zweiter Schritt im Wizard von Doxygen" width="300" height="232" class="size-medium wp-image-385" /></a><p class="wp-caption-text">Zweiter Schritt im Wizard von Doxygen</p></div>
<p><em>-> Nächster Schritt</em></p>
<p><strong>Select the output format(s) to generate</strong><br />
Ich möchte in meinen Dokus immer links einen Frame mit Baumnavigation (<em>&#8220;with frames and a navigation tree&#8221;</em>) 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 <a href="http://www.tug.org/mactex/2009/" title="The MacTeX-2009 Distribution">MacTeX</a> <a href="#782609744">[6]</a> und der eingabe &#8220;make&#8221; im Terminal in eine PDF umgewandelt werden kann.</p>
<div id="attachment_386" class="wp-caption aligncenter" style="width: 310px"><a href="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-11.png"><img src="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-11-300x232.png" alt="Dritter Schritt im Wizard von Doxygen" title="Dritter Schritt im Wizard von Doxygen" width="300" height="232" class="size-medium wp-image-386" /></a><p class="wp-caption-text">Dritter Schritt im Wizard von Doxygen</p></div>
<p><em>-> Nächster Schritt</em></p>
<p>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.<br />
Nachdem der Wizard durchgestanden ist, kann gerne im Reiter &#8220;Run&#8221; auf den Button &#8220;Run Doxygen&#8221; gedrückt werden. Vergesst nicht, eure Profildatei zu speichern!<br />
Geht nichts schief, bekommt ihr, wenn ihr den Button &#8220;Show HTML Output&#8221; mit eurer Maus malträtiert, eine HTML-Seite eurer Doku im Browser präsentiert. Das sieht dann so aus:</p>
<div id="attachment_388" class="wp-caption aligncenter" style="width: 310px"><a href="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-8.png"><img src="http://www.soraxdesign.de/wp-content/uploads/2009/11/Bild-8-300x246.png" alt="Ausgabe der HTML Doku" title="Ausgabe der HTML Doku" width="300" height="246" class="size-medium wp-image-388" /></a><p class="wp-caption-text">Ausgabe der HTML Doku</p></div>
<p>Kommen wir nun zu einigen Experteneinstellungen, die ihr im zweiten Reiter findet. Dort sind einige Einstellungen versteckt, die teilweise sehr wichtig sind.</p>
<p><strong>-> Project</strong></p>
<p><strong>OUTPUT_LANGUAGE</strong><br />
Sprachumstellung auf Deutsch, so dass einige Standardbegriffe in der Doku auf Deutsch erscheinen (&#8220;File List&#8221; -> &#8220;Auflistung der Dateien&#8221;). Es sind aber noch nicht alle Begriffe übersetzt.</p>
<p><strong>STRIP_FROM_PATH</strong><br />
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 &#8220;my/project/with/long/path/to/the/classes&#8221;).</p>
<p><strong>SEPARATE_MEMBER_PAGES</strong><br />
Seid ihr ein eifriger Kommentator und schreibt auch was zu euren Klassenvariablen, könnt ihr eure Romane auf einzelnen Seiten ausgeben lassen.</p>
<p><strong>-> Build</strong></p>
<p><strong>EXTRACT_ALL</strong><br />
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.</p>
<p><strong>-> Input</strong></p>
<p><strong>INPUT_ENCODING</strong><br />
Hier tragt ihr am besten &#8220;ISO-8859-1&#8243; ein, wenn eure Dateien nicht im UTF-8 Format abgespeichert sind, sonst bekommt ihr in eurer Doku nur Zeichensalat. </p>
<p><strong>EXCLUDE</strong><br />
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. </p>
<p><strong>-> HTML</strong></p>
<p><strong>HTML_HEADER, HTML_FOOTER, HTML_STYLESHEET </strong><br />
Ü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.</p>
<p><strong>TREEVIEW_WIDTH</strong><br />
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.</p>
<p>So sähe dann übrigens die PDF Datei aus, wenn ihr sie durch MacTeX jagt:<br />
<a href='http://www.soraxdesign.de/wp-content/uploads/2009/11/refman.pdf'>Dokumentation</a></p>
<p>Was heisst &#8220;technische Dokumentation&#8221; 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!</p>
<p><strong>Quellen</strong><br />
<ul>	<li><a name="7826097391"></a>[1] Die Technische Dokumentation im Wandel: <a href="http://www.transline.de/transline-tecNews/technische-dokumentation-im-wandel-anforderungen-redaktionssysteme-docuglobe">http://www.transline.de/transline-tecNews/technische-dokumentation-im-wandel-anforderungen-redaktionssysteme-docuglobe</a></li>	<li><a name="7826097402"></a>[2] Was ist Technische Dokumentation?: <a href="http://www.comet.de/technische_redaktion/technische_dokumentation.php">http://www.comet.de/technische_redaktion/technische_dokumentation.php</a></li>	<li><a name="7826097413"></a>[3] Checkliste zur Qualitätssicherung Technischer Dokumentation: <a href="http://www.indoition.com/de/qualitaet-software-dokumentation.htm">http://www.indoition.com/de/qualitaet-software-dokumentation.htm</a></li>	<li><a name="7826097424"></a>[4] Javadoc - was ist das und wie nutze ich es?: <a href="http://de.wikipedia.org/wiki/Javadoc">http://de.wikipedia.org/wiki/Javadoc</a></li>	<li><a name="7826097435"></a>[5] <br />
Source code documentation generator tool: <a href="http://www.stack.nl/~dimitri/doxygen/">http://www.stack.nl/~dimitri/doxygen/</a></li>	<li><a name="7826097446"></a>[6] The MacTeX-2009 Distribution: <a href="http://www.tug.org/mactex/2009/">http://www.tug.org/mactex/2009/</a></li></ul></p>


<p>Related posts:<ol><li><a href='http://www.soraxdesign.de/2009/08/24/externalinterface-zusammenspiel-von-swf-und-javascript/' rel='bookmark' title='Permanent Link: Tutorial: ExternalInterface &#8211; Zusammenspiel von SWF und JavaScript'>Tutorial: ExternalInterface &#8211; Zusammenspiel von SWF und JavaScript</a> <small>Manchmal ist es nötig, SWF Dateien mit dem aktuellen Container...</small></li>
<li><a href='http://www.soraxdesign.de/2009/10/22/tutorial-mehrsprachige-anwendungen-in-flex-3-runtime-localization/' rel='bookmark' title='Permanent Link: Tutorial: Mehrsprachige Anwendungen in Flex 3'>Tutorial: Mehrsprachige Anwendungen in Flex 3</a> <small>Wer schon einmal vor der Aufgabe stand, eine Flex Projekt...</small></li>
</ol></p>
<p>Ähnliche Artikel bereitgestellt von <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p>]]></content:encoded>
			<wfw:commentRss>http://www.soraxdesign.de/2009/11/26/dokumentation-quelltextdoxygen-objective-c-java/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
