SliTaz Repositories

     1.1 --- a/pt/devel/index.html	Wed May 06 02:41:02 2009 +0000
     1.2 +++ b/pt/devel/index.html	Sat Jun 20 21:12:52 2009 +0000
     1.3 @@ -73,14 +73,19 @@
     1.4  <h2><font color="#df8f06">Espaço dos Desenvolvedores do SliTaz</font></h2>
     1.5  
     1.6  <ul>
     1.7 +	<li><a href="#kiss">KISS e respeito aos padrões.</a></li>
     1.8  	<li><a href="#tank">Build host &amp; home.</a></li>
     1.9      <li><a href="#repos">Repositórios Mercurial.</a></li>
    1.10 +    <li><a href="#iconv">Implementação da função iconv().</a></li>
    1.11      <li><a href="#pkgs">Pacotes Tazpkg.</a></li>
    1.12 +	<li><a href="#pkgs-naming">Nomes de pacotes.</a></li>    
    1.13      <li><a href="#website">Gerenciamento do Website.</a></li>
    1.14 +	<li><a href="#xhtml">Estilo para codificação de xHTML.</a></li>    
    1.15      <li><a href="../mailing-list.html">Lista de Discussão.</a></li>
    1.16      <li><a href="../doc/cookbook/wok-tools.html">Wok &amp; Ferramentas.</a></li>
    1.17      <li>Mercurial Repositories: <a href="http://hg.slitaz.org" >hg.slitaz.org</a></li>
    1.18      <li>SliTaz Laboratories: <a href="http://labs.slitaz.org/">labs.slitaz.org</a></li>
    1.19 +	<li><a href="http://labs.slitaz.org/wiki/distro">Wiki dos desenvolvedores</a></li>    
    1.20  </ul>
    1.21  
    1.22  <p>
    1.23 @@ -98,6 +103,26 @@
    1.24  ativos no <a href="http://forum.slitaz.org/">fórum</a> e na 
    1.25  <a href="../mailing-list.html">lista de discussão</a>.
    1.26  </p>
    1.27 +<p>
    1.28 +Há um website dedicado exclusivamente à participação de artistas interessados
    1.29 +em contribuir com o projeto - <a href="http://art.slitaz.org/">http://art.slitaz.org</a>. 
    1.30 +Mediante a criação de uma conta de usuário, pode-se postar gráficos ou 
    1.31 +figuras relacionadas ao SliTaz. O website é mantindo por uma comunidade 
    1.32 +de voluntários e se houver interesse em nos ajudar a gerenciá-lo, entre 
    1.33 +em contato via email ou pela lista de discussão.
    1.34 +</p>
    1.35 +
    1.36 +<a name="kiss"></a>
    1.37 +<h3>KISS e respeito aos padrões</h3>
    1.38 +<p>
    1.39 +"Keep it Simple", ou seja, tentamos manter as coisas simples: respeito 
    1.40 +aos padrões, planejamento cuidadoso e documentação escrita de alta 
    1.41 +qualidade, fornecimento de um sistema robusto e estável e um sistema de 
    1.42 +arquivos (<em>rootfs</em>) no LiveCD leve o suficiente para ser executado 
    1.43 +em máquinas que tenham ao menos 128 mb de memória RAM. Também usamos
    1.44 +aplicativos baseados em GTK+2, Dialog, scripts SHell ou PHP. A idéia
    1.45 +é não nos repetirmos e deixar o sistema básico leve e pequeno.
    1.46 +</p>
    1.47  
    1.48  <a name="tank"></a>
    1.49  <h3>Tank - Build host &amp; home</h3>
    1.50 @@ -110,6 +135,11 @@
    1.51  mercurial:
    1.52  <a href="http://tank.slitaz.org/">tank.slitaz.org</a>
    1.53  </p>
    1.54 +<p>
    1.55 +Instruções para a utilização deste servidor estão descritas no "Livro de
    1.56 +Receitas" (cookbook): 
    1.57 +<a href="../doc/cookbook/build-host.html">SliTaz Build Host (tank)</a>.
    1.58 +</p>
    1.59  
    1.60  <a name="repos"></a>
    1.61  <h3>Repositórios Mercurial</h3>
    1.62 @@ -182,6 +212,15 @@
    1.63  	<li><code>hg head</code> : Mostra o último log.</li>
    1.64  </ul>
    1.65  
    1.66 +<a name="iconv"></a>
    1.67 +<h3>Implementação da função iconv()</h3>
    1.68 +<p>
    1.69 +O SliTaz utiliza a função iconv() fornecida pela biblioteca glibc do 
    1.70 +projeto GNU - alguns pacotes que necessitam da função <code>libiconv</code>
    1.71 +devem usar a versão fornecida pela glibc (<code>glibc-locale</code>). Note
    1.72 +que já não há mais um pacote libiconv (1.2 MB) no SliTaz.
    1.73 +</p>
    1.74 +
    1.75  <a name="pkgs"></a>
    1.76  <h3>Pacotes Tazpkg</h3>
    1.77  <p>
    1.78 @@ -209,6 +248,15 @@
    1.79  existe para te guiar nos primeiros passos.
    1.80  </p>
    1.81  
    1.82 +<a name="pkgs-naming"></a>
    1.83 +<h3>Nomes de Pacotes</h3>
    1.84 +<p>
    1.85 +Na maioria dos casos o nome do pacote é o mesmo do código fonte, exceto
    1.86 +para os módulos das linguagens Python, Perl, PHP, Ruby e Lua. Por exemplo,
    1.87 +o pacote que fornece o sistema de templates Kid, escrito em Python e XML,
    1.88 +é nomeado: <code>python-kid</code>.
    1.89 +</p>
    1.90 +
    1.91  <a name="website"></a>
    1.92  <h3>Gerenciamento do website e manuais</h3>
    1.93  <p>
    1.94 @@ -221,7 +269,49 @@
    1.95    Ou, se você tiver as permissões necessárias:
    1.96   $ hg clone http://repos.slitaz.org/website
    1.97  </pre>
    1.98 -<h4>Diff e patch</h4>
    1.99 +
   1.100 +<a name="xhtml"></a>
   1.101 +<h3>Estilo para codificação de xHTML</h3>
   1.102 +<p>
   1.103 +As páginas nos diferentes <em>manuais</em> são codificadas em xHTML 1.0
   1.104 +transitional. As cores para o corpo da página (<code>body</code>) e para 
   1.105 +os títulos são definidas diretamente de forma a permitir que os links
   1.106 +sejam facilmente identificáveis. Os títulos de primeiro nível são usados
   1.107 +apenas uma vez, no topo da página, os de segundo nível são usados para
   1.108 +nomear as seções e os de terceiro e quarto nível para as subseções. Se
   1.109 +uma lista é usada para os tópicos, usando âncoras para as diferentes seções,
   1.110 +é posta logo no início da página, após o título da mesma.
   1.111 +Parágrafos são colocados dentro das tags <code>&lt;p&gt;&lt;/p&gt;</code>.
   1.112 +Para indentação, usa-se tabulações (tabs), de forma a manter-se a semântica
   1.113 +e para diminuir espaço em termos de octetos (bytes). Para mostrar trechos
   1.114 +de código, como o nome de um comando dentro de um parágrafo, 
   1.115 +<code>&lt;code&gt;</code> é o método recomendado. Para mostrar a saida
   1.116 +de comandos ou comandos a serem digitados em um terminal, usa-se
   1.117 +<code>&lt;pre&gt;</code>. Exemplo:
   1.118 +</p>
   1.119 +<pre>
   1.120 + $ comando
   1.121 +</pre>
   1.122 +<p>
   1.123 +Para mostrar texto que pode ser copiado e colado, como scripts, peças de
   1.124 +código, arquivos de configuração, etc, também se usa a tag 
   1.125 +<code>&lt;pre&gt;</code>, em conjunto com a classe CSS chamada "script".
   1.126 +Exemplo:
   1.127 +</p>
   1.128 +<pre class="script">
   1.129 +&lt;pre class="script"&gt;
   1.130 +
   1.131 +code...
   1.132 +
   1.133 +&lt;/pre&gt;
   1.134 +</pre>
   1.135 +<p>
   1.136 +Texto <em>enfatizado</em> é colocado dentro da tag <code>&lt;em&gt;</code> 
   1.137 +e links internos são relativos. É recomendável checar a validade do código
   1.138 +xHTML por meio do <em>validador</em> online da W3C.
   1.139 +</p>
   1.140 +
   1.141 +<h3>Diff e patch</h3>
   1.142  <p>
   1.143  As utilidades <code>diff</code> e <code>patch</code> são ferramentas de linha
   1.144  de comando para criação e implementação de diferenças entre dois arquivos. Esta