website diff pt/doc/cookbook/wok-tools.html @ rev 529
pt: cookbook - general update
| author | Claudinei Pereira <claudinei@slitaz.org> |
|---|---|
| date | Sun Jul 26 11:36:42 2009 +0000 (2009-07-26) |
| parents | |
| children | c6b2d9c4e031 |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/pt/doc/cookbook/wok-tools.html Sun Jul 26 11:36:42 2009 +0000 1.3 @@ -0,0 +1,224 @@ 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 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt"> 1.7 +<head> 1.8 + <title>Livro de Receitas do SliTaz - Wok & Ferramentas</title> 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="slitaz portuguese cookbook" /> 1.11 + <meta name="expires" content="never" /> 1.12 + <meta name="modified" content="2008-07-16 21:45:00" /> 1.13 + <meta name="publisher" content="www.slitaz.org" /> 1.14 + <meta name="author" content="Christophe Lincoln, Paul Issot"/> 1.15 + <link rel="shortcut icon" href="favicon.ico" /> 1.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 1.17 +</head> 1.18 +<body bgcolor="#ffffff"> 1.19 + 1.20 +<!-- Header and quick navigation --> 1.21 +<div id="header"> 1.22 +<div align="right" id="quicknav"> 1.23 + <a name="top"></a> 1.24 + <a href="receipts.html">Receitas</a> | 1.25 + <a href="index.html">Conteúdo</a> 1.26 +</div> 1.27 +<h1><font color="#3E1220">SliTaz Cookbook (pt)</font></h1> 1.28 +</div> 1.29 + 1.30 +<!-- Content. --> 1.31 +<div id="content"> 1.32 +<div class="content-right"></div> 1.33 + 1.34 +<h2><font color="#DF8F06">Wok & Ferramentas</font></h2> 1.35 + 1.36 +<ul> 1.37 + <li><a href="#tazwok">Sumário</a></li> 1.38 + <li><a href="#wok">Ferramentas Wok</a></li> 1.39 + <li><a href="#cook">Compilação e geração de pacotes</a></li> 1.40 + <li><a href="#opts">Opções durante a compilação de um pacote</a></li> 1.41 + <li><a href="#files">Arquivos incluidos ou pacotes excluidos</a></li> 1.42 + <li><a href="#categories">Categorias de pacotes</a></li> 1.43 + <li><a href="#woktree">Estrutura dos pacotes no wok</a></li> 1.44 + <li><a href="#pkgtree">Estrutura de um pacote .tazpkg</a></li> 1.45 + <li><a href="receipts.html">Receitas</a></li> 1.46 +</ul> 1.47 + 1.48 +<a name="tazwok"></a> 1.49 +<h3>Sumário - Tazwok e o wok</h3> 1.50 +<p> 1.51 +A idéia é usar um diretório (wok) contendo todos os pacotes disponíveis, cada 1.52 +um contendo ao menos uma receita que defina o download, desempacotamento, 1.53 +compilação e geração de um binário. Para funcionar, o tazwok também precisa 1.54 +criar um diretório para armazenar fontes baixados ($SOURCES_REPOSITORY) e um 1.55 +repositório de pacotes gerados ($PACKAGES_REPOSITORY), valores que podem ser 1.56 +configurados usando o arquivo <code>/etc/tazwok.conf</code>. 1.57 +</p> 1.58 + 1.59 +<a name="wok"></a> 1.60 +<h3><font color="#6c0023">Ferramentas Wok</font></h3> 1.61 +<p> 1.62 +Para começar, o tazwok precisa estar instalado no sistema, assim como as 1.63 +principais ferramentas de desenvolvimento (binutils, compilador, bibliotecas 1.64 +de desenvolvimento, make), que devem ser baixadas do mirror. Para tanto, deve-se 1.65 +instalar o meta-pacote <code>slitaz-toolchain</code>: 1.66 +</p> 1.67 +<pre> # tazpkg recharge 1.68 + # tazpkg get-install slitaz-toolchain 1.69 +</pre> 1.70 +<h4>Obtenha o wok</h4> 1.71 +<p> 1.72 +Antes de iniciar o trabalho também é necessário recuperar o wok dos repositórios 1.73 +Mercurial ou de um arquivo no mirror primário (TuxFamily). Exemplo usando o 1.74 +SliTaz para ser construído no diretório <code>/home/slitaz</code>: 1.75 +</p> 1.76 +<pre> $ hg clone http://hg.slitaz.org/wok/ /home/slitaz/wok 1.77 +</pre> 1.78 +<p> 1.79 +Os arquivos também estão disponíveis em: 1.80 +<a href="ftp://download.tuxfamily.org/slitaz/wok/"> 1.81 + ftp://download.tuxfamily.org/slitaz/wok/</a>. 1.82 +Obtenha a última versão dos diretórios cooking ou undigest. Antes de compilar 1.83 +seu primeiro pacote, o tazwok precisa saber onde procurar os arquivos. Por padrão 1.84 +o caminho é <code>/home/slitaz/wok</code>, mas você pode mudar isto ou renomear 1.85 +o wok que deseja baixar. Para visualizar/checar os caminhos utilizados pelo 1.86 +tazwok e o número de pacotes no wok, use o comando tazwok <code>stats</code>: 1.87 +</p> 1.88 +<pre> # tazwok stats 1.89 +</pre> 1.90 + 1.91 +<a name="cook"></a> 1.92 +<h3>Compilação e geração de pacotes</h3> 1.93 +<p> 1.94 +Configure, compile, "limpe": a forma como o SliTaz gera os pacotes pode ser 1.95 +colocada em um simples comando. Para evitar frustrações, é recomendável iniciar 1.96 +a construção do pacote sem mudar sua receita ou dependências. M4 é um candidato 1.97 +ideal para a sua primeira <code>geração</code>: 1.98 +</p> 1.99 +<pre> # tazwok cook m4 1.100 +</pre> 1.101 +<p> 1.102 +Uma vez que o trabalho foi feito, o pacote é localizado no diretório especificado 1.103 +pelo arquivo de configuração (o padrão é em <code>/home/slitaz/packages</code>). 1.104 +Se tudo correu bem, você pode instalar o pacote no sistema anfitrião ou usa-lo 1.105 +para gerar uma distribuição LiveCD com o Tazlito. Para criar um novo pacote 1.106 +você pode usar o comando <code>new-tree</code> com a opção <code>--interactive</code> 1.107 +e ler a documentação fornecida pela página de <a href="receipts.html">receitas</a>. 1.108 +</p> 1.109 +<h4>Cook-list - Lista de Geração</h4> 1.110 +<p> 1.111 +Para compilar vários pacotes com um único comando, você pode usar a lista de 1.112 +geração. Há listas-exemplo em <code>usr/share/examples/tazwok/cooklists</code>, 1.113 +que são somente arquivos texto com um nome de pacote por linha. Exemplo do 1.114 +comando "cook-list" usando "mypkgs.cooklist": 1.115 +</p> 1.116 +<pre> # tazwok cook-list mypkgs.cooklist 1.117 +</pre> 1.118 + 1.119 +<a name="opts"></a> 1.120 +<h3>Opções durante a compilação de um pacote</h3> 1.121 +<p> 1.122 +Você é livre para usar quaisquer opções que queira, somente respeitando a 1.123 +Hierarquia do Sistema de Arquivos (FSH), os documentos em <code>/usr/share/doc</code> 1.124 +e seguindos os padrões Freedesktop (.desktop). Então fica a seu critério, por 1.125 +exemplo, disabilitar suporte a XML, tendo binários menores para o PHP e abrindo 1.126 +mão da libxml2 mas, neste caso, diminuir o tamanho dos binários acaba resultando 1.127 +em perda de funcionalidade. Se você tiver qualquer dúvida, olhe as receitas e 1.128 +opções de compilação em <code>compile_rules</code>. 1.129 +</p> 1.130 +<h4>Otimização</h4> 1.131 +<p> 1.132 +Os pacotes oficiais do SliTaz são otimizados para i486, os argumentos de 1.133 +otimização usados para a configuração estão especificados em <code>/etc/tazwok.conf</code> 1.134 +e pode ser envocados pela variável <code>$CONFIGURE_ARGS</code>. Se você deseja 1.135 +compilar um pacote com opções diferentes, pode modificar o arquivo de 1.136 +configuração do tazwok: 1.137 +</p> 1.138 +<pre class="script">CONFIGURE_ARGS="--build=i486-pc-linux-gnu --host=i486-pc-linux-gnu" 1.139 +</pre> 1.140 + 1.141 +<a name="files"></a> 1.142 +<h3>Arquivos incluidos ou pacotes excluidos</h3> 1.143 +<p> 1.144 +Geralmente os pacote base não contém as páginas man, info, os arquivos doc ou 1.145 +bibliotecas estáticas, então precisamos criá-los por meio de um pacote-doc ou 1.146 +um pacote-dev. Note que no SliTaz não se pretende incluir os comandos man ou 1.147 +info, então não há nenhum manual ou arquivo info GNU. A criação de pacotes 1.148 +contendo documentos é realmente opcional, especialmente se o material estiver 1.149 +em inglês. No entanto, um trecho de texto sobre o pacote incluido no Manual 1.150 +SliTaz seria bem apreciado. 1.151 +</p> 1.152 +<p> 1.153 +Em termos de configuração, quando possível, o objetivo é oferecer arquivos 1.154 +básicos de configuração para rodar o pacote diretamente. No caso do pacote do 1.155 +servidor web LightTPD, o SliTaz fornece arquivos de configuração e scripts de 1.156 +inicialização localizados em /etc/init.d/ (documentados no Manual SliTaz). Para 1.157 +um pacote novo, você é livre para escolher a configuração padrão dependendo em 1.158 +que você pensa ser mais fácil para o usuário final. No SliTaz existem exemplos 1.159 +de configuração em <code>/usr/share/examples</code> e outros tipos de informações 1.160 +úteis. 1.161 +</p> 1.162 + 1.163 +<a name="categories"></a> 1.164 +<h3>Categorias de pacotes</h3> 1.165 +<p> 1.166 +As categorias de pacotes existem somente para propósitos de informação e não são 1.167 +fixas, a idéia é classificar os pacotes para que uma página web possa ser gerada 1.168 +toda noite, recuperando dados na receita do pacote. Em resumo, inclua pacotes 1.169 +de desenvolvimento em "devel", o Xorg em "x-window" e novos pacotes variados 1.170 +em "extra". 1.171 +</p> 1.172 + 1.173 +<a name="woktree"></a> 1.174 +<h3>Estrutura dos pacotes no wok</h3> 1.175 +<p> 1.176 +A estrutura de um pacote no wok deve sempre ser respeitada para que o tazwok 1.177 +possa encontrar arquivos e diretórios corretos. Possíveis conteúdos de um pacote 1.178 +(note que o diretório /taz é criado no momento da geração): 1.179 +</p> 1.180 +<ul> 1.181 + <li><code>stuff/</code> : O material usado para configurar, compilar e gerar 1.182 + o pacote (patch(es), Makefile, pseudo fs, etc).</li> 1.183 + <li><code>taz/</code> : Árvore de diretórios contendo o pacote tazpkg 1.184 + gerado - o pacote comprimido é arquivado no diretório especificado em 1.185 + $PACKAGES_REPOSITORY no arquivo de configuração do tazwok.</li> 1.186 + <li><code>receipt</code> : A receita (veja 1.187 + <a href="receipts.html">receitas</a>).</li> 1.188 + <li><code>description.txt</code> : (opcional) A descrição do pacote é 1.189 + copiada para a raíz do pacote tazpkg. Uma vez instalado, o tazpkg lida com 1.190 + este arquivo por meio do comando "tazpkg desc nome-do-pacote".</li> 1.191 +</ul> 1.192 + 1.193 +<a name="pkgtree"></a> 1.194 +<h3>Estrutura de um pacote .tazpkg</h3> 1.195 +<p> 1.196 +Os pacotes do SliTaz são arquivos cpio contendo arquivos e um sistema de 1.197 +arquivos comprimidos com o gzip: 1.198 +</p> 1.199 +<ul> 1.200 + <li><code>fs/</code> : Pseudo Sistema de Arquivos contendo todos os 1.201 + arquivos a serem instalados.</li> 1.202 + <li><code>receipt</code> : A receita (veja receipt.txt).</li> 1.203 + <li><code>files.list</code> : Uma lista de arquivos do pacote.</li> 1.204 + <li><code>description.txt</code> : A descrição do pacote (opcional).</li> 1.205 +</ul> 1.206 + 1.207 +<!-- End of content --> 1.208 +</div> 1.209 + 1.210 +<!-- Footer. --> 1.211 +<div id="footer"> 1.212 + <div class="footer-right"></div> 1.213 + <a href="#top">Topo da Página</a> | 1.214 + <a href="index.html">Conteúdo</a> 1.215 +</div> 1.216 + 1.217 +<div id="copy"> 1.218 + Copyright © 2008 <a href="http://www.slitaz.org/pt/">SliTaz</a> - 1.219 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 1.220 + Documentation is under 1.221 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 1.222 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 1.223 +</div> 1.224 + 1.225 +</body> 1.226 +</html> 1.227 +