Debians dokumentationsprojekts SVN

Debians dokumentationsprojekt opbevarer sine websider og mange af vejledningsteksterne på Debians Subversion-server på adressen svn.debian.org. svn.debian.org er del af Gforge-installationen på alioth.debian.org. Læs Alioth-dokumentationen for flere oplysninger om hvordan denne tjeneste fungerer.

Alle kan hente kildekoden fra SVN-serveren. Kun medlemmer af Debians dokumentationsprojekt kan opdatere filer.

Adgang til kildekoden i SVN

Du kan anvende en webgrænseflade til at tilgå filerne individuelt og se ændringer af dem på adressen http://svn.debian.org/wsvn/ddp/manuals/trunk

For at hente en komplet vejledning er direkte adgang til SVN-serveren ofte en bedre mulighed. Du skal have pakken subversion på din egen maskine.

Anonym adgang (kun læsning) til SVN-serveren

Anvend denne kommando for at hente alle filerne:

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

Herved oprettes mapperne rekursivt og filerne placeres i dem.

For at opdatere din lokale kopi med alle ændringer foretaget af andre, skal du gå ind i mappen manuals og køre kommandoen:

svn update

Adgang til SVN-serveren, med opdateringsrettigheder

Før du tilgår SVN-serveren ved hjælp af denne metode, skal du først have fået tildelt opdateringsrettigheder. Læs først om hvordan man beder om opdateringsrettigheder.

Herved oprettes mapperne rekursivt og filerne placeres i dem.

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

Herved oprettes mapperne rekursivt og der kommer indhold i dem.

For at opdatere din lokale kopi med alle ændringer foretaget af andre, skal du gå ind i mappen manuals og køre kommandoen:

svn update

Hvordan man får opdateringsrettigheder

Opdateringsrettigheder er tilgængelige for alle, der har lyst til at deltage i udarbejdelsen af vejledningerne. Generelt beder vi om, at man først har indsendt en række nyttige ændringer.

For at få opdateringsrettigheder, skal du på engelsk bede om det på Debians dokumentationspostliste. Her skal du forklare hvorfor du har brug for adgang. Oplys dit loginnavn på Alioth. Når dit ønske er blevet opfyldt, vil du være medlem af ddp-projektet (og Unix-gruppen) på Alioth.

Automatisk opdateringsmekanisme

De udgivne websider med vejledningsteksterne genereres af et cronjob, der kører dagligt på www-master.debian.org en gang efter klokken 15.39 PT (Pacific time).

Skriptet udfører en svn update og dernæst make -C manuals clean publish.

Makefilen er sat op til at genopbygge hver undermappe (som indeholder vedligeholdt dokumentation) og til at installere filerne fra hver undermappe i undermappen doc/manuals/ på webstedet. Undermappernes makefiler er baseret på manuals/standard.makefile.

Dokumentationsfilerne som genereres af opdateringsskriptet finder man på http://www.debian.org/doc/manuals/.

Logfilerne som genereres af opdateringsskriptet finder man på http://www-master.debian.org/build-logs/ddp/