From 0f53747b9997f12ccf024802c878be205420b0fb Mon Sep 17 00:00:00 2001 From: Arquivo Publico de Memoria Coletiva Date: Sat, 1 Aug 2015 16:45:39 -0300 Subject: Tarefas: manifesto e documentacao --- index.rss | 68 ++++++++++++++++++++++++++++----------------------------- todo.mdwn | 2 ++ todo/index.html | 4 +++- 3 files changed, 39 insertions(+), 35 deletions(-) diff --git a/index.rss b/index.rss index ae01403..f4c2e02 100644 --- a/index.rss +++ b/index.rss @@ -16,9 +16,10 @@ https://arquivo.sarava.org/todo/ Sat, 01 Aug 2015 16:15:25 -0300 - 2015-08-01T19:38:17Z + 2015-08-01T19:45:00Z <ul> +<li>Manifesto.</li> <li>Migrar do <a href="https://arquivo.sarava.org/tarefas">ditz</a>.</li> <li>Implementar assinatura do repositório.</li> <li>Logfile para o cronjob.</li> @@ -26,6 +27,7 @@ <li>Avaliar workflow (<code>git-flow</code> conflita com <code>git-annex</code>?).</li> <li>Avaliar retorno de conteúdo dos <a href="https://links.sarava.org">Links Saraventos</a> por conta de performance.</li> <li>Alvo padrão do <code>Makefile</code> realizando as configurações básicas de um novo espelho.</li> +<li>Documentação mais detalhada e explicativa.</li> </ul> @@ -42,7 +44,7 @@ https://arquivo.sarava.org/documentacao/ Sat, 01 Aug 2015 14:39:12 -0300 - 2015-08-01T19:37:48Z + 2015-08-01T19:43:06Z <ul> <li>Rede de curadorias.</li> @@ -54,39 +56,9 @@ </ul> -<h2>Compilando a documentação</h2> - -<p>Esta documentação é mantida usando um <a href="https://rhatto.sarava.org/static/">compilador de sítios estáticos</a>. Para compilá-la, use</p> - -<pre><code>make web -</code></pre> - -<p>Notar que:</p> - -<ul> -<li>O sítio estático é gerado <em>na mesma pasta</em> do repositório para facilitar sua replicação e espelhamento.</li> -<li>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.</li> -</ul> - - -<h2>Criando o sistema</h2> - -<ul> -<li>O sistema foi criado usando <a href="http://git-annex.branchable.com/tips/setup_a_public_repository_on_a_web_site/">esta dica</a>.</li> -<li><p>Ele usa <a href="https://arquivo.sarava.org/bin/post-update">este post-update hook</a>, que pode ser instalado usando:</p> - -<p> make post_update</p></li> -</ul> - - -<h2>Atualização automática</h2> - -<p>Conteúdos baixados de outros sites pode ser automaticamente incluídos no <code>git-annex</code> diariamente através <a href="https://arquivo.sarava.org/bin/cron">de um cronjob</a> como o seguinte:</p> - -<pre><code>30 6 * * * /var/cache/sites/arquivo/bin/cron -</code></pre> +<h2>Criação</h2> -<p>Ou de acordo com um <a href="http://git-annex.branchable.com/design/assistant/inotify/">git-annex watch</a>.</p> +<p>O sistema foi criado usando <a href="http://git-annex.branchable.com/tips/setup_a_public_repository_on_a_web_site/">esta dica</a>.</p> <h2>Obtendo uma cópia</h2> @@ -127,6 +99,34 @@ cd arquivo &amp;&amp; git annex init SERVIDOR &amp;&amp; make wh </code></pre> <p>A partir deste ponto você já pode adicionar usar o repositório normalmente.</p> + +<h2>Compilando a documentação</h2> + +<p>Esta documentação é mantida usando um <a href="https://rhatto.sarava.org/static/">compilador de sítios estáticos</a>. Para compilá-la, use</p> + +<pre><code>make web +</code></pre> + +<p>Notar que:</p> + +<ul> +<li>O sítio estático é gerado <em>na mesma pasta</em> do repositório para facilitar sua replicação e espelhamento.</li> +<li>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.</li> +</ul> + + +<h2>Atualização automática</h2> + +<p>Conteúdos baixados de outros sites pode ser automaticamente incluídos no <code>git-annex</code> diariamente através <a href="https://arquivo.sarava.org/bin/cron">de um cronjob</a> como o seguinte:</p> + +<pre><code>30 6 * * * /var/cache/sites/arquivo/bin/cron +</code></pre> + +<ul> +<li>Um <a href="https://arquivo.sarava.org/bin/post-update">post-update hook</a> é disponibilizado para facilitar atualizações depois de um <code>git annex sync</code>.</li> +<li>O <a href="http://git-annex.branchable.com/design/assistant/inotify/">git-annex watch</a> também pode ser utilizado.</li> +</ul> + diff --git a/todo.mdwn b/todo.mdwn index 07db009..6aa9c7d 100644 --- a/todo.mdwn +++ b/todo.mdwn @@ -1,5 +1,6 @@ [[!meta title="Tarefas"]] +* Manifesto. * Migrar do [ditz](/tarefas). * Implementar assinatura do repositório. * Logfile para o cronjob. @@ -7,3 +8,4 @@ * Avaliar workflow (`git-flow` conflita com `git-annex`?). * Avaliar retorno de conteúdo dos [Links Saraventos](https://links.sarava.org) por conta de performance. * Alvo padrão do `Makefile` realizando as configurações básicas de um novo espelho. +* Documentação mais detalhada e explicativa. diff --git a/todo/index.html b/todo/index.html index 0b629ad..a5534d0 100644 --- a/todo/index.html +++ b/todo/index.html @@ -67,6 +67,7 @@ Posted Sáb 01 Ago 2015 16:15:25 BRT

@@ -100,7 +102,7 @@ -- cgit v1.2.3