tazwok diff doc/tazwok.pt.html @ rev 235

Add functionnality: webserver
author Antoine Bodin <gokhlayeh@slitaz.org>
date Thu Feb 10 15:36:26 2011 +0100 (2011-02-10)
parents
children 0bc5a6853a5e
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/tazwok.pt.html	Thu Feb 10 15:36:26 2011 +0100
     1.3 @@ -0,0 +1,239 @@
     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>Manual Tazwok</title>
     1.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    1.10 +    <meta name="description" content="" />
    1.11 +    <meta name="expires" content="never" />
    1.12 +    <meta name="modified" content="2008-07-18 20:30:00" />
    1.13 +    <style type="text/css"><!--
    1.14 +    body { font: 90% sans-serif, vernada, arial; margin: 0; }
    1.15 +    #header { background: #f0ba08; color: black; height: 50px;
    1.16 +        border-top: 1px solid black; border-bottom: 1px solid black; }
    1.17 +    #content { margin: 0px 50px 26px 50px; }
    1.18 +    h1 { margin: 14px 0px 0px 16px; }
    1.19 +    li { line-height: 1.4em; }
    1.20 +    pre { padding: 5px; color: black; background: #e1e0b0; }
    1.21 +    pre.script { padding: 10px; color: black; background: #e8e8e8;
    1.22 +        border: 1px inset #333333; }
    1.23 +    code { font-size: 100%; color: #669900; background: transparent; }
    1.24 +    hr { color: white; background: white; height: 1px; border: 0; }
    1.25 +    --></style>
    1.26 +</head>
    1.27 +<body bgcolor="#ffffff">
    1.28 +<div id="header">
    1.29 +<h1><font color="#3e1220">Manual Tazwok</font></h1>
    1.30 +</div>
    1.31 +<hr />
    1.32 +<!-- Start content -->
    1.33 +<div id="content">
    1.34 +
    1.35 +<h2>NOME</h2>
    1.36 +<p>
    1.37 +Tazwok - SliTaz sources and packages cooker.
    1.38 +</p>
    1.39 +
    1.40 +<h2>SINTAXE</h2>
    1.41 +<pre> tazwok [command] [package|list|category|dir] [--option]
    1.42 +</pre>
    1.43 +
    1.44 +<h2>DESCRIÇÃO</h2>
    1.45 +<p>
    1.46 +O Tazwok é uma ferramenta de linha de comando para configurar e compilar um pacote
    1.47 +a partir de seus fontes. Ele também pode criar pacotes prontos para serem 
    1.48 +utilizados pelo Tazpkg, o gerenciador de pacotes do SliTaz. Para funcionar,
    1.49 +o Tazwok usa um diretório contendo a receita e as informações necessárias para
    1.50 +a construção do pacote. Esta receita também pode ser usada pelo Tazpkg e 
    1.51 +consiste de diferentes variáveis e funções. Tazwok usa o arquivo de configuração
    1.52 +/etc/tazwok.conf para achar o caminho até o wok, os fontes do pacote e gerar
    1.53 +os pacotes .tazpkg. Também pode gerar uma lista de pacotes com seus md5, criar
    1.54 +pacotes interativamente, buscar por pacotes no wok, limpar arquivos gerados e 
    1.55 +até mesmo produzir diferentes pacotes ao mesmo tempo (ver os comandos disponíveis).
    1.56 +</p>
    1.57 +<p>
    1.58 +O Tazwok é inteiramente construído a partir do zero usando SHell Script. 
    1.59 +Compatível com o Bash, roda sobre o Ash - parte do projeto Busybox. O Tazwok é 
    1.60 +distribuído sob a licença livre GNU GPL V3. O Livro de Receitas do SliTaz
    1.61 +também fornece documentação sobre o Tazwok e receitas de pacotes.
    1.62 +</p>
    1.63 +
    1.64 +<h2>COMANDOS</h2>
    1.65 +<a name="usage"></a>
    1.66 +<h3><font color="#6c0023">usage</font></h3>
    1.67 +<p>
    1.68 +Mostra um resumo dos comandos disponíveis e uma pequena descrição em inglês:
    1.69 +</p>
    1.70 +<pre> # tazwok usage
    1.71 +</pre>
    1.72 +<a name="stats"></a>
    1.73 +<h3><font color="#6c0023">stats</font></h3>
    1.74 +<p>
    1.75 +Mostra informações contidas no arquivo de configuração e o número de pacotes
    1.76 +disponíveis no wok:
    1.77 +</p>
    1.78 +<pre> # tazwok stats
    1.79 +</pre>
    1.80 +<a name="list"></a>
    1.81 +<h3><font color="#6c0023">list</font></h3>
    1.82 +<p>
    1.83 +Permite listar todos os pacotes que se encontram no wok ou as categorias padrão
    1.84 +(você pode criar a sua própria). Também lista os pacotes por categoria:
    1.85 +</p>
    1.86 +<pre> # tazwok list
    1.87 + # tazwok list category
    1.88 +</pre>
    1.89 +<a name="info"></a>
    1.90 +<h3><font color="#6c0023">info</font></h3>
    1.91 +<p>
    1.92 +Este comando fornece informações sobre o pacote - nome, versão, etc. Informações
    1.93 +nas receitas básicas de pacote são como as mostradas pelo Tazpkg sobre os 
    1.94 +pacotes instalados:
    1.95 +</p>
    1.96 +<pre> # tazwok info package
    1.97 +</pre>
    1.98 +<a name="check-log"></a>
    1.99 +<h3><font color="#6c0023">check-log</font></h3>
   1.100 +<p>
   1.101 +Ao compilar um binário a partir dos fontes, o Tazwok gera algumas mensagens que
   1.102 +são armazenadas no arquivo "process.log". Para visualizá-lo:
   1.103 +</p>
   1.104 +<pre> # tazwok check-log package
   1.105 +</pre>
   1.106 +<a name="search"></a>
   1.107 +<h3><font color="#6c0023">search</font></h3>
   1.108 +<p>
   1.109 +Permite procurar por pacotes no wok. Pode-se especificar uma palavra-chave ou o
   1.110 +nome do pacote:
   1.111 +</p>
   1.112 +<pre> # tazwok search name
   1.113 +</pre>
   1.114 +<a name="compile"></a>
   1.115 +<h3><font color="#6c0023">compile</font></h3>
   1.116 +<p>
   1.117 +Este comando utiliza as regras de compilação (compile_rules) especificadas na
   1.118 +receita do pacote em questão para compilar os fontes. Note que as regras de 
   1.119 +compilação nem sempre são necessárias - pacotes gerados pelos comandos "genpkg"
   1.120 +e "cook" também podem compilar fontes e generar pacotes binários. Exemplo:
   1.121 +</p>
   1.122 +<pre> # tazwok compile package
   1.123 +</pre>
   1.124 +<a name="genpkg"></a>
   1.125 +<h3><font color="#6c0023">genpkg</font></h3>
   1.126 +<p>
   1.127 +"Genpkg" gera um pacote .tazpkg usando as "genpkg_rules" encontradas na receita.
   1.128 +Uma vez que o pacote é gerado, ele é armazenado no repositório de pacotes
   1.129 +especificado no arquivo de configuração (para visualizar rode "tazwok stats").
   1.130 +O pacote pode ser usando pelo Tazpkg ou pelo Tazlito para gerar uma distribuição
   1.131 +LiveCD. Note que arquivos padrão como local, pixmap e name.desktop são
   1.132 +automaticamente copiados para $fs/usr/share, caso os caminhos padrões sejam
   1.133 +informados ou se o arquivo existe no diretório /stuff. Exemplo de utilização
   1.134 +do "genpkg":
   1.135 +</p>
   1.136 +<pre> # tazwok genpkg package
   1.137 +</pre>
   1.138 +<a name="cook"></a>
   1.139 +<h3><font color="#6c0023">cook</font></h3>
   1.140 +<p>
   1.141 +Simplesmente compila e gera o pacote:
   1.142 +</p>
   1.143 +<pre> # tazwok cook package
   1.144 +</pre>
   1.145 +<a name="cook-list"></a>
   1.146 +<h3><font color="#6c0023">cook-list</font></h3>
   1.147 +<p>
   1.148 +Este comando roda o "tazwok cook" em todos os pacotes contidos no arquivo de
   1.149 +listagem especificado como argumento na linha de comando. "Cook-list" é usado, 
   1.150 +por exemplo, para gerar o sistema base (base-system) sem a glibc. No SliTaz,
   1.151 +você encontra exemplo de listas de geração no diretório /usr/share/examples/tazwok.cooklists:
   1.152 +</p>
   1.153 +<pre> # tazwok cook-list packages.cooklist
   1.154 +</pre>
   1.155 +<a name="clean"></a>
   1.156 +<h3><font color="#6c0023">clean</font></h3>
   1.157 +<p>
   1.158 +Deleta todos os arquivos gerados na compilação e empacotamento:
   1.159 +</p>
   1.160 +<pre> # tazwok clean package
   1.161 +</pre>
   1.162 +<a name="new-tree"></a>
   1.163 +<h3><font color="#6c0023">new-tree</font></h3>
   1.164 +<p>
   1.165 +O comando "new-tree" cria um novo pacote no wok e pode ser usado interativamente.
   1.166 +Ele cria um diretório para o pacote e uma receita, que pode ser editada por seu
   1.167 +editor de textos favorito e que pode ser configurada pela opção --interactive.
   1.168 +Para obter ajuda você pode dar uma olhada nas receitas existentes ou ler a
   1.169 +documentação no Livro de Receitas. Exemplo:
   1.170 +</p>
   1.171 +<pre> # tazwok new-tree package
   1.172 + # tazwok new-tree package --interactive
   1.173 +</pre>
   1.174 +<a name="gen-list"></a>
   1.175 +<h3><font color="#6c0023">gen-list</font></h3>
   1.176 +<p>
   1.177 +O comando "gen-list" gera uma lista de pacotes (packages.list), seus md5
   1.178 +(packages.md5) e uma lista de opções de pacotes contendo informações 
   1.179 +(packages.txt). As listas são criadas na base de pacotes contidos em um
   1.180 +diretório. A lista em formato texto é construída usando uma receita contida
   1.181 +no wok. O diretório de pacotes padrão é aquele especificado no arquivo de
   1.182 +configuração, mas você pode especificá-lo na linha de comando. Exemplos:
   1.183 +</p>
   1.184 +<pre> # tazwok gen-list
   1.185 + # tazwok gen-list --text
   1.186 + # tazwok gen-list /path/to/repository
   1.187 +</pre>
   1.188 +<a name="gen-clean-wok"></a>
   1.189 +<h3><font color="#6c0023">gen-clean-wok and clean-wok</font></h3>
   1.190 +<p>
   1.191 +O comando "gen-clean-wok" cria um novo wok, o que é útil para salvar uma versão
   1.192 +do wok ou criar uma cópia de testes. Rodar "clean-wok" limpa todos os pacotes
   1.193 +no wok atual e apaga todos os arquivos gerados. Para gerar um wok limpo ou limpar
   1.194 +o wok atual:
   1.195 +</p>
   1.196 +<pre> # tazwok gen-clean-wok path/to/new-wok
   1.197 + # tazwok clean-wok
   1.198 +</pre>
   1.199 +<a name="remove"></a>
   1.200 +<h3><font color="#6c0023">remove</font></h3>
   1.201 +<p>
   1.202 +Remove o pacote especificado do wok, incluindo receitas e outros arquivos
   1.203 +relacionados:
   1.204 +</p>
   1.205 +<pre> # tazwok remove package
   1.206 +</pre>
   1.207 +<a name="build-depends"></a>
   1.208 +<h3><font color="#6c0023">build-depends</font></h3>
   1.209 +<p>
   1.210 +Gera uma lista de pacotes para a construção do wok:
   1.211 +</p>
   1.212 +<pre> # tazwok build-depends
   1.213 +</pre>
   1.214 +<a name="compare"></a>
   1.215 +<h3><font color="#6c0023">cmp|compare</font></h3>
   1.216 +<p>
   1.217 +Compara o wok e os pacotes preparados e gera um relatório. Pacotes
   1.218 +obsoletos podem ser deletados com a opção --remove. A opção --cook
   1.219 +compila os pacotes. Exemplos:
   1.220 +</p>
   1.221 +<pre> # tazwok compare
   1.222 + # tazwok compare --remove
   1.223 + # tazwok compare --cook
   1.224 +</pre> 
   1.225 +<a name="check"></a>
   1.226 +<h3><font color="#6c0023">check</font></h3>
   1.227 +<p>
   1.228 +Checa as receitas em busca de erros comuns:
   1.229 +</p>
   1.230 +<pre> # tazwok check
   1.231 +</pre>
   1.232 +
   1.233 +<h2>MANTENEDOR</h2>
   1.234 +<p>
   1.235 +Christophe Lincoln &lt;pankso at slitaz.org&gt;
   1.236 +</p>
   1.237 +
   1.238 +<!-- End content -->
   1.239 +</div>
   1.240 +
   1.241 +</body>
   1.242 +</html>