Informationen für Webmaster

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:

• Savannah -- für den CVS-Dienst (siehe unten) und das Management von Zugriffsberechtigungen
• XHTML -- aus dem die statischen Seiten alle 5 Minuten generiert werden
• Concurrent Version System (CVS) -- zur Koordinierung und Synchronisierung

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 www.fsfeurope.org werden als eine Sammlung von XML-Dateien gewartet. Der Webserver erzeugt aus diesem XML-Dateien automatisch alle fünf 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 www.fsfeurope.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 übersetztem 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.

Sich bei Savannah registrieren

Die Quelldateien der Webseiten werden auf Savannah gespeichert. Dieser Server wird von der Free Software Foundation, unserer Schwesterorganisation in Nordamerika, gehostet. Sie können sich einen Account auf diesem Server anlegen, um Schreibzugriff auf diese Dateien zu bekommen.

Einen neuen Account registrieren

Folgen Sie diesem Link, um einen neuen Account zu registrieren. Wählen Sie einen Login-Namen und ein Passwort, tragen Sie Ihren echten Namen und Ihre E-mail-Adresse ein und drücken Sie auf den „Absenden“ Knopf.

Jetzt werden Sie eine E-Mail von Savannah erhalten. Um Ihre Registrierung abzuschließen, besuchen Sie die in der Mail erwähnte URL. Unbestätigte Accounts werden nach zwei Tagen aus der Datenbank gelöscht.

Wenn Sie Ihren Account bestätigt haben, können Sie sich bei https://savannah.gnu.org mit Ihrem Login-Namen und Passwort einloggen.

Einen SSH-Schlüssel erzeugen

Während Sie das Passwort benutzen können, um sich ins Portal auf Savannah einzuloggen, müssen Sie einen SSH-Schlüssel registrieren, um einen CVS-Zugang zu bekommen. Das muss von jeder Maschine aus gemacht werden, von der Sie auf das CVS-Repository zugreifen.

Folgen Sie bitte der Anleitung im Savannah-FAQ um einen SSH-Schlüssel zu erzeugen und zu registrieren.

Dem FSFE-Projekt beitreten

Auf Savannah werden viele Projekte gehostet, und der CVS-Zugang erfolgt auf Projektbasis. Um Zugang zu den FSFE-Webseite-Quelldateien zu bekommen, müssen Sie ein Mitglied des FSFE-Projekts werden.

Wählen Sie "Gruppenmitgliedschaft" in den oberen Tabs. Jetzt können Sie "FSFE" in das Suchfeld "Bewerben, um in Projekten mitzuarbeiten" eingeben, den FSF Europe Kontrollkasten aktivieren und einen Kommentar eingeben.

Die Administratoren des FSFE-Projekts bekommen dann eine E-Mail mit Ihrer Anfrage und dem Kommentar, den Sie eingeben haben, und können Ihre Mitgliedschaft im Projekt genehmigen. Danach sollten Sie "FSF Europe" unter "Gruppen, von denen ich Mitglied bin" sehen, nachdem Sie sich bei Savannah angemeldet haben.

Das Repository das erste Mal abgleichen

Zuerst sollten Sie sicherstellen, dass Ihre ~/.bashrc-Datei eine Zeile enthält, in der
export CVS_RSH=ssh
steht. Dann legen Sie ein Verzeichnis für das Repository an und führen in diesem Verzeichnis folgenden Befehl aus:
$ cvs -z3 -d Benutzername@cvs.savannah.gnu.org:/web/fsfe co .
Nun werden Sie nach Ihrem SSH-Passwort gefragt. Geben Sie es ein und bestätigen Sie nochmals. Wenn alles in Ordnung ist, sollte die Webseite jetzt ausgecheckt werden.

Mit dem Repository arbeiten

Nachdem Sie das Repository das erste Mal überprüft haben, sollten Sie
$ cvs update -d
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
$ cvs 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
$ cvs commit Dateiname aus. Ein Editor öffnet sich dann, damit Sie Ihre Änderungen beschreiben können.

Eine ausführliche Anleitung für CVS finden Sie auf der CVS-Homepage.

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

Verantwortungsvoller Umgang mit dem Schreibzugriff

Wenn Sie auf die Webseite 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-Locale der Sprache des Wörterbuchs entspricht).

• Stellen Sie sicher, dass alle Dateien korrektes XML sind. Es gibt ein Skript namens tools/validate.pl, das Ihnen hilft, Fehler im Markup zu finden. Fehlerhaftes XML stört den automatischen Generierungsprozess der Webseiten und blockiert Updates für die gesamte FSFE-Webseite. Wenn Sie vermuten, dass der Generierungsprozess gestört ist, können Sie das Protokoll des letzten Generierungslaufs hier nachlesen.

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

  xmllint --noout file.xhtml

  aus 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 CVS-Schreibzugriff ab, damit Übersetzungen und Verbesserungen von Leuten ohne Schreibzugriff auch committet 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 committen.

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.

Wenn Sie nicht nur daran interessiert sind, Seiten zu übersetzen, werfen Sie bitte einen Blick in die Struktur-Referenz.

Es gibt auch eine Texinfo-Dokumentation "Webmastering FSF Europe" von Jonas Öberg, der das Generierungssystem für diese Seite implementiert hat. Dort erfahren Sie mehr darüber, wie diese Webseiten funktionieren.

To top