Sehen wir doch, was der Autor selber dazu sagt

Dem habe ich nichts hinzuzufügen. Ausser dem Link zum Buch

Verwandte Artikel:

1. Buchempfehlung: Drive
2. Notiz: Common Lisp unter Mac OS X
3. Die LISP-IDE Odysee

Die decoded conference steht für eine Verbindung von Design und Code (..) Sprecher aus den Bereichen generative Gestaltung, Informationsvisualisierung, Gaming, interaktive Installationen bis hin zu Physical Computing lüften für euch den Vorhang und geben tiefe Einblicke in ihre Arbeiten und deren Entstehungsgeschichten.

Selbstverständlich haben wir Zipfelmäuse es uns nicht nehmen lassen, uns 2 Tickets zu organisieren. Wir sind ganz gespannt auf die verschiedenen Vorträge und am meisten freuen wir uns auf den Vortrag von Massimo Banzi, einem der Mitbegründer von tinker.it und dem Erfinder des Arduino’s.

Falls jemand von euch auch hingeht – wir würden uns sehr darauf freuen, euch dort zu treffen!

Verwandte Artikel:

1. Zipfelmaus @ decoded conference – München 23.10.10
2. Neue Updates für den LED-Flitzer
3. Symfony – Whoops. Hashfunktionen sind langsam :)

Elektrischer Reporter: Was ist ein Nerd?

Falls jemand testen will wie nerdig er ist einfach das Bild unten anklicken – wenn ihr mehr als 98 schafft würden wir uns sehr über einen Kommentar freuen

Verwandte Artikel:

1. Decoded Conference – Wir sind dabei!
2. Wie Nerds Geld zählen

When the cache was switched on in settings.yml a partial’s variables were always passed through md5(serialize($vars))

Weiterhin schreibt Kris Wallsmith, das MD5 auf riesige Datenmengen anzuwenden doch recht langsam ist – wo ich nur zustimmen kann

Vor 3 Tagen hat Kris das ganze gefixt (von md5() ) befreit und es scheint, dass wir bei YiGG nun endlich noch mehr Zeug cachen werden können. Leider hatten wir bisher das Problem, dass besonders bei vielen gecachten Fragmenten die Performance anstelle sich zu verbessern in den Keller ging.

Vielen dank Kris! Manchmal stecken solche Fehler im Detail. Wen die ganze Story interessiert, der möge doch bitte einfach im Symfony-Blog nachlesen.

Verwandte Artikel:

1. nahoMailPlugin für Symfony
2. Continous Integration with Hudson, GIT and Symfony
3. Langsam nährt sich das Eichhörnchen

Möglicherweise ist der schlechte Ruf von PHP sicher darin verwurzelt, dass man sehr unsauber damit programmieren kann und oft kräuseln sich einem beim lesen von Codefragmenten die Zehennägel.

In meiner neuen Kategorie PHP 5 möchte ich euch ein paar Kniffe zeigen, mit denen man seinen eigenen Programmierstyl verbessern kann. Inwiefern diese Ratschläge nützlich sind, sei dem Leser überlassen.

Heute geht es um das leidige Thema Kommentare.

Warum sind Kommentare wichtig?

Bei YiGG haben wir im laufe der Zeit viele zehntausend Zeilen Quellcode erzeugt. Wir sind ein kleines Team und jeder von uns hat einen Großteil des Codes schon einmal gesehen. Würden wir nicht akribisch auf die Dokumentation des Codes achten, hätten wir schnell einen echtes Problem und würden Stunden damit verbringen herauszufinden, was Funktion xyz genau macht.

Writing good documentation is essential to the success of any software project. The quality of documentation can be even more important than the quality of the code itself, as a good first impression will prompt developers to look further into your code.

Um ein guter PHP-Entwickler zu werden, sollte man also gleich von Anfang an darauf achten, vernünftige Kommentare zu schreiben.

Industriestandard phpDocumentor

Es empfiehlt sich für seine Kommentare ein einheitliches Format zu verwenden, dass von jedem anderen professionellen PHP-Programmierer verstanden wird.

In der PHP-Welt hat sich in den letzten Jahren zusehends das phpDocumentor-Format durchgesetzt. Es hat den großen Vorteil, dass die Dokumentation nicht nur gut für Menschen sondern auch gut durch Maschinen lesbar ist. Konkret bedeutet das: Wer seine Dokumentation mit phpDocumentor schreibt, wird auch in allen IDE’s später den Komfort der Autocompletion für seinen eigenen Code genießen können.

Ein weiterer Vorteil ist das man mit phpDocumentor auch eine komplette und klickbare Dokumentation all seiner Klassen und Funktionen erstellen lassen kann

Aber lassen wir kurz mal den Code sprechen, damit ihr am Beispiel einer Datei aus einem beliebigen großen PHP-Projekt mal sehen könnt wie so etwas aussieht.

< ?php
/**
 * Piwik - Open source web analytics
 *
 * @link http://piwik.org
 * @license http://www.gnu.org/licenses/gpl-3.0.html Gpl v3 or later
 * @version $Id: Auth.php 581 2008-07-27 23:07:52Z matt $
 *
 * @package Piwik
 */

interface Piwik_Auth {
	/**
	 * @return Piwik_Auth_Result
	 */
	public function authenticate();
}

/**
 *
 * @package Piwik
 */
class Piwik_Auth_Result extends Zend_Auth_Result

Sowohl jede Datei, als auch jede Klasse und Funktion werden dokumentiert. Die Tags sind dabei genau festgelegt. Als Einstieg empfiehlt es sich folgendes Cheatsheet von 2tbsb.com herunterzuladen. Es lohnt sich, das PDF auszudrucken und immer in Sichtweite zu haben, bis man die wichtigsten Tags verinnerlicht hat.

Nützlich können ausserdem IDE's sein, die die phpDocumentor-Tags automatisch ergänzen.

Sonstige Konventionen

Oft benutz und auch von vielen IDEs erkannt werden auch Kommentare wie:
//@todo Eine bessere Lösung finden

Man kann auch zu viel kommentieren!

Leider sieht man manchmal auch Dateien mit zu vielen Kommentaren - Trivialitäten sollten nicht kommentiert werden. Auch wenn sich das einfach anhört, aber zumindest ich habe am Anfang zu viel kommentiert und auch das macht den Code unübersichtlich.

Die Oftmals bessere Lösung ist z.b. das vergeben besserer Variablennamen oder das extrahieren einer Methode, die einen logischen Namen hat.

Der Code sollte an sich kommunizieren, was er tut. Solltet ihr also innerhalb einer Funktion den Drang verspüren zu kommentieren, lohnt es sich eine Sekunde innezuhalten und zu überlegen - kann ich das eleganter lösen? Sollte ich ein refactoring anwenden? Ist die Funktion zu lang? Meistens lautet die Antwort, dass man lieber nachpolieren sollte.

Wie haltet ihr es mit Kommentaren?

Verwandte Artikel:

1. EEE Box: EEE-Box – Xandros + Ubuntu = die bessere EEE Box
2. Comments to Nabaztag Version 0.1

Heute möchte ich loben und zwar den NDR. Vor einigen Tagen hörte ich auf NDR 4 Info, dass es ein neues NDR-Iphone-Programm gibt – natürlich musste ich das Programm als treuer Fischkopf ausprobieren.

Das Programm funktioniert problemlos und es ist sehr erfrischend den NDR auch in München auf dem Fußweg zur Arbeit hören zu können.

Bedienung

Die Bedienung der NDR-Iphone Applikation ist spielend einfach. Man kann – ähnlich wie bei den Seiten der Iphone-Applikationen – einfach durch die Sender blättern. Auf der Detailseite des jeweiligen Senders sieht man das aktuelle Programm und auch Informationen zum aktuellen Programm.

Noch verbessert werden an der Applikation kann die Weckfunktion: Will man sich morgens mit Radio wecken lassen, ist oft vorher schon aus nicht nachvollziehbaren Gründen die Batterie leergesaugt.

Mein Workaround für die fehlende Weckfunktion

Ich lasse mich trotzdem mit NDR Info Wecken nur über meinen Laptop Dazu benutze ich einfach das Programm Awaken.

Dazu habe ich mir einfach den Stream von NDR Info in eine eigene Playlist gelegt. Funtkioniert wunderbar.

Schade, dass es leider immer noch zum großen Teil ansonsten nur Müll für mein GEZ-Geld gibt.

Verwandte Artikel:

1. Schnieke Bausätze, die es hier in Deutschland gar nicht gibt
2. Der falsche Geiz der IPhone-Nutzer.
3. Menno, das MS Robotics Studio will nicht

Es war nicht weiter schwer ein kleines Script zu schreiben, dass dem Hasen Text To Speech Nachrichten schickt.

Da ich euch gerne an meiner Arbeit teilhaben lassen will, hier der Quellcode.

class NabaztagAPI
< ?php
{
  private $endpoint = "http://api.nabaztag.com/vl/FR/api.jsp?";
  private $auth_params; // Associative array with Sn + Token
  private $call_params; // Associative array with the params for this API-Call
  private $settings;

  /**
   * Constructs the first part of the nabaztag url, including credentials
   * @param string Serialnumber of the nabaztag ($sn)
   * @param string Auth-Token of the nabaztag ($token)
   * @param array settings
   */
  function __construct($sn, $token, $settings = array())
  {
    $this->auth_params = array("sn" => $sn, "token" => $token);
    $this->settings = $settings;
  }

  /**
   * Sends a TTS (text to speech) message to the nabaztag
   * @param string $message
   * @return string
   */

  public function sendTts($message)
  {
    $this->call_params = array("tts" => $message);
    return $this->callNabaztag();
  }

  /**
   * Constructs url and fires the request returns answer
   */

  private function callNabaztag()
  {
    $params = array_merge($this->auth_params, $this->call_params);
    $url = "";

    $param_url = "";
    foreach($params as $key => $val){
      $param_url .= sprintf("&%s=%s", $key, urlencode($val));
    }

    $url = $this->endpoint.substr($param_url, 1);
    return file_get_contents($url);
  }
}

Benutz wird die Klasse einfach so:

$api = new NabaztagApi($nab_id, $nab_token);
$api->sendTts($message);
</pre>

Verwandte Artikel:

1. Advanced PHP: Decapsulating Objects
2. Comment to Nabaztag WordPress Plugin
3. Comments to Nabaztag Version 0.1

Daher habe ich mich vor zwei Jahren verdammt gefreut als ich in Bullitt168 Blog über Visor las. Seitdem ist mir diese Erweiterung fürs Terminal ein treuer Begleiter, darüber zu bloggen habe ich seither trotzdem noch nicht geschafft.

Visor sieht etwa so aus:

Visor ist also praktisch ein HUD mit dem Terminal. Der Vorteil davon: Es fährt per Tastenkombination aus und wenn man es nicht mehr braucht fährt es wieder ein und verbraucht absolut keinen Platz mehr.

Ein kleines Gimmik von Visor ist, dass man Quartz-Animationen einblenden lassen kann im Hintergrund und das ganze so noch etwas spaciger aussehen lassen kann.. Großartig, um Kollegen zu beeindrucken..

Wünschen würde ich mir in den Einstellungen noch, dass ich mir den Monitor auf dem Visor herunterfährt aussuchen kann – zur Zeit fährt Visor auf der Seite des aktiven Terminalfensters herunter.

Um Visor installieren zu können benötigt man SIMBL, dass ich aber dank meines Lieblingssafariplugins immer installiert habe.

Ein kleines Problem von Visor, dass es sich nur zusammen mit dem Terminal einblenden lässt lässt sich einfach dadurch lösen, dass man das Terminal kopiert und bei der kopierten Version das Icon versteckt. Dann noch das modifizierte Terminal beim Systemstart mitstarten lassen und man befindet sich auf Terminalwolke 7.

Weitere Links zum Thema:

Visor Projektseite

Verwandte Artikel:

1. Notiz: Common Lisp unter Mac OS X
2. Notiz: tmux

Update vom 03.05.08.
Anscheinend gibt es auch mit der Kombination AMD CPUs und ATI-Grafikkarten ebenfalls Probleme mit dem Robotics Studio.

Verwandte Artikel:

1. GEZ – es gibt nicht nur Musikantenstadl!
2. VHDL-AMS-Tools – oder Programme, die komplizierter nicht sein könnten
3. E-Books – Das kann doch nicht so schwer sein..

Vor ein paar Tagen bin ich auf die verrückte Idee gekommen, das schöne Wetter und die Mörderreichweite unseres Büro WLAN’s auszunutzen und einfach draußen zu arbeiten. Ich muss sagen, die Idee war ausserordentlich gut !

Nebenbei können sich alle YiGG-Nutzer auf ein paar coole Features freuen, die jetzt in der nächsten Zeit kommen. Auf dem Dach hat man halt gute Ideen. Mit dem Umbau von Web2.0Du.de bin ich, angesichts des tollen Wetters, nicht so recht weitergekommen, im Hintergrund ändern sich aber viele Kleinigkeiten, von denen ihr (hoffentlich) nichts mitbekommt.

Verwandte Artikel:

1. 50 Imitationen in unter 50 Sekunden
2. Meine Meinung zu Mikroformaten
3. Web 2.0 Dude überholt YiGG bei Alexa.com

Um ehrlich zu sein, bin ich damit als Webentwickler doch etwas überfordert, aber mich reizt die (zumindest für mich große) Herausforderung, dem Ding Leben einzuhauchen.

An Web2.0Du.de bastele ich auch rum, leider vorerst nur hinter den Kulissen, da es bei Y!GG gerade wirklich viel Arbeit gibt und das Wetter in München so phantastisch ist.

Verwandte Artikel:

1. GEZ – es gibt nicht nur Musikantenstadl!
2. Safari 4 Beta Review – Meine Eindrücke von der neuen Beta
3. Conquest of the Terminal.