Documentação

Sat, 01 Aug 2015 14:39:12 -0300

Rede de curadorias.
Formatos livres.
Future-proofing.
Facilitar a indexação.
Princípios dos grupos e mídias livres.
Uma alternativa ao cloud computing e aos acervos corporativos.

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.

Criando o sistema

O sistema foi criado usando esta dica.
Ele usa este post-update hook, que pode ser instalado usando

make post_update

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

Ou de acordo com um git-annex watch.

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