diff options
| author | Arquivo Publico de Memoria Coletiva <arquivo@sarava.org> | 2015-07-31 23:25:50 -0300 |
|---|---|---|
| committer | Arquivo Publico de Memoria Coletiva <arquivo@sarava.org> | 2015-07-31 23:25:50 -0300 |
| commit | bbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc (patch) | |
| tree | f88afd85c0848abb1895fed5134ad3d3b2b29b70 /doc.mdwn | |
| parent | acfbabc4e756b97310c8878d94514e8ab546ff88 (diff) | |
| download | arquivo-bbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc.tar.gz arquivo-bbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc.tar.bz2 | |
Initial documentation
Diffstat (limited to 'doc.mdwn')
| -rw-r--r-- | doc.mdwn | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/doc.mdwn b/doc.mdwn new file mode 100644 index 00000000000..755667a1194 --- /dev/null +++ b/doc.mdwn @@ -0,0 +1,70 @@ +[[!meta title="Documentação"]] + +- Rede de curadorias. +- Formatos livres. +- Future-proofing. +- Facilitar a indexação. +- [Princípios dos grupos e mídias livres](https://encontro.sarava.org/Principal/ConjuntoDePrincipiosEticos). +- Uma alternativa ao cloud computing e aos acervos corporativos ou hospedados exclusivamente em datacenters. + +Compilando a documentação +------------------------- + +Esta documentação é mantida usando o [pandoc](http://johnmacfarlane.net/pandoc). Para compilá-la, use + + pandoc -c misc/style.css -s README.mdwn -o README.html + +Criando o sistema +----------------- + +O sistema foi criado usando [esta dica](http://git-annex.branchable.com/tips/setup_a_public_repository_on_a_web_site/) e usando [este post-update hook](/.git/hooks/post-update): + + #!/bin/sh + + cd .. + unset GIT_DIR + git annex sync + + cd - + exec git update-server-info + +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 * * * cd /var/cache/sites/arquivo && /usr/bin/git annex add . && /usr/bin/git annex sync &> /dev/null + +Ou de acordo com um [git-annex watch](http://git-annex.branchable.com/design/assistant/inotify/). + +Obtendo uma cópia +----------------- + +Usando git: + + 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 + +A partir deste ponto você já pode adicionar usar o repositório normalmente. |