Michel Krämer

Einfachere Benutzung von Git

michel — Fri, 04 Jun 2010 10:54:36 +0000

Seit einiger Zeit benutze ich Git zur Verwaltung meiner Projekte. Da die graphischen Benutzeroberflächen noch nicht besonders ausgereift sind und ich gerne die volle Kontrolle über alles habe, benutze ich Git auf der Kommandozeile (i.e. Bash). Damit ich dort nicht immer wieder die gleichen Kommandos eingeben muss, habe ich mir einige Bash-Aliasse und -Funktionen überlegt, die die Benutzung von Git vereinfachen.

Die vereinfachten Kommandos kann man in meinem Github-Repository herunterladen. Eine Anleitung zur Installation und Benutzung findet sich in der README.

Hier nun eine kurzer Ausschnitt aus den definierten Kommandos:

add: Führt git add -v und danach git status aus. Alle Parameter werden an git add weitergeleitet.
Beispiel:
add -p foobar.txt
commit
: Alias für git commit
gadd
: Filtert die Ausgabe von git ls-files mit grep, damit nur die Dateien zum Index hinzugefügt werden, die einem bestimmten Muster entsprechen. Alle Parameter (einschließlich des Musters) werden an grep übergeben. Genauso wie bei add wird hier am Ende git status aufgerufen.
Beispiel:
gadd -i '\.java$'
log: Alias für git log
pull: Führt git pull --rebase aus und zeigt dann die Commits seit dem letzten Pull in einem komprimierten Format an.
push: Alias für git push
st: Alias für git status

Die Kommandos wurden unter msysgit getestet, sollten aber auch auf anderen Plattformen funktionieren. Eine vollständige Liste findet man in der README.

In Zukunft wird die Liste der Kommandos vielleicht noch erweitert. Ich würde mich über Feedback freuen.

Abschließend möchte ich mich bei Simon Templer und Simon Thum für die Ideen bedanken!

Mehrsprachige Webseiten mit Lift und OSGi

michel — Mon, 05 Apr 2010 15:11:12 +0000

Für die Internationalisierung von Webseiten bietet Lift bereits einige Mechanismen. Wird das Framework aber in einer OSGi-Umgebung verwendet, benötigt man einen kleinen Workaround, damit die Resource-Bundles in Form von Property-Files gefunden werden können.

Internationalisierung mit Lift

Zunächst eine kleine Zusammenfassung der Möglichkeiten zur Internationalisierung mit Lift: Die String-Ressourcen müssen in so genannten “Property-Bundles” abgelegt werden. Das sind ganz normale Java-Properties-Dateien in der folgenden Form:

title=Meine Website
yes=Ja
no=Nein
deletequestion=Möchten Sie alles löschen?

Der Name der Property-Bundles beginnt immer mit lift. Jedoch werden unterschiedliche Suffixe angehängt, die die entsprechende Sprache und optional das Land im ISO-Format angeben. Zum Beispiel enthält die Datei lift_en.properties englische String-Ressourcen während lift_de.properties deutsche und lift_de_CH.properties schweizerdeutsche enthält. Den Präfix lift kann man im Boot-Loader der Webapplikation spezifizieren:

1	LiftRules.resourceNames = "einAndererPraefix" :: Nil

Die Variable resourceNames ist dabei eine Liste von Strings. Das heißt, man kann seine Resource-Bundles auch in mehrere Dateien mit unterschiedlichen Präfixen aufteilen, damit man z.B. in großen Projekten nicht den Überblick verliert.

Hat man die Resource-Bundles erstellt, kann man Strings in HTML-Templates mit übersetzen. Verwendet man also die Properties-Datei aus obigem Beispiel, dann wird das folgende Template

<html>
<head>
<title>="title" /></title>
</head>
<body>
="deletequestion" />
<button>="yes" /></button>
<button>="no" /></button>
</body>
</html>

in folgenden HTML-Code übersetzt:

<html>
<head>
<title>Meine Website</title>
</head>
<body>
Möchten Sie alles Löschen?
<button>Ja</button>
<button>Nein</button>
</body>
</html>

Im Scala-Quellcode kann man stattdessen das Stateful-Objekt net.liftweb.http.S verwenden. Es definiert die Methode ?, die einen String als Parameter annimmt und diesen im Resource-Bundle sucht:

1 2	def snippet(xhtml: NodeSeq): NodeSeq = <p>{ S ? "deletequestion" }</p>

Ein kleiner Tipp: Möchte man in den HTML-Templates Tag-Attribute übersetzen (z.B. das Attribut value eines input-Elements), dann sollte man den entsprechenden Teil in ein Snippet auslagern, sodass man das S-Objekt verwenden kann:

1 2	def inputButton(xhtml: NodeSeq): NodeSeq = <input type="button" value={ S ? "yes" } />

Resource-Bundles in der OSGi-Umgebung

Das Problem mit der oben beschriebenen Methode ist, dass die Resource-Bundles von Lift im Classpath mittels getClass.getClassLoader.getResourceAsStream() gesucht werden. In einer OSGi-Umgebung können Sie demnach nicht mehr gefunden werden, da der Classloader des Bundles net.liftweb.lift-webkit verwendet wird.

Wie eingangs erwähnt, kann man dies mit einem Workaround lösen. Dazu muss man im BootLoader eine Resource-Bundle-Factory definieren:

1
2
3

LiftRules.resourceBundleFactories prepend {
  case (basename, locale) => ResourceBundle.getBundle(basename, locale)
}

Dadurch werden die Resource-Bundles über den Classloader des Bundles, das den BootLoader enthält, geladen.

Zusammenfassung

Die Mechanismen zur Internationalisierung mit Lift sind ausreichend für die meisten Webseiten. Wenn man etwas mit dem Lift-Tag nicht übersetzen kann (z.B. Attribute) oder man mehr Kontrolle benötigt, muss man auf Snippets ausweichen. In OSGi-Umgebungen muss man eine Resource-Bundle-Factory erzeugen, die die Properties-Dateien über den korrekten Classloader lädt.

In einem weiteren Artikel werde ich in Kürze auf die Übersetzung von Strings in JavaScript-Dateien eingehen.

Scala-Projekte mit Eclipse PDE Build bauen

michel — Tue, 30 Mar 2010 06:01:15 +0000

PDE Build ist das Standard-Build-System von Eclipse. Es wird verwendet, um OSGi Bundles, Plugins, Features oder Produkte zu exportieren. Im so genannten Headless Mode kann man es einsetzen, um automatisierte Builds ohne Eclipse UI durchzuführen. Die Scala IDE unterstützt PDE Build bisher noch nicht. Um Scala-Projekte zu kompilieren, muss man selbst etwas Hand anlegen.

Zunächst benötigt man ein Ant-Skript, das man in den Build-Prozess einhängen kann. Das Skript sollte den Namen customBuildCallbacks.xml haben und im Wurzel-Verzeichnis des Bundles liegen, das den zu kompilierenden Scala-Quellcode enthält:

Im gleichen Verzeichnis liegt die Datei build.properties des Plugins. (Nicht zu verwechseln mit der build.properties-Datei, die man für den Headless Build benötigt!) Damit das neue Ant-Skript während des PDE Builds auch ausgeführt wird, muss man dieser Datei folgendes hinzufügen:

1 2	customBuildCallbacks=customBuildCallbacks.xml customBuildCallbacks.inheritall=true

Die zweite Zeile ermöglicht den Zugriff auf globale Properties wie zum Beispiel ${build.result.folder}.

Im Ant-Skript kann man spezielle Targets definieren, die zu bestimmten Zeitpunkten im Build-Prozess aufgerufen werden. Am besten kopiert man dazu die Vorlage aus dem Verzeichnis ${eclipse.home}/plugins/org.eclipse.pde.build_*/templates/plugins/.

Das Target post.compile.@dot eignet sich hervorragend, um den Scala-Compiler manuell aufzurufen. Dazu muss man zunächst die Ant-Tasks definieren, die bereits mit der Scala Library ausgeliefert werden. Eine automatische Suche nach der Scala Library, die durch die Scala IDE installiert wird, und den dazugehörigen Tools kann man in Ant zum Beispiel folgendermaßen realisieren:


 property="eclipse.home">
     location="${eclipse.launcher}" />
    >
        
         from="*/eclipse.exe" to="*" handledirsep="true" />
    >
>
 

 property="scala_bundle">
    >
         dir="${eclipse.home}/plugins">
             name="scala.library_*" />
        >
    >
>
 

 property="scala_tools_jar">
    >
         dir="${eclipse.home}/plugins">
             name="scala.tools.nsc_*" />
        >
    >
>

Danach steht der Pfad zum Scala-OSGi-Bundle in der Variablen ${scala_bundle} zur Verfügung. Die Variable ${scala_tools_jar} zeigt außerdem auf die Jar-Datei, die die Scala-Tools und damit auch die Ant-Tasks enthält.

Das Library-Bundle muss als nächstes entpackt werden, damit die eigentliche Scala-Library scala-library.jar bei der Task-Definition und beim Kompilieren im Classpath verwendet werden kann. Dazu nutzt man am besten das temporäre Build-Verzeichnis, das in der Variablen ${build.result.folder} zu finden ist:

1
2
3

 dest="${build.result.folder}/scala-library" src="${scala_bundle}" />
 name="scala_library_jar"
    location="${build.result.folder}/scala-library/lib/scala-library.jar" />

Danach können die Scala-Ant-Tasks definiert werden:


 resource="scala/tools/ant/antlib.xml">
    >
         location="${scala_tools_jar}" />
         location="${scala_library_jar}" />
    >
>

Vor dem Kompilieren der Klassen, muss zunächst noch der korrekte Classpath definiert werden. Dieser setzt sich aus den vom PDE Build vorgegebenen Classpath @dot.classpath und der Scala-Library zusammen:

 property="my.classpath">
    >
        >
             refid="@dot.classpath" />
             location="${scala_library_jar}" />
        >
        
         />
    >
>

Das Filtern von nicht vorhandenen Bibliotheken aus dem Classpath über ist hierbei optional. Damit dies funktioniert, muss man im Root-Knoten der XML-Datei den entsprechenden Namespace definieren:

1
2
3

 name="Build specific targets and properties"
    xmlns:rsel="antlib:org.apache.tools.ant.types.resources.selectors">
    ...

Schließlich wird der Quellcode kompiliert:


 dir="${target.folder}" />
 srcdir="${source.folder1}"
    destdir="${target.folder}"
    classpath="${my.classpath}">
     name="**/*.scala" />
>

Als letztes kann man noch die Scala-Quelldateien aus dem Zielordner entfernen, damit diese nicht mit dem Plugin ausgeliefert werden:


>
     dir="${target.folder}" includes="**/*.scala" />
>

Zusammenfassung

Die hier vorgestellte Methode verwendet die Möglichkeit, eigene Ant-Kommandos in den PDE-Build-Prozess aufzunehmen. Dabei wird versucht, die Scala-Bibliothek und die -Tools zu verwenden, die zusammen mit der IDE ausgeliefert werden. Falls man dies nicht möchte, kann man auch die Dateien scala-library.jar sowie scala-compiler.jar (enthält den Ant-Task) aus der Standard-Scala-Distribution kopieren und diese stattdessen in den Classpath einbinden.

Den vollständigen Quellcode der generischen Datei customBuildCallbacks.xml kann man hier herunterladen:

Note: There is a file embedded within this post, please visit this post to download the file.

Die Datei kann ohne Änderungen in jedes OSGi-Bundle kopiert werden, das mit PDE Build gebaut werden soll und Scala-Code enthält. Lediglich die Datei build.properties muss noch wie oben beschrieben angepasst werden.

Style Guide für Scala

michel — Mon, 22 Mar 2010 18:20:23 +0000

Scala hat bisher noch keinen offiziellen Style Guide, weshalb Daniel Spiewak im November 2009 einen Vorschlag für ein solches Dokument auf der Scala-Mailingliste gepostet hat. Wie dort zu lesen ist, findet selbst Martin Odersky, der Schöpfer von Scala, den Vorschlag gut und kann sich vorstellen, das Dokument in absehbarer Zeit offiziell auf der Scala-Website zu veröffentlichen.

Die PDF-Version kann man sich unter folgender Adresse herunterladen:
http://www.codecommit.com/scala-style-guide.pdf

Eine Online-Version ist unter folgender Adresse verfügbar:
http://davetron5000.github.com/scala-style/

Der Style Guide ist gut gegliedert. Zu jedem Vorschlag wird auch stets ein Grund angegeben, warum es sinnvoll ist, den Code auf diese Weise zu formatieren und nicht anders. Gegenbeispiele zeigen, wie unleserlich der Code wird, wenn man sich nicht an den Style Guide hält.

Da ich ein großer Verfechter strukturierten Codes bin, kann ich das Dokument nur jedem empfehlen, der sich mit Scala beschäftigt. Wenn man die Sprache gerade neu lernt, sollte man sich den Style Guide möglichst früh durchlesen, damit gar nicht erst “schlechte Gewohnheiten” aufkommen. Durch Einhalten des Styles kann die Lesbarkeit von Scala-Programmen erhöht werden, wodurch auch die Erweiterbarkeit und Wartbarkeit vereinfacht wird.

phpBB auf dem iPhone/iPod Touch

michel — Wed, 03 Mar 2010 19:46:40 +0000

Das iPhone eignet sich hervorragend für Foren-Moderatoren, die viel unterwegs sind und z.B. im Zug Beiträge beantworten möchten. Leider lässt sich das Standard-Theme von phpBB auf dem iPhone (oder dem iPod Touch) nur sehr schlecht bedienen. Die Schriftgröße ist außerdem in den meisten Foren so klein, dass man ständig zoomen muss.

Etwas komfortabler ist das speziell für das iPhone entwickelte, kostenlose Theme phpbb-iphone-style. Es reduziert die Anzeige auf die wichtigsten Elemente, vergrößert die Schrift und erleichtert die Bedienung mit dem Touchscreen.

Die Installation ist sehr einfach. Man muss lediglich den Quellcode aus dem Subversion-Repository des Projekts herunterladen und auf dem Webserver in das Unterverzeichnis “styles” kopieren. Wenn man möchte, kann man außerdem die beigelegten Anweisungen befolgen, sodass beim Öffnen des Forums mit einem mobilen Browser automatisch das neue Theme ausgewählt wird. Hat man das erledigt, kann man das Theme wahlweise im Administrationsbereich deaktivieren, sodass es in normalen Browsern nicht manuell ausgewählt werden kann.

Ich habe phpbb-iphone-style im Spamihilator-Forum installiert. Hier ein paar Screenshots:

\n\n\n\n

Ich werde in den kommenden Tagen noch einige kleinere Änderungen am Aussehen vornehmen, sodass es besser zum Stil der Spamihilator-Website passt.

Neues Scala-Projekt mit OSGi

michel — Mon, 15 Feb 2010 18:44:48 +0000

Die Plugin-Download-Seite von Spamihilator bedarf einer umfassenden Überarbeitung. Ich möchte diese Gelegenheit nutzen, um mich ein wenig mehr mit Scala zu beschäftigen. Um die Praxistauglichkeit zu testen, möchte ich Scala auch in Verbindung mit Lift, Spring und Hibernate benutzen. Das ganze soll zudem als Applikation unter OSGi laufen. Als IDE kommt Eclipse mit dem Scala-Plugin zum Einsatz. In den nächsten Wochen werde ich hier über meine Erfahrungen berichten.

Ich habe mich nach einiger Prüfung für den Einsatz der aktuellen Version Scala 2.8.0 Beta 1 entschieden, da die neue Sprachdefinition einige Vorteile gegenüber 2.7 besitzt (wie zum Beispiel die überarbeitete Collection-API oder Default-Arguments, die ich aus C++ gewohnt bin).

Erzeugen eines neuen OSGI-Bundles mit Scala-Nature

Zunächst muss die Scala IDE für Eclipse installiert werden. Danach kann man Scala-Programme mit Eclipse schreiben, ausführen und sogar debuggen. Das Plugin ist gut benutzbar, jedoch noch lange nicht so ausgereift wie die Java-Unterstützung von Eclipse. Hier und da stößt man noch auf kleinere Bugs. Zum Beispiel werden manchmal Fehlermeldungen im eigentlich korrekten Quellcode angezeigt, die sich nur dadurch entfernen lassen, dass man “Project/Clean…” benutzt und alles neu kompiliert. Dies passiert jedoch erfreulicherweise relativ selten.

Um ein OSGi-Bundle mit Scala-Nature zu erzeugen, muss man in Eclipse zunächst ein ganz normales Plugin-Projekt erzeugen. Danach muss man die Scala-Nature hinzufügen, damit der Scala-Quellcode kompiliert werden kann. Dazu klickt man mit der rechten Maustaste im Navigator oder Package Explorer auf das neue Projekt und wählt “Scala/Add Scala Nature”. Dadurch werden folgende Einträge in die Datei .project eingefügt:

>
    >ch.epfl.lamp.sdt.core.scalabuilder>
    >
    >
>

1	>ch.epfl.lamp.sdt.core.scalanature>

Damit die Scala Library genutzt werden kann, muss man in der META-INF/MANIFEST.MF das Bundle “scala.library” als “Required Bundle” angeben:

1	Require-Bundle: scala.library;bundle-version="2.8.0"

In einigen Fällen muss man zusätzlich die Scala-Library zum Classpath hinzufügen. Dazu kann man die Datei .classpath manuell anpassen:

1	kind="con" path="ch.epfl.lamp.sdt.launching.SCALA_CONTAINER" />

Falls es danach immer noch nicht möglich ist, Scala-Klassen zu kompilieren, kann es daran liegen, dass sie nach wie vor als Java-Quellcode interpretiert werden. In diesem Fall muss man den Java-Builder in den Projekt-Eigenschaften deaktivieren. Dadurch kann man innerhalb eines Projekts natürlich keine Scala- und Java-Klassen mehr mischen. Zwischen unterschiedlichen OSGi-Bundles funktioniert es jedoch problemlos. Es ist anzunehmen, dass dies ein Fehler der aktuellen Beta-Version der Scala IDE ist, denn laut Dokumentation sollte dieses Feature eigentlich funktionieren.

Bewertung

Der Scala-Compiler erstellt normalen Java-Bytecode sodass eine vollständige Integration mit Java und OSGi sichergestellt ist. Etwas störend ist die unvollständige Unterstützung von OSGi-Package-Imports der Scala IDE. Wenn man einmal ein Package aus einem Bundle per Import-Package importiert hat, kann man danach auch Klassen aus allen anderen Packages dieses Bundles im Scala-Quellcode importieren. Die IDE zeigt dabei keine Fehler an. Zur Laufzeit kommt es jedoch korrekterweise zu ClassNotFoundExceptions. Man hat somit zwei Möglichkeiten:

Auf Require-Bundle statt Import-Package umsteigen, was jedoch nicht empfohlen ist.
Nach dem Auftreten der Laufzeitfehler die Packages manuell importieren (erfahrende OSGi-Entwickler kennen diese Vorgehensweise sowieso) und auf eine neue Version der Scala IDE warten.

Windows Vista auf eine andere Partition verschieben

michel — Wed, 06 May 2009 18:48:07 +0000

Der Kauf einer größeren Festplatte muss nicht unbedingt bedeuten, dass man das komplette Betriebssystem neu installieren muss. Dieser Artikel fasst die Schritte zusammen, die beim Verschieben einer Vista-Installation auf eine andere Partition nötig sind. Die Punkte lassen sich auch anwenden, wenn man eine Dual-Boot-Konfiguration auflösen und das Betriebssystem auf der Startpartition gegen das auf einer anderen ersetzen möchte.

Der Artikel Howto: Duplicate any Windows installation to a new hard disk … von Lorin Thwaits ist ein guter Ausgangspunkt. Die dort beschriebenen Schritte seien hier kurz zusammengefasst:

Vorbereiten der Zielpartition (z.B. durch Formatierung oder Partitionierung)
Einlegen der Windows Vista-Installations-DVD
Rechner neu starten und von der Installations-DVD booten
Installation starten, bis man zur Eingabe der Seriennummer gelangt
Durch Drücken von Umschalt+F10 ein Eingabefenster öffnen
Mit folgendem Kommando alle Dateien von der alten Partition (z.B. X:) auf die neue (z.B. C:) kopieren:
ROBOCOPY X:\ C:\ /e /XJ /efsraw /copyall /dcopy:t /r:0
Abwarten, bis alle Dateien kopiert wurden (dies kann je nach Größe der Partition mehrere Stunden dauern)
Installation abbrechen und neu starten

Weitere Informationen findet man in oben genanntem Artikel. Allerdings bezieht dieser sich auf das Kopieren einer Windows XP-Installation. Erst in den Kommentaren liest man, dass der Schalter /XJ für das Kopieren einer Vista-Installation unbedingt nötig ist! Dadurch wird nämlich verhindert, dass so genannte “Abzweigunspunkte” (engl. Junction Points) verfolgt werden. Ein solcher Punkt ist in der Deutschen Vista-Version z.B. das virtuelle Verzeichnis “C:\Benutzer”, das in Wirklichkeit auf “C:\Users” verweist. Lässt man den Schalter weg, kopiert ROBOCOPY beide Verzeichnisse, wodurch doppelter Speicherplatz belegt wird.

Probleme beim Booten

Nach dem Kopieren kann es passieren, dass Vista nicht mehr korrekt startet. Die folgenden Hinweise sollen bei der Problemlösung helfen:

Beim Start erscheint: NTLDR fehlt

Dieses Problem lässt sich einfach beheben, indem man von der Windows Vista-DVD bootet und die Reparaturoption auswählt. Die Installationsroutine sollte einen Fehler finden und beheben. Gegebenenfalls ist die Prozedur ein weiteres Mal zu wiederholen. Danach sollte Windows wieder starten.

Nach dem Starten von Windows, kann man sich anmelden, aber dann bleibt der Bildschirm leer

Dieser Fall tritt auf, wenn der Windows Explorer nicht gefunden werden kann. Vista speichert in der Registry zu jedem Laufwerksbuchstaben den physischen Identifzierer der jeweiligen Festplatte bzw. Partition. Da sich Vista nun auf einer anderen Partition befindet, entspricht der Laufwerksbuchstabe C: nicht mehr dem gleichen Identifizierer wie vorher. Dieses Problem kann man wie folgt lösen:

Windows neu starten
Bevor der Startbildschirm erscheint F8 drücken, um das Boot-Menü zu öffnen
“Abgesicherter Modus” auswählen.
Nach dem Start von Windows mit einem Benutzer anmelden, der Administratorrechte hat. Wurde das Administratorkonto nicht aktiviert, hat der Hauptbenutzer im abgesicherten Modus automatisch alle Rechte.
Sollte der Explorer immer noch nicht starten, durch Drücken von Strg+Alt+Entf den Task-Manager öffnen
Den Menüpunkt “Datei/Neuer Task (Ausführen…)” wählen.
regedit eingeben und mit OK bestätigen.
Der Registrierungs-Editor erscheint. Dort folgenden Pfad öffnen:
HKEY_LOCAL_MACHINE\SYSTEM\MountedDevices
Auf der rechten Seite alle Einträge (außer “Standard”) löschen
Rechner neu starten

Nach diesen Schritten sollte das System wieder wie gewohnt laufen.

Ruhezustand funktioniert nicht mehr (das System fährt nicht mehr korrekt hoch)

Dies kann zwei Ursachen haben. Entweder ist die Datei für den Ruhezustand (C:\hiberfil.sys) defekt oder ein Eintrag in der Startkonfiguration stimmt nicht.

Im ersten Fall genügt es, folgende Schritte durchzuführen:

Im Startmenü den Eintrag “Zubehör/Eingabeaufforderung” mit der rechten Maustaste anklicken und “Als Administrator ausführen” wählen.
Folgende Kommandos ausführen:
powercfg -h off powercfg -h on

Der Ruhezustand wird hiermit deaktiviert und danach wieder aktiviert, wodurch die hiberfil.sys neu erstellt wird.

Funktioniert der Ruhezustand danach immer noch nicht, ist die Startkonfiguration beschädigt. Dies kann man wie folgt beheben:

Die Eingabeaufforderung wie oben als Administrator starten
Überprüfen der Startkonfiguration durch folgendes Kommando:
bcdedit -enum all
Der Abschnitt “Resume from Hibernate” oder “Wiederaufnahme aus dem Ruhezustand” sollte vorhanden sein. (Falls nicht, bitte die oben beschriebenen Schritte ausführen). Allerdings enthält dieser folgenden fehlerhaften Eintrag:
inherit {resumeloadersettings}
Kopieren des Identifizierers des entsprechenden Abschnitts. Zum Beispiel:
Bezeichner {xxxx-xxxx-xxxx-xxxx}
Den fehlerhaften Eintrag durch folgendes Kommando löschen (wobei der Bezeichner durch den soeben kopierten ersetzt werden muss:
bcdedit -deletevalue {xxxx-xxxx-xxxx-xxxx} inherit

Danach sollte der Ruhezustand wie gewohnt funktionieren. Falls der Startbildschirm nun in englischer Sprache erscheint, kann man ihn mit folgendem Kommando auf Deutsch umschalten:

bcdedit -set {xxxx-xxxx-xxxx-xxxx} locale de-DE

Der Identifizierer ist wieder durch den oben gefundenen zu ersetzen.

Weitere Informationen zur Startkonfiguration findet man in Martin Richters Artikel Vista SP1 und so manche Ruhezustand/Hibernate Probleme.

5 Anti-Spam-Maßnahmen für phpBB 3.0

michel — Wed, 08 Apr 2009 15:29:38 +0000

phpBB ist als Foren-Software mit offenem Quellcode sehr beliebt und weit verbreitet. Aus diesem Grund ist es aber auch häufig das Ziel von Spammern. In der Version 3.0 wurde deshalb unter anderem ein besseres Captcha eingeführt. Leider haben sich die Spammer inzwischen auf die neue Version eingestellt und Bots geschrieben, die das Captcha automatisch überwinden und Beiträge absetzen können. Im Folgenden werden deshalb fünf Anti-Spam-Maßnahmen beschrieben, die sich in jeder phpBB-3.0-Installation einsetzen lassen und sehr effektiv sind. Ziel ist es dabei, möglichst viele Spam-Beiträge zu blockieren ohne den normalen Betrieb des Forums zu beeinträchtigen.

Maßnahme 1: Links

Spammer versuchen meist bestimmte Websites zu bewerben. Deshalb enthalten etwa 95% aller Spam-Beiträge Links bzw. URLs. Die effektivste Methode solche Beiträge zu verhindern, ist Links komplett zu sperren. Da die hier vorgestellten Maßnahmen normale Benutzer aber möglichst wenig beeinträchtigen sollen, kann ein kleiner Trick verwendet werden: Es wird davon ausgegangen, dass ein Spammer sich in einem Forum neu anmeldet und direkt damit beginnt, Werbebotschaften zu schreiben. Das heißt, Gäste und Benutzer mit weniger als einer bestimmten Zahl von Beiträgen werden als potenzielle Spammer behandelt. Ihre Beiträge werden genauer untersucht. Alle anderen Benutzer bleiben von den Maßnahmen unbetroffen.

Um Beiträge mit Links zu blockieren, kann die Funktion submit_post() in der Datei includes\functions_posting.php um folgende Zeilen ergänzt werden:

//Define the minimum number of posts for "good" users
//Users below this threshold are considered potential spammers
$user_posts_threshold = 3;
 
//strip whitespace characters in the post body
$msgwows = $data['message'];
$msgwows = str_replace(" ", "", $msgwows);
$msgwows = str_replace("\n", "", $msgwows);
$msgwows = str_replace("\r", "", $msgwows);
$msgwows = str_replace("\t", "", $msgwows);
 
if (!$user->data['is_registered'] ||
    $user->data['user_posts'] < $user_posts_threshold) {
  if (strpos($msgwows, 'http://') !== FALSE ||
      strpos($msgwows, 'ftp://') !== FALSE ||
      strpos($msgwows, 'www.') !== FALSE ||
      strpos($msgwows, '[url') !== FALSE) {
    trigger_error("You are not allowed to post URLs!");
  }
}

Dieser Code sollte selbstverständlich ganz am Anfang der Funktion stehen, damit die Beiträge vor dem Speichern gefiltert werden.

Maßnahme 2: Bilder

Spammer versuchen Filter oftmals durch den Einsatz von Bildern zu umgehen. Dazu schreiben sie ihre Werbebotschaften und Links in Bilddateien und hängen diese an Foren-Beiträge an. Mit dem gleicher Methode wie oben beschrieben, können in der Funktion submit_post() in der Datei functions/functions_posting.php Beiträge mit Bildern geblockt werden:

if (!$user->data['is_registered'] ||
    $user->data['user_posts'] < $user_posts_threshold) {
  if (strpos($msgwows, '[img') !== FALSE) {
    trigger_error("You are not allowed to post images!");
  }
}

Maßnahme 3: Russische und Chinesische Beiträge?

Einige Spam-Beiträge sind auf Russisch oder Chinesisch oder enthalten einfach nur eine Menge unleserlicher Sonderzeichen. Man kann sich zunutze machen, dass in deutsch- und englischsprachigen Foren in der Regel nur Deutsche bzw. Englische Beiträge erwünscht sind. Beiträge mit sehr vielen Sonderzeichen bzw. Zeichen aus fremdsprachigen Alphabeten können problemlos als Spam betrachtet werden.

Cory Mawhorter hat eine kleine PHP-Funktion veröffentlicht (is_english()), die auf einfache Weise Sonderzeichen erkennt. Diese kann verwendet werden, um Deutsche bzw. Englische Texte von fremdsprachigen zu unterscheiden:

if (!$user->data['is_registered'] ||
    $user->data['user_posts'] < $user_posts_threshold) {
  if (!is_english($msgwows, 0.75)) {
    trigger_error("Only German or English posts are allowed here!");
  }
}

Maßnahme 4: http:BL

Das Project Honey Pot bietet ein effektives System an, um Spammer und Adresssammler von Webseiten fern zu halten. http:BL gleicht die IP-Adresse eines Besuchers mit einer Datenbank ab. Ist die IP-Adresse bekannt und verbirgt sich dahinter ein Spammer, dann kann der Besucher schon gesperrt werden bevor er die Webseite sieht. Das System verwendet DNS, wodurch die Abfragen relativ schnell sind.

Um http:BL zu verwenden, muss man sich bei Project Honey Pot registrieren. Dadurch erhält man einen Schlüssel, der dem eigenen Benutzernamen eindeutig zugeordnet ist. Project Honey Pot will dadurch Missbrauch des Systems verhindern. Ein MOD für phpBB wird angeboten, allerdings nur für Version 2.0. Diesen kann man unter Umständen an phpBB 3.0 anpassen. Alternativ kann man folgenden Code an das Ende der Datei common.php kopieren:

//configure your http:BL Access Key here
$httpblkey = "xxxxxxxxxxx";
$httpblmaxdays = 21;
$httpblmaxthreat = 25;
 
//if you already configured a honey pot on your website use this line:
//$httpblhoneypot = "http://xxxxxxxxxxx";
 
function httpbl_check() {
  global $httpblkey, $httpblmaxdays, $httpblmaxthreat, $httpblhoneypot;
 
  $ip = $_SERVER["REMOTE_ADDR"];
 
  $result = explode(".", gethostbyname($httpblkey."."
    .implode(".", array_reverse(explode(".", $ip)))
    .".dnsbl.httpbl.org"));
 
  if ($result[0] != 127) {
    //something went wrong or the IP is not in the database.
    //ignore this one.
    return;
  }
 
  $days = $result[1];
  $threat = $result[2];
 
  if ($days < $httpblmaxdays && $threat > $httpblmaxthreat) {
    if ($httpblhoneypot) {
      header("HTTP/1.1 301 Moved Permanently");
      header("Location: ".$httpblhoneypot);
    }
    die();
  }
}
httpbl_check();

In der Variablen $httpblkey muss der http:BL Access Key angegeben werden.

Maßnahme 5: Akismet

Eine weitere Methode Spam zu blockieren, ist Akismet. Dieses System wird auch gerne in WordPress-Blogs eingesetzt. Wie für Project Honey Pot, benötigt man hierfür einen API-Key, den man durch eine Registrierung erhält.

In Foren kann Akismet zum Beispiel beim Absenden von Beiträgen verwendet werden. Das System kann zu Falschmeldungen führen, weshalb die Filterung auch hier wieder nur auf die ersten Beiträge eines Benutzers beschränkt wird. Der folgende Code verwendet die Datei Akismet.class.php, die man von Alex Potsides’ Blog herunterladen kann. Der Code kann in die Funktion submit_post() in der Datei includes/functions_posting.php eingefügt werden:

//configure your Akismet API key here
$akismet_key = 'xxxxxxxxxxx';
 
//the URL you entered when you registered for a Wordpress account
$akismet_url = 'xxxxxxxxxxx';
 
include('Akismet.class.php');
 
$akismet = new Akismet($akismet_url, $akismet_key);
if (!$user->data['is_registered'])
  $akismet->setCommentAuthor($username);
else
  $akismet->setCommentAuthor($user->data['username']);
$akismet->setCommentContent($data['message']);
$akismet->setUserIP($user->ip);
if ($user->data['is_registered'])
{
  $akismet->setCommentAuthorEmail(strtolower($user->data['user_email']));
  $akismet->setCommentAuthorURL(strtolower($user->data['user_website']));
}
 
if ((!$user->data['is_registered'] ||
    $user->data['user_posts'] < $user_posts_threshold) &&
    $akismet->isCommentSpam()) {
    trigger_error("Akismet says your post is spam");
}

Die Variable $akismet_key muss den Akismet API Key enthalten. Die URL, die man bei der Registrierung für einen WordPress-Account angegeben hat, muss in der Variablen $akismet_url stehen.

Akismet kann desweiteren sinnvoll bei der Registrierung von neuen Benutzern eingesetzt werden. Dazu ist folgender Code in die Funktion user_add() in der Datei includes/functions_user.php einzufügen:

//configure your Akismet API key here
$akismet_key = 'xxxxxxxxxxx';
 
//the URL you entered when you registered for a Wordpress account
$akismet_url = 'xxxxxxxxxxx';
 
include('Akismet.class.php');
 
$akismet = new Akismet($akismet_url, $akismet_key);
$akismet->setCommentAuthor($username_clean);
$akismet->setUserIP($user->ip);
$akismet->SetCommentAuthorEmail(strtolower($user_row['user_email']));
 
if($akismet->isCommentSpam()) {
  trigger_error("Akismet says you are a spammer");
}

Fazit

Die hier vorgestellten Maßnahmen helfen, das Spam-Aufkommen in phpBB-3.0-Foren drastisch zu reduzieren. Seit dem Aktivieren der verschiedenen Filter im Spamihilator-Forum konnte kein einziger Spammer einen Beitrag absetzen. Das Blockieren von Links und Bildern ist dabei die effektivste Methode. Durch das Filtern von Sonderzeichen werden alle anderen Spam-Beiträge verhindert. Der normale Betrieb wird kaum gestört, da die Maßnahmen nur neue Benutzer betreffen. Sobald ein Benutzer eine bestimmte Anzahl von “guten” Beiträgen geschrieben hat, werden die Filter deaktiviert. Bisher hat dies noch kein Spammer ausgenutzt. Falls dies jemals der Fall sein sollte, kann die Schwelle sehr leicht erhöht werden.

Trotz aller Filtermaßnahmen beim Schreiben von Beträgen, bleibt immer noch das Problem, dass Spammer sich nach wie vor registrieren und in ihrer Signatur auf eine Webseite verlinken können. Maßnahmen für dieses Problem sind noch zu entwickeln.

In vielen von Spam geplagten Foren sind Gäste nicht zugelassen. Man muss sich registrieren, um Beiträge schreiben zu können. Dies kann für einfache Support-Foren zu umständlich sein. Die Benutzer möchten gerne Beiträge schreiben können ohne lange und komplizierte Registrierungsverfahren zu durchlaufen. Mit den in diesem Artikel vorgestellten Maßnahmen können Gäste grundsätzlich wieder zugelassen werden, denn die Filterung ist für solche immer aktiv.

Abschließend bleibt zu erwähnen, dass der Einsatz von Akismet auf deutschen Webseiten zur Zeit noch umstritten ist. Weiteres darüber findet man unter anderem in folgendem Artikel: http://www.drweb.de/magazin/akismet-und-der-datenschutz/. Maßnahme 5 kann bei Bedarf ausgelassen werden.

Lizenz

Die hier vorgestellten Code-Schnipsel von Michel Krämer sind unter der Lizenz Creative Commons Attribution-Share Alike 3.0 veröffentlicht.

Schallabsorbierer DR002

michel — Tue, 27 Jan 2009 20:25:35 +0000

Damit man später im Mix alle Möglichkeiten hat, Gesang gut zu integrieren, wird dieser in der Regel trocken aufgenommen. Dazu verwendet man oft Kabinen, die durch spezielle akustische Maßnahmen möglichst “tot” klingen, also keinen Nachhall erzeugen. Bei Bedarf kann man diesen später mit einem guten Hallalgorithmus dosiert hinzufügen.

Dieser Artikel beschreibt den Aufbau eines Schallabsorbierers, der das Mikrofon vor Reflexionen abschirmt, sodass möglichst nur das Direktsignal aufgenommen wird. Als Bauelemente kommen ausgewählte Materialien aus dem Baumarkt zum Einsatz:

Filz (ca. 80x40cm)
Dämmschaum (nicht drückend)
Streckmetall (100x30cm)
Dämmwolle (70x30cm)
Holzleiste (ca. 1,5×1×200cm)
Kunststoffleiste (ca. 1,5×1,5x240cm)
Aluminiumfolie (140x30cm)
diverse Schrauben
diverse Eisenteile

\n\n\n\n

Der Rahmen

Zunächst wird die Holzleiste in acht 30cm lange Stücke zerschnitten. Zwei davon dienen später als äußere Randstücke und müssen im Moment nicht weiter bearbeitet werden. Die anderen erhalten auf der langen Seite einen Winkel von 22,5°, sodass man je zwei mit Holzleim zusammenkleben kann und dadurch drei Leisten mit einem 45°-Winkel erhält (siehe Abbildung).

Aus der Kunststoffleiste wird nun ein Rahmen erstellt. Dazu werden zuerst zwei 30cm lange Stücke abgeschnitten, die später die äußeren, senkrechten Teile bilden. Sie werden an den beiden Enden um je 45° abgeschrägt, damit sie später mit den anderen Teilen einen rechten Winkel bilden können.

Die oberen und unteren Teile (insgesamt 8 Stück) haben je eine Länge von ca. 17cm. Die genaue Länge ist vom Streckmetall abhängig, das später an die Rückseite des Geräts angebracht wird. Vier dieser Teile erhalten beidseitig einen Winkel von 22,5°, damit man sie – ähnlich wie die Holzleisten – zu einem 45°-Winkel zusammenfügen kann. Die äußeren Teile erhalten nur auf einer Seite einen 22,5°-Winkel und auf der anderen einen 45°-Winkel nach unten, damit sie auf die oben angesprochenen senkrechten Teile passen.
\n\n\n

Die Rückseite

Nachdem der Rahmen vorbereitet wurde, muss zunächst das Streckmetall gebogen werden. Dazu wird es in zwei Hälften geteilt, von denen eine ca. 70cm lang sein sollte (je nach Länge der oberen und unteren Kunststoffleisten multipliziert mit 4). Dieses Teil erhält in Abständen von 17cm (siehe oben) einen Knick von 45°. Es ergibt sich ein U-förmiges Gebilde mit einer Gesamtbiegung von 135°.

Das restliche Metall sollte in vier gleichgroße Teile geschnitten werden, wobei das vierte noch einmal halbiert werden muss. Drei dieser Teile werden in der Mitte um 45° geknickt. Sie kommen später (zusammen mit den geklebten Holzleisten) in die Ecken des Rahmens. Die halbierten Teile kommen an den linken und rechten Rand (siehe Abbildung).

Verwendet man ein Eisengitter, ist es ratsam die Teile an dieser Stelle noch zu lackieren, da sie sonst schnell rosten. Bei einem Aluminiumgitter ist dies nicht notwendig. Außerdem ist dieses auch leichter als ein Eisengitter – allerdings auch teurer.

Die Dämmwolle

Setzt man die zusammengeklebten Holzleisten in die Ecken der Kunststoffteile ein und fügt die anderen am Rand hinzu, ergeben sich dazwischen Freiräume. Diese müssen mit der Dämmwolle gefüllt werden. Am einfachsten ist es, wenn man den vorbereiteten Rahmen an dieser Stelle zusammenlegt (ohne ihn zu verschrauben) und die Freiräume mit einem Zentimetermaß ausmisst. So kann man vier Platten aus dem Dämmmaterial herausschneiden, die dort genau hereinpassen.

Diese Platten müssen außerdem halbiert werden, sodass sich aus je einer Platte zwei gleichgroße, halb so dünne Platten ergeben. Dazwischen wird eine Schicht Aluminiumfolie gelegt.

\n\n

Zusammenfügen der Teile

Nun kann alles zusammengefügt werden. Zusammen mit den Holzleisten passt das Streckmetall genau in die Kunststoffleisten hinein. Auf der Rückseite – zwischen Holzleisten und Metall – ist noch eine Schicht Aluminiumfolie hinzuzufügen. Diese dient nicht nur einem akustischen, sondern auch einem optischen Zweck. Außerdem können somit später keine “Krümel” von der Dämmwolle abfallen.

Man sollte mit den unteren Leisten beginnen, die Holzteile, die Aluminiumfolie und das Metall hinzufügen und alles verschrauben. Sodann können die Platten aus dem Dämmmaterial mit der Aluminiumfolie in die Freiräume gesteckt werden.

Als nächstes werden die Kunststoffleisten an der Seite und oben ebenfalls mit dem Holz verschraubt. Man sollte möglichst kleine Schrauben verwenden, damit das Holz nicht bricht.

\n\n

Die Innenseite

Der Hauptteil des Schirms ist nun fertig. Er kann jedoch noch verbessert werden, indem man auf der Innenseite eine Schicht Dämmschaum und Filz anbringt. Dazu wird aus einer Lage Filz eine Form in der Größe 70x30x1cm erstellt. Am besten spannt man um diese noch einen Holzrahmen (falls man noch altes Holz zur Verfügung hat), damit sich die Form beim nächsten Schritt möglichst wenig verbiegt.

Der Dämmschaum kann nun in die Form hineingefüllt werden. Es ist zu beachten, dass dieses Material an Volumen sehr stark zunimmt. Eine dünne Schicht sollte reichen. Wer jedoch sicher gehen will und die Dose Dämmschaum sowieso nicht mehr benötigt, kann auch ein bisschen mehr in die Form füllen.

Nachdem der Schaum trocken ist, was durchaus einen Tag dauern kann, wird alles Überflüssige mit einem möglichst langen Messer abgeschnitten, sodass eine 1cm dicke Platte aus Schaum mit aufgeklebten Filz übrig bleibt.

Diese wird dann in den Abständen der Schirmecken mit einem Messer vorsichtig eingeschnitten und dort geknickt. Die Platte kann dann an der Innenseite des Schirms angebracht werden, indem man sie mit den Holzleisten verschraubt.

\n\n\n\n

Die Halterung

Hat man dies erledigt, ist der Schirm schon einsatzbereit. Will man noch eine Halterung anbringen (wie auf der Abbildung zu sehen), sollte man dies vor der Verschraubung der Schaumplatte mit dem Rahmen tun.

Die Halterung des DR002 besteht aus ein paar geschweißten Blechen, die am Rahmen befestigt sind. Diese wurden auf eine Schraube gedreht, damit man später auch die Höhe des Schirms gegenüber dem Mikrofon verändern kann. Die Schraube wurde außerdem auf ein Stück Eisen geschweißt, das in der Mitte eine Aussparung hat. Diese ist so groß, dass man das Stück Eisen mittels einer Flügelmutter auf einen Mikrofonständer schrauben kann. Das Mikrofon wird befestigt, indem man eine Gewindestange (bzw. zwei aneinandergeschweißte Schrauben) von unten in das Eisenstück steckt und mit einer Flügelmutter festzieht.

\n\n