rev |
line source |
claudinei@990
|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
al@1029
|
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
claudinei@990
|
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt">
|
claudinei@990
|
4 <head>
|
al@1029
|
5 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
al@1029
|
6 <title>SliTaz - Espaço dos Desenvolvedores</title>
|
al@1029
|
7 <meta name="description" content="SliTaz GNU/Linux project information overview" />
|
al@1029
|
8 <meta name="keywords" lang="pt" content="sobre slitaz, gnu, linux, mini distro, livecd" />
|
al@1029
|
9 <meta name="author" content="Claudinei Pereira" />
|
al@1029
|
10 <?php include("../../lib/html/meta-link.html"); ?>
|
claudinei@990
|
11 </head>
|
claudinei@990
|
12 <body>
|
claudinei@990
|
13
|
claudinei@990
|
14 <?php include("../../lib/html/header.pt.html"); ?>
|
claudinei@990
|
15
|
claudinei@990
|
16 <!-- Block -->
|
claudinei@990
|
17 <div id="block">
|
al@1029
|
18 <?php include("../../lib/html/nav.pt.html"); ?>
|
al@1029
|
19 <!-- Information/image -->
|
claudinei@990
|
20 <div id="block_info">
|
claudinei@990
|
21 <h4>Desenvolvimento</h4>
|
claudinei@990
|
22 <p>
|
al@1029
|
23 Utilitários, linhas mestras e serviços utilizados para
|
al@1029
|
24 desenvolver o SliTaz.
|
al@1029
|
25 </p>
|
claudinei@990
|
26 <p>
|
al@1029
|
27 <img src="/images/users.png" alt="[ ]" />
|
paul@1022
|
28 Utilize também o <a href="http://scn.slitaz.org/">SCN</a>
|
claudinei@990
|
29 (SliTaz Community Network) e a
|
paul@1022
|
30 <a href="../mailing-list.php">lista de discussão</a>.
|
claudinei@990
|
31 </p>
|
claudinei@990
|
32 </div>
|
claudinei@990
|
33 </div>
|
claudinei@990
|
34
|
paul@1022
|
35 <?php include("../../lib/lang.php"); ?>
|
claudinei@990
|
36
|
claudinei@990
|
37 <!-- Content -->
|
claudinei@990
|
38 <div id="content">
|
claudinei@990
|
39
|
paul@1022
|
40 <h2>Espaço dos Desenvolvedores do SliTaz</h2>
|
claudinei@990
|
41
|
claudinei@990
|
42 <ul>
|
paul@1022
|
43 <li><a href="#kiss">KISS e respeito aos padrões.</a></li>
|
claudinei@990
|
44 <li><a href="#tank">Build host & home.</a></li>
|
al@1029
|
45 <li><a href="#repos">Repositórios Mercurial.</a></li>
|
al@1029
|
46 <li><a href="#gui">Interface gráfica em GTK e Web/CGI</a></li>
|
al@1029
|
47 <li><a href="#iconv">Implementação da função iconv().</a></li>
|
al@1029
|
48 <li><a href="#pkgs">Pacotes Tazpkg.</a></li>
|
al@1029
|
49 <li><a href="#website">Gerenciamento do Website.</a></li>
|
claudinei@990
|
50 </ul>
|
claudinei@990
|
51
|
al@1029
|
52 <h2 id="kiss">KISS e respeito aos padrões</h2>
|
al@1029
|
53
|
claudinei@990
|
54 <p>
|
claudinei@990
|
55 "Keep it Simple", ou seja, tentamos manter as coisas simples: respeito
|
paul@1022
|
56 aos padrões, planejamento cuidadoso e documentação escrita de alta
|
paul@1022
|
57 qualidade, fornecimento de um sistema robusto e estável e um sistema de
|
claudinei@990
|
58 arquivos (<em>rootfs</em>) no LiveCD leve o suficiente para ser executado
|
paul@1022
|
59 em máquinas que tenham ao menos 128 mb de memória RAM. Também usamos
|
paul@1022
|
60 aplicativos baseados em GTK+2, Dialog, scripts SHell ou PHP. A idéia
|
paul@1022
|
61 é não nos repetirmos e deixar o sistema básico leve e pequeno.
|
claudinei@990
|
62 </p>
|
claudinei@990
|
63
|
al@1029
|
64 <h2 id="tank">Tank - Build host & home</h2>
|
al@1029
|
65
|
claudinei@990
|
66 <p>
|
claudinei@990
|
67 Cada participante do projeto pode obter uma conta no servidor do projeto
|
paul@1022
|
68 com acesso seguro, espaço em disco, um diretório público e acesso a todas
|
claudinei@990
|
69 as ferramentas de desenvolvimento. Os desenvolvendores podem compilar
|
paul@1022
|
70 pacotes e os mantenedores dos mirrors podem gerenciar as sincronizações.
|
paul@1022
|
71 O Tank também hospeda o website, o boot via web e os repositórios
|
claudinei@990
|
72 mercurial:
|
claudinei@990
|
73 <a href="http://tank.slitaz.org/">tank.slitaz.org</a>
|
claudinei@990
|
74 </p>
|
claudinei@990
|
75 <p>
|
paul@1022
|
76 Instruções para a utilização deste servidor estão descritas no "Livro de
|
claudinei@990
|
77 Receitas" (cookbook):
|
claudinei@990
|
78 <a href="http://doc.slitaz.org/pt:cookbook:buildhost">SliTaz Build Host (tank)</a>.
|
claudinei@990
|
79 </p>
|
claudinei@990
|
80
|
al@1029
|
81 <h2 id="repos">Repositórios Mercurial</h2>
|
al@1029
|
82
|
claudinei@990
|
83 <p>
|
paul@1022
|
84 Os repositórios Mercurial ou Hg do SliTaz podem ser listados ou clonados por
|
claudinei@990
|
85 qualquer um na URL: <a href="http://hg.slitaz.org/">http://hg.slitaz.org/</a>.
|
paul@1022
|
86 Pessoas com acesso de escrita podem acessar diretamente pelo endereço
|
paul@1022
|
87 <code>repos.slitaz.org</code> que necessita de autenticação.
|
paul@1022
|
88 O Mercurial usa Python e é instalável com o comando:
|
claudinei@990
|
89 <code>tazpkg get-install mercurial</code>
|
claudinei@990
|
90 </p>
|
al@1029
|
91
|
claudinei@990
|
92 <h3>~/.hgrc</h3>
|
al@1029
|
93
|
claudinei@990
|
94 <p>
|
paul@1022
|
95 Antes de sua primeira transferência no servidor, assegure-se de que possui
|
paul@1022
|
96 o arquivo de configuração do Hg correto com seu nome e endereço de e-mail
|
paul@1022
|
97 e lembre-se de checar que você não está acessando como usuário root.
|
claudinei@990
|
98 Exemplo de arquivo ~/.hgrc:
|
claudinei@990
|
99 </p>
|
claudinei@990
|
100 <pre class="script">
|
claudinei@990
|
101 [ui]
|
claudinei@990
|
102 username = FirstName LastName <you@example.org>
|
claudinei@990
|
103 </pre>
|
al@1029
|
104
|
claudinei@990
|
105 <h4>Clonar, modificar, transferir e finalizar</h4>
|
al@1029
|
106
|
claudinei@990
|
107 <p>
|
paul@1022
|
108 Clonar (clone) um repositório, exemplo para slitaz-doc:
|
claudinei@990
|
109 </p>
|
claudinei@990
|
110 <pre>
|
claudinei@990
|
111 $ hg clone http://repos.slitaz.org/wok
|
claudinei@990
|
112 </pre>
|
claudinei@990
|
113 <p>
|
paul@1022
|
114 Mude de diretório para slitaz-doc, note que você deve estar no repositório
|
claudinei@990
|
115 para poder utilizar os comandos "hg". Para marcar todos os logs ou somente o
|
paul@1022
|
116 último log:
|
claudinei@990
|
117 </p>
|
claudinei@990
|
118 <pre>
|
claudinei@990
|
119 $ hg log
|
claudinei@990
|
120 $ hg head
|
claudinei@990
|
121 </pre>
|
claudinei@990
|
122 <p>
|
claudinei@990
|
123 Modifique um ou mais arquivos e transfira (commit):
|
claudinei@990
|
124 </p>
|
claudinei@990
|
125 <pre>
|
claudinei@990
|
126 $ hg add
|
claudinei@990
|
127 $ hg status
|
claudinei@990
|
128 $ hg commit -m "Log message..."
|
claudinei@990
|
129 $ hg log
|
claudinei@990
|
130 </pre>
|
claudinei@990
|
131 <p>
|
paul@1022
|
132 Note que você pode usar o comando <code>rollback</code> para desfazer a última
|
paul@1022
|
133 transação. Antes de finalizar (push) as mudanças no servidor é seguro executar
|
claudinei@990
|
134 o comando pull ao menos uma vez:
|
claudinei@990
|
135 </p>
|
claudinei@990
|
136 <pre>
|
claudinei@990
|
137 $ hg pull
|
claudinei@990
|
138 $ hg push
|
claudinei@990
|
139 </pre>
|
claudinei@990
|
140 <p>
|
paul@1022
|
141 Está feito, suas mudanças, código ou correções estão agora no servidor
|
claudinei@990
|
142 </p>
|
claudinei@990
|
143
|
paul@1022
|
144 <h4>Comandos Úteis</h4>
|
al@1029
|
145
|
claudinei@990
|
146 <p>
|
claudinei@990
|
147 Comandos do mercurial (hg) que podem ser usados.
|
claudinei@990
|
148 </p>
|
claudinei@990
|
149 <ul>
|
claudinei@990
|
150 <li><code>hg help</code> : Mostra uma lista completa dos comandos.</li>
|
paul@1022
|
151 <li><code>hg rollback</code> : Desfaz a última ação (commit, pull,
|
al@1029
|
152 push).</li>
|
claudinei@990
|
153 <li><code>hg log <package></code> : Mostra o log de um pacote.</li>
|
paul@1022
|
154 <li><code>hg head</code> : Mostra o último log.</li>
|
claudinei@990
|
155 </ul>
|
claudinei@990
|
156
|
al@1029
|
157 <h2 id="gui">Interface Gráfica - C/GTK, Yad, Vala/Genie e WEB/GCI</h2>
|
al@1029
|
158
|
claudinei@990
|
159 <p>
|
al@1029
|
160 Há várias maneiras de criar interfáces gráficas para o usuário para a
|
al@1029
|
161 distribuição. No início do projeto até a versão 3.0, usamos principalmente
|
al@1029
|
162 o GTKDialog, o que nos permitia criar interfaces razoavelmente complexas
|
al@1029
|
163 em GTK, ao mesmo tempo que pudemos usar uma linguagem de script que
|
al@1029
|
164 era executada sem a necessidade de ser compilada. Porém, o GTKDialog
|
al@1029
|
165 não é mais mantido pelos desenvolvedores, e está desatualizado, então
|
al@1029
|
166 tivemos que mudar para o Yad para criar algumas caixas de diálogo simples.
|
al@1029
|
167 Para todos as ferramentas de administração, pacotes e configuração
|
al@1029
|
168 próprias da distribuição, agora usamos o TazPanel, que é uma interface
|
al@1029
|
169 WEB/CGI escrita em xHTML5 e CSS3.
|
claudinei@990
|
170 </p>
|
claudinei@990
|
171 <p>
|
al@1029
|
172 O Yad é simples, porém não nos permite criar interfaces muito complexas,
|
al@1029
|
173 então outra maneira teve de ser abordada. A vantagem de uma linguagem
|
al@1029
|
174 de script é o fato de não precisar ser compilada e ser codificada em
|
al@1029
|
175 tempo real, porém isso significa em programas que rodam com um pouco menos
|
al@1029
|
176 de performance. Escrever programas na Linguagem C é complexo e atrai
|
al@1029
|
177 menos desenvolvedores, porque linguagens de script são mais atrativas
|
al@1029
|
178 para aqueles que desejam contribuir, tal como o SHell Script, que é
|
al@1029
|
179 fácil de compreender e manter. Deste modo, com uma linguagem de programação
|
al@1029
|
180 script uma interface WEB/CGI ou em GTK, podemos manter nossas linhas
|
al@1029
|
181 mestras e atrair desenvolvedores.
|
claudinei@990
|
182 </p>
|
claudinei@990
|
183 <p>
|
al@1029
|
184 Há muitas linguagens que usam GTK, como Genie, Vala ou GTKaml. Mas é
|
al@1029
|
185 preciso manter em mente que elas não são tão populares quanto o C ou GTK
|
al@1029
|
186 e não são tão fáceis de aprender e usar (para interfaces simples, melhor é
|
al@1029
|
187 utilizar scripts SHell para tarefas corriqueiras). Pode-se usar o Vala,
|
al@1029
|
188 porém note o seguinte exemplo, que é o código necessário para criar uma
|
al@1029
|
189 simples caixa de diálogo, e possui 14 linhas de código:
|
claudinei@990
|
190 </p>
|
claudinei@990
|
191 <pre>
|
al@1029
|
192 #include <gtk/gtk.h>;
|
claudinei@990
|
193 int main(int argc, char *argv[])
|
claudinei@990
|
194 {
|
claudinei@990
|
195 GtkWidget *window;
|
claudinei@990
|
196
|
al@1029
|
197 gtk_init(&argc, &argv);
|
claudinei@990
|
198 window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
|
claudinei@990
|
199 g_signal_connect (G_OBJETCT (window), "destroy",
|
claudinei@990
|
200 G_CALLBACK (gtk_main_quit), NULL);
|
claudinei@990
|
201
|
claudinei@990
|
202 gtk_widget_show(window);
|
claudinei@990
|
203 gtk_main();
|
claudinei@990
|
204 return 0;'
|
claudinei@990
|
205 }
|
claudinei@990
|
206 </pre>
|
claudinei@990
|
207 <p>
|
al@1029
|
208 Caso queira contribuir, e não está certo qual linguagem usar, mande uma
|
al@1029
|
209 mensagem para a lista de discussão. Para pequenas interface gráficas,
|
al@1029
|
210 utilize o TazBox como exemplo, que pode ser encontrado no repositório
|
al@1029
|
211 slitaz-tools, que também possui pequenas interfaces gráficas, como a
|
al@1029
|
212 responsável pelo logout do usuário. O primeiro utilitário do SliTaz a
|
al@1029
|
213 ser escrito em Linguagem C pura, com GTK, é o TazWeb, e ele pode ser
|
al@1029
|
214 utilizado como exemplo na utilização da função system() para incluir
|
al@1029
|
215 comandos do sistema em uma interface. Esta ferramente utiliza
|
al@1029
|
216 wget para downloads e sed para adicionar favoritos.
|
claudinei@990
|
217 </p>
|
claudinei@990
|
218 <p>
|
al@1029
|
219 Scripts em Yad devem seguir as linhas mestras de codificação para a
|
al@1029
|
220 distribuição:
|
al@1029
|
221 <a href="http://hg.slitaz.org/slitaz-dev-tools/raw-file/tip/tazyad/README">
|
al@1029
|
222 README</a> e o
|
al@1029
|
223 <a href="http://hg.slitaz.org/slitaz-dev-tools/raw-file/tip/tazyad/tazyad">
|
al@1029
|
224 código de exemplo</a>.
|
claudinei@990
|
225 </p>
|
claudinei@990
|
226
|
al@1029
|
227 <h2 id="iconv">Implementação da função iconv()</h2>
|
al@1029
|
228
|
claudinei@990
|
229 <p>
|
paul@1022
|
230 O SliTaz utiliza a função iconv() fornecida pela biblioteca glibc do
|
paul@1022
|
231 projeto GNU - alguns pacotes que necessitam da função <code>libiconv</code>
|
paul@1022
|
232 devem usar a versão fornecida pela glibc (<code>glibc-locale</code>). Note
|
paul@1022
|
233 que já não há mais um pacote libiconv (1.2 MB) no SliTaz.
|
claudinei@990
|
234 </p>
|
claudinei@990
|
235
|
al@1029
|
236 <h2 id="pkgs">Pacotes Tazpkg</h2>
|
al@1029
|
237
|
claudinei@990
|
238 <p>
|
paul@1022
|
239 Os pacotes tazpkg no SliTaz são automaticamente criados via o
|
paul@1022
|
240 <a href="http://cook.slitaz.org/">robô de compilação</a> e receitas
|
claudinei@990
|
241 no wok. O Livro de Receitas descreve o
|
claudinei@990
|
242 <a href="http://doc.slitaz.org/pt:cookbook:wok">uso das ferramentas</a>
|
claudinei@990
|
243 e o formato das <a href="http://doc.slitaz.org/pt:cookbook:receipt">receitas</a>.
|
paul@1022
|
244 Informações sobre o comando cook e sobre criação de arquivos receipt são
|
paul@1022
|
245 necessários para a criação de pacotes.
|
claudinei@990
|
246 </p>
|
claudinei@990
|
247 <p>
|
paul@1022
|
248 Em termos de escolha de pacote, a idéia é oferecer o pacote por tarefa ou
|
paul@1022
|
249 funcionalidade, isto é, a mais leve aplicação em seu campo e sem duplicações.
|
paul@1022
|
250 Note que a atual seleção de pacotes não é imutável, se você souber de uma
|
claudinei@990
|
251 alternativa mais leve, com mais funcionalidades ou mais <em>sexy</em> por apenas
|
paul@1022
|
252 alguns KB a mais, sugira na lista de discussão. Atenção redobrada é prestada
|
paul@1022
|
253 aos pacotes do LiveCD: eles devem ser "limpos", removendo-se dependências
|
paul@1022
|
254 desnecessárias e opções do compilador. Em geral os pacotes candidatos a fazer
|
paul@1022
|
255 parte do LiveCD são discutidos na lista.
|
claudinei@990
|
256 </p>
|
claudinei@990
|
257 <p>
|
paul@1022
|
258 Antes de você começar a compilar e a criar pacotes para o SliTaz, certifique-se
|
paul@1022
|
259 que o trabalho ainda não existe na relação do wok disponível no mirror principal
|
paul@1022
|
260 do SliTaz. Não se esqueça que os membros da lista podem te ajudar e que a
|
paul@1022
|
261 documentação do <a href="http://doc.slitaz.org/pt:cookbook:wok">wok e ferramentas</a>
|
claudinei@990
|
262 existe para te guiar nos primeiros passos.
|
claudinei@990
|
263 </p>
|
claudinei@990
|
264
|
al@1029
|
265 <h3 id="pkgs-naming">Nomes de Pacotes</h3>
|
al@1029
|
266
|
claudinei@990
|
267 <p>
|
paul@1022
|
268 Na maioria dos casos o nome do pacote é o mesmo do código fonte, exceto
|
paul@1022
|
269 para os módulos das linguagens Python, Perl, PHP, Ruby e Lua. Por exemplo,
|
claudinei@990
|
270 o pacote que fornece o sistema de templates Kid, escrito em Python e XML,
|
paul@1022
|
271 é nomeado: <code>python-kid</code>.
|
claudinei@990
|
272 </p>
|
claudinei@990
|
273
|
al@1029
|
274 <h2 id="website">Gerenciamento do website e manuais</h2>
|
al@1029
|
275
|
claudinei@990
|
276 <p>
|
paul@1022
|
277 O website e os manuais (Manual do SliTaz, Livro de Receitas) são
|
paul@1022
|
278 gerenciados pelo repositório mercurial, podendo ser clonados da
|
claudinei@990
|
279 seguinte maneira:
|
claudinei@990
|
280 </p>
|
claudinei@990
|
281 <pre>
|
claudinei@990
|
282 $ hg clone http://hg.slitaz.org/website
|
paul@1022
|
283 Ou, se você tiver as permissões necessárias:
|
claudinei@990
|
284 $ hg clone http://repos.slitaz.org/website
|
claudinei@990
|
285 </pre>
|
claudinei@990
|
286
|
al@1029
|
287 <h3 id="xhtml">Estilo para codificação de xHTML</h3>
|
al@1029
|
288
|
claudinei@990
|
289 <p>
|
paul@1022
|
290 As páginas nos diferentes <em>manuais</em> são codificadas em xHTML 1.0
|
paul@1022
|
291 transitional. As cores para o corpo da página (<code>body</code>) e para
|
paul@1022
|
292 os títulos são definidas diretamente de forma a permitir que os links
|
paul@1022
|
293 sejam facilmente identificáveis. Os títulos de primeiro nível são usados
|
paul@1022
|
294 apenas uma vez, no topo da página, os de segundo nível são usados para
|
paul@1022
|
295 nomear as seções e os de terceiro e quarto nível para as subseções. Se
|
paul@1022
|
296 uma lista é usada para os tópicos, usando âncoras para as diferentes seções,
|
paul@1022
|
297 é posta logo no início da página, após o título da mesma.
|
paul@1022
|
298 Parágrafos são colocados dentro das tags <code><p></p></code>.
|
paul@1022
|
299 Para indentação, usa-se tabulações (tabs), de forma a manter-se a semântica
|
paul@1022
|
300 e para diminuir espaço em termos de octetos (bytes). Para mostrar trechos
|
paul@1022
|
301 de código, como o nome de um comando dentro de um parágrafo,
|
paul@1022
|
302 <code><code></code> é o método recomendado. Para mostrar a saida
|
claudinei@990
|
303 de comandos ou comandos a serem digitados em um terminal, usa-se
|
claudinei@990
|
304 <code><pre></code>. Exemplo:
|
claudinei@990
|
305 </p>
|
claudinei@990
|
306 <pre>
|
claudinei@990
|
307 $ comando
|
claudinei@990
|
308 </pre>
|
claudinei@990
|
309 <p>
|
paul@1022
|
310 Para mostrar texto que pode ser copiado e colado, como scripts, peças de
|
paul@1022
|
311 código, arquivos de configuração, etc, também se usa a tag
|
claudinei@990
|
312 <code><pre></code>, em conjunto com a classe CSS chamada "script".
|
claudinei@990
|
313 Exemplo:
|
claudinei@990
|
314 </p>
|
claudinei@990
|
315 <pre class="script">
|
claudinei@990
|
316 <pre class="script">
|
claudinei@990
|
317
|
claudinei@990
|
318 code...
|
claudinei@990
|
319
|
claudinei@990
|
320 </pre>
|
claudinei@990
|
321 </pre>
|
claudinei@990
|
322 <p>
|
paul@1022
|
323 Texto <em>enfatizado</em> é colocado dentro da tag <code><em></code>
|
paul@1022
|
324 e links internos são relativos. É recomendável checar a validade do código
|
claudinei@990
|
325 xHTML por meio do <em>validador</em> online da W3C.
|
claudinei@990
|
326 </p>
|
claudinei@990
|
327
|
claudinei@990
|
328 <h2>Diff e patch</h2>
|
al@1029
|
329
|
claudinei@990
|
330 <p>
|
paul@1022
|
331 As utilidades <code>diff</code> e <code>patch</code> são ferramentas de linha
|
paul@1022
|
332 de comando para criação e implementação de diferenças entre dois arquivos. Esta
|
paul@1022
|
333 técnica é freqüentemente usada para colaboração e as mudanças feitas no arquivo
|
paul@1022
|
334 original podem ser extraídas facilmente. Para criar um arquivo <code>diff</code>
|
paul@1022
|
335 legível aos humanos em um simples editor de textos, você deve fornecer a opção
|
claudinei@990
|
336 <code>-u</code> :
|
claudinei@990
|
337 </p>
|
claudinei@990
|
338 <pre>
|
claudinei@990
|
339 $ diff -u file.orig file.new > file.diff
|
claudinei@990
|
340 </pre>
|
claudinei@990
|
341 <p>
|
claudinei@990
|
342 Para aplicar um patch:
|
claudinei@990
|
343 </p>
|
claudinei@990
|
344 <pre>
|
claudinei@990
|
345 $ patch file.orig file.diff
|
claudinei@990
|
346 </pre>
|
claudinei@990
|
347
|
claudinei@990
|
348 <!-- End of content -->
|
claudinei@990
|
349 </div>
|
claudinei@990
|
350
|
claudinei@990
|
351 <?php include("../../lib/html/footer.pt.html"); ?>
|
claudinei@990
|
352
|
claudinei@990
|
353 </body>
|
claudinei@990
|
354 </html>
|