aboutsummaryrefslogtreecommitdiff
path: root/doc.mdwn
diff options
context:
space:
mode:
authorArquivo Publico de Memoria Coletiva <arquivo@sarava.org>2015-07-31 23:25:50 -0300
committerArquivo Publico de Memoria Coletiva <arquivo@sarava.org>2015-07-31 23:25:50 -0300
commitbbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc (patch)
treef88afd85c0848abb1895fed5134ad3d3b2b29b70 /doc.mdwn
parentacfbabc4e756b97310c8878d94514e8ab546ff88 (diff)
downloadarquivo-bbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc.tar.gz
arquivo-bbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc.tar.bz2
Initial documentation
Diffstat (limited to 'doc.mdwn')
-rw-r--r--doc.mdwn70
1 files changed, 70 insertions, 0 deletions
diff --git a/doc.mdwn b/doc.mdwn
new file mode 100644
index 0000000..755667a
--- /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.