website diff pt/devel/forge.php @ rev 1208

Announce 5.0 RC1
author Christophe Lincoln <pankso@slitaz.org>
date Fri May 02 16:06:58 2014 +0200 (2014-05-02)
parents 8187351f0215
children aea4f0603412
line diff
     1.1 --- a/pt/devel/forge.php	Sat Mar 31 17:19:39 2012 +0100
     1.2 +++ b/pt/devel/forge.php	Fri May 02 16:06:58 2014 +0200
     1.3 @@ -1,16 +1,13 @@
     1.4  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     1.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     1.6 +	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     1.7  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt">
     1.8  <head>
     1.9 -    <title>SliTaz - Espaço dos Desenvolvedores</title>
    1.10 -    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    1.11 -    <meta name="description" content="SliTaz GNU/Linux project information overview" />
    1.12 -    <meta name="keywords" lang="pt" content="sobre slitaz, gnu, linux, mini distro, livecd" />
    1.13 -    <meta name="robots" content="index, follow, all" />
    1.14 -    <meta name="modified" content="2011-03-26 00:30:00" />
    1.15 -    <meta name="author" content="Claudinei Pereira" />
    1.16 -    <link rel="shortcut icon" href="../../favicon.ico" />
    1.17 -    <link rel="stylesheet" type="text/css" href="../../slitaz.css" />
    1.18 +	<meta http-equiv="content-type" content="text/html; charset=utf-8" />
    1.19 +	<title>SliTaz - Espaço dos Desenvolvedores</title>
    1.20 +	<meta name="description" content="SliTaz GNU/Linux project information overview" />
    1.21 +	<meta name="keywords" lang="pt" content="sobre slitaz, gnu, linux, mini distro, livecd" />
    1.22 +	<meta name="author" content="Claudinei Pereira" />
    1.23 +	<?php include("../../lib/html/meta-link.html"); ?>
    1.24  </head>
    1.25  <body>
    1.26  
    1.27 @@ -18,18 +15,16 @@
    1.28  
    1.29  <!-- Block -->
    1.30  <div id="block">
    1.31 -
    1.32 -    <?php include("../../lib/html/nav.pt.html"); ?>
    1.33 -
    1.34 -    <!-- Information/image -->
    1.35 +	<?php include("../../lib/html/nav.pt.html"); ?>
    1.36 +	<!-- Information/image -->
    1.37  	<div id="block_info">
    1.38  		<h4>Desenvolvimento</h4>
    1.39  		<p>
    1.40 -            Utilitários, linhas mestras e serviços utilizados para 
    1.41 -            desenvolver o SliTaz.
    1.42 -        </p>
    1.43 +			Utilitários, linhas mestras e serviços utilizados para 
    1.44 +			desenvolver o SliTaz.
    1.45 +		</p>
    1.46  		<p>
    1.47 -			<img src="../../images/users.png" alt="users.png" />
    1.48 +			<img src="/images/users.png" alt="[ ]" />
    1.49  			Utilize também o <a href="http://scn.slitaz.org/">SCN</a>
    1.50  			(SliTaz Community Network) e a 
    1.51  			<a href="../mailing-list.php">lista de discussão</a>.
    1.52 @@ -47,15 +42,15 @@
    1.53  <ul>
    1.54  	<li><a href="#kiss">KISS e respeito aos padrões.</a></li>
    1.55  	<li><a href="#tank">Build host &amp; home.</a></li>
    1.56 -    <li><a href="#repos">Repositórios Mercurial.</a></li>
    1.57 -    <li><a href="#gui">Interface gráfica em GTK e Web/CGI</a></li>
    1.58 -    <li><a href="#iconv">Implementação da função iconv().</a></li>
    1.59 -    <li><a href="#pkgs">Pacotes Tazpkg.</a></li>
    1.60 -    <li><a href="#website">Gerenciamento do Website.</a></li>
    1.61 +	<li><a href="#repos">Repositórios Mercurial.</a></li>
    1.62 +	<li><a href="#gui">Interface gráfica em GTK e Web/CGI</a></li>
    1.63 +	<li><a href="#iconv">Implementação da função iconv().</a></li>
    1.64 +	<li><a href="#pkgs">Pacotes Tazpkg.</a></li>
    1.65 +	<li><a href="#website">Gerenciamento do Website.</a></li>
    1.66  </ul>
    1.67  
    1.68 -<a name="kiss"></a>
    1.69 -<h2>KISS e respeito aos padrões</h2>
    1.70 +<h2 id="kiss">KISS e respeito aos padrões</h2>
    1.71 +
    1.72  <p>
    1.73  "Keep it Simple", ou seja, tentamos manter as coisas simples: respeito 
    1.74  aos padrões, planejamento cuidadoso e documentação escrita de alta 
    1.75 @@ -66,8 +61,8 @@
    1.76  é não nos repetirmos e deixar o sistema básico leve e pequeno.
    1.77  </p>
    1.78  
    1.79 -<a name="tank"></a>
    1.80 -<h2>Tank - Build host &amp; home</h2>
    1.81 +<h2 id="tank">Tank - Build host &amp; home</h2>
    1.82 +
    1.83  <p>
    1.84  Cada participante do projeto pode obter uma conta no servidor do projeto
    1.85  com acesso seguro, espaço em disco, um diretório público e acesso a todas
    1.86 @@ -83,8 +78,8 @@
    1.87  <a href="http://doc.slitaz.org/pt:cookbook:buildhost">SliTaz Build Host (tank)</a>.
    1.88  </p>
    1.89  
    1.90 -<a name="repos"></a>
    1.91 -<h2>Repositórios Mercurial</h2>
    1.92 +<h2 id="repos">Repositórios Mercurial</h2>
    1.93 +
    1.94  <p>
    1.95  Os repositórios Mercurial ou Hg do SliTaz podem ser listados ou clonados por 
    1.96  qualquer um na URL: <a href="http://hg.slitaz.org/">http://hg.slitaz.org/</a>. 
    1.97 @@ -93,7 +88,9 @@
    1.98  O Mercurial usa Python e é instalável com o comando: 
    1.99  <code>tazpkg get-install mercurial</code>
   1.100  </p>
   1.101 +
   1.102  <h3>~/.hgrc</h3>
   1.103 +
   1.104  <p>
   1.105  Antes de sua primeira transferência no servidor, assegure-se de que possui
   1.106  o arquivo de configuração do Hg correto com seu nome e endereço de e-mail
   1.107 @@ -104,7 +101,9 @@
   1.108  [ui]
   1.109  username = FirstName LastName &lt;you@example.org&gt;
   1.110  </pre>
   1.111 +
   1.112  <h4>Clonar, modificar, transferir e finalizar</h4>
   1.113 +
   1.114  <p>
   1.115  Clonar (clone) um repositório, exemplo para slitaz-doc:
   1.116  </p>
   1.117 @@ -143,58 +142,59 @@
   1.118  </p>
   1.119  
   1.120  <h4>Comandos Úteis</h4>
   1.121 +
   1.122  <p>
   1.123  Comandos do mercurial (hg) que podem ser usados.
   1.124  </p>
   1.125  <ul>
   1.126  	<li><code>hg help</code> : Mostra uma lista completa dos comandos.</li>
   1.127  	<li><code>hg rollback</code> : Desfaz a última ação (commit, pull, 
   1.128 -    push).</li>
   1.129 +		push).</li>
   1.130  	<li><code>hg log &lt;package&gt;</code> : Mostra o log de um pacote.</li>
   1.131  	<li><code>hg head</code> : Mostra o último log.</li>
   1.132  </ul>
   1.133  
   1.134 -<a name="gui"></a>
   1.135 -<h2>Interface Gráfica - C/GTK, Yad, Vala/Genie e WEB/GCI</h2>
   1.136 +<h2 id="gui">Interface Gráfica - C/GTK, Yad, Vala/Genie e WEB/GCI</h2>
   1.137 +
   1.138  <p>
   1.139 -    Há várias maneiras de criar interfáces gráficas para o usuário para a
   1.140 -    distribuição. No início do projeto até a versão 3.0, usamos principalmente
   1.141 -    o GTKDialog, o que nos permitia criar interfaces razoavelmente complexas
   1.142 -    em GTK, ao mesmo tempo que pudemos usar uma linguagem de script que 
   1.143 -    era executada sem a necessidade de ser compilada. Porém, o GTKDialog
   1.144 -    não é mais mantido pelos desenvolvedores, e está desatualizado, então
   1.145 -    tivemos que mudar para o Yad para criar algumas caixas de diálogo simples.
   1.146 -    Para todos as ferramentas de administração, pacotes e configuração
   1.147 -    próprias da distribuição, agora usamos o TazPanel, que é uma interface
   1.148 -    WEB/CGI escrita em xHTML5 e CSS3.
   1.149 +	Há várias maneiras de criar interfáces gráficas para o usuário para a
   1.150 +	distribuição. No início do projeto até a versão 3.0, usamos principalmente
   1.151 +	o GTKDialog, o que nos permitia criar interfaces razoavelmente complexas
   1.152 +	em GTK, ao mesmo tempo que pudemos usar uma linguagem de script que 
   1.153 +	era executada sem a necessidade de ser compilada. Porém, o GTKDialog
   1.154 +	não é mais mantido pelos desenvolvedores, e está desatualizado, então
   1.155 +	tivemos que mudar para o Yad para criar algumas caixas de diálogo simples.
   1.156 +	Para todos as ferramentas de administração, pacotes e configuração
   1.157 +	próprias da distribuição, agora usamos o TazPanel, que é uma interface
   1.158 +	WEB/CGI escrita em xHTML5 e CSS3.
   1.159  </p> 
   1.160  <p>
   1.161 -    O Yad é simples, porém não nos permite criar interfaces muito complexas,
   1.162 -    então outra maneira teve de ser abordada. A vantagem de uma linguagem
   1.163 -    de script é o fato de não precisar ser compilada e ser codificada em
   1.164 -    tempo real, porém isso significa em programas que rodam com um pouco menos
   1.165 -    de performance. Escrever programas na Linguagem C é complexo e atrai
   1.166 -    menos desenvolvedores, porque linguagens de script são mais atrativas
   1.167 -    para aqueles que desejam contribuir, tal como o SHell Script, que é
   1.168 -    fácil de compreender e manter. Deste modo, com uma linguagem de programação
   1.169 -    script uma interface WEB/CGI ou em GTK, podemos manter nossas linhas
   1.170 -    mestras e atrair desenvolvedores.
   1.171 +	O Yad é simples, porém não nos permite criar interfaces muito complexas,
   1.172 +	então outra maneira teve de ser abordada. A vantagem de uma linguagem
   1.173 +	de script é o fato de não precisar ser compilada e ser codificada em
   1.174 +	tempo real, porém isso significa em programas que rodam com um pouco menos
   1.175 +	de performance. Escrever programas na Linguagem C é complexo e atrai
   1.176 +	menos desenvolvedores, porque linguagens de script são mais atrativas
   1.177 +	para aqueles que desejam contribuir, tal como o SHell Script, que é
   1.178 +	fácil de compreender e manter. Deste modo, com uma linguagem de programação
   1.179 +	script uma interface WEB/CGI ou em GTK, podemos manter nossas linhas
   1.180 +	mestras e atrair desenvolvedores.
   1.181  </p>
   1.182  <p>
   1.183 -    Há muitas linguagens que usam GTK, como Genie, Vala ou GTKaml. Mas é
   1.184 -    preciso manter em mente que elas não são tão populares quanto o C ou GTK
   1.185 -    e não são tão fáceis de aprender e usar (para interfaces simples, melhor é
   1.186 -    utilizar scripts SHell para tarefas corriqueiras). Pode-se usar o Vala,
   1.187 -    porém note o seguinte exemplo, que é o código necessário para criar uma
   1.188 -    simples caixa de diálogo, e possui 14 linhas de código:
   1.189 +	Há muitas linguagens que usam GTK, como Genie, Vala ou GTKaml. Mas é
   1.190 +	preciso manter em mente que elas não são tão populares quanto o C ou GTK
   1.191 +	e não são tão fáceis de aprender e usar (para interfaces simples, melhor é
   1.192 +	utilizar scripts SHell para tarefas corriqueiras). Pode-se usar o Vala,
   1.193 +	porém note o seguinte exemplo, que é o código necessário para criar uma
   1.194 +	simples caixa de diálogo, e possui 14 linhas de código:
   1.195  </p>
   1.196  <pre>
   1.197 -#include <gtk/gtk.h>;
   1.198 +#include &lt;gtk/gtk.h&gt;;
   1.199  int main(int argc, char *argv[])
   1.200  {
   1.201      GtkWidget *window;
   1.202  
   1.203 -    gtk_init(&argc, &argv);
   1.204 +    gtk_init(&amp;argc, &amp;argv);
   1.205      window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
   1.206      g_signal_connect (G_OBJETCT (window), "destroy",
   1.207              G_CALLBACK (gtk_main_quit), NULL);
   1.208 @@ -205,27 +205,27 @@
   1.209  }
   1.210  </pre>
   1.211  <p>
   1.212 -    Caso queira contribuir, e não está certo qual linguagem usar, mande uma
   1.213 -    mensagem para a lista de discussão. Para pequenas interface gráficas, 
   1.214 -    utilize o TazBox como exemplo, que pode ser encontrado no repositório
   1.215 -    slitaz-tools, que também possui pequenas interfaces gráficas, como a
   1.216 -    responsável pelo logout do usuário. O primeiro utilitário do SliTaz a 
   1.217 -    ser escrito em Linguagem C pura, com GTK, é o TazWeb, e ele pode ser
   1.218 -    utilizado como exemplo na utilização da função system() para incluir
   1.219 -    comandos do sistema em uma interface. Esta ferramente utiliza
   1.220 -    wget para downloads e sed para adicionar favoritos.
   1.221 +	Caso queira contribuir, e não está certo qual linguagem usar, mande uma
   1.222 +	mensagem para a lista de discussão. Para pequenas interface gráficas, 
   1.223 +	utilize o TazBox como exemplo, que pode ser encontrado no repositório
   1.224 +	slitaz-tools, que também possui pequenas interfaces gráficas, como a
   1.225 +	responsável pelo logout do usuário. O primeiro utilitário do SliTaz a 
   1.226 +	ser escrito em Linguagem C pura, com GTK, é o TazWeb, e ele pode ser
   1.227 +	utilizado como exemplo na utilização da função system() para incluir
   1.228 +	comandos do sistema em uma interface. Esta ferramente utiliza
   1.229 +	wget para downloads e sed para adicionar favoritos.
   1.230  </p>
   1.231  <p>
   1.232 -    Scripts em Yad devem seguir as linhas mestras de codificação para a 
   1.233 -    distribuição:
   1.234 -    <a href="http://hg.slitaz.org/slitaz-dev-tools/raw-file/tip/tazyad/README">
   1.235 -        README</a> e o
   1.236 -    <a href="http://hg.slitaz.org/slitaz-dev-tools/raw-file/tip/tazyad/tazyad">
   1.237 -        código de exemplo</a>.
   1.238 +	Scripts em Yad devem seguir as linhas mestras de codificação para a 
   1.239 +	distribuição:
   1.240 +	<a href="http://hg.slitaz.org/slitaz-dev-tools/raw-file/tip/tazyad/README">
   1.241 +		README</a> e o
   1.242 +	<a href="http://hg.slitaz.org/slitaz-dev-tools/raw-file/tip/tazyad/tazyad">
   1.243 +		código de exemplo</a>.
   1.244  </p>
   1.245  
   1.246 -<a name="iconv"></a>
   1.247 -<h2>Implementação da função iconv()</h2>
   1.248 +<h2 id="iconv">Implementação da função iconv()</h2>
   1.249 +
   1.250  <p>
   1.251  O SliTaz utiliza a função iconv() fornecida pela biblioteca glibc do 
   1.252  projeto GNU - alguns pacotes que necessitam da função <code>libiconv</code>
   1.253 @@ -233,8 +233,8 @@
   1.254  que já não há mais um pacote libiconv (1.2 MB) no SliTaz.
   1.255  </p>
   1.256  
   1.257 -<a name="pkgs"></a>
   1.258 -<h2>Pacotes Tazpkg</h2>
   1.259 +<h2 id="pkgs">Pacotes Tazpkg</h2>
   1.260 +
   1.261  <p>
   1.262  Os pacotes tazpkg no SliTaz são automaticamente criados via o
   1.263  <a href="http://cook.slitaz.org/">robô de compilação</a> e receitas
   1.264 @@ -262,8 +262,8 @@
   1.265  existe para te guiar nos primeiros passos.
   1.266  </p>
   1.267  
   1.268 -<a name="pkgs-naming"></a>
   1.269 -<h3>Nomes de Pacotes</h3>
   1.270 +<h3 id="pkgs-naming">Nomes de Pacotes</h3>
   1.271 +
   1.272  <p>
   1.273  Na maioria dos casos o nome do pacote é o mesmo do código fonte, exceto
   1.274  para os módulos das linguagens Python, Perl, PHP, Ruby e Lua. Por exemplo,
   1.275 @@ -271,8 +271,8 @@
   1.276  é nomeado: <code>python-kid</code>.
   1.277  </p>
   1.278  
   1.279 -<a name="website"></a>
   1.280 -<h2>Gerenciamento do website e manuais</h2>
   1.281 +<h2 id="website">Gerenciamento do website e manuais</h2>
   1.282 +
   1.283  <p>
   1.284  O website e os manuais (Manual do SliTaz, Livro de Receitas) são
   1.285  gerenciados pelo repositório mercurial, podendo ser clonados da 
   1.286 @@ -284,8 +284,8 @@
   1.287   $ hg clone http://repos.slitaz.org/website
   1.288  </pre>
   1.289  
   1.290 -<a name="xhtml"></a>
   1.291 -<h3>Estilo para codificação de xHTML</h3>
   1.292 +<h3 id="xhtml">Estilo para codificação de xHTML</h3>
   1.293 +
   1.294  <p>
   1.295  As páginas nos diferentes <em>manuais</em> são codificadas em xHTML 1.0
   1.296  transitional. As cores para o corpo da página (<code>body</code>) e para 
   1.297 @@ -326,6 +326,7 @@
   1.298  </p>
   1.299  
   1.300  <h2>Diff e patch</h2>
   1.301 +
   1.302  <p>
   1.303  As utilidades <code>diff</code> e <code>patch</code> são ferramentas de linha
   1.304  de comando para criação e implementação de diferenças entre dois arquivos. Esta