SliTaz Repositories

     1.1 --- a/doc/tazlito.pt.html	Mon Feb 22 17:37:10 2010 +0100
     1.2 +++ b/doc/tazlito.pt.html	Fri Feb 26 12:47:54 2010 -0300
     1.3 @@ -40,17 +40,20 @@
     1.4  </pre>
     1.5  
     1.6  <h2>DESCRIÇÃO</h2>
     1.7 +
     1.8  <p>
     1.9  Tazlito é um pequeno utilitário que extrai um LiveCD, reconstrói a imagem ISO
    1.10 -e regenera o sistema de arquivos root do LiveCD. Tazlito também pode gerar
    1.11 -uma distribuição a partir de uma lista de pacotes previamente baixados. Para
    1.12 -rodar, o Tazlito usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf
    1.13 -ou o tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica
    1.14 -o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos e
    1.15 -da ISO a ser gerada. Tazlito também pode ser usado para configurar um diretório
    1.16 -contendo arquivos adicionais que serão copiados para o LiveCD na geração da
    1.17 -distribuição.
    1.18 +e regenera o sistema de arquivos root do LiveCD, criando uma variante
    1.19 +(flavor) da distribuição. O Tazlito também pode gerar uma distribuição a 
    1.20 +partir de uma lista de pacotes previamente baixados. Para rodar, o Tazlito 
    1.21 +usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf ou o 
    1.22 +tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica
    1.23 +o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos 
    1.24 +e da ISO a ser gerada. Tazlito também pode ser usado para configurar um 
    1.25 +diretório contendo arquivos adicionais que serão copiados para o LiveCD na 
    1.26 +geração da distribuição.
    1.27  </p>
    1.28 +
    1.29  <p>
    1.30  Tazlito é distribuído sobre a licença livre GNU GPL V3, istalada por padrão no
    1.31  SliTaz e instalada/testada com sucesso no Debian GNU/Linux. Você irá encontrar
    1.32 @@ -58,6 +61,7 @@
    1.33  </p>
    1.34  
    1.35  <h2>COMANDOS</h2>
    1.36 +
    1.37  <a name="usage"></a>
    1.38  <h3><font color="#6c0023">usage</font></h3>
    1.39  <p>
    1.40 @@ -67,6 +71,7 @@
    1.41  <pre>
    1.42   # tazlito usage
    1.43  </pre>
    1.44 +
    1.45  <a name="stats"></a>
    1.46  <h3><font color="#6c0023">stats</font></h3>
    1.47  <p>
    1.48 @@ -76,6 +81,7 @@
    1.49  <pre>
    1.50   # tazlito stats
    1.51  </pre>
    1.52 +
    1.53  <a name="gen-config"></a>
    1.54  <h3><font color="#6c0023">gen-config</font></h3>
    1.55  <p>
    1.56 @@ -87,6 +93,7 @@
    1.57   # tazlito gen-config
    1.58   # tazlito gen-config /path/to/distro
    1.59  </pre>
    1.60 +
    1.61  <a name="configure"></a>
    1.62  <h3><font color="#6c0023">configure</font></h3>
    1.63  <p>
    1.64 @@ -96,6 +103,7 @@
    1.65  <pre>
    1.66   # tazlito configure
    1.67  </pre>
    1.68 +
    1.69  <a name="gen-iso"></a>
    1.70  <h3><font color="#6c0023">gen-iso</font></h3>
    1.71  <p>
    1.72 @@ -108,6 +116,7 @@
    1.73  <pre>
    1.74   # tazlito gen-iso
    1.75  </pre>
    1.76 +
    1.77  <a name="gen-initiso"></a>
    1.78  <h3><font color="#6c0023">gen-initiso</font></h3>
    1.79  <p>
    1.80 @@ -118,6 +127,7 @@
    1.81  <pre>
    1.82   # tazlito gen-initiso
    1.83  </pre>
    1.84 +
    1.85  <a name="list-flavors"></a>
    1.86  <h3><font color="#6c0023">list-flavors</font></h3>
    1.87  <p>
    1.88 @@ -128,6 +138,7 @@
    1.89   # tazlito list-flavors
    1.90   # tazlito list-flavors --recharge
    1.91  </pre>
    1.92 +
    1.93  <a name="get-flavor"></a>
    1.94  <h3><font color="#6c0023">get-flavor</font></h3>
    1.95  <p>
    1.96 @@ -137,6 +148,7 @@
    1.97  <pre>
    1.98   # tazlito get-flavor particular-flavor
    1.99  </pre>
   1.100 +
   1.101  <a name="show-flavor"></a>
   1.102  <h3><font color="#6c0023">show-flavor</font></h3>
   1.103  <p>
   1.104 @@ -148,6 +160,7 @@
   1.105   # tazlito show-flavor particular-flavor --brief
   1.106   # tazlito show-flavor particular-flavor --brief --noheader
   1.107  </pre>
   1.108 +
   1.109  <a name="gen-flavor"></a>
   1.110  <h3><font color="#6c0023">gen-flavor</font></h3>
   1.111  <p>
   1.112 @@ -158,6 +171,7 @@
   1.113  <pre>
   1.114   # tazlito gen-flavor new-flavor
   1.115  </pre>
   1.116 +
   1.117  <a name="gen-liveflavor"></a>
   1.118  <h3><font color="#6c0023">gen-liveflavor</font></h3>
   1.119  <p>
   1.120 @@ -168,6 +182,40 @@
   1.121  <pre> # tazlito gen-liveflavor
   1.122   # tazlito gen-liveflavor --help
   1.123  </pre>
   1.124 +
   1.125 +<a name="upgrade-flavor"></a>
   1.126 +<h3><font color="#6c0023">upgrade-flavor</font></h3>
   1.127 +<p>
   1.128 +Este comando renova um arquivo flavor, atualizando a lista de pacotes
   1.129 +com a versão mais recente disponível no mirror:
   1.130 +</p>
   1.131 +<pre>
   1.132 + # tazlito upgrade-flavor this-flavor
   1.133 +</pre>
   1.134 +
   1.135 +<a name="extract-flavor"></a>
   1.136 +<h3><font color="#6c0023">extract-flavor</font></h3>
   1.137 +<p>
   1.138 +O comando 'extract-flavor' converte um flavor em uma estrutura de pastas
   1.139 +facilmente modificável em /home/slitaz/flavors que pode ser ser 
   1.140 +gerenciada com o mercurial:
   1.141 +<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
   1.142 +</p>
   1.143 +<pre>
   1.144 + # tazlito extract-flavor this-flavor
   1.145 +</pre>
   1.146 +
   1.147 +<a name="pack-flavor"></a>
   1.148 +<h3><font color="#6c0023">pack-flavor</font></h3>
   1.149 +<p>
   1.150 +Este comando converte uma estrutura de pastas encontrada em /home/slitaz/flavors
   1.151 +em um arquivo de variante (.flavor). É o inverso do que o comando 
   1.152 +'extract-flavor' faz:
   1.153 +</p>
   1.154 +<pre>
   1.155 + # tazlito pack-flavor this-flavor
   1.156 +</pre>
   1.157 +
   1.158  <a name="extract-distro"></a>
   1.159  <h3><font color="#6c0023">extract-distro</font></h3>
   1.160  <p>
   1.161 @@ -179,6 +227,7 @@
   1.162  <pre>
   1.163   # tazlito extract-distro slitaz-cooking.iso
   1.164  </pre>
   1.165 +
   1.166  <a name="gen-distro"></a>
   1.167  <h3><font color="#6c0023">gen-distro</font></h3>
   1.168  <p>
   1.169 @@ -200,6 +249,7 @@
   1.170   # tazlito gen-distro --iso=slitaz.iso
   1.171   # tazlito gen-distro package-list
   1.172  </pre>
   1.173 +
   1.174  <a name="clean-distro"></a>
   1.175  <h3><font color="#6c0023">clean-distro</font></h3>
   1.176  <p>
   1.177 @@ -208,16 +258,7 @@
   1.178  <pre>
   1.179   # tazlito clean-distro
   1.180  </pre>
   1.181 -<a name="addhacker"></a>
   1.182 -<h3><font color="#6c0023">addhacker</font></h3>
   1.183 -<p>
   1.184 -Este comando permite a adição do usuário "hacker" à distribuição - o que permite
   1.185 -a utilização de uma conta de usuário sem a necessidade de uma senha. Note que
   1.186 -este comando muda as permissões de todos os arquivos em <code>/home/hacker/</code>:
   1.187 -</p>
   1.188 -<pre>
   1.189 - # tazlito addhacker
   1.190 -</pre>
   1.191 +
   1.192  <a name="check-distro"></a>
   1.193  <h3><font color="#6c0023">check-distro</font></h3>
   1.194  <p>
   1.195 @@ -228,6 +269,68 @@
   1.196   # tazlito check-distro
   1.197  </pre>
   1.198  
   1.199 +<a name="writeiso"></a>
   1.200 +<h3><font color="#6c0023">writeiso</font></h3>
   1.201 +<p>
   1.202 +Este comando irá converter o sistema de arquivos atual em um arquivo
   1.203 +cpio (rootfs.gz) e então gerar uma imagem ISO inicializável. Pode ser
   1.204 +usado tanto em instalações no HD quanto em modo LiveCD, e irá arquivar
   1.205 +também o conteúdo do diretório /home. Com ele, pode-se facilmente 
   1.206 +remasterizar e construir sua própria imagem de LiveCD. Para tanto
   1.207 +inicie o sistema, modifique arquivos, instale pacotes e então:
   1.208 +</p>
   1.209 +<pre>
   1.210 + # tazlito writeiso [gzip|lzma|none]
   1.211 + # tazlito writeiso gzip
   1.212 + # tazlito writeiso gzip image-name
   1.213 +</pre>
   1.214 +
   1.215 +<a name="frugal-install"></a>
   1.216 +<h3><font color="#6c0023">frugal-install</font></h3>
   1.217 +<p>
   1.218 +Executa uma instalação frugal em /boot/frugal e adiciona uma entrada ao
   1.219 +GRUB, caso necessário. Este tipo de instalação irá rodar o SliTaz
   1.220 +diretamente na memória RAM (mesmo comportamento do LiveCD), o que
   1.221 +permite testar a distro ou ter um sistema de recuperação pronto para uso.
   1.222 +Para instalar todos os arquivos necessários a partir de uma estrutura
   1.223 +de pastas ou de uma imagem ISO:
   1.224 +</p>
   1.225 +<pre>
   1.226 + # tazlito frugal-install
   1.227 + # tazlito -fi slitaz.iso
   1.228 +</pre>
   1.229 +
   1.230 +<a name="check-list"></a>
   1.231 +<h3><font color="#6c0023">check-list</font></h3>
   1.232 +<p>
   1.233 +Verifica se o arquivo distro-packages.list está atualizado com as
   1.234 +mais recentes versões dos pacotes:
   1.235 +</p>
   1.236 +<pre>
   1.237 + # tazlito check-list
   1.238 +</pre>
   1.239 +
   1.240 +<a name="repack"></a>
   1.241 +<h3><font color="#6c0023">repack</font></h3>
   1.242 +<p>
   1.243 +Comprime novamente o rootfs com a melhor compressão possível:
   1.244 +</p>
   1.245 +<pre>
   1.246 + # tazlito repack slitaz.iso
   1.247 +</pre>
   1.248 +
   1.249 +<a name="merge"></a>
   1.250 +<h3><font color="#6c0023">merge</font></h3>
   1.251 +<p>
   1.252 +Combina diversas variantes. Cada rootfs é uma consequência de seu
   1.253 +anterior. O primeiro rootfs é extraido da imagem ISO indicada como
   1.254 +terceiro argumento. As variantes serão escolhidas no momento do boot,
   1.255 +de acordo com a memória RAM disponível:
   1.256 +</p>
   1.257 +<pre>
   1.258 + # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
   1.259 +</pre>
   1.260 +
   1.261  <a name="emu-iso"></a> 
   1.262  <h3><font color="#6c0023">emu-iso</font></h3> 
   1.263  <p> 
   1.264 @@ -252,6 +355,165 @@
   1.265   # tazlito burn-iso slitaz-hacked.iso
   1.266  </pre>
   1.267  
   1.268 +<h2>FLAVORS</h2>
   1.269 +<p>
   1.270 +Um arquivo <i>.flavor</i> contém somente alguns poucos Kb de informação
   1.271 +necessária para (re)construir um LiveCD customizado do SliTaz.
   1.272 +</p>
   1.273 +
   1.274 +<a name="rebuild-flavor"></a>
   1.275 +<h3><font color="#6c0023">(Re)construa uma variante</font></h3>
   1.276 +<p>
   1.277 +Você pode escolher uma variante para (re)construir a partir daquelas
   1.278 +disponíveis:
   1.279 +</p>
   1.280 +<pre>
   1.281 +# tazlito list-flavors
   1.282 +
   1.283 +List of flavors
   1.284 +================================================================================
   1.285 +Name              ISO   Rootfs  Description
   1.286 +================================================================================
   1.287 +base               6.9M  13.1M  Minimal set of packages to boot
   1.288 +core-3in1         31.5M 105.6M  SliTaz core system with justX and base alternatives
   1.289 +core              31.5M 104.6M  SliTaz core system
   1.290 +eeepc             31.2M 105.4M  SliTaz eeepc system
   1.291 +justX             16.1M  51.2M  SliTaz with a minimal X environment
   1.292 +</pre>
   1.293 +<p>
   1.294 +Como exeplo, começaremos a reconstruir a variante <i>eeepc</i> que 
   1.295 +ocupa 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M:
   1.296 +</p>
   1.297 +<pre>
   1.298 +# tazlito clean-distro
   1.299 +# tazlito get-flavor eeepc
   1.300 +# tazlito gen-distro
   1.301 +</pre>
   1.302 +
   1.303 +<a name="create-flavor"></a>
   1.304 +<h3><font color="#6c0023">Crie uma variante</font></h3>
   1.305 +<p>
   1.306 +Para criar uma variante, você deve:
   1.307 +</p>
   1.308 +<ul>
   1.309 +    <li>Criar uma imagem ISO usando o comando <b>tazlito-gen-distro</b>
   1.310 +        e então criar um arquivo flavor usando <b>tazlito gen-flavor</b>; ou</li>
   1.311 +    <li>Criar diretamente uma estrutura de arquivos que define o flavor
   1.312 +        (veja <b>tazlito extract-flavor</b>) e então criar o flavor
   1.313 +        usando <b>tazlito pack-flavor</b>.</li>
   1.314 +</ul>
   1.315 +
   1.316 +<a name="publish-flavor"></a>
   1.317 +<h3><font color="#6c0023">Publique uma variante</font></h3>
   1.318 +<p>
   1.319 +Um arquivo .flavor possui alguns Kb de tamanho, então você pode enviá-lo
   1.320 +para a lista de discussão do SliTaz.
   1.321 +</p>
   1.322 +<p>
   1.323 +Os arquivos resultantes do comando <b>tazlito extract flavor</b> pode 
   1.324 +também ser colocado no repositório mercurial (http://repos.slitaz.org/flavors).
   1.325 +Este método é preferido porque a estrutura de pastas poderá ser
   1.326 +acessada diretamente por uma interface web.
   1.327 +</p>
   1.328 +<p>
   1.329 +Esta estrutura inclui:
   1.330 +</p>
   1.331 +<ul>
   1.332 +<li>
   1.333 +Uma <b>receita</b> (arquivo <i>receipt</i>) que descreve a variante
   1.334 +por intermédio das variáveis:
   1.335 +  <ul>
   1.336 +  <li>
   1.337 +FLAVOR: O nome da variante.
   1.338 +  </li>
   1.339 +  <li>
   1.340 +SHORT_DESC: Uma curta descrição
   1.341 +  </li>
   1.342 +  <li>
   1.343 +VERSION: Versão.
   1.344 +  </li>
   1.345 +  <li>
   1.346 +MAINTAINER: Email do desenvolvedor/criador.
   1.347 +  </li>
   1.348 +  <li>
   1.349 +FRUGAL_RAM: Memória RAM mínima recomendável (variável opcional).
   1.350 +  </li>
   1.351 +  <li>
   1.352 +ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM (opcional).
   1.353 +  </li>
   1.354 +  <li>
   1.355 +INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CDROM (opcional).
   1.356 +  </li>
   1.357 +  <li>
   1.358 +ISO_SIZE: Tamanho do CDROM (opcional).
   1.359 +  </li>
   1.360 +  <li>
   1.361 +ROOTFS_SELECTION: Opcional, veja <i>Meta flavor</i> abaixo.
   1.362 +  </li>
   1.363 +  </ul>
   1.364 +</li>
   1.365 +<li>
   1.366 +O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar
   1.367 +uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis). 
   1.368 +Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja 
   1.369 +definida.
   1.370 +</li>
   1.371 +<li>
   1.372 +O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais 
   1.373 +(undigest) a serem incluidos para se obter pacotes personalizados.
   1.374 +</li>
   1.375 +<li>
   1.376 +O diretório opcional <b>rootfs</b> contem uma estrutura de pastas e arquivos
   1.377 +a serem adicionados ao sistema de arquivos rootfs.gz (normalmente serão
   1.378 +arquivos de configuração).
   1.379 +</li>
   1.380 +<li>
   1.381 +O diretório opcional <b>rootcd</b> contem uma estrutura de pastas e arquivos
   1.382 +a serem adicionados ao CDROM.
   1.383 +</li>
   1.384 +</ul>
   1.385 +
   1.386 +<a name="tune-flavor"></a>
   1.387 +<h3><font color="#6c0023">Adapte uma variante</font></h3>
   1.388 +<p>
   1.389 +Às vezes é mais fácil modificar uma variante existente do que criar uma
   1.390 +nova. Para adaptar a variante eeepc, por exemplo:
   1.391 +</p>
   1.392 +<pre>
   1.393 +# tazpkg get-install mercurial
   1.394 +# cd /home/slitaz
   1.395 +# hg clone http://hg.slitaz.org/flavors
   1.396 +# cd flavors
   1.397 +# cp -a eeepc myslitaz
   1.398 +</pre>
   1.399 +<p>
   1.400 +Arquivos em <i>my-slitaz</i> podem ser adaptados, então:
   1.401 +</p>
   1.402 +<pre>
   1.403 +# tazlito pack-flavor myslitaz
   1.404 +</pre>
   1.405 +<p>
   1.406 +Isto irá criar uma nova variante adaptada de uma outra existente.
   1.407 +</p>
   1.408 +
   1.409 +<a name="meta-flavor"></a>
   1.410 +<h3><font color="#6c0023">Meta flavor</font></h3>
   1.411 +<p>
   1.412 +Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se
   1.413 +iniciar o sistema com uma meta variante, uma variante contida no LiveCD
   1.414 +irá ser chamada dependendo do tamanho da memória RAM disponível. A 
   1.415 +variável ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os
   1.416 +parametros das variantes existentes. Exemplo usando a meta variante
   1.417 +<a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"></a>:
   1.418 +</p>
   1.419 +<pre>
   1.420 +ROOTFS_SELECTION="160M core 96M justX 32M base"
   1.421 +</pre>
   1.422 +<p>
   1.423 +Este tipo de variante não possui uma lista de pacotes (packages.list)
   1.424 +e só é suportada no SliTaz a partir do kernel 2.6.30.
   1.425 +</p>
   1.426 +
   1.427  <h2>MANTENEDOR</h2>
   1.428  <p>
   1.429  Christophe Lincoln &lt;pankso at slitaz.org&gt;