Achtung: Diese Seite ist eine Übersetzung, deren Original sich seit der Übersetzung geändert hat. Sie sehen also möglicherweise eine ältere Version. Bitte informieren Sie sich hier darüber, wie Sie uns bei Übersetzungen und anderen Dingen unterstützen können.

Informationen für Webmaster

Das Web-Team pflegt und entwickelt die Webseiten der FSFE, angefangen bei fsfe.org bis hin zu Seiten für Projekte und Kampagnen. Webmaster arbeiten ehrenamtlich an der ständigen Verbesserung des Webauftritts der Organisation, sowie an der Weiterentwicklung der technischen Umsetzung.

Lerne uns kennen, lerne die Webseite kennen

Wenn Sie erfahren wollen, woraus die Arbeit an der Webseite von FSFE besteht, ist der beste Weg, mit uns ins Gespräch zu kommen. Einige der Webmaster sind regelmäßig auf freenode's #fsfe Kanal, wo wir Sie gerne kennenlernen und Ihre Fragen beantworten! Um zu erfahren, wer an der Webseite und bei FSFE arbeitet, schauen Sie auf unserer Teamseite nach.

Ihre Web-Koordinatoren, Nicolas Jean und Andreas Tolf Tolfsen.

Einleitung

Die Techniken und Programme zur Verwaltung der FSFE-Webseiten sollten den meisten Entwicklern und Autoren schon bekannt sein. Sie könnten aber auch für diejenigen interessant sein, die sie noch nicht entdeckt haben.

Übersetzer und gelegentliche Helfer werden höchstwahrscheinlich nur mit Folgendem in Berührung kommen:

XHTML -- aus dem die Seiten alle zehn Minuten generiert werden
Subversion – für die Versionskontrolle der Seitenquellen
Trac – für die Verwaltung von Zugriffsrechten, Problemverfolgung und andere verwandte Dienste.

Freiwillige, die sich eingehender mit Wartungsarbeiten beschäftigen wollen, sollten auch mit Folgendem vertraut sein:

Perl -- für Skripts zur Wartung und Seitenerstellung
Apache -- als Webserver

Verstehen, wie die Webseiten generiert werden

Die Webseiten auf fsfe.org werden als eine Sammlung von XML-Dateien gewartet. Der Webserver erzeugt aus diesem XML-Dateien automatisch alle zehn Minuten die HTML-Seiten. Somit geschehen alle Änderungen der Seiten in den XML-Dateien und das HTML wird nie direkt verändert.

Jede Seite auf fsfe.org wird seitenname.sprache.html genannt. (Für sprache wird der ISO-639 Code der Sprache genommen, der wie "en" für Englisch oder "de" für Deutsch immer aus zwei Buchstaben besteht.) Die Quelldateien werden seitenname.sprache.xhtml benannt.

Einige Seiten haben auch einen dynamischen Teil. Außer dem festen Text, der aus der .xhtml-Datei geholt wird, schließen sie auch Informationen aus einer oder mehreren .xml-Dateien mit ein. Immer wenn so eine Seite generiert wird, nimmt das Generierungssystem wenn möglich die übersetzten .xml-Dateien und greift für noch nicht übersetzte .xml-Dateien auf die englische Version zurück. Auf diese Weise können solche Seiten am Ende teilweise übersetzten Text zusammen mit Teilen anzeigen, die noch auf Englisch zu sehen sind. Beispiele für solche Seiten sind unter anderem die Startseite, die Newsseite, und die Veranstaltungsseite.

Zugriff auf die Webseiten erhalten

Die Quelldateien für die Webseiten sind im Subversion-Repository fsfe-web, das auf dem FSFE-Subversionserver gehostet wird, gespeichert. Andere Dienste sind auf der zugehörigen trac-Instanz verfügbar.

Um Zugriff auf diese Werkzeuge zu erhalten, befolgen Sie bitte diese Anweisungen:

Wenn Sie Fellow der FSFE sind, haben Sie bereits Lesezugriff auf Subversion und trac, sie können sich mit ihrem üblichen Fellowshipnamen und dem zugehörigen Kennwort anmelden.

Um Schreibzugriff auf das Subversion-Repository und das trac-Wiki- und Ticketsystem zu erhalten, schreiben Sie bitte einfach an system-hackers@fsfeurope.org (Mitglieder von FSFE's Verwaltungsteam haben automatisch Schreibzugriff).
Alle anderen können sich mit einem Gastzugang für Subversion und trac registrieren, indem sie das Formular unter https://trac.fsfe.org/fsfe-web/register ausfüllen. Sobald Sie sich registrieren, haben Sie Lesezugriff auf das Subversion-Repository und können sich auf der trac-Seite anmelden (bitte beachten Sie, dass ihrem gewählten Benutzernamen das guest-Präfix hinzugefügt wird). Es wird dann automatisch eine Benachrichtigung an den Repository-Administrator geschickt, der ihnen sobald wie möglich Schreibzugriff gewähren wird.

Eine Subversion-Arbeitskopie auschecken

Das Subversion-Repository hat zwei Haupt-Codezweige für den Netzauftritt der FSFE, den SVN-"trunk", der verwendet wird, um die Produktiv-Instanz der Seite unter http://fsfe.org zu bauen und den "test"-Zweig, der für den Bau von http://test.fsfe.org benützt wird.

Für die tägliche Arbeit, wie etwa das Hinzufügen von Newseinträgen, das Übersetzen einzelner Seiten (oder auch das Entwickeln kleinere Veränderungen des Netzauftritts), sollten Sie den SVN-"trunk" auschecken:

svn --username IHRNAME co https://svn.fsfe.org/fsfe-web/trunk

Um an größeren Änderungen des Netzauftritts zu arbeiten, die unter Umständen die Seite beeinträchtigen könnten, verwenden Sie bitte den "test"-Zweig des SVN-Repositorys:

svn --username IHRNAME co https://svn.fsfe.org//fsfe-web/branches/test

Bitte beachten Sie, dass eine vollständige Arbeitskopie etwa 160 MB groß ist. Wenn Sie nur an einem Teil des Netzauftritts arbeiten möchten, können Sie auch nur diejenigen Verzeichnisse auschecken, an denen Sie zu arbeiten gedenken. Sie können das SVN-Verzeichnis anschauen, um das zu finden, woran Sie interessiert sind.

Mit dem Repository arbeiten

In Subversion muss Schlüsselwort-Ersetzung ausdrücklich für jede einzelne Datei eingeschaltet werden. Da wir einige Schlüsselwörter auf .xml und .xhtml Dateien verwenden (zum Beispiel das $Author$ Schlüsselwort in der Fußzeile), sollten Sie das Einschalten der Schlüsselwörter automatisieren, indem Sie folgenden Abschnitt in Ihre ~/.subversion/config Datei einfügen:

enable-auto-props = yes

[auto-props]
*.xml = svn:keywords=Date Author Id Revision;svn:mime-type=text/xml;svn:eol-style=native
*.xhtml = svn:keywords=Date Author Id Revision;svn:mime-type=text/xhtml;svn:eol-style=native

Nachdem Sie das Repository das erste Mal ausgecheckt haben, sollten Sie

$ svn update

im FSFE-Verzeichnis jedes Mal ausführen, bevor Sie an einer bestimmten Datei arbeiten.

Wenn Sie dem Repository neue Dateien hinzufügen wollen, müssen Sie

$ svn add Dateiname

ausführen.

Um Ihre Änderungen dem Server zu schicken, egal ob es neue Dateien oder Änderungen an existierenden Dateien sind, führen Sie

$ svn commit Dateiname

aus. Es öffnet sich dann ein Editor, damit Sie Ihre Änderungen beschreiben können.

Wenn Sie das Arbeiten mit CVS gewohnt sind, werden Sie sehr schnell mit SVN arbeiten können. Es wird ihnen aufgefallen sein, dass die grundlegenden Befehle sehr ähnlich sind. Wenn Sie mehr erfahren möchten, finden Sie auf der Seite Subversion for CVS Users (englisch) einen Überblick über die Unterschiede zwischen CVS und SVN und im CVS to SVN Crossover Guide (englisch) einen kurzen Vergleich der CVS- und SVN-Befehle.

Eine detaillierte Anleitung für SVN können Sie auf der Seite desSubversion-Buchs (englisch) herunterladen (wir verwenden Version 1.5 von SVN).

Werkzeuge zur Koordination

Die Arbeit an den Seiten des Netzauftritts wird über die Webmaster-Mailingliste koordiniert.

Die "fsfe-web"-trac-Instanz bietet einige weitere Werkzeuge, um die Koordinierung zu erleichtern: einen Browser für das SVN-Repository, ein System zur Problemverfolgung und ein Wiki.

Mehr Informationen zur Benutzung von trac finden Sie auf der TracGuide-Wikiseite.

Wenn Sie alle Veränderungen an den Quelldateien der Webseiten verfolgen wollen, können Sie sich auch in die Benachrichtigungs-Mailingliste eintragen. Dann erhalten Sie eine E-Mail für jede Änderung, die im Verzeichnisbaum der Quelldateien vorgenommen wird.

Verantwortungsvoller Umgang mit dem Schreibzugriff

Wenn Sie auf die Webseiten Schreibzugriff haben, tragen Sie sich bitte in die Webmaster-Mailingliste ein.

Bitte behalten Sie im Hinterkopf, dass alle Änderungen automatisch wirksam und sichtbar werden, ohne dass Irgendjemand weiter etwas tun muss. Somit gibt es einige Dinge, um die wir Sie bitten möchten, wenn Sie Änderungen oder neue Dateien einbringen:

Die FSFE trägt die Verantwortung für den Inhalt der Webseiten. Bitte schicken Sie keine Änderungen, die die Bedeutung des Textes verändern, ohne dass ein Mitglied des Kernteams der FSFE zugestimmt hat. (Das ist bei Übersetzungen von schon existierendem Inhalt nicht notwendig.)
Wenn Sie Übersetzungen schicken und es irgendeine Möglichkeit gibt, dass andere den Text auf Fehler überprüfen, dann nutzen Sie diese Möglichkeit. Sie sollten die Mailingliste für Übersetzer nutzen, um dort um Korrekturlesen zu bitten. Wir ermutigen Sie dazu, Dateien mit automatischen Tools wie GNU aspell oder einem anderen Rechtschreibprüfungsprogramm Ihrer Wahl auf Rechtschreibfehler zu überprüfen, egal ob Sie Dateien übersetzen oder korrekturlesen. Um zum Beispiel GNU aspell auf einem Debian GNU/Linux System zu nutzen, installieren Sie einfach die Pakete aspell und aspell-XX ("XX" ist Ihr Sprachcode), und führen dann den Befehl

aspell -H -d language -c file.xhtml

aus (hier ist "language" der Name des Wörterbuchs für Ihre Sprache; die -d -Option kann weggelassen werden, wenn Ihr UNIX-Gebietsschema der Sprache des Wörterbuchs entspricht).
Stellen Sie sicher, dass alle Dateien korrektes XML enthalten. Der SVN-Server überprüft standardmäßig die XML-Syntax von Dateien mit den Endungen .xml und .xhtml und wird das Einchecken verbieten, wenn XML-Fehler gefunden wurden. Um dies zu verhindern, können Sie ihre Dateien vor dem Einchecken auf eine der folgenden Arten überprüfen.

Es gibt ein Skript namens /trunk/tools/validate.pl, das Ihnen hilft, Fehler im Markup zu finden. Fehlerhaftes XML stört den automatischen Generierungsprozess der Webseiten und blockiert Aktualisierungen für die gesamte FSFE-Webseite. Wenn Sie vermuten, dass der Generierungsprozess unterbrochen ist, können Sie das Protokoll des letzten Generierungslaufs auf unseren Statusseiten nachlesen.

validate.pl benötigt das XML::LibXML Perl Modul; wenn es nicht auf Ihrem System installiert ist, können Sie Dateien auch mit einem XML-Prüfungsprogramm Ihrer Wahl validieren. Sie können zum Beispiel das Kommandozeilen-Werkzeug xmllint vom libxml2-Projekt benutzen. Wenn Sie die Debian GNU/Linux-Distribution nutzen, installieren Sie das libxml2-utils-Paket); führen Sie den Befehl

xmllint --noout Datei.xhtml

aus (wobei Datei die Datei ist, welche Sie überprüfen wollen), und suchen Sie nach möglichen Fehlermeldungen.
Stellen Sie sicher, dass die Codierung der Datei konsistent ist und sie dem Inhalt des "encoding"-Attributs in der ersten Zeile entspricht. Wenn Ihre Datei zum Beispiel als "iso-8859-1" (auch bekannt als "latin-1"-Codierung) codiert ist, sollte in der ersten Zeile der Datei stehen:

<?xml version="1.0" encoding="iso-8859-1" ?>

Eine weitere gültige Codierung ist die Unicode- oder "UTF-8"-Codierung. Wenn Sie die Codierung einer Datei ändern wollen, können Sie das Standardwerkzeug iconv wie in folgendem Beispiel benutzen (hier wird eine Datei von der "latin1" auf "utf-8" umcodiert):

iconv -f LATIN1 -t UTF8 inputfile > outputfile

Bitte stimmen Sie sich mit anderen Leuten mit SVN-Schreibzugriff ab, damit Übersetzungen und Verbesserungen von Leuten ohne Schreibzugriff auch eingecheckt werden, nachdem sie korrekturgelesen worden sind. Bitte überprüfen Sie diese Dateien natürlich ebenso genau, wie Sie Ihre eigenen Dateien überprüfen, bevor Sie sie einchecken.

Holen von markierten Nachrichten und Ereignissen, Erstellen einer Landesseite

Bitte sehen Sie auf der für diesen Zweck erstellten Anleitung nach.

Weitergehende Information

Da die FSFE-Webseite sowohl eine europäische/globale Ebene als auch vom Anwender wählbare lokale Ebenen hat, die sie um länderspezifische Informationen ergänzt, weist ihr Layout eine gewisse Komplexität auf. Diese bleibt dem Anwender der Seite aber vollständig verborgen.

Es gibt auch eine Texinfo-Dokumentation "Webmastering FSFE" von Jonas Öberg, der das Generierungssystem für diese Seite implementiert hat. Bitte lesen Sie sie, um mehr darüber zu erfahren, wie diese Webseiten funktionieren.

To top

Suchen