# HG changeset patch
# User Claudinei Pereira <claudinei@slitaz.org>
# Date 1267199274 10800
# Node ID 15c9c8e0da1cd08528eba15b55562fa23fe1a9b5
# Parent  3fc95e228478a946d69d8a16b47a9e3107ff7ab2
Update tazlito.pt.html

diff -r 3fc95e228478 -r 15c9c8e0da1c doc/tazlito.pt.html
--- a/doc/tazlito.pt.html	Mon Feb 22 17:37:10 2010 +0100
+++ b/doc/tazlito.pt.html	Fri Feb 26 12:47:54 2010 -0300
@@ -40,17 +40,20 @@
 </pre>
 
 <h2>DESCRIÇÃO</h2>
+
 <p>
 Tazlito é um pequeno utilitário que extrai um LiveCD, reconstrói a imagem ISO
-e regenera o sistema de arquivos root do LiveCD. Tazlito também pode gerar
-uma distribuição a partir de uma lista de pacotes previamente baixados. Para
-rodar, o Tazlito usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf
-ou o tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica
-o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos e
-da ISO a ser gerada. Tazlito também pode ser usado para configurar um diretório
-contendo arquivos adicionais que serão copiados para o LiveCD na geração da
-distribuição.
+e regenera o sistema de arquivos root do LiveCD, criando uma variante
+(flavor) da distribuição. O Tazlito também pode gerar uma distribuição a 
+partir de uma lista de pacotes previamente baixados. Para rodar, o Tazlito 
+usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf ou o 
+tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica
+o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos 
+e da ISO a ser gerada. Tazlito também pode ser usado para configurar um 
+diretório contendo arquivos adicionais que serão copiados para o LiveCD na 
+geração da distribuição.
 </p>
+
 <p>
 Tazlito é distribuído sobre a licença livre GNU GPL V3, istalada por padrão no
 SliTaz e instalada/testada com sucesso no Debian GNU/Linux. Você irá encontrar
@@ -58,6 +61,7 @@
 </p>
 
 <h2>COMANDOS</h2>
+
 <a name="usage"></a>
 <h3><font color="#6c0023">usage</font></h3>
 <p>
@@ -67,6 +71,7 @@
 <pre>
  # tazlito usage
 </pre>
+
 <a name="stats"></a>
 <h3><font color="#6c0023">stats</font></h3>
 <p>
@@ -76,6 +81,7 @@
 <pre>
  # tazlito stats
 </pre>
+
 <a name="gen-config"></a>
 <h3><font color="#6c0023">gen-config</font></h3>
 <p>
@@ -87,6 +93,7 @@
  # tazlito gen-config
  # tazlito gen-config /path/to/distro
 </pre>
+
 <a name="configure"></a>
 <h3><font color="#6c0023">configure</font></h3>
 <p>
@@ -96,6 +103,7 @@
 <pre>
  # tazlito configure
 </pre>
+
 <a name="gen-iso"></a>
 <h3><font color="#6c0023">gen-iso</font></h3>
 <p>
@@ -108,6 +116,7 @@
 <pre>
  # tazlito gen-iso
 </pre>
+
 <a name="gen-initiso"></a>
 <h3><font color="#6c0023">gen-initiso</font></h3>
 <p>
@@ -118,6 +127,7 @@
 <pre>
  # tazlito gen-initiso
 </pre>
+
 <a name="list-flavors"></a>
 <h3><font color="#6c0023">list-flavors</font></h3>
 <p>
@@ -128,6 +138,7 @@
  # tazlito list-flavors
  # tazlito list-flavors --recharge
 </pre>
+
 <a name="get-flavor"></a>
 <h3><font color="#6c0023">get-flavor</font></h3>
 <p>
@@ -137,6 +148,7 @@
 <pre>
  # tazlito get-flavor particular-flavor
 </pre>
+
 <a name="show-flavor"></a>
 <h3><font color="#6c0023">show-flavor</font></h3>
 <p>
@@ -148,6 +160,7 @@
  # tazlito show-flavor particular-flavor --brief
  # tazlito show-flavor particular-flavor --brief --noheader
 </pre>
+
 <a name="gen-flavor"></a>
 <h3><font color="#6c0023">gen-flavor</font></h3>
 <p>
@@ -158,6 +171,7 @@
 <pre>
  # tazlito gen-flavor new-flavor
 </pre>
+
 <a name="gen-liveflavor"></a>
 <h3><font color="#6c0023">gen-liveflavor</font></h3>
 <p>
@@ -168,6 +182,40 @@
 <pre> # tazlito gen-liveflavor
  # tazlito gen-liveflavor --help
 </pre>
+
+<a name="upgrade-flavor"></a>
+<h3><font color="#6c0023">upgrade-flavor</font></h3>
+<p>
+Este comando renova um arquivo flavor, atualizando a lista de pacotes
+com a versão mais recente disponível no mirror:
+</p>
+<pre>
+ # tazlito upgrade-flavor this-flavor
+</pre>
+
+<a name="extract-flavor"></a>
+<h3><font color="#6c0023">extract-flavor</font></h3>
+<p>
+O comando 'extract-flavor' converte um flavor em uma estrutura de pastas
+facilmente modificável em /home/slitaz/flavors que pode ser ser 
+gerenciada com o mercurial:
+<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
+</p>
+<pre>
+ # tazlito extract-flavor this-flavor
+</pre>
+
+<a name="pack-flavor"></a>
+<h3><font color="#6c0023">pack-flavor</font></h3>
+<p>
+Este comando converte uma estrutura de pastas encontrada em /home/slitaz/flavors
+em um arquivo de variante (.flavor). É o inverso do que o comando 
+'extract-flavor' faz:
+</p>
+<pre>
+ # tazlito pack-flavor this-flavor
+</pre>
+
 <a name="extract-distro"></a>
 <h3><font color="#6c0023">extract-distro</font></h3>
 <p>
@@ -179,6 +227,7 @@
 <pre>
  # tazlito extract-distro slitaz-cooking.iso
 </pre>
+
 <a name="gen-distro"></a>
 <h3><font color="#6c0023">gen-distro</font></h3>
 <p>
@@ -200,6 +249,7 @@
  # tazlito gen-distro --iso=slitaz.iso
  # tazlito gen-distro package-list
 </pre>
+
 <a name="clean-distro"></a>
 <h3><font color="#6c0023">clean-distro</font></h3>
 <p>
@@ -208,16 +258,7 @@
 <pre>
  # tazlito clean-distro
 </pre>
-<a name="addhacker"></a>
-<h3><font color="#6c0023">addhacker</font></h3>
-<p>
-Este comando permite a adição do usuário "hacker" à distribuição - o que permite
-a utilização de uma conta de usuário sem a necessidade de uma senha. Note que
-este comando muda as permissões de todos os arquivos em <code>/home/hacker/</code>:
-</p>
-<pre>
- # tazlito addhacker
-</pre>
+
 <a name="check-distro"></a>
 <h3><font color="#6c0023">check-distro</font></h3>
 <p>
@@ -228,6 +269,68 @@
  # tazlito check-distro
 </pre>
 
+<a name="writeiso"></a>
+<h3><font color="#6c0023">writeiso</font></h3>
+<p>
+Este comando irá converter o sistema de arquivos atual em um arquivo
+cpio (rootfs.gz) e então gerar uma imagem ISO inicializável. Pode ser
+usado tanto em instalações no HD quanto em modo LiveCD, e irá arquivar
+também o conteúdo do diretório /home. Com ele, pode-se facilmente 
+remasterizar e construir sua própria imagem de LiveCD. Para tanto
+inicie o sistema, modifique arquivos, instale pacotes e então:
+</p>
+<pre>
+ # tazlito writeiso [gzip|lzma|none]
+ # tazlito writeiso gzip
+ # tazlito writeiso gzip image-name
+</pre>
+
+<a name="frugal-install"></a>
+<h3><font color="#6c0023">frugal-install</font></h3>
+<p>
+Executa uma instalação frugal em /boot/frugal e adiciona uma entrada ao
+GRUB, caso necessário. Este tipo de instalação irá rodar o SliTaz
+diretamente na memória RAM (mesmo comportamento do LiveCD), o que
+permite testar a distro ou ter um sistema de recuperação pronto para uso.
+Para instalar todos os arquivos necessários a partir de uma estrutura
+de pastas ou de uma imagem ISO:
+</p>
+<pre>
+ # tazlito frugal-install
+ # tazlito -fi slitaz.iso
+</pre>
+
+<a name="check-list"></a>
+<h3><font color="#6c0023">check-list</font></h3>
+<p>
+Verifica se o arquivo distro-packages.list está atualizado com as
+mais recentes versões dos pacotes:
+</p>
+<pre>
+ # tazlito check-list
+</pre>
+
+<a name="repack"></a>
+<h3><font color="#6c0023">repack</font></h3>
+<p>
+Comprime novamente o rootfs com a melhor compressão possível:
+</p>
+<pre>
+ # tazlito repack slitaz.iso
+</pre>
+
+<a name="merge"></a>
+<h3><font color="#6c0023">merge</font></h3>
+<p>
+Combina diversas variantes. Cada rootfs é uma consequência de seu
+anterior. O primeiro rootfs é extraido da imagem ISO indicada como
+terceiro argumento. As variantes serão escolhidas no momento do boot,
+de acordo com a memória RAM disponível:
+</p>
+<pre>
+ # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
+</pre>
+
 <a name="emu-iso"></a> 
 <h3><font color="#6c0023">emu-iso</font></h3> 
 <p> 
@@ -252,6 +355,165 @@
  # tazlito burn-iso slitaz-hacked.iso
 </pre>
 
+<h2>FLAVORS</h2>
+<p>
+Um arquivo <i>.flavor</i> contém somente alguns poucos Kb de informação
+necessária para (re)construir um LiveCD customizado do SliTaz.
+</p>
+
+<a name="rebuild-flavor"></a>
+<h3><font color="#6c0023">(Re)construa uma variante</font></h3>
+<p>
+Você pode escolher uma variante para (re)construir a partir daquelas
+disponíveis:
+</p>
+<pre>
+# tazlito list-flavors
+
+List of flavors
+================================================================================
+Name              ISO   Rootfs  Description
+================================================================================
+base               6.9M  13.1M  Minimal set of packages to boot
+core-3in1         31.5M 105.6M  SliTaz core system with justX and base alternatives
+core              31.5M 104.6M  SliTaz core system
+eeepc             31.2M 105.4M  SliTaz eeepc system
+justX             16.1M  51.2M  SliTaz with a minimal X environment
+</pre>
+<p>
+Como exeplo, começaremos a reconstruir a variante <i>eeepc</i> que 
+ocupa 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M:
+</p>
+<pre>
+# tazlito clean-distro
+# tazlito get-flavor eeepc
+# tazlito gen-distro
+</pre>
+
+<a name="create-flavor"></a>
+<h3><font color="#6c0023">Crie uma variante</font></h3>
+<p>
+Para criar uma variante, você deve:
+</p>
+<ul>
+    <li>Criar uma imagem ISO usando o comando <b>tazlito-gen-distro</b>
+        e então criar um arquivo flavor usando <b>tazlito gen-flavor</b>; ou</li>
+    <li>Criar diretamente uma estrutura de arquivos que define o flavor
+        (veja <b>tazlito extract-flavor</b>) e então criar o flavor
+        usando <b>tazlito pack-flavor</b>.</li>
+</ul>
+
+<a name="publish-flavor"></a>
+<h3><font color="#6c0023">Publique uma variante</font></h3>
+<p>
+Um arquivo .flavor possui alguns Kb de tamanho, então você pode enviá-lo
+para a lista de discussão do SliTaz.
+</p>
+<p>
+Os arquivos resultantes do comando <b>tazlito extract flavor</b> pode 
+também ser colocado no repositório mercurial (http://repos.slitaz.org/flavors).
+Este método é preferido porque a estrutura de pastas poderá ser
+acessada diretamente por uma interface web.
+</p>
+<p>
+Esta estrutura inclui:
+</p>
+<ul>
+<li>
+Uma <b>receita</b> (arquivo <i>receipt</i>) que descreve a variante
+por intermédio das variáveis:
+  <ul>
+  <li>
+FLAVOR: O nome da variante.
+  </li>
+  <li>
+SHORT_DESC: Uma curta descrição
+  </li>
+  <li>
+VERSION: Versão.
+  </li>
+  <li>
+MAINTAINER: Email do desenvolvedor/criador.
+  </li>
+  <li>
+FRUGAL_RAM: Memória RAM mínima recomendável (variável opcional).
+  </li>
+  <li>
+ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM (opcional).
+  </li>
+  <li>
+INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CDROM (opcional).
+  </li>
+  <li>
+ISO_SIZE: Tamanho do CDROM (opcional).
+  </li>
+  <li>
+ROOTFS_SELECTION: Opcional, veja <i>Meta flavor</i> abaixo.
+  </li>
+  </ul>
+</li>
+<li>
+O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar
+uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis). 
+Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja 
+definida.
+</li>
+<li>
+O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais 
+(undigest) a serem incluidos para se obter pacotes personalizados.
+</li>
+<li>
+O diretório opcional <b>rootfs</b> contem uma estrutura de pastas e arquivos
+a serem adicionados ao sistema de arquivos rootfs.gz (normalmente serão
+arquivos de configuração).
+</li>
+<li>
+O diretório opcional <b>rootcd</b> contem uma estrutura de pastas e arquivos
+a serem adicionados ao CDROM.
+</li>
+</ul>
+
+<a name="tune-flavor"></a>
+<h3><font color="#6c0023">Adapte uma variante</font></h3>
+<p>
+Às vezes é mais fácil modificar uma variante existente do que criar uma
+nova. Para adaptar a variante eeepc, por exemplo:
+</p>
+<pre>
+# tazpkg get-install mercurial
+# cd /home/slitaz
+# hg clone http://hg.slitaz.org/flavors
+# cd flavors
+# cp -a eeepc myslitaz
+</pre>
+<p>
+Arquivos em <i>my-slitaz</i> podem ser adaptados, então:
+</p>
+<pre>
+# tazlito pack-flavor myslitaz
+</pre>
+<p>
+Isto irá criar uma nova variante adaptada de uma outra existente.
+</p>
+
+<a name="meta-flavor"></a>
+<h3><font color="#6c0023">Meta flavor</font></h3>
+<p>
+Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se
+iniciar o sistema com uma meta variante, uma variante contida no LiveCD
+irá ser chamada dependendo do tamanho da memória RAM disponível. A 
+variável ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os
+parametros das variantes existentes. Exemplo usando a meta variante
+<a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"></a>:
+</p>
+<pre>
+ROOTFS_SELECTION="160M core 96M justX 32M base"
+</pre>
+<p>
+Este tipo de variante não possui uma lista de pacotes (packages.list)
+e só é suportada no SliTaz a partir do kernel 2.6.30.
+</p>
+
 <h2>MANTENEDOR</h2>
 <p>
 Christophe Lincoln &lt;pankso at slitaz.org&gt;