Documentação

Posted Sáb 01 Ago 2015 16:48:57 BRT

Sobre

  • Apenas conteúdo em copyleft ou uso justo é disponibilizado.
  • Por limitação de espaço e banda, nem todos os arquivos estão disponíveis online.
  • Se você achar um link quebrado de um arquivo que queira baixar, entre em contato que possivelmente o disponibilizaremos.
  • Se você possui algum arquivo que queira disponibilizar, entre em contato que avaliaremos a viabilidade.
  • Para entrar em contato, escreva para arquivo arroba sarava.org.

Criação

O sistema foi usa o git-annex e foi criado usando esta dica.

Obtendo uma cópia

Usando git:

git clone git://git.sarava.org/arquivo.git

Usando git via https:

git clone https://arquivo.sarava.org/.git arquivo

Usando rsync:

rsync -avz rsync://arquivo.sarava.org/arquivo/ arquivo/

Usando httrack:

httrack http://arquivo.sarava.org/

Restaurando o espelho principal

No caso de alguma falha, proceda a partir de uma das cópias:

git clone --bare arquivo arquivo.git # um repositório bare é copiado mais rapidamente
rsync -avz -e 'ssh -p PORTA' arquivo.git/ arquivo@SERVIDOR:/var/cache/sites/arquivo.git

Já nos servidor remoto:

cd /var/cache/sites
git clone arquivo.git arquivo && rm -rf arquivo.git
chown -R arquivo. arquivo
cd arquivo && git annex init SERVIDOR && make whoami && make post_update

A partir deste ponto você já pode adicionar usar o repositório normalmente.

Compilando a documentação

Esta documentação é mantida usando um compilador de sítios estáticos. Para compilá-la, use

make web

Notar que:

  • O sítio estático é gerado na mesma pasta do repositório para facilitar sua replicação e espelhamento.
  • Assim, caso algum arquivo de documentação seja renomeado, os correspondentes arquivos gerados estaticamente também devem ser renomeados para evitar o acúmulo de detritos digitais.

Atualização automática

Conteúdos baixados de outros sites pode ser automaticamente incluídos no git-annex diariamente através de um cronjob como o seguinte:

30 6 * * * /var/cache/sites/arquivo/bin/cron