O Projeto de Documentação do Debian armazena suas páginas e muitos de seus manuais no servidor Subversion do Debian em svn.debian.org. svn.debian.org é parte da instalação Gforge em alioth.debian.org. Por favor, leia a documentação da Alioth para mais informações sobre como este serviço funciona.
Todos podem baixar os fontes do servidor SVN. Somente membros do Projeto de Documentação do Debian podem atualizá-los.
Você pode utilizar uma interface web para acessar os arquivos individualmente e conferir as mudanças neles em http://svn.debian.org/wsvn/ddp/manuals/trunk
Para baixar um manual inteiro, acesso direto ao servidor SVN é, com freqüência, uma alternativa melhor. Você precisa do pacote subversion instalado no seu computador.
Use este comando para baixar todos os arquivos:
svn co svn://svn.debian.org/ddp/manuals/trunk manuals
Isto criará recursivamente os diretórios e os populará.
Para atualizar sua cópia local com quaisquer mudanças feitas por outras pessoas, acesse o diretório manuals e execute o comando:
svn update
Antes de acessar o servidor SVN utilizando este método você deve primeiramente obter permissão de escrita no servidor. Por favor, primeiramente leia como solicitar a permissão de escrita.
Use este comando para baixar todos os arquivos:
svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals
Isto criará os diretórios recursivamente e os populará.
Para atualizar sua cópia local com quaisquer mudanças feitas por outras pessoas, acesse o diretório manuals e execute o comando:
svn update
Privilégios de atualização estão disponíveis para qualquer pessoa que deseje participar no processo de escrever os manuais. Nós geralmente requeremos a pessoa tenha enviado alguns patches úteis primeiro.
Para obter privilégios de atualização, você precisa enviar uma
requisição para a lista
de discussão de documentação Debian. Por favor, explique por que
você precisa de acesso. Por favor, indique qual seu nome de usuário
na Alioth.
Uma vez que sua requisição tenha sido aprovada, você fará parte do
projeto ddp
(e do grupo Unix) na Alioth.
As páginas publicadas do manual são geradas por uma tarefa do cron em
www-master.debian.org todos os dias em alguma hora depois das 15:39 horário
do pacífico (Pacific time
).
O script realiza um svn update, e então
make -C manuals clean publish, ambos no diretório
ddp.
O makefile é configurado de forma a reconstruir cada subdiretório (que
contenha documentação mantida), e instalar os arquivos de cada subdiretório
no subdiretório doc/manuals/ do site web. Os arquivos makefiles
do subdiretório são derivados de
manuals/standard.makefile.
Os arquivos de documentação gerados pelo script de atualização podem ser encontrados em http://www.debian.org/doc/manuals/.
Os arquivos de registro (logs
) gerados pelo script de atualização
podem ser encontrados em
http://www-master.debian.org/build-logs/ddp/