From bbe6887ccc93a31c04050c4fcb7e9ff03ffe22bc Mon Sep 17 00:00:00 2001
From: Arquivo Publico de Memoria Coletiva <arquivo@sarava.org>
Date: Fri, 31 Jul 2015 23:25:50 -0300
Subject: Initial documentation

---
 doc.mdwn | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 doc.mdwn

(limited to 'doc.mdwn')

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.
-- 
cgit v1.2.3