tazlito annotate doc/tazlito.fr.html @ rev 117

Add English manual from website (thanks Paul)
author Christophe Lincoln <pankso@slitaz.org>
date Sun Jan 17 18:51:48 2010 +0100 (2010-01-17)
parents
children e97f3622d93a
rev   line source
pankso@117 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@117 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@117 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
pankso@117 4 <head>
pankso@117 5 <title>Tazlito Manual - SliTaz Live Tool</title>
pankso@117 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@117 7 <meta name="description" content="" />
pankso@117 8 <meta name="expires" content="never" />
pankso@117 9 <meta name="modified" content="2007-08-03 13:26:42" />
pankso@117 10 <style type="text/css"><!--
pankso@117 11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
pankso@117 12 #header { background: #f0ba08; color: black; height: 50px;
pankso@117 13 border-top: 1px solid black; border-bottom: 1px solid black; }
pankso@117 14 #content { margin: 0px 50px 26px 50px; }
pankso@117 15 h1 { margin: 14px 0px 0px 16px; }
pankso@117 16 li { line-height: 1.4em; }
pankso@117 17 pre { padding: 5px; color: black; background: #e1e0b0; }
pankso@117 18 pre.script { padding: 10px; color: black; background: #e8e8e8;
pankso@117 19 border: 1px inset #333333; }
pankso@117 20 code { font-size: 100%; color: #669900; background: transparent; }
pankso@117 21 hr { color: white; background: white; height: 1px; border: 0; }
pankso@117 22 --></style>
pankso@117 23 </head>
pankso@117 24 <body bgcolor="#ffffff">
pankso@117 25 <div id="header">
pankso@117 26 <h1><font color="#3e1220">Tazlito Manual</font></h1>
pankso@117 27 </div>
pankso@117 28 <hr />
pankso@117 29 <!-- Start content -->
pankso@117 30 <div id="content">
pankso@117 31
pankso@117 32 <h2>NOM</h2>
pankso@117 33 <p>
pankso@117 34 Tazlito - SliTaz Live Tool.
pankso@117 35 </p>
pankso@117 36
pankso@117 37 <h2>SYNTAXE</h2>
pankso@117 38 <pre>
pankso@117 39 tazlito [command] [list|iso|flavor] [dir]
pankso@117 40 </pre>
pankso@117 41
pankso@117 42 <h2>DESCRIPTION</h2>
pankso@117 43 <p>
pankso@117 44 Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire
pankso@117 45 l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne
pankso@117 46 aussi la possibilité de générer une distribution depuis une liste de paquets
pankso@117 47 préalablements téléchargés et stockés dans un répertoire. Pour fonctionner,
pankso@117 48 l'application Tazlito utilise un fichier de configuration système
pankso@117 49 /etc/slitaz-tools/tazlito.conf ou un fichier tazlito.conf se trouvant dans le
pankso@117 50 répertoire courant. Ce fichier de configuration peut facilement être généré
pankso@117 51 automatiquement par Tazlito, il spécifie le nom de l'image ISO, le nom du
pankso@117 52 volume, le préparateur, le chemin vers le repositoire des paquets et celui
pankso@117 53 vers la distribution. Tazlito permet aussi de configurer un répertoire
pankso@117 54 contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors
pankso@117 55 de la génération de la distribution.
pankso@117 56 </p>
pankso@117 57 <p>
pankso@117 58 Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur
pankso@117 59 SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez
pankso@117 60 aussi un complément d'informations au sujet de création de sa propre version
pankso@117 61 du LiveCD, via le livre de cuisine (Cookbook) de SliTaz
pankso@117 62 (http://www.slitaz.org/doc/cookbook/) et le Handbook.
pankso@117 63 </p>
pankso@117 64
pankso@117 65 <h2>COMMANDES</h2>
pankso@117 66 <a name="usage"></a>
pankso@117 67 <h3><font color="#6c0023">usage</font></h3>
pankso@117 68 <p>
pankso@117 69 La commande 'usage' affiche une liste des commandes disponibles avec une
pankso@117 70 courte description :
pankso@117 71 </p>
pankso@117 72 <pre>
pankso@117 73 # tazlito usage
pankso@117 74 </pre>
pankso@117 75 <a name="stats"></a>
pankso@117 76 <h3><font color="#6c0023">stats</font></h3>
pankso@117 77 <p>
pankso@117 78 Stats affiche les variables de configuration, le chemin vers les différents
pankso@117 79 fichiers et répertoires et les informations sur l'image ISO :
pankso@117 80 </p>
pankso@117 81 <pre>
pankso@117 82 # tazlito stats
pankso@117 83 </pre>
pankso@117 84 <a name="gen-config"></a>
pankso@117 85 <h3><font color="#6c0023">gen-config</font></h3>
pankso@117 86 <p>
pankso@117 87 La commande 'gen-config' vous permet de générer une fichier de configuration
pankso@117 88 prêt à être édité. Par défaut le fichier est créé dans le répertoire courant
pankso@117 89 et peut aussi l'être dans un autre répertoire si spécifié :
pankso@117 90 </p>
pankso@117 91 <pre>
pankso@117 92 # tazlito gen-config
pankso@117 93 # tazlito gen-config /path/to/distro
pankso@117 94 </pre>
pankso@117 95 <a name="configure"></a>
pankso@117 96 <h3><font color="#6c0023">configure</font></h3>
pankso@117 97 <p>
pankso@117 98 La commande configure permet de configurer le fichier de configuration
pankso@117 99 système ou celui trouvé dans le répertoire courant :
pankso@117 100 </p>
pankso@117 101 <pre>
pankso@117 102 # tazlito configure
pankso@117 103 </pre>
pankso@117 104 <a name="gen-iso"></a>
pankso@117 105 <h3><font color="#6c0023">gen-iso</font></h3>
pankso@117 106 <p>
pankso@117 107 La commande 'gen-iso' pour <em>Generate ISO</em> permet de générer une nouvelle
pankso@117 108 image ISO du LiveCD suite à des modifications et ajouter dans le système
pankso@117 109 racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire
pankso@117 110 contenant la structure du système Live, cette structure peur facilement être
pankso@117 111 construite avec la commande 'extract-distro', modifiée et reconstruite via :
pankso@117 112 </p>
pankso@117 113 <pre>
pankso@117 114 # tazlito gen-iso
pankso@117 115 </pre>
pankso@117 116 <a name="gen-initiso"></a>
pankso@117 117 <h3><font color="#6c0023">gen-initiso</font></h3>
pankso@117 118 <p>
pankso@117 119 La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en
pankso@117 120 reconstruisant préalablement l'initramfs compressé du système. L'initramfs
pankso@117 121 contient tous le système racine de la distribution et doit être reconstruite
pankso@117 122 en cas de modifications sur les fichiers.
pankso@117 123 </p>
pankso@117 124 <pre>
pankso@117 125 # tazlito gen-initiso
pankso@117 126 </pre>
pankso@117 127 <a name="list-flavors"></a>
pankso@117 128 <h3><font color="#6c0023">list-flavors</font></h3>
pankso@117 129 <p>
pankso@117 130 La commande 'list-flavors' télécharge si nécessaire et affiche la liste des
pankso@117 131 différentes saveurs disponibles. On peut forcer le téléchargement avec
pankso@117 132 '--recharge'.
pankso@117 133 </p>
pankso@117 134 <pre>
pankso@117 135 # tazlito list-flavors
pankso@117 136 # tazlito list-flavors --recharge
pankso@117 137 </pre>
pankso@117 138 <a name="get-flavor"></a>
pankso@117 139 <h3><font color="#6c0023">get-flavor</font></h3>
pankso@117 140 <p>
pankso@117 141 La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers
pankso@117 142 nécessaires à 'gen-distro' pour refabriquer une saveur.
pankso@117 143 </p>
pankso@117 144 <pre>
pankso@117 145 # tazlito get-flavor saveur-particuliere
pankso@117 146 </pre>
pankso@117 147 <a name="show-flavor"></a>
pankso@117 148 <h3><font color="#6c0023">show-flavor</font></h3>
pankso@117 149 <p>
pankso@117 150 La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses
pankso@117 151 dimensions après refabrication. Les options '--brief' et '--noheader' réduisent
pankso@117 152 l'affichage produit.
pankso@117 153 </p>
pankso@117 154 <pre>
pankso@117 155 # tazlito show-flavor saveur-particuliere
pankso@117 156 # tazlito show-flavor saveur-particuliere --brief
pankso@117 157 # tazlito show-flavor saveur-particuliere --brief --noheader
pankso@117 158 </pre>
pankso@117 159 <a name="gen-flavor"></a>
pankso@117 160 <h3><font color="#6c0023">gen-flavor</font></h3>
pankso@117 161 <p>
pankso@117 162 La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur
pankso@117 163 à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor
pankso@117 164 produit pourra être ensuite envoyé à slitaz.org.
pankso@117 165 </p>
pankso@117 166 <pre>
pankso@117 167 # tazlito gen-flavor nouvelle-saveur
pankso@117 168 </pre>
pankso@117 169 <a name="gen-liveflavor"></a>
pankso@117 170 <h3><font color="#6c0023">gen-liveflavor</font></h3>
pankso@117 171 <p>
pankso@117 172 La commande 'gen-liveflavor' crée une image ISO et un fichier de description
pankso@117 173 d'une nouvelle saveur à partir de la distribution courante. Un fichier texte
pankso@117 174 optionnel permetde décrire les modifications à faire par rapport à la
pankso@117 175 distribution courante. Le format de chacune de ses lignes est
pankso@117 176 [code][tabulation][caractères]. Les valeurs possibles de code sont +,-,@,! et ?
pankso@117 177 pour ajouter un paquet, le retirer, décrire la saveur, ajouter un paquet non
pankso@117 178 libre, et afficher un message à l'écran.
pankso@117 179 </p>
pankso@117 180 <pre>
pankso@117 181 # tazlito gen-liveflavor nouvelle-saveur
pankso@117 182 # tazlito gen-liveflavor autre-saveur mes-modifications
pankso@117 183 # cat mes-modifications
pankso@117 184 @ Developper tools and some non-free packages
pankso@117 185 + slitaz-toolchain
pankso@117 186 + mercurial
pankso@117 187 ! skype
pankso@117 188 ! flash-plugin
pankso@117 189 </pre>
pankso@117 190 <a name="extract-distro"></a>
pankso@117 191 <h3><font color="#6c0023">extract-distro</font></h3>
pankso@117 192 <p>
pankso@117 193 La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
pankso@117 194 LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
pankso@117 195 Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
pankso@117 196 reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
pankso@117 197 d'utilisation :
pankso@117 198 </p>
pankso@117 199 <pre>
pankso@117 200 # tazlito extract-distro slitaz-cooking.iso
pankso@117 201 </pre>
pankso@117 202 <a name="gen-distro"></a>
pankso@117 203 <h3><font color="#6c0023">gen-distro</font></h3>
pankso@117 204 <p>
pankso@117 205 La commande <em>Generate Distribution</em> permet de générer la structure du
pankso@117 206 système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
pankso@117 207 commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
pankso@117 208 paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
pankso@117 209 La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
pankso@117 210 Si l'on utilise le Live-CD, les options --cdrom et --iso=<image-iso> permettent
pankso@117 211 de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
pankso@117 212 de les télécharger et récupère les fichiers additionnels du Live-CD.
pankso@117 213 Le chemin vers les différents répertoires sont à configurer dans le fichier de
pankso@117 214 configuration utilisé et les paquets peuvent être téléchargés depuis les
pankso@117 215 miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
pankso@117 216 </p>
pankso@117 217 <pre>
pankso@117 218 # tazlito gen-distro
pankso@117 219 # tazlito gen-distro --cdrom
pankso@117 220 # tazlito gen-distro --iso=slitaz.iso
pankso@117 221 # tazlito gen-distro package-list
pankso@117 222 </pre>
pankso@117 223 <a name="clean-distro"></a>
pankso@117 224 <h3><font color="#6c0023">clean-distro</font></h3>
pankso@117 225 <p>
pankso@117 226 Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
pankso@117 227 </p>
pankso@117 228 <pre>
pankso@117 229 # tazlito clean-distro
pankso@117 230 </pre>
pankso@117 231 <a name="check-distro"></a>
pankso@117 232 <h3><font color="#6c0023">check-distro</font></h3>
pankso@117 233 <p>
pankso@117 234 Cette commande permet simplement de vérifier si les fichiers non installés par
pankso@117 235 des paquets, sont bien présents dans la distro :
pankso@117 236 </p>
pankso@117 237 <pre>
pankso@117 238 # tazlito check-distro
pankso@117 239 </pre>
pankso@117 240
pankso@117 241 <a name="emu-iso"></a>
pankso@117 242 <h3><font color="#6c0023">emu-iso</font></h3>
pankso@117 243 <p>
pankso@117 244 La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
pankso@117 245 SliTaz. Qemu est permet de tester l'image ISO fraîchement construite sans
pankso@117 246 la graver sur cdrom ou redémarrer en mode frugal.
pankso@117 247 </p>
pankso@117 248 <pre>
pankso@117 249 # tazlito emu-iso
pankso@117 250 # tazlito emu-iso path/to/image.iso
pankso@117 251 </pre>
pankso@117 252
pankso@117 253 <a name="burn-iso"></a>
pankso@117 254 <h3><font color="#6c0023">burn-iso</font></h3>
pankso@117 255 <p>
pankso@117 256 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
pankso@117 257 l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
pankso@117 258 du fichier de configuration courant, mais il est possible de spécifier une
pankso@117 259 autre image via la ligne de commande :
pankso@117 260 </p>
pankso@117 261 <pre>
pankso@117 262 # tazlito burn-iso
pankso@117 263 # tazlito burn-iso slitaz-hacked.iso
pankso@117 264 </pre>
pankso@117 265
pankso@117 266 <h2>MAINTENEUR</h2>
pankso@117 267 <p>
pankso@117 268 Christophe Lincoln &lt;pankso at slitaz.org&gt;
pankso@117 269 </p>
pankso@117 270
pankso@117 271 <!-- End content -->
pankso@117 272 </div>
pankso@117 273 </body>
pankso@117 274 </html>