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

Use /home/slitaz/VERSION as work directory
author Christophe Lincoln <pankso@slitaz.org>
date Thu Feb 24 14:08:19 2011 +0100 (2011-02-24)
parents deb4940afbdd
children 24e40c1edb67
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@211 9 <meta name="modified" content="2011-02-24 13:30:00" />
pankso@117 10 <style type="text/css"><!--
pankso@211 11 body { font: 90% sans-serif, vernada, arial; margin: 0;
pankso@211 12 border-top: 34px solid #f1f1f1; }
pankso@211 13 #header { background: #351a0a; color: black; height: 50px;
pankso@117 14 border-top: 1px solid black; border-bottom: 1px solid black; }
pankso@117 15 #content { margin: 0px 50px 26px 50px; }
pankso@211 16 h1 { margin: 14px 0px 0px 16px; color: #fff; margin: 10px; }
pankso@211 17 h3 { font-weight: bold; color: #666666; }
pankso@117 18 li { line-height: 1.4em; }
pankso@211 19 pre { padding: 5px; color: black; background: #e1e0b0;
pankso@211 20 border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; }
pankso@117 21 code { font-size: 100%; color: #669900; background: transparent; }
pankso@117 22 hr { color: white; background: white; height: 1px; border: 0; }
pankso@117 23 --></style>
pankso@117 24 </head>
pankso@117 25 <body bgcolor="#ffffff">
pankso@117 26 <div id="header">
pankso@211 27 <h1>Tazlito Manual</h1>
pankso@117 28 </div>
pankso@211 29 <hr />
pankso@117 30 <!-- Start content -->
pankso@117 31 <div id="content">
pankso@117 32
pankso@117 33 <h2>NOM</h2>
pankso@117 34 <p>
pankso@117 35 Tazlito - SliTaz Live Tool.
pankso@117 36 </p>
pankso@117 37
pankso@117 38 <h2>SYNTAXE</h2>
pankso@117 39 <pre>
pankso@117 40 tazlito [command] [list|iso|flavor] [dir]
pankso@117 41 </pre>
pankso@117 42
pankso@117 43 <h2>DESCRIPTION</h2>
pankso@117 44 <p>
pankso@117 45 Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire
pankso@117 46 l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne
pankso@117 47 aussi la possibilité de générer une distribution depuis une liste de paquets
pankso@117 48 préalablements téléchargés et stockés dans un répertoire. Pour fonctionner,
pankso@117 49 l'application Tazlito utilise un fichier de configuration système
pascal@158 50 /etc/tazlito/tazlito.conf ou un fichier tazlito.conf se trouvant dans le
pankso@117 51 répertoire courant. Ce fichier de configuration peut facilement être généré
pankso@117 52 automatiquement par Tazlito, il spécifie le nom de l'image ISO, le nom du
pankso@117 53 volume, le préparateur, le chemin vers le repositoire des paquets et celui
pankso@117 54 vers la distribution. Tazlito permet aussi de configurer un répertoire
pankso@117 55 contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors
pankso@117 56 de la génération de la distribution.
pankso@117 57 </p>
pankso@117 58 <p>
pankso@117 59 Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur
pankso@117 60 SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez
pankso@117 61 aussi un complément d'informations au sujet de création de sa propre version
pankso@117 62 du LiveCD, via le livre de cuisine (Cookbook) de SliTaz
pankso@117 63 (http://www.slitaz.org/doc/cookbook/) et le Handbook.
pankso@117 64 </p>
pankso@117 65
pankso@117 66 <h2>COMMANDES</h2>
pankso@117 67 <a name="usage"></a>
pankso@211 68 <h3>usage</h3>
pankso@117 69 <p>
pankso@117 70 La commande 'usage' affiche une liste des commandes disponibles avec une
pascal@155 71 courte description&nbsp;:
pankso@117 72 </p>
pankso@117 73 <pre>
pankso@117 74 # tazlito usage
pankso@117 75 </pre>
pascal@155 76
pankso@117 77 <a name="stats"></a>
pankso@211 78 <h3>stats</h3>
pankso@117 79 <p>
pankso@117 80 Stats affiche les variables de configuration, le chemin vers les différents
pascal@155 81 fichiers et répertoires et les informations sur l'image ISO&nbsp;:
pankso@117 82 </p>
pankso@117 83 <pre>
pankso@117 84 # tazlito stats
pankso@117 85 </pre>
pascal@155 86
pankso@117 87 <a name="gen-config"></a>
pankso@211 88 <h3>gen-config</h3>
pankso@117 89 <p>
pankso@117 90 La commande 'gen-config' vous permet de générer une fichier de configuration
pankso@117 91 prêt à être édité. Par défaut le fichier est créé dans le répertoire courant
pascal@155 92 et peut aussi l'être dans un autre répertoire si spécifié&nbsp;:
pankso@117 93 </p>
pankso@117 94 <pre>
pankso@117 95 # tazlito gen-config
pankso@117 96 # tazlito gen-config /path/to/distro
pankso@117 97 </pre>
pascal@155 98
pankso@117 99 <a name="configure"></a>
pankso@211 100 <h3>configure</h3>
pankso@117 101 <p>
pankso@117 102 La commande configure permet de configurer le fichier de configuration
pascal@155 103 système ou celui trouvé dans le répertoire courant&nbsp;:
pankso@117 104 </p>
pankso@117 105 <pre>
pankso@117 106 # tazlito configure
pankso@117 107 </pre>
pascal@155 108
pankso@117 109 <a name="gen-iso"></a>
pankso@211 110 <h3>gen-iso</h3>
pankso@117 111 <p>
pankso@117 112 La commande 'gen-iso' pour <em>Generate ISO</em> permet de générer une nouvelle
pankso@117 113 image ISO du LiveCD suite à des modifications et ajouter dans le système
pankso@117 114 racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire
pankso@117 115 contenant la structure du système Live, cette structure peur facilement être
pascal@155 116 construite avec la commande 'extract-distro', modifiée et reconstruite via&nbsp;:
pankso@117 117 </p>
pankso@117 118 <pre>
pankso@117 119 # tazlito gen-iso
pankso@117 120 </pre>
pascal@155 121
pankso@117 122 <a name="gen-initiso"></a>
pankso@211 123 <h3>gen-initiso</h3>
pankso@117 124 <p>
pankso@117 125 La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en
pankso@117 126 reconstruisant préalablement l'initramfs compressé du système. L'initramfs
pankso@117 127 contient tous le système racine de la distribution et doit être reconstruite
pankso@117 128 en cas de modifications sur les fichiers.
pankso@117 129 </p>
pankso@117 130 <pre>
pankso@117 131 # tazlito gen-initiso
pankso@117 132 </pre>
pascal@155 133
pankso@117 134 <a name="list-flavors"></a>
pankso@211 135 <h3>list-flavors</h3>
pankso@117 136 <p>
pankso@117 137 La commande 'list-flavors' télécharge si nécessaire et affiche la liste des
pankso@117 138 différentes saveurs disponibles. On peut forcer le téléchargement avec
pankso@117 139 '--recharge'.
pankso@117 140 </p>
pankso@117 141 <pre>
pankso@117 142 # tazlito list-flavors
pankso@117 143 # tazlito list-flavors --recharge
pankso@117 144 </pre>
pankso@117 145 <a name="get-flavor"></a>
pankso@211 146 <h3>get-flavor</h3>
pankso@117 147 <p>
pankso@117 148 La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers
pankso@117 149 nécessaires à 'gen-distro' pour refabriquer une saveur.
pankso@117 150 </p>
pankso@117 151 <pre>
pankso@117 152 # tazlito get-flavor saveur-particuliere
pankso@117 153 </pre>
pascal@155 154
pankso@117 155 <a name="show-flavor"></a>
pankso@211 156 <h3>show-flavor</h3>
pankso@117 157 <p>
pankso@117 158 La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses
pankso@117 159 dimensions après refabrication. Les options '--brief' et '--noheader' réduisent
pankso@117 160 l'affichage produit.
pankso@117 161 </p>
pankso@117 162 <pre>
pankso@117 163 # tazlito show-flavor saveur-particuliere
pankso@117 164 # tazlito show-flavor saveur-particuliere --brief
pankso@117 165 # tazlito show-flavor saveur-particuliere --brief --noheader
pankso@117 166 </pre>
pascal@155 167
pankso@117 168 <a name="gen-flavor"></a>
pankso@211 169 <h3>gen-flavor</h3>
pankso@117 170 <p>
pankso@117 171 La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur
pankso@117 172 à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor
pankso@117 173 produit pourra être ensuite envoyé à slitaz.org.
pankso@117 174 </p>
pankso@117 175 <pre>
pankso@117 176 # tazlito gen-flavor nouvelle-saveur
pankso@117 177 </pre>
pascal@155 178
pankso@117 179 <a name="gen-liveflavor"></a>
pankso@211 180 <h3>gen-liveflavor</h3>
pankso@117 181 <p>
pankso@117 182 La commande 'gen-liveflavor' crée une image ISO et un fichier de description
pankso@117 183 d'une nouvelle saveur à partir de la distribution courante. Un fichier texte
pankso@117 184 optionnel permetde décrire les modifications à faire par rapport à la
pankso@117 185 distribution courante. Le format de chacune de ses lignes est
pankso@117 186 [code][tabulation][caractères]. Les valeurs possibles de code sont +,-,@,! et ?
pankso@117 187 pour ajouter un paquet, le retirer, décrire la saveur, ajouter un paquet non
pankso@117 188 libre, et afficher un message à l'écran.
pankso@117 189 </p>
pankso@117 190 <pre>
pankso@117 191 # tazlito gen-liveflavor nouvelle-saveur
pankso@117 192 # tazlito gen-liveflavor autre-saveur mes-modifications
pankso@117 193 # cat mes-modifications
pankso@117 194 @ Developper tools and some non-free packages
pankso@117 195 + slitaz-toolchain
pankso@117 196 + mercurial
pascal@155 197 ! skype
pascal@155 198 ! flash-plugin
pankso@117 199 </pre>
pascal@155 200
pascal@155 201 <a name="upgrade-flavor"></a>
pankso@211 202 <h3>upgrade-flavor</h3>
pascal@155 203 <p>
pascal@155 204 La commande 'upgrade-flavor' raffraîchit une saveur consue pour une ancienne
pascal@155 205 version de SliTaz en mettant à jour la liste des paquets avec les dernières
pascal@155 206 versions des paquets disponibles.
pascal@155 207 </p>
pascal@155 208 <pre>
pascal@155 209 # tazlito upgrade-flavor une-saveur
pascal@155 210 </pre>
pascal@155 211
pascal@155 212 <a name="extract-flavor"></a>
pankso@211 213 <h3>extract-flavor</h3>
pascal@155 214 <p>
pascal@155 215 La commande 'extract-flavor' convertit une saveur en une arborescence
pankso@212 216 facilement modifiable dans /home/slitaz/VERSION/flavors qui pourra être gérée
pankso@212 217 avec Mercurial dans <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
pankso@212 218 Par exemple sur une cooking le répértoire de travail sera /home/slitaz/cooking/flavors.
pascal@155 219 </p>
pascal@155 220 <pre>
pascal@155 221 # tazlito extract-flavor une-saveur
pascal@155 222 </pre>
pascal@155 223
pascal@155 224 <a name="pack-flavor"></a>
pankso@211 225 <h3>pack-flavor</h3>
pascal@155 226 <p>
pankso@212 227 La commande 'pack-flavor' convertit une arborescence de /home/slitaz/VERSION/flavors
pascal@155 228 en saveur (.flavor). Soit l'opération inverse de <i>tazlito extract-flavor</i>.
pascal@155 229 </p>
pascal@155 230 <pre>
pascal@155 231 # tazlito pack-flavor une-saveur
pascal@155 232 </pre>
pascal@155 233
pankso@117 234 <a name="extract-distro"></a>
pankso@211 235 <h3>extract-distro</h3>
pankso@117 236 <p>
pankso@117 237 La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
pankso@117 238 LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
pankso@117 239 Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
pankso@117 240 reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
pascal@155 241 d'utilisation&nbsp;:
pankso@117 242 </p>
pankso@117 243 <pre>
pankso@117 244 # tazlito extract-distro slitaz-cooking.iso
pankso@117 245 </pre>
pankso@117 246 <a name="gen-distro"></a>
pankso@211 247 <h3>gen-distro</h3>
pankso@117 248 <p>
pankso@117 249 La commande <em>Generate Distribution</em> permet de générer la structure du
pankso@117 250 système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
pankso@117 251 commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
pankso@117 252 paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
pankso@117 253 La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
paul@159 254 Si l'on utilise le Live-CD, les options --cdrom et --iso='image-iso' permettent
pankso@117 255 de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
pankso@117 256 de les télécharger et récupère les fichiers additionnels du Live-CD.
pankso@117 257 Le chemin vers les différents répertoires sont à configurer dans le fichier de
pankso@117 258 configuration utilisé et les paquets peuvent être téléchargés depuis les
pascal@155 259 miroirs de SliTaz ou générés par Tazwok. Pour générer une distro&nbsp;:
pankso@117 260 </p>
pankso@117 261 <pre>
pankso@117 262 # tazlito gen-distro
pankso@117 263 # tazlito gen-distro --cdrom
pankso@117 264 # tazlito gen-distro --iso=slitaz.iso
pankso@117 265 # tazlito gen-distro package-list
pankso@117 266 </pre>
pankso@117 267 <a name="clean-distro"></a>
pankso@211 268 <h3>clean-distro</h3>
pankso@117 269 <p>
pascal@155 270 Supprime tous les fichiers générés ou extraits de la structure du LiveCD&nbsp;:
pankso@117 271 </p>
pankso@117 272 <pre>
pankso@117 273 # tazlito clean-distro
pankso@117 274 </pre>
pankso@117 275 <a name="check-distro"></a>
pankso@211 276 <h3>check-distro</h3>
pankso@117 277 <p>
pankso@117 278 Cette commande permet simplement de vérifier si les fichiers non installés par
pascal@155 279 des paquets, sont bien présents dans la distro&nbsp;:
pankso@117 280 </p>
pankso@117 281 <pre>
pankso@117 282 # tazlito check-distro
pankso@117 283 </pre>
pankso@117 284
pascal@158 285 <a name="writeiso"></a>
pankso@211 286 <h3>writeiso</h3>
pascal@158 287 <p>
pascal@158 288 Cette commande sauvegarde le système de fichier dans une archive cpio
pascal@158 289 (rootfs.gz) et génère une image ISO bootable. Writeiso peut être utilisé
pascal@158 290 avec une installation sur disque dur ou en mode live. Il sauvegarde aussi
pascal@158 291 votre répertoire /home. Cette commande vous permet de modifier de refabriquer
pascal@158 292 facilement votre propre LiveCD. Il suffit de démarrer le LiveCD, de modifier
pascal@158 293 les fichiers que vous voulez et de faire :
pascal@158 294 </p>
pascal@158 295 <pre>
pascal@158 296 # tazlito writeiso [gzip|lzma|none]
pascal@158 297 # tazlito writeiso gzip
pascal@158 298 # tazlito writeiso gzip image-name
pascal@158 299 </pre>
pascal@158 300
pascal@155 301 <a name="frugal-install"></a>
pankso@211 302 <h3>frugal-install</h3>
pascal@155 303 <p>
pascal@158 304 Installe les fichiers nécessaire du CD-ROM dans /boot/frugal et ajoute
pascal@158 305 une entée GRUB si nécessaire. En mode frugal, Slitaz fonctionne entièrement
pascal@158 306 en mémoire (RAM). Cela permet de tester une distribution sans graver d'ISO ou
pascal@158 307 d'avoir un OS de dépannage prêt lorsque l'ordinateur démarre.
pascal@158 308 Pour installer tous les fichiers nécessaires à partir d'une arborescence ou
pascal@158 309 d'une image ISO :
pascal@155 310 </p>
pascal@155 311 <pre>
pascal@155 312 # tazlito frugal-install slitaz.iso
pascal@158 313 # tazlito -fi slitaz.iso
pascal@155 314 </pre>
pascal@155 315
pascal@155 316 <a name="check-list"></a>
pankso@211 317 <h3>check-list</h3>
pascal@155 318 <p>
pascal@155 319 Vérifie si distro-packages.list est à jour avec les dernières version des paquets.
pascal@155 320 </p>
pascal@155 321 <pre>
pascal@155 322 # tazlito check-list
pascal@155 323 </pre>
pascal@155 324
pascal@155 325 <a name="repack"></a>
pankso@211 326 <h3>repack</h3>
pascal@155 327 <p>
pascal@155 328 Recompresse le(s) rootfs avec la meilleure compression possible.
pascal@155 329 </p>
pascal@155 330 <pre>
pascal@155 331 # tazlito repack slitaz.iso
pascal@155 332 </pre>
pascal@155 333
pascal@155 334 <a name="merge"></a>
pankso@211 335 <h3>merge</h3>
pascal@155 336 <p>
pascal@155 337 Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
pascal@155 338 est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
pascal@158 339 ISO en 3e paramètre.
pascal@155 340 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
pascal@155 341 disponible.
pascal@155 342 </p>
pascal@155 343 <pre>
pascal@155 344 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
pascal@155 345 </pre>
pascal@155 346
pascal@171 347 <a name="build-loram"></a>
pankso@211 348 <h3>build-loram</h3>
pascal@171 349 <p>
pascal@171 350 Crée une image ISO pour les machines avec peu de mémoire.
pascal@171 351 Le système de fichier racine peut soit être toujours chargé en mémoire ou peut
pascal@171 352 éventuellement rester sur le cdrom selon la mémoire disponible.
pascal@171 353 </p>
pascal@171 354 <pre>
pascal@171 355 # tazlito build-loram slitaz.iso loram.iso
pascal@171 356 # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom
pascal@171 357 </pre>
pascal@171 358
pankso@117 359 <a name="emu-iso"></a>
pankso@211 360 <h3>emu-iso</h3>
pankso@117 361 <p>
pascal@155 362 La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
pascal@155 363 SliTaz. Qemu permet de tester l'image ISO fraîchement construite sans
pankso@117 364 la graver sur cdrom ou redémarrer en mode frugal.
pankso@117 365 </p>
pankso@117 366 <pre>
pankso@117 367 # tazlito emu-iso
pankso@117 368 # tazlito emu-iso path/to/image.iso
pankso@117 369 </pre>
pankso@117 370
pankso@117 371 <a name="burn-iso"></a>
pankso@211 372 <h3>burn-iso</h3>
pankso@117 373 <p>
pankso@117 374 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
pankso@117 375 l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
pankso@117 376 du fichier de configuration courant, mais il est possible de spécifier une
pascal@155 377 autre image via la ligne de commande&nbsp;:
pankso@117 378 </p>
pankso@117 379 <pre>
pankso@117 380 # tazlito burn-iso
pankso@117 381 # tazlito burn-iso slitaz-hacked.iso
pankso@117 382 </pre>
pankso@117 383
pascal@155 384 <h2>SAVEURS</h2>
pascal@155 385 <p>
pascal@155 386 Les fichiers <i>.flavor</i> contiennent en quelques Ko toutes les informations
pascal@155 387 nécessaires pour refabriquer un Live CD customisé de SliTaz.
pascal@155 388 </p>
pascal@155 389 <a name="rebuild-flavor"></a>
pankso@211 390 <h3>Refabriquer une saveur</h3>
pascal@155 391 <p>
pascal@155 392 On choisit la saveur à refabriquer parmi celles disponibles.
pascal@155 393 </p>
pascal@155 394 <pre>
pascal@155 395 # tazlito list-flavors
pascal@155 396
pascal@155 397 List of flavors
pascal@155 398 ================================================================================
pascal@155 399 Name ISO Rootfs Description
pascal@155 400 ================================================================================
pascal@155 401 base 6.9M 13.1M Minimal set of packages to boot
pascal@155 402 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
pascal@155 403 core 31.5M 104.6M SliTaz core system
pascal@155 404 eeepc 31.2M 105.4M SliTaz eeepc system
pascal@155 405 justX 16.1M 51.2M SliTaz with a minimal X environnement
pascal@155 406 </pre>
pascal@155 407 <p>
pascal@155 408 Nous allons refabriquer la saveur <i>eeepc</i> dont le système de fichier utilise
pascal@155 409 105.4M de RAM et le CD-ROM fait 31.2M.
pascal@155 410 </p>
pascal@155 411 <pre>
pascal@155 412 # tazlito clean-distro
pascal@155 413 # tazlito get-flavor eeepc
pascal@155 414 # tazlito gen-distro
pascal@155 415 </pre>
pascal@155 416
pascal@155 417 <a name="create-flavor"></a>
pankso@211 418 <h3>Créer une saveur</h3>
pascal@155 419 <p>
pascal@155 420 Pour créer une saveur, il faut :
pascal@155 421 </p>
pascal@155 422 <ul>
pascal@155 423 <li>
pascal@155 424 Soit créer une image ISO avec <b>tazlito gen-distro</b> puis créer la saveur
pascal@155 425 correspondante avec <b>tazlito gen-flavor</b>.
pascal@155 426 </li>
pascal@155 427 <li>
pascal@155 428 Soit créer directement l'arboscence qui définie la saveur (voir la commande
pascal@155 429 <b>tazlito extract-flavor</b>) puis créer la saveur avec
pascal@155 430 <b>tazlito pack-flavor</b>.
pascal@155 431 </li>
pascal@181 432 <li>Soit utiliser le
pascal@181 433 <a href="http://mirror.slitaz.org/pizza/">générateur de saveur en ligne</a> :
pascal@181 434 </li>
pascal@155 435 </ul>
pascal@155 436
pascal@155 437 <a name="publish-flavor"></a>
pankso@211 438 <h3>Publier une saveur</h3>
pascal@155 439 <p>
pascal@158 440 Les fichiers .flavor ne font généralement que quelques Ko. Ils peuvent être
pascal@155 441 envoyés via la liste de diffusion de SliTaz.
pascal@155 442 </p>
pascal@155 443 <p>
pascal@155 444 Le résultat de <b>tazlito extract-flavor</b> peut aussi être mis dans mercurial
pascal@155 445 (http://repos.slitaz.org/flavors). Cette méthode est préférable car l'arborescence
pascal@167 446 sera directement visible avec
pascal@167 447 <a href="http://hg.slitaz.org/flavors/file/tip">l'interface web de mercurial</a>.
pascal@155 448 </p>
pascal@158 449 <p>
pascal@158 450 Cette arborescence comprend :
pascal@158 451 </p>
pascal@158 452 <ul>
pascal@158 453 <li>
pascal@158 454 Le fichier <b>receipt</b> décrit la saveur grâce aux variables&nbsp;:
pascal@158 455 <ul>
pascal@158 456 <li>
pascal@158 457 <i>FLAVOR</i> : le nom de la saveur.
pascal@158 458 </li>
pascal@158 459 <li>
pascal@158 460 <i>SHORT_DESC</i> : la description en une ligne.
pascal@158 461 </li>
pascal@158 462 <li>
pascal@158 463 <i>VERSION</i> : format libre.
pascal@158 464 </li>
pascal@158 465 <li>
pascal@158 466 <i>MAINTAINER</i> : adresse email.
pascal@158 467 </li>
pascal@158 468 <li>
pascal@158 469 <i>FRUGAL_RAM</i> : optionnel (peut être estimé), RAM minimum nécessaire.
pascal@158 470 </li>
pascal@158 471 <li>
pascal@158 472 <i>ROOTFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
pascal@158 473 </li>
pascal@158 474 <li>
pascal@158 475 <i>INITRAMFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
pascal@158 476 </li>
pascal@158 477 <li>
pascal@158 478 <i>ISO_SIZE</i> : optionnel (peut être estimé). Taille du CD-ROM.
pascal@158 479 </li>
pascal@158 480 <li>
pascal@158 481 <i>ROOTFS_SELECTION</i> : optionnel, voir <i>Meta saveur</i> plus bas.
pascal@158 482 </li>
pascal@158 483 </ul>
pascal@158 484 </li>
pascal@158 485 <li>
pascal@158 486 Le fichier <b>packages.list</b> contenant la liste des paquets sans
pascal@158 487 préciser leur version (tazlito utilisera la dernière disponible)
pascal@158 488 Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
pascal@158 489 </li>
pascal@158 490 <li>
pascal@158 491 Le fichier optionnel <b>mirrors</b> contenant la liste des miroirs non
pascal@158 492 officiels (undigest) à ajouter pour inclure des paquets personnels.
pascal@158 493 </li>
pascal@158 494 <li>
pascal@158 495 Le répertoire optionnel <b>rootfs</b> contenant l'arborescence à ajouter dans
pascal@158 496 le système de fichier racine rootfs.gz (des fichiers de configuration
pascal@158 497 habituellement).
pascal@158 498 </li>
pascal@158 499 <li>
pascal@158 500 Le répertoire optionnel <b>rootcd</b> contenant l'arborescence à ajouter dans
pascal@158 501 la racine du CD-ROM.
pascal@158 502 </li>
pascal@158 503 </ul>
pascal@155 504
pascal@155 505 <a name="tune-flavor"></a>
pankso@211 506 <h3>Adapter une saveur</h3>
pascal@155 507 <p>
pascal@155 508 Il est souvent plus simple de modifier une saveur existante que d'en créer une
pascal@155 509 ex-nihilo. Pour adapter la saveur eeepc par exemple&nbsp;:
pascal@155 510 </p>
pascal@155 511 <pre>
pascal@155 512 # tazpkg get-install mercurial
pascal@155 513 # cd /home/slitaz
pascal@155 514 # hg clone http://hg.slitaz.org/flavors
pascal@155 515 # cd flavors
pascal@155 516 # cp -a eeepc myslitaz
pascal@155 517 </pre>
pascal@155 518 <p>
pascal@155 519 Les fichiers dans myslitaz peuvent être adaptés, puis
pascal@155 520 </p>
pascal@155 521 <pre>
pascal@155 522 # tazlito pack-flavor myslitaz
pascal@155 523 </pre>
pascal@155 524 <p>
pascal@155 525 Créera simplement la nouvelle saveur.
pascal@155 526 </p>
pascal@165 527 <p>
pascal@165 528 Astuce: on peut éviter l'installation de mercurial en extrayant une saveur.
pascal@165 529 L'exemple précédent dévient:
pascal@165 530 </p>
pascal@165 531 <pre>
pascal@165 532 # tazlito get-flavor eeepc
pascal@165 533 # tazlito extract-flavor eeepc.flavor
pascal@165 534 # cd /home/slitaz/flavors
pascal@165 535 # cp -a eeepc myslitaz
pascal@165 536 </pre>
pascal@155 537
pascal@155 538 <a name="meta-flavor"></a>
pankso@211 539 <h3>Meta saveur</h3>
pascal@155 540 <p>
pascal@155 541 Une meta saveur contient plusieurs saveurs imbriquées comme des poupées russes.
pascal@155 542 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
pascal@155 543 disponible.
pascal@155 544 La variable <i>ROOTFS_SELECTION</i> définit les couples (quantité de RAM minimun,
pascal@155 545 saveur correspondante), <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt">
pascal@155 546 exemple</a>&nbsp;:
pascal@155 547 </p>
pascal@155 548 <pre>
pascal@155 549 ROOTFS_SELECTION="160M core 96M justX 32M base"
pascal@155 550 </pre>
pascal@155 551 <p>
pascal@155 552 Une meta saveur n'a pas de liste de paquets <i>(packages.list)</i>.
pascal@155 553 Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les
pascal@158 554 meta saveurs.
pascal@155 555 </p>
pascal@155 556
pankso@117 557 <h2>MAINTENEUR</h2>
pankso@117 558 <p>
pankso@117 559 Christophe Lincoln &lt;pankso at slitaz.org&gt;
pankso@117 560 </p>
pankso@117 561
pankso@117 562 <!-- End content -->
pankso@117 563 </div>
pankso@117 564 </body>
pankso@117 565 </html>