SliTaz Repositories

     1.1 --- a/fr/doc/manuals/tazlito.html	Tue Feb 09 13:59:46 2010 +0100
     1.2 +++ b/fr/doc/manuals/tazlito.html	Tue Feb 09 15:07:13 2010 +0100
     1.3 @@ -67,40 +67,44 @@
     1.4  <h3><font color="#6c0023">usage</font></h3>
     1.5  <p>
     1.6  La commande 'usage' affiche une liste des commandes disponibles avec une
     1.7 -courte description :
     1.8 +courte description&nbsp;:
     1.9  </p>
    1.10  <pre>
    1.11   # tazlito usage
    1.12  </pre>
    1.13 +
    1.14  <a name="stats"></a>
    1.15  <h3><font color="#6c0023">stats</font></h3>
    1.16  <p>
    1.17  Stats affiche les variables de configuration, le chemin vers les différents
    1.18 -fichiers et répertoires et les informations sur l'image ISO :
    1.19 +fichiers et répertoires et les informations sur l'image ISO&nbsp;:
    1.20  </p>
    1.21  <pre>
    1.22   # tazlito stats
    1.23  </pre>
    1.24 +
    1.25  <a name="gen-config"></a>
    1.26  <h3><font color="#6c0023">gen-config</font></h3>
    1.27  <p>
    1.28  La commande 'gen-config' vous permet de générer une fichier de configuration
    1.29  prêt à être édité. Par défaut le fichier est créé dans le répertoire courant
    1.30 -et peut aussi l'être dans un autre répertoire si spécifié :
    1.31 +et peut aussi l'être dans un autre répertoire si spécifié&nbsp;:
    1.32  </p>
    1.33  <pre>
    1.34   # tazlito gen-config
    1.35   # tazlito gen-config /path/to/distro
    1.36  </pre>
    1.37 +
    1.38  <a name="configure"></a>
    1.39  <h3><font color="#6c0023">configure</font></h3>
    1.40  <p>
    1.41  La commande configure permet de configurer le fichier de configuration
    1.42 -système ou celui trouvé dans le répertoire courant :
    1.43 +système ou celui trouvé dans le répertoire courant&nbsp;:
    1.44  </p>
    1.45  <pre>
    1.46   # tazlito configure
    1.47  </pre>
    1.48 +
    1.49  <a name="gen-iso"></a>
    1.50  <h3><font color="#6c0023">gen-iso</font></h3>
    1.51  <p>
    1.52 @@ -108,11 +112,12 @@
    1.53  image ISO du LiveCD suite à des modifications et ajouter dans le système
    1.54  racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire
    1.55  contenant la structure du système Live, cette structure peur facilement être
    1.56 -construite avec la commande 'extract-distro', modifiée et reconstruite via :
    1.57 +construite avec la commande 'extract-distro', modifiée et reconstruite via&nbsp;:
    1.58  </p>
    1.59  <pre>
    1.60   # tazlito gen-iso
    1.61  </pre>
    1.62 +
    1.63  <a name="gen-initiso"></a>
    1.64  <h3><font color="#6c0023">gen-initiso</font></h3>
    1.65  <p>
    1.66 @@ -124,6 +129,7 @@
    1.67  <pre>
    1.68   # tazlito gen-initiso
    1.69  </pre>
    1.70 +
    1.71  <a name="list-flavors"></a>
    1.72  <h3><font color="#6c0023">list-flavors</font></h3>
    1.73  <p>
    1.74 @@ -144,6 +150,7 @@
    1.75  <pre>
    1.76   # tazlito get-flavor saveur-particuliere 
    1.77  </pre>
    1.78 +
    1.79  <a name="show-flavor"></a>
    1.80  <h3><font color="#6c0023">show-flavor</font></h3>
    1.81  <p>
    1.82 @@ -156,6 +163,7 @@
    1.83   # tazlito show-flavor saveur-particuliere --brief
    1.84   # tazlito show-flavor saveur-particuliere --brief --noheader
    1.85  </pre>
    1.86 +
    1.87  <a name="gen-flavor"></a>
    1.88  <h3><font color="#6c0023">gen-flavor</font></h3>
    1.89  <p>
    1.90 @@ -166,6 +174,116 @@
    1.91  <pre>
    1.92   # tazlito gen-flavor nouvelle-saveur
    1.93  </pre>
    1.94 +
    1.95 +<a name="gen-liveflavor"></a>
    1.96 +<h3><font color="#6c0023">gen-liveflavor</font></h3>
    1.97 +<p>
    1.98 +La commande 'gen-liveflavor' crée une image ISO et un fichier de description
    1.99 +d'une nouvelle saveur à partir de la distribution courante. Un fichier texte
   1.100 +optionnel permetde décrire les modifications à faire par rapport à la
   1.101 +distribution courante. Le format de chacune de ses lignes est 
   1.102 +[code][tabulation][caractères]. Les valeurs possibles de code sont +,-,@,! et ?
   1.103 +pour ajouter un paquet, le retirer, décrire la saveur, ajouter un paquet non
   1.104 +libre, et afficher un message à l'écran.
   1.105 +</p>
   1.106 +<pre>
   1.107 + # tazlito gen-liveflavor nouvelle-saveur
   1.108 + # tazlito gen-liveflavor autre-saveur mes-modifications
   1.109 + # cat mes-modifications
   1.110 + @      Developper tools and some non-free packages
   1.111 + +      slitaz-toolchain
   1.112 + +      mercurial
   1.113 + !      skype
   1.114 + !      flash-plugin
   1.115 +</pre>
   1.116 +
   1.117 +<a name="upgrade-flavor"></a>
   1.118 +<h3><font color="#6c0023">upgrade-flavor</font></h3>
   1.119 +<p>
   1.120 +La commande 'upgrade-flavor' raffraîchit une saveur consue pour une ancienne
   1.121 +version de SliTaz en mettant à jour la liste des paquets avec les dernières
   1.122 +versions des paquets disponibles.
   1.123 +</p>
   1.124 +<pre>
   1.125 + # tazlito upgrade-flavor une-saveur
   1.126 +</pre>
   1.127 +
   1.128 +<a name="extract-flavor"></a>
   1.129 +<h3><font color="#6c0023">extract-flavor</font></h3>
   1.130 +<p>
   1.131 +La commande 'extract-flavor' convertit une saveur en une arborescence
   1.132 +facilement modifiable dans /home/slitaz/flavors/<saveur> qui pourra être gérée
   1.133 +avec Mercurial dans http://hg.slitaz.org/flavors.
   1.134 +</p>
   1.135 +<p>
   1.136 +Cette arborescence comprend :
   1.137 +</p>
   1.138 +<ul>
   1.139 +<li>
   1.140 +Le fichier <b>receipt</b> décrit la saveur grâce aux variables&nbsp;:
   1.141 +  <ul>
   1.142 +  <li>
   1.143 +  <i>FLAVOR</i> : le nom de la saveur.
   1.144 +  </li>
   1.145 +  <li>
   1.146 +  <i>SHORT_DESC</i> : la description en une ligne.
   1.147 +  </li>
   1.148 +  <li>
   1.149 +  <i>VERSION</i> : format libre.
   1.150 +  </li>
   1.151 +  <li>
   1.152 +  <i>MAINTAINER</i> : adresse email.
   1.153 +  </li>
   1.154 +  <li>
   1.155 +  <i>FRUGAL_RAM</i> : optionnel (peut être estimé), RAM minimum nécessaire.
   1.156 +  </li>
   1.157 +  <li>
   1.158 +  <i>ROOTFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
   1.159 +  </li>
   1.160 +  <li>
   1.161 +  <i>INITRAMFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
   1.162 +  </li>
   1.163 +  <li>
   1.164 +  <i>ISO_SIZE</i> : optionnel (peut être estimé). Taille du CD-ROM.
   1.165 +  </li>
   1.166 +  <li>
   1.167 +  <i>ROOTFS_SELECTION</i> : optionnel, voir <i>Meta saveur</i> plus bas.
   1.168 +  </li>
   1.169 +  </ul>
   1.170 +</li>
   1.171 +<li>
   1.172 +Le fichier <b>packages.list</b> contenant la liste des paquets sans
   1.173 +préciser leur version (tazlito utilisera la dernière disponible)
   1.174 +Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
   1.175 +</li>
   1.176 +<li>
   1.177 +Le fichier optionnel <b>mirrors</b> contenant la liste des miroirs non 
   1.178 +officiels (undigest) à ajouter pour inclure des paquets personnels.
   1.179 +</li>
   1.180 +<li>
   1.181 +Le répertoire optionnel <b>rootfs</b> contenant l'arborescence à ajouter dans
   1.182 +le système de fichier racine rootfs.gz (des fichiers de configuretion 
   1.183 +habituellement).
   1.184 +</li>
   1.185 +<li>
   1.186 +Le répertoire optionnel <b>rootcd</b> contenant l'arborescence à ajouter dans
   1.187 +la racine du CD-ROM.
   1.188 +</li>
   1.189 +</ul>
   1.190 +<pre>
   1.191 + # tazlito extract-flavor une-saveur
   1.192 +</pre>
   1.193 +
   1.194 +<a name="pack-flavor"></a>
   1.195 +<h3><font color="#6c0023">pack-flavor</font></h3>
   1.196 +<p>
   1.197 +La commande 'pack-flavor' convertit une arborescence de /home/slitaz/flavors/ 
   1.198 +en saveur (.flavor). Soit l'opération inverse de <i>tazlito extract-flavor</i>.
   1.199 +</p>
   1.200 +<pre>
   1.201 + # tazlito pack-flavor une-saveur
   1.202 +</pre>
   1.203 +
   1.204  <a name="extract-distro"></a>
   1.205  <h3><font color="#6c0023">extract-distro</font></h3>
   1.206  <p>
   1.207 @@ -173,7 +291,7 @@
   1.208  LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
   1.209  Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
   1.210  reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
   1.211 -d'utilisation :
   1.212 +d'utilisation&nbsp;:
   1.213  </p>
   1.214  <pre>
   1.215   # tazlito extract-distro slitaz-cooking.iso
   1.216 @@ -186,12 +304,12 @@
   1.217  commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
   1.218  paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
   1.219  La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
   1.220 -Si l'on utilise le Live-CD, les options --cdrom et --iso=image-iso permettent
   1.221 +Si l'on utilise le Live-CD, les options --cdrom et --iso=<image-iso> permettent
   1.222  de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
   1.223  de les télécharger et récupère les fichiers additionnels du Live-CD.
   1.224  Le chemin vers les différents répertoires sont à configurer dans le fichier de
   1.225  configuration utilisé et les paquets peuvent être téléchargés depuis les
   1.226 -miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
   1.227 +miroirs de SliTaz ou générés par Tazwok. Pour générer une distro&nbsp;:
   1.228  </p>
   1.229  <pre>
   1.230   # tazlito gen-distro
   1.231 @@ -202,55 +320,190 @@
   1.232  <a name="clean-distro"></a>
   1.233  <h3><font color="#6c0023">clean-distro</font></h3>
   1.234  <p>
   1.235 -Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
   1.236 +Supprime tous les fichiers générés ou extraits de la structure du LiveCD&nbsp;:
   1.237  </p>
   1.238  <pre>
   1.239   # tazlito clean-distro
   1.240  </pre>
   1.241 -<a name="addhacker"></a>
   1.242 -<h3><font color="#6c0023">addhacker</font></h3>
   1.243 -<p>
   1.244 -La commande 'addhacker' permet d'ajouter l'utilisateur Hacker à la distribution,
   1.245 -cela permet d'avoir un compte utilisateur sans mot de passe. A noter que cette
   1.246 -commande effectue un changement de permissions sur tous les fichiers contenus
   1.247 -dans <code>/home/hacker</code> :
   1.248 -</p>
   1.249 -<pre>
   1.250 - # tazlito addhacker
   1.251 -</pre>
   1.252  <a name="check-distro"></a>
   1.253  <h3><font color="#6c0023">check-distro</font></h3>
   1.254  <p>
   1.255  Cette commande permet simplement de vérifier si les fichiers non installés par
   1.256 -des paquets, sont bien présents dans la distro :
   1.257 +des paquets, sont bien présents dans la distro&nbsp;:
   1.258  </p>
   1.259  <pre>
   1.260   # tazlito check-distro
   1.261  </pre>
   1.262 +
   1.263 +<a name="frugal-install"></a>
   1.264 +<h3><font color="#6c0023">frugal-install</font></h3>
   1.265 +<p>
   1.266 +Installe les fichiers nécessaire du CD-ROM dans /boot/frugal.
   1.267 +</p>
   1.268 +<pre>
   1.269 + # tazlito frugal-install slitaz.iso
   1.270 +</pre>
   1.271 +
   1.272 +<a name="check-list"></a>
   1.273 +<h3><font color="#6c0023">check-list</font></h3>
   1.274 +<p>
   1.275 +Vérifie si distro-packages.list est à jour avec les dernières version des paquets.
   1.276 +</p>
   1.277 +<pre>
   1.278 + # tazlito check-list
   1.279 +</pre>
   1.280 +
   1.281 +<a name="repack"></a>
   1.282 +<h3><font color="#6c0023">repack</font></h3>
   1.283 +<p>
   1.284 +Recompresse le(s) rootfs avec la meilleure compression possible.
   1.285 +</p>
   1.286 +<pre>
   1.287 + # tazlito repack slitaz.iso
   1.288 +</pre>
   1.289 +
   1.290 +<a name="merge"></a>
   1.291 +<h3><font color="#6c0023">merge</font></h3>
   1.292 +<p>
   1.293 +Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
   1.294 +est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
   1.295 +ISO en 2e paramètre.
   1.296 +La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
   1.297 +disponible.
   1.298 +</p>
   1.299 +<pre>
   1.300 + # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
   1.301 +</pre>
   1.302 +
   1.303  <a name="emu-iso"></a>
   1.304  <h3><font color="#6c0023">emu-iso</font></h3>
   1.305  <p>
   1.306 -La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer 
   1.307 -SliTaz. Qemu est permet de tester l'image ISO fraîchement construite sans
   1.308 +La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
   1.309 +SliTaz. Qemu permet de tester l'image ISO fraîchement construite sans
   1.310  la graver sur cdrom ou redémarrer en mode frugal.
   1.311  </p>
   1.312  <pre>
   1.313   # tazlito emu-iso
   1.314   # tazlito emu-iso path/to/image.iso
   1.315  </pre>
   1.316 +
   1.317  <a name="burn-iso"></a>
   1.318  <h3><font color="#6c0023">burn-iso</font></h3>
   1.319  <p>
   1.320  Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
   1.321  l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
   1.322  du fichier de configuration courant, mais il est possible de spécifier une
   1.323 -autre image via la ligne de commande :
   1.324 +autre image via la ligne de commande&nbsp;:
   1.325  </p>
   1.326  <pre>
   1.327   # tazlito burn-iso
   1.328   # tazlito burn-iso slitaz-hacked.iso
   1.329  </pre>
   1.330  
   1.331 +<h2>SAVEURS</h2>
   1.332 +<p>
   1.333 +Les fichiers <i>.flavor</i> contiennent en quelques Ko toutes les informations
   1.334 +nécessaires pour refabriquer un Live CD customisé de SliTaz.
   1.335 +</p>
   1.336 +<a name="rebuild-flavor"></a>
   1.337 +<h3><font color="#6c0023">Refabriquer une saveur</font></h3>
   1.338 +<p>
   1.339 +On choisit la saveur à refabriquer parmi celles disponibles.
   1.340 +</p>
   1.341 +<pre>
   1.342 +# tazlito list-flavors   
   1.343 +
   1.344 +List of flavors
   1.345 +================================================================================
   1.346 +Name              ISO   Rootfs  Description
   1.347 +================================================================================
   1.348 +base               6.9M  13.1M  Minimal set of packages to boot
   1.349 +core-3in1         31.5M 105.6M  SliTaz core system with justX and base alternatives
   1.350 +core              31.5M 104.6M  SliTaz core system
   1.351 +eeepc             31.2M 105.4M  SliTaz eeepc system
   1.352 +justX             16.1M  51.2M  SliTaz with a minimal X environnement
   1.353 +</pre>
   1.354 +<p>
   1.355 +Nous allons refabriquer la saveur <i>eeepc</i> dont le système de fichier utilise
   1.356 +105.4M de RAM et le CD-ROM fait 31.2M.
   1.357 +</p>
   1.358 +<pre>
   1.359 +# tazlito clean-distro
   1.360 +# tazlito get-flavor eeepc
   1.361 +# tazlito gen-distro
   1.362 +</pre>
   1.363 +
   1.364 +<a name="create-flavor"></a>
   1.365 +<h3><font color="#6c0023">Créer une saveur</font></h3>
   1.366 +<p>
   1.367 +Pour créer une saveur, il faut :
   1.368 +</p>
   1.369 +<ul>
   1.370 +<li>
   1.371 +Soit créer une image ISO avec <b>tazlito gen-distro</b> puis créer la saveur
   1.372 +correspondante avec <b>tazlito gen-flavor</b>.
   1.373 +</li>
   1.374 +<li>
   1.375 +Soit créer directement l'arboscence qui définie la saveur (voir la commande
   1.376 +<b>tazlito extract-flavor</b>) puis créer la saveur avec 
   1.377 +<b>tazlito pack-flavor</b>.
   1.378 +</li>
   1.379 +</ul>
   1.380 +
   1.381 +<a name="publish-flavor"></a>
   1.382 +<h3><font color="#6c0023">Publier une saveur</font></h3>
   1.383 +<p>
   1.384 +Les fichiers .flavor ne font généralement que quelques Ko. Il peuvent être
   1.385 +envoyés via la liste de diffusion de SliTaz.
   1.386 +</p>
   1.387 +<p>
   1.388 +Le résultat de <b>tazlito extract-flavor</b> peut aussi être mis dans mercurial
   1.389 +(http://repos.slitaz.org/flavors). Cette méthode est préférable car l'arborescence
   1.390 +sera directement visible avec l'interface web de mercurial.
   1.391 +</p>
   1.392 +
   1.393 +<a name="tune-flavor"></a>
   1.394 +<h3><font color="#6c0023">Adapter une saveur</font></h3>
   1.395 +<p>
   1.396 +Il est souvent plus simple de modifier une saveur existante que d'en créer une
   1.397 +ex-nihilo. Pour adapter la saveur eeepc par exemple&nbsp;:
   1.398 +</p>
   1.399 +<pre>
   1.400 +# tazpkg get-install mercurial
   1.401 +# cd /home/slitaz
   1.402 +# hg clone http://hg.slitaz.org/flavors
   1.403 +# cd flavors
   1.404 +# cp -a eeepc myslitaz
   1.405 +</pre>
   1.406 +<p>
   1.407 +Les fichiers dans myslitaz peuvent être adaptés, puis
   1.408 +</p>
   1.409 +<pre>
   1.410 +# tazlito pack-flavor myslitaz
   1.411 +</pre>
   1.412 +<p>
   1.413 +Créera simplement la nouvelle saveur.
   1.414 +</p>
   1.415 +
   1.416 +<a name="meta-flavor"></a>
   1.417 +<h3><font color="#6c0023">Meta saveur</font></h3>
   1.418 +<p>
   1.419 +Une meta saveur contient plusieurs saveurs imbriquées comme des poupées russes.
   1.420 +La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
   1.421 +disponible.
   1.422 +La variable <i>ROOTFS_SELECTION</i> définit les couples (quantité de RAM minimun,
   1.423 +saveur correspondante), <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt">
   1.424 +exemple</a>&nbsp;:
   1.425 +</p>
   1.426 +<pre>
   1.427 +ROOTFS_SELECTION="160M core 96M justX 32M base" 
   1.428 +</pre>
   1.429 +<p>
   1.430 +Une meta saveur n'a pas de liste de paquets <i>(packages.list)</i>.
   1.431 +Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les
   1.432 +meta saveur.
   1.433 +</p>
   1.434 +
   1.435  <h2>MAINTENEUR</h2>
   1.436  <p>
   1.437  Christophe Lincoln &lt;pankso at slitaz.org&gt;