diff options
Diffstat (limited to 'documentacao/index.html')
| -rw-r--r-- | documentacao/index.html | 204 |
1 files changed, 204 insertions, 0 deletions
diff --git a/documentacao/index.html b/documentacao/index.html new file mode 100644 index 00000000000..27c5d34c3bd --- /dev/null +++ b/documentacao/index.html @@ -0,0 +1,204 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + +<head> +<meta name="viewport" content="width=device-width, initial-scale=1.0" /> +<meta http-equiv="onion-location" content="http://74bl64uknv672pgnqpzve2w5zrjq4e5umpqkov2nhakxn3w52brd7lid.onion" /> + +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<title>Documentação</title> + +<link rel="stylesheet" href="../bootstrap/css/bootstrap.min.css" type="text/css" /> +<link rel="stylesheet" href="../bootstrap/css/bootstrap-responsive.min.css" /> + +<link rel="stylesheet" href="../local.css" type="text/css" /> + + + + + +<style type="text/css"> +@media (max-width: 979px) { + .navbar-fixed-top { + position: fixed; + margin-left: 0px; + margin-right: 0px; + } +} +</style> +</head> +<body> + +<div class="container"> + + <div class="row-fluid"> + <div class="span12"> + <h1></h1> + + <ul class="breadcrumb"> + + <li><a href="../">Arquivo Público de Memória Coletiva</a> <span class="divider">/</span> </li> + + <li>Documentação</li> + <li><span class="divider">|</span> <a href="../conteudo">Conteúdo</a></li> + <li><span class="divider">|</span> <a href="../documentacao">Documentação</a></li> + <li><span class="divider">|</span> <a href="../tarefas">Tarefas</a></li> + <li><span class="divider">|</span> <a href="https://git.fluxo.info/?p=arquivo.git;a=history;f=documentacao.mdwn">Histórico</a></li> + <li><span class="divider">|</span> <a href="https://git.fluxo.info/arquivo/atom/?h=master">Feed</a></li> + </ul> + </div> + </div> + + <div class="page row-fluid"> + + <div> + <div class="pageheader"> + <div class="header"> + <h1> + Documentação + + </h1> + + </div> + + </div> + + <div id="pagebody"> + + <div id="content"> + <p class="pagedate"> + <strong>Posted <span class="date">sáb 01 ago 2015 14:40:22</span></strong> + </p> + <h2>Sobre</h2> + +<ul> +<li>Apenas conteúdo em <a href="https://pt.wikipedia.org/wiki/Copyleft">copyleft</a> ou uso justo é disponibilizado.</li> +<li>Por limitação de espaço e banda, nem todos os arquivos estão disponíveis online.</li> +<li>Se você achar um link quebrado de um arquivo que queira baixar, entre em contato que possivelmente o disponibilizaremos.</li> +<li>Se você possui algum arquivo que queira disponibilizar, entre em contato que avaliaremos a viabilidade.</li> +<li>Para entrar em contato, escreva para <code>arquivo arroba fluxo.info</code>.</li> +</ul> + + +<h2>Criação</h2> + +<p>O sistema foi usa o <a href="http://git-annex.branchable.com">git-annex</a> e 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> + +<p>Usando git:</p> + +<pre><code>git clone git://git.fluxo.info/arquivo.git +</code></pre> + +<p>Usando git via https:</p> + +<pre><code>git clone https://git.fluxo.info/arquivo +</code></pre> + +<p>Usando git via https direto do site:</p> + +<pre><code>git clone https://arquivo.fluxo.info/.git arquivo +</code></pre> + +<p>Usando rsync:</p> + +<pre><code>rsync -avz rsync://arquivo.fluxo.info/arquivo/ arquivo/ +</code></pre> + +<p>Usando httrack:</p> + +<pre><code>httrack http://arquivo.fluxo.info/ +</code></pre> + +<h2>Restaurando o espelho principal</h2> + +<p>No caso de alguma falha, proceda a partir de uma das cópias:</p> + +<pre><code>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 +</code></pre> + +<p>Já nos servidor remoto:</p> + +<pre><code>cd /var/cache/sites +git clone arquivo.git arquivo && rm -rf arquivo.git +chown -R arquivo. arquivo +cd arquivo && git annex init SERVIDOR && make whoami && make post_receive +</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.fluxo.info/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/sync">de um script</a> como o seguinte:</p> + +<pre><code>30 6 * * * /var/cache/sites/arquivo/bin/sync +</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 /> + + + + + + </div> + + <div id="footer" class="pagefooter"> + + <div id="pageinfo"> + + + + + + + + + + <!--<div class="pagedate"> + Last edited <span class="date">sáb 25 mar 2017 21:32:25</span> + </div> --> + + </div> + + + <!-- from Arquivo Público de Memória Coletiva --> + </div> + + </div> + + <div class="span4"> + + + + </div> + + </div> +</div> + +</body> +</html> |