website diff doc/manuals/tazlito.html @ rev 4

French doc with Handbook and Cookbook
author Christophe Lincoln <pankso@slitaz.org>
date Sat Mar 29 12:01:05 2008 +0100 (2008-03-29)
parents
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/manuals/tazlito.html	Sat Mar 29 12:01:05 2008 +0100
     1.3 @@ -0,0 +1,235 @@
     1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     1.5 +	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     1.7 +<head>
     1.8 +	<title>Tazlito Manual - SliTaz Live Tool</title>
     1.9 +	<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    1.10 +	<meta name="description" content="" />
    1.11 +	<meta name="expires" content="never" />
    1.12 +	<meta name="modified" content="2007-08-03 13:26:42" />
    1.13 +	<style type="text/css"><!--
    1.14 +	body { font: 90% sans-serif, vernada, arial; margin: 0; }
    1.15 +	#header { background: #f0ba08; color: black; height: 50px;
    1.16 +		border-top: 1px solid black; border-bottom: 1px solid black; }
    1.17 +	#content { margin: 0px 50px 26px 50px; }
    1.18 +	h1 { margin: 14px 0px 0px 16px; }
    1.19 +	li { line-height: 1.4em; }
    1.20 +	pre { padding: 5px; color: black; background: #e1e0b0; }
    1.21 +	pre.script { padding: 10px; color: black; background: #e8e8e8;
    1.22 +		border: 1px inset #333333; }
    1.23 +	code { font-size: 100%; color: #669900; background: transparent; }
    1.24 +	hr { color: white; background: white; height: 1px; border: 0; }
    1.25 +	--></style>
    1.26 +</head>
    1.27 +<body bgcolor="#ffffff">
    1.28 +<div id="header">
    1.29 +<h1><font color="#3e1220">Tazlito Manual</font></h1>
    1.30 +</div>
    1.31 +<hr />
    1.32 +<!-- Start content -->
    1.33 +<div id="content">
    1.34 +
    1.35 +<h2>NOM</h2>
    1.36 +<p>
    1.37 +Tazlito - SliTaz Live Tool.
    1.38 +</p>
    1.39 +
    1.40 +<h2>SYNTAXE</h2>
    1.41 +<pre>
    1.42 +tazlito [command] [list|iso|flavor] [dir]
    1.43 +</pre>
    1.44 +
    1.45 +<h2>DESCRIPTION</h2>
    1.46 +<p>
    1.47 +Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire
    1.48 +l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne
    1.49 +aussi la possibilité de générer une distribution depuis une liste de paquets
    1.50 +préalablements téléchargés et stockés dans un répertoire. Pour fonctionner,
    1.51 +l'application Tazlito utilise un fichier de configuration système
    1.52 +/etc/slitaz-tools/tazlito.conf ou un fichier tazlito.conf se trouvant dans le
    1.53 +répertoire courant. Ce fichier de configuration peut facilement être généré
    1.54 +automatiquement par Tazlito, il spécifie le nom de l'image ISO, le nom du
    1.55 +volume, le préparateur, le chemin vers le repositoire des paquets et celui
    1.56 +vers la distribution. Tazlito permet aussi de configurer un répertoire
    1.57 +contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors
    1.58 +de la génération de la distribution.
    1.59 +</p>
    1.60 +<p>
    1.61 +Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur 
    1.62 +SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez 
    1.63 +aussi un complément d'informations au sujet de création de sa propre version
    1.64 +du LiveCD, via le livre de cuisine (Cookbook) de SliTaz
    1.65 +(http://www.slitaz.org/doc/cookbook/) et le Handbook.
    1.66 +</p>
    1.67 +
    1.68 +<h2>COMMANDES</h2>
    1.69 +<h3><font color="#6c0023">usage</font></h3>
    1.70 +<p>
    1.71 +La commande 'usage' affiche une liste des commandes disponibles avec une
    1.72 +courte description :
    1.73 +</p>
    1.74 +<pre>
    1.75 + # tazlito usage
    1.76 +</pre>
    1.77 +<h3><font color="#6c0023">stats</font></h3>
    1.78 +<p>
    1.79 +Stats affiche les variables de configuration, le chemin vers les différents
    1.80 +fichiers et répertoires et les informations sur l'image ISO :
    1.81 +</p>
    1.82 +<pre>
    1.83 + # tazlito stats
    1.84 +</pre>
    1.85 +<h3><font color="#6c0023">gen-config</font></h3>
    1.86 +<p>
    1.87 +La commande 'gen-config' vous permet de générer une fichier de configuration
    1.88 +prêt à être édité. Par défaut le fichier est créé dans le répertoire courant
    1.89 +et peut aussi l'être dans un autre répertoire si spécifié :
    1.90 +</p>
    1.91 +<pre>
    1.92 + # tazlito gen-config
    1.93 + # tazlito gen-config /path/to/distro
    1.94 +</pre>
    1.95 +<h3><font color="#6c0023">configure</font></h3>
    1.96 +<p>
    1.97 +La commande configure permet de configurer le fichier de configuration
    1.98 +système ou celui trouvé dans le répertoire courant :
    1.99 +</p>
   1.100 +<pre>
   1.101 + # tazlito configure
   1.102 +</pre>
   1.103 +<h3><font color="#6c0023">gen-iso</font></h3>
   1.104 +<p>
   1.105 +La commande 'gen-iso' pour <em>Generate ISO</em> permet de générer une nouvelle
   1.106 +image ISO du LiveCD suite à des modifications et ajouter dans le système
   1.107 +racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire
   1.108 +contenant la structure du système Live, cette structure peur facilement être
   1.109 +construite avec la commande 'extract-distro', modifiée et reconstruite via :
   1.110 +</p>
   1.111 +<pre>
   1.112 + # tazlito gen-iso
   1.113 +</pre>
   1.114 +<h3><font color="#6c0023">gen-initiso</font></h3>
   1.115 +<p>
   1.116 +La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en
   1.117 +reconstruisant préalablement l'initramfs compressé du système. L'initramfs
   1.118 +contient tous le système racine de la distribution et doit être reconstruite
   1.119 +en cas de modifications sur les fichiers.
   1.120 +</p>
   1.121 +<pre>
   1.122 + # tazlito gen-initiso
   1.123 +</pre>
   1.124 +<h3><font color="#6c0023">list-flavors</font></h3>
   1.125 +<p>
   1.126 +La commande 'list-flavors' télécharge si nécessaire et affiche la liste des
   1.127 +différentes saveurs disponibles. On peut forcer le téléchargement avec
   1.128 +'--recharge'.
   1.129 +</p>
   1.130 +<pre>
   1.131 + # tazlito list-flavors
   1.132 + # tazlito list-flavors --recharge
   1.133 +</pre>
   1.134 +<h3><font color="#6c0023">get-flavor</font></h3>
   1.135 +<p>
   1.136 +La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers
   1.137 +nécessaires à 'gen-distro' pour refabriquer une saveur. 
   1.138 +</p>
   1.139 +<pre>
   1.140 + # tazlito get-flavor saveur-particuliere 
   1.141 +</pre>
   1.142 +<h3><font color="#6c0023">show-flavor</font></h3>
   1.143 +<p>
   1.144 +La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses
   1.145 +dimensions après refabrication. Les options '--brief' et '--noheader' réduisent
   1.146 +l'affichage produit.
   1.147 +</p>
   1.148 +<pre>
   1.149 + # tazlito show-flavor saveur-particuliere 
   1.150 + # tazlito show-flavor saveur-particuliere --brief
   1.151 + # tazlito show-flavor saveur-particuliere --brief --noheader
   1.152 +</pre>
   1.153 +<h3><font color="#6c0023">gen-flavor</font></h3>
   1.154 +<p>
   1.155 +La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur
   1.156 +à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor
   1.157 +produit pourra être ensuite envoyé à slitaz.org.
   1.158 +</p>
   1.159 +<pre>
   1.160 + # tazlito gen-flavor nouvelle-saveur
   1.161 +</pre>
   1.162 +<h3><font color="#6c0023">extract-distro</font></h3>
   1.163 +<p>
   1.164 +La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
   1.165 +LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
   1.166 +Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
   1.167 +reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
   1.168 +d'utilisation :
   1.169 +</p>
   1.170 +<pre>
   1.171 + # tazlito extract-distro slitaz-cooking.iso
   1.172 +</pre>
   1.173 +<h3><font color="#6c0023">gen-distro</font></h3>
   1.174 +<p>
   1.175 +La commande <em>Generate Distribution</em> permet de générer la structure du
   1.176 +système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
   1.177 +commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
   1.178 +paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
   1.179 +La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
   1.180 +Si l'on utilise le Live-CD, les options --cdrom et --iso=<image-iso> permettent
   1.181 +de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
   1.182 +de les télécharger et récupère les fichiers additionnels du Live-CD.
   1.183 +Le chemin vers les différents répertoires sont à configurer dans le fichier de
   1.184 +configuration utilisé et les paquets peuvent être téléchargés depuis les
   1.185 +miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
   1.186 +</p>
   1.187 +<pre>
   1.188 + # tazlito gen-distro
   1.189 + # tazlito gen-distro --cdrom
   1.190 + # tazlito gen-distro --iso=slitaz.iso
   1.191 + # tazlito gen-distro package-list
   1.192 +</pre>
   1.193 +<h3><font color="#6c0023">clean-distro</font></h3>
   1.194 +<p>
   1.195 +Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
   1.196 +</p>
   1.197 +<pre>
   1.198 + # tazlito clean-distro
   1.199 +</pre>
   1.200 +<h3><font color="#6c0023">addhacker</font></h3>
   1.201 +<p>
   1.202 +La commande 'addhacker' permet d'ajouter l'utilisateur Hacker à la distribution,
   1.203 +cela permet d'avoir un compte utilisateur sans mot de passe. A noter que cette
   1.204 +commande effectue un changement de permissions sur tous les fichiers contenus
   1.205 +dans <code>/home/hacker</code> :
   1.206 +</p>
   1.207 +<pre>
   1.208 + # tazlito addhacker
   1.209 +</pre>
   1.210 +<h3><font color="#6c0023">check-distro</font></h3>
   1.211 +<p>
   1.212 +Cette commande permet simplement de vérifier si les fichiers non installés par
   1.213 +des paquets, sont bien présents dans la distro :
   1.214 +</p>
   1.215 +<pre>
   1.216 + # tazlito check-distro
   1.217 +</pre>
   1.218 +<h3><font color="#6c0023">burn-iso</font></h3>
   1.219 +<p>
   1.220 +Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
   1.221 +l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
   1.222 +du fichier de configuration courant, mais il est possible de spécifier une
   1.223 +autre image via la ligne de commande :
   1.224 +</p>
   1.225 +<pre>
   1.226 + # tazlito burn-iso
   1.227 + # tazlito burn-iso slitaz-hacked.iso
   1.228 +</pre>
   1.229 +
   1.230 +<h2>MAINTENEUR</h2>
   1.231 +<p>
   1.232 +Christophe Lincoln &lt;pankso at slitaz.org&gt;
   1.233 +</p>
   1.234 +
   1.235 +<!-- End content -->
   1.236 +</div>
   1.237 +</body>
   1.238 +</html>