diff options
| -rw-r--r-- | documentacao.mdwn | 52 | ||||
| -rw-r--r-- | documentacao/index.html | 64 |
2 files changed, 56 insertions, 60 deletions
diff --git a/documentacao.mdwn b/documentacao.mdwn index 588afc46089..f22f66cc4af 100644 --- a/documentacao.mdwn +++ b/documentacao.mdwn @@ -7,34 +7,10 @@ - [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 - -Notar que: - -* O sítio estático é gerado *na mesma pasta* do repositório para facilitar sua replicação e espelhamento. -* 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. - -Criando o sistema ------------------ - -* O sistema foi criado usando [esta dica](http://git-annex.branchable.com/tips/setup_a_public_repository_on_a_web_site/). -* Ele usa [este post-update hook](/bin/post-update), que pode ser instalado usando: - - make 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](/bin/cron) como o seguinte: - - 30 6 * * * /var/cache/sites/arquivo/bin/cron +Criação +------- -Ou de acordo com um [git-annex watch](http://git-annex.branchable.com/design/assistant/inotify/). +O sistema foi criado usando [esta dica](http://git-annex.branchable.com/tips/setup_a_public_repository_on_a_web_site/). Obtendo uma cópia ----------------- @@ -71,3 +47,25 @@ Já nos servidor remoto: cd arquivo && git annex init SERVIDOR && make whoami && make post_update A partir deste ponto você já pode adicionar usar o repositório normalmente. + +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 + +Notar que: + +* O sítio estático é gerado *na mesma pasta* do repositório para facilitar sua replicação e espelhamento. +* 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. + +Atualização automática +---------------------- + +Conteúdos baixados de outros sites pode ser automaticamente incluídos no `git-annex` diariamente através [de um cronjob](/bin/cron) como o seguinte: + + 30 6 * * * /var/cache/sites/arquivo/bin/cron + +* Um [post-update hook](/bin/post-update) é disponibilizado para facilitar atualizações depois de um `git annex sync`. +* O [git-annex watch](http://git-annex.branchable.com/design/assistant/inotify/) também pode ser utilizado. diff --git a/documentacao/index.html b/documentacao/index.html index c8cac67242f..25fda49549a 100644 --- a/documentacao/index.html +++ b/documentacao/index.html @@ -76,39 +76,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="/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="/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> @@ -150,6 +120,34 @@ cd arquivo && git annex init SERVIDOR && make whoami && <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="/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="/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> + + </div> <hr /> @@ -173,7 +171,7 @@ cd arquivo && git annex init SERVIDOR && make whoami && <!--<div class="pagedate"> - Last edited <span class="date">Sáb 01 Ago 2015 16:37:48 BRT</span> + Last edited <span class="date">Sáb 01 Ago 2015 16:43:06 BRT</span> </div> --> </div> |