Das Debian-Dokumentations-Projekt speichert seine Webseiten und viele der Handbuchtexte auf dem Subversions-Server von Debian auf svn.debian.org. svn.debian.org ist Teil der Gforge-Installation auf alioth.debian.org. Bitte lesen Sie die Alioth-Dokumentation für weitere Informationen, wie dieser Dienst funktioniert.
Jeder kann sich die Dateien vom SVN-Server herunterladen. Nur Mitglieder des Debian-Dokumentations-Projekts können die Dateien bearbeiten.
Sie können unter http://svn.debian.org/wsvn/ddp/manuals/trunk ein Web-Schnittstelle verwenden, um einzeln auf die Dateien zuzugreifen und deren Änderungen zu sehen.
Zum Herunterladen eines kompletten Handbuchs ist der direkte Zugriff auf den SVN-Server meistens die bessere Wahl. Sie benötigen dazu das subversion-Paket auf Ihrem eigenen Rechner.
Verwenden Sie diesen Befehl, um alle Dateien herunterzuladen:
svn co svn://svn.debian.org/ddp/manuals/trunk manuals
Das wird die Verzeichnisse rekursiv erzeugen und entsprechend behandeln.
Um Ihre lokale Kopie mit allen Änderungen zu aktualisieren, die von den Entwicklern gemacht wurden, begeben Sie sich in das Verzeichnis manuals und führen den folgenden Befehl aus:
svn update
Bevor Sie auf den SVN-Server mit dieser Methode zugreifen können, muss Ihnen zuerst Schreibzugriff gewährt worden sein. Bitte lesen Sie, wie Sie diesen anfordern können.
Verwenden Sie diesen Befehl, um alle Dateien herunterzuladen:
svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals
Das wird die Verzeichnisse rekursiv erzeugen und entsprechend behandeln.
Um Ihre lokale Kopie mit allen Änderungen zu aktualisieren, die von den Entwicklern gemacht wurden, begeben Sie sich in das Verzeichnis manuals und führen den folgenden Befehl aus:
svn update
Update-Privilegien kann jede Person erhalten, die sich am Schreiben von Handbüchern beteiligen möchte. Wir fordern üblicherweise, dass Sie zuerst einige nützliche Patches eingebracht haben.
Um Update-Privilegien zu erhalten, müssen Sie eine Anfrage an die
Debian-Dokumentations-Mailingliste senden. Bitte erläutern Sie, warum Sie Zugriff benötigen.
Bitte geben Sie Ihren Alioth-Loginnamen
an. Sobald Ihrer Anfrage zugestimmt wurde, werden Sie Teil des ddp
-Projektes (und der
Unix-Gruppe) auf Alioth.
Die veröffentlichten Webseiten der Handbücher werden von einem Cronjob auf www.debian.org jeden Tag ab 15:39 (Pazifik-Zeit) generiert.
Das Skript führt svn update und anschließend make -C manuals clean publish aus.
Die Make-Datei ist so eingerichtet, dass Dateien in jedem
Unterverzeichnis neu generiert werden (das gepflegte Dokumentation
enthält), und dass es Dateien aus jedem Unterverzeichnis im Verzeichnis
doc/manuals/ der Website installiert. Die Makefiles der
Unterverzeichnisse sind Abkömmlinge von
manuals/standard.makefile.
Die Dokumentationsdateien, die vom update-Skript generiert werden, können unter http://www.debian.org/doc/manuals/ gefunden werden.
Die Protokoll-Dateien, die vom update-Skript generiert werden, können unter http://www-master.debian.org/build-logs/ddp/ gefunden werden.