aboutsummaryrefslogtreecommitdiff
path: root/documentacao.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'documentacao.mdwn')
-rw-r--r--documentacao.mdwn65
1 files changed, 65 insertions, 0 deletions
diff --git a/documentacao.mdwn b/documentacao.mdwn
new file mode 100644
index 0000000..b069567
--- /dev/null
+++ b/documentacao.mdwn
@@ -0,0 +1,65 @@
+[[!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.
+
+Compilando a documentação
+-------------------------
+
+Esta documentação é mantida usando um [compilador de sítios estáticos](https://rhatto.sarava.org/static/). Para compilá-la, use
+
+ make web
+
+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](bin/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](http://git-annex.branchable.com/design/assistant/inotify/).
+
+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
+
+A partir deste ponto você já pode adicionar usar o repositório normalmente.