SVN för Debian Documentation Project

Debian Documentation Project lagrar sina webbsidor samt stora delar av manualtexterna på Debians subversion-server svn.debian.org.

Vem som helst kan hämta källkoden från svn-servern. Endast Debian Documentation Projects medlemmar kan uppdatera filer.

Nå källkoden i svn

Du kan använda ett webbgränssnitt för att komma åt filer individuellt och se ändringarna på dem.

För att hämta en hel manual är direktåtkomst till svn-servern oftast ett bättre val. Du måste då installera subversion-paketet på din egen maskin.

Ansluta anonymt (skrivskyddat) till svn-servern

Använd detta kommando för att hämta alla filer:

svn co svn://svn.debian.org/ddp/manuals/trunk manuals

Detta kommer att skapa och fylla alla kataloger rekursivt.

För att uppdatera din lokala kopia med ändringar gjorda av andra går du in i katalogen manuals och kör kommandot:

svn update

Ansluta mot svn-server med uppdateringsprivilegier

Innan du ansluter till svn-servern med denna metod måste du först få skrivåtkomst till den. Läs mer om hur du efterfrågar uppdateringsprivilegier först.

Använd detta kommando för att hämta alla filer:

svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals

Detta kommer att skapa och fylla alla kataloger rekursivt.

För att uppdatera din lokala kopia med ändringar gjorda av andra går du in i katalogen manuals och kör kommandot:

svn update

Få uppdateringsprivilegier

Uppdateringsprivilegier är tillgängliga för alla som önskar delta i att skriva manualerna. Vi ber normalt om att du sänt in några användbara patchar först.

För att få uppdateringsprivilegier sänder du en förfrågan till sändlistan för dokumentation i Debian. Förklara varför du behöver tillgång. Ange ditt användarnamn på Alioth. Så snart din förfrågan godkänts kommer du bli en del av ddp-projektet (och -Unix-gruppen) på Alioth.

Automatisk uppdateringsmekanism

De publicerade webbversionerna av manualtexterna genereras av ett cronjobb som körs på www-master.debian.org varje dag någon gång efter 15:39 stillahavstid.

Skriptet utför kommandot svn update och sedan Make -C manuals clean publish.

Makefilen är skriven så att den bygger om varje katalog (som innehåller dokumentation som underhålls) och installerar filerna från varje katalog i underkatalogen doc/manuals/ på webbplatsen. Underkatalogen makefiles bygger på manuals/standard.makefile.

Dokumentationsfilerna som genereras av uppdateringsskriptet finns under http://www.debian.org/doc/manuals/.

Loggfilerna som genereras av uppdateringsskriptet finns på http://www-master.debian.org/build-logs/ddp/