Documentação

Sat, 01 Aug 2015 16:48:57 -0300

Criação

O sistema 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

Um post-update hook é disponibilizado para facilitar atualizações depois de um git annex sync.
O git-annex watch também pode ser utilizado.

Tarefas