SliTaz Repositories

     1.1 --- a/doc/handbook-stable/book.css	Fri Feb 06 23:17:00 2009 +0100
     1.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.3 @@ -1,170 +0,0 @@
     1.4 -/* 
     1.5 -	CSS style for SliTaz GNU/Linux *book.
     1.6 -	Pankso 2007 - www.slitaz.org
     1.7 -*/
     1.8 -
     1.9 -body {
    1.10 -	font: 13px sans-serif, vernada, arial;
    1.11 -	background: #222222;
    1.12 -	margin: 0;
    1.13 -	padding-bottom: 100%;
    1.14 -}
    1.15 -
    1.16 -#header {
    1.17 -	background: #BFB06B url(images/css/header.png) repeat-x top;
    1.18 -	color: black;
    1.19 -	height: 50px;
    1.20 -	border-top: 1px solid black;
    1.21 -	border-bottom: 1px solid black;
    1.22 -}
    1.23 -#quicknav {
    1.24 -	margin-right: 6px;
    1.25 -	text-align: right;
    1.26 -	font-size: 12px;
    1.27 -	}
    1.28 -#quicknav {
    1.29 -	margin-right: 6px;
    1.30 -}
    1.31 -
    1.32 -#quicknav a {
    1.33 -	background: inherit;
    1.34 -	color: #222222;
    1.35 -}
    1.36 -
    1.37 -#quicknav a:hover {
    1.38 -	background: inherit;
    1.39 -	color: #EDEDED;
    1.40 -}
    1.41 -
    1.42 -/*  content. */
    1.43 -
    1.44 -#content {
    1.45 -	background: white url(images/css/content-tl.png) no-repeat top left;
    1.46 -	color: black;
    1.47 -	padding: 20px;
    1.48 -	margin: 30px 50px 0px 50px;
    1.49 -	width: auto;
    1.50 -	text-align: justify;
    1.51 -}
    1.52 -
    1.53 -#content li {
    1.54 -	line-height: 1.5em;
    1.55 -	text-align: left;
    1.56 -}
    1.57 -
    1.58 -/*  Footer. */
    1.59 -
    1.60 -#footer {
    1.61 -	font-size: 11px;
    1.62 -	font-weight: bold;
    1.63 -	background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left;
    1.64 -	color: black;
    1.65 -	height: 20px;
    1.66 -	padding: 6px 0px 0px 10px;
    1.67 -	margin: 0px 50px 0px 50px;
    1.68 -	width: auto;
    1.69 -	text-align: center ;
    1.70 -}
    1.71 -
    1.72 -#footer a {
    1.73 -	text-decoration: none;
    1.74 -	background: #eaeaea;
    1.75 -	color: #3E1220;
    1.76 -}
    1.77 -
    1.78 -#footer a:hover {
    1.79 -	background: #eaeaea;
    1.80 -	color: #DF8F06;
    1.81 -}
    1.82 -
    1.83 -/* Legal information */
    1.84 -
    1.85 -#copy {
    1.86 -	font-size: 11px ;
    1.87 -	text-align: center ;
    1.88 -	background: transparent;
    1.89 -	color: #a8a8a8;
    1.90 -	padding-top: 20px;
    1.91 -}
    1.92 -
    1.93 -#copy a {
    1.94 -	background: inherit;
    1.95 -	color: #a8a8a8;
    1.96 -}
    1.97 -
    1.98 -#copy a:hover {
    1.99 -	background: inherit;
   1.100 -	color: #EDEDED;
   1.101 -}
   1.102 -
   1.103 -/* Div for round corners. */
   1.104 -
   1.105 -.content-right, .footer-right {
   1.106 -	width: 16px;
   1.107 -	color: white;
   1.108 -	background-color: #333333;
   1.109 -}
   1.110 -.content-right {
   1.111 -	background: url(images/css/content-tr.png) no-repeat top right;
   1.112 -	height: 16px;
   1.113 -	right: 50px;
   1.114 -	top: 82px;
   1.115 -	position: absolute;
   1.116 -}
   1.117 -
   1.118 -.footer-right {
   1.119 -	background: url(images/css/footer-br.png) no-repeat bottom right;
   1.120 -	height: 20px;
   1.121 -	float: right;
   1.122 -}
   1.123 -
   1.124 -/* General HTML entities for  content. */
   1.125 -
   1.126 -h1 {
   1.127 -	margin: 0px 0px 0px 16px;
   1.128 -}
   1.129 -
   1.130 -h2 {
   1.131 -	margin: 12px 0;
   1.132 -	color: #484B7C;
   1.133 -	background: white;
   1.134 -}
   1.135 -
   1.136 -h3 {
   1.137 -	font-weight: bold;
   1.138 -	color: #6c0023;
   1.139 -	background: white;
   1.140 -}
   1.141 -
   1.142 -a {
   1.143 -	text-decoration: underline;
   1.144 -}
   1.145 -a:hover {
   1.146 -	text-decoration: none;
   1.147 -}
   1.148 -
   1.149 -pre {
   1.150 -	padding: 5px;
   1.151 -	color: black;
   1.152 -	background: #e1e0b0;
   1.153 -}
   1.154 -pre.script {
   1.155 -	padding: 10px;
   1.156 -	color: black;
   1.157 -	background: #e8e8e8;
   1.158 -	border: 1px inset #333333;
   1.159 -}
   1.160 -
   1.161 -code {
   1.162 -	font-size: 12px;
   1.163 -	color: #669900;
   1.164 -	background: transparent;
   1.165 -}
   1.166 -
   1.167 -li {
   1.168 -	line-height: 1.4em;
   1.169 -}
   1.170 -
   1.171 -hr {
   1.172 -	border: 0pt none;
   1.173 -}

     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/doc/handbook-stable/chroot-env.html	Fri Feb 06 23:20:14 2009 +0100
     2.3 @@ -0,0 +1,196 @@
     2.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     2.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     2.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     2.7 +<head>
     2.8 +    <title>SliTaz Handbook - Chroot env</title>
     2.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    2.10 +    <meta name="description" content="SliTaz chroot environnement chrooté développer tester" />
    2.11 +    <meta name="expires" content="never" />
    2.12 +    <meta name="modified" content="2007-12-03 12:30:00" />
    2.13 +    <meta name="publisher" content="www.slitaz.org" />
    2.14 +    <meta name="author" content="Christophe Lincoln"/>
    2.15 +    <link rel="shortcut icon" href="favicon.ico" />
    2.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    2.17 +</head>
    2.18 +<body bgcolor="#ffffff">
    2.19 +
    2.20 +<!-- Header and quick navigation -->
    2.21 +<div id="header">
    2.22 +<div align="right" id="quicknav">
    2.23 +    <a name="top"></a>
    2.24 +    <a href="hacking-livecd.html">Hacking LiveCD</a> |
    2.25 +    <a href="index.html">Table des matières</a>
    2.26 +</div>
    2.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    2.28 +</div>
    2.29 +
    2.30 +<!-- Content. -->
    2.31 +<div id="content">
    2.32 +<div class="content-right"></div>
    2.33 +
    2.34 +<h2><font color="#DF8F06">Chroot environment</font></h2>
    2.35 +
    2.36 +<p>
    2.37 +Ce document décrit les étapes à réaliser pour créer un environnement chrooté,
    2.38 +afin de changer la racine du système pour travailler. Cela permet de compiler,
    2.39 +tester et développer SliTaz sans risques pour le système hôte depuis lequel
    2.40 +on travaille. Ce système hôte peut être SliTaz installée en dur ou tout autre
    2.41 +système GNU/Linux tel que Debian, Fedora, PCLinuxOS, etc. On peut aussi créer
    2.42 +un environnement chrooté en mode LiveCD associé à un media USB. Les seuls
    2.43 +prérequis sont d'avoir une image ISO de SliTaz à disposition et un peu de
    2.44 +temps. A noter que toutes les opérations sont réalisées en tant
    2.45 +qu'administrateur (<em>root</em>).
    2.46 +</p>
    2.47 +<h3><font color="#6c0023">Préparer l'environnement</font></h3>
    2.48 +<p>
    2.49 +Pour commencer, il faut extraire le contenu de l'image ISO dans le répertoire
    2.50 +qui va servir au chroot. Le répertoire de chroot peut se créer à l'endroit que
    2.51 +l'on veut, nous utilisons un répertoire <code>/home/slitaz/chroot-env</code>.
    2.52 +Pour extraire le contenu d'une image ISO, il faut la monter en <em>loop</em>
    2.53 +sur un répertoire, pour ensuite copier le système de fichiers racine
    2.54 +compressé (<code>rootfs.gz</code>) dans le répertoire de chroot. En
    2.55 +supposant que l'ISO est dans le répertoire courant :
    2.56 +</p>
    2.57 +<pre>
    2.58 + # mkdir /tmp/loop
    2.59 + # mount -o loop slitaz-cooking.iso /tmp/loop
    2.60 + # mkdir -p /home/slitaz/chroot-env
    2.61 + # cp /tmp/loop/boot/rootfs.gz \
    2.62 +   /home/slitaz/chroot-env
    2.63 + # umount /tmp/loop
    2.64 +</pre>
    2.65 +<p>
    2.66 +Maintenant qu'on a une copie du système de fichiers compressé, il faut le
    2.67 +décompresser et le désarchiver (c'est une archive <code>cpio</code> compressée
    2.68 +avec lzma ou gzip). Pour finir cette étape de préparation et continuer, on 
    2.69 +peut retirer le <code>rootfs</code> qui n'est plus utilisé :
    2.70 +</p>
    2.71 +<pre>
    2.72 + # cd /home/slitaz/chroot-env
    2.73 + # (zcat rootfs.gz 2>/dev/null || lzma d rootfs.gz -so) | cpio -id
    2.74 + # rm rootfs rootfs.gz
    2.75 +</pre>
    2.76 +<p>
    2.77 +Si le désarchivage du rootfs compressé avec LZMA échoue  en utilisant la 
    2.78 +première méthode vous pouvez utiliser:
    2.79 +</p>
    2.80 +<pre>
    2.81 + # unlzma rootfs.gz -S .gz 
    2.82 + # cat rootfs | cpio -id
    2.83 +</pre>
    2.84 +
    2.85 +<h3><font color="#6c0023">Utiliser l'environnement</font></h3>
    2.86 +<p>
    2.87 +Pour utiliser l'environnemnt chrooté, il suffit de monter quelques systèmes
    2.88 +de fichier virtuels et d'utiliser la commande <code>chroot</code>. Pour se
    2.89 +simplifier la vie on peut rapidement créer un petit script automatisant
    2.90 +le chroot. Exemple en utilisant le répertoire de chroot
    2.91 +<code>/home/slitaz/chroot-env</code> et en créant un script nommé
    2.92 +<code>chroot_in_env.sh</code> dans <code>/home/slitaz</code>. A noter que
    2.93 +le contenu du script n'a pas besoin d'être tapé mais simplement copié/coller
    2.94 +dans le terminal et que sur un autre système que SliTaz vous pouvez
    2.95 +décommenter les lignes montant/démontant <code>/dev</code> et
    2.96 +<code>/tmp</code> :
    2.97 +</p>
    2.98 +<pre>
    2.99 + # cat &gt; /home/slitaz/chroot_in_env.sh &lt;&lt; "EOF"
   2.100 +</pre>
   2.101 +<pre class="script">
   2.102 +#!/bin/sh
   2.103 +# Chroot in SliTaz to hack.
   2.104 +#
   2.105 +ROOTFS="/home/slitaz/chroot-env"
   2.106 +
   2.107 +# Mount virtual Kernel file systems and chroot.
   2.108 +#
   2.109 +#mount --bind /dev $ROOTFS/dev
   2.110 +#mount --bind /tmp $ROOTFS/tmp
   2.111 +mount -t proc proc $ROOTFS/proc
   2.112 +mount -t sysfs sysfs $ROOTFS/sys
   2.113 +mount -t devpts devpts $ROOTFS/dev/pts
   2.114 +mount -t tmpfs shm $ROOTFS/dev/shm
   2.115 +
   2.116 +echo "Chrooting in $ROOTFS... "
   2.117 +chroot $ROOTFS /bin/sh --login
   2.118 +
   2.119 +# Unmount virtual Kernel file systems on exit.
   2.120 +#
   2.121 +umount $ROOTFS/dev/shm
   2.122 +umount $ROOTFS/dev/pts
   2.123 +umount $ROOTFS/sys
   2.124 +umount $ROOTFS/proc
   2.125 +#umount $ROOTFS/tmp
   2.126 +#umount $ROOTFS/dev
   2.127 +
   2.128 +echo "Exiting of $ROOTFS chroot environment... "
   2.129 +
   2.130 +EOF
   2.131 +</pre>
   2.132 +<p>
   2.133 +Pour finir et tester l'environnement, il suffit de rendre le script exécutable
   2.134 +et le lancer :
   2.135 +</p>
   2.136 +<pre>
   2.137 + # chmod +x /home/slitaz/chroot_in_env.sh
   2.138 + # sh /home/slitaz/chroot_in_env.sh
   2.139 +</pre>
   2.140 +<h4>Activer le réseau</h4>
   2.141 +<p>
   2.142 +Pour avoir le réseau afin de télécharger, naviguer en mode texte et installer
   2.143 +des paquets de développement, il suffit de lancer le client DHCP sur la bonne
   2.144 +interface, exemple avec <code>eth1</code> :
   2.145 +</p>
   2.146 +<pre>
   2.147 + /# udhcpc -i eth1
   2.148 +</pre>
   2.149 +<h4>Installer des paquets</h4>
   2.150 +<p>
   2.151 +Si le réseau est fonctionnel, il suffit de recharger la liste des paquets et
   2.152 +utiliser <code>tazpkg get-install</code> pour installer de nouveaux paquets.
   2.153 +Si la connexion n'est pas possible, on peut télécharger les paquets du miroir
   2.154 +depuis un autre système, les copier dans l'environnement chrooté et les
   2.155 +installer via la commande <code>tazpkg install</code>. Pour installer la base
   2.156 +des outils de compilation :
   2.157 +</p>
   2.158 +<pre>
   2.159 + /# tazpkg recharge
   2.160 + /# tazpkg get-install slitaz-toolchain
   2.161 +</pre>
   2.162 +<p>
   2.163 +Une fois l'environnement configuré, on peut complier des applications
   2.164 +depuis les sources pour en créer des paquets, tester des scripts et autre.
   2.165 +Le chapitre <a href="development.html">développement</a> du Handbook et le
   2.166 +<a href="http://www.slitaz.org/doc/cookbook/">Cookbook</a> devraient aider à
   2.167 +aller plus loin.
   2.168 +</p>
   2.169 +<h4>Sortir de l'environnement</h4>
   2.170 +<p>
   2.171 +Pour sortir de l'environnement chrooté il suffit de taper <code>exit</code>,
   2.172 +le script <code>chroot_in_env.sh</code> va finir son rôle en démontant
   2.173 +le systèmes de fichiers virtuels propre au Kernel Linux :
   2.174 +</p>
   2.175 +<pre>
   2.176 + /# exit
   2.177 + #
   2.178 +</pre>
   2.179 +
   2.180 +<!-- End of content -->
   2.181 +</div>
   2.182 +
   2.183 +<!-- Footer. -->
   2.184 +<div id="footer">
   2.185 +	<div class="footer-right"></div>
   2.186 +	<a href="#top">Haut de la page</a> | 
   2.187 +	<a href="index.html">Table des matières</a>
   2.188 +</div>
   2.189 +
   2.190 +<div id="copy">
   2.191 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   2.192 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   2.193 +    Documentation publiées sous
   2.194 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   2.195 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   2.196 +</div>
   2.197 +
   2.198 +</body>
   2.199 +</html>

     3.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     3.2 +++ b/doc/handbook-stable/cmdline.html	Fri Feb 06 23:20:14 2009 +0100
     3.3 @@ -0,0 +1,363 @@
     3.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     3.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     3.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     3.7 +<head>
     3.8 +    <title>SliTaz Handbook - Ligne de commandes</title>
     3.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    3.10 +    <meta name="description" content="commande de base linux SliTaz help ls cd wget ligne de commandes console terminal xterm" />
    3.11 +    <meta name="expires" content="never" />
    3.12 +    <meta name="modified" content="2007-12-03 12:30:00" />
    3.13 +    <meta name="publisher" content="www.slitaz.org" />
    3.14 +    <meta name="author" content="Christophe Lincoln"/>
    3.15 +    <link rel="shortcut icon" href="favicon.ico" />
    3.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    3.17 +</head>
    3.18 +<body bgcolor="#ffffff">
    3.19 +
    3.20 +<!-- Header and quick navigation -->
    3.21 +<div id="header">
    3.22 +<div align="right" id="quicknav">
    3.23 +    <a name="top"></a>
    3.24 +    <a href="jwm.html">JWM</a> |
    3.25 +    <a href="index.html">Table des matières</a>
    3.26 +</div>
    3.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    3.28 +</div>
    3.29 +
    3.30 +<!-- Content. -->
    3.31 +<div id="content">
    3.32 +<div class="content-right"></div>
    3.33 +
    3.34 +<h2><font color="#DF8F06">Références en ligne de commandes (<em>cmdline</em>)</font></h2>
    3.35 +
    3.36 +<ul>
    3.37 +    <li><a href="#intro">Introduction aux commandes.</a></li>
    3.38 +    <li><a href="#help">Aide et liste des commandes disponibles.</a></li>
    3.39 +    <li><a href="#ls">Lister les fichiers contenus dans un répertoire.</a></li>
    3.40 +    <li><a href="#cd">Se déplacer dans les répertoires.</a></li>
    3.41 +    <li><a href="#cp">Copier des fichiers.</a></li>
    3.42 +    <li><a href="#mkdir">Créer de nouveaux répertoires.</a></li>
    3.43 +    <li><a href="#rm">Supprimer des fichiers ou des répertoires.</a></li>
    3.44 +    <li><a href="#read">Lire des fichiers.</a></li>
    3.45 +    <li><a href="#edit">Editer des fichiers en mode ncurses.</a></li>
    3.46 +    <li><a href="#cat">Cat</a> - &Eacute;diter en ligne de commandes.</li>
    3.47 +    <li><a href="#web-nav">Naviguer sur le web.</a></li>
    3.48 +    <li><a href="#irc-chat">Discuter sur les canaux IRC.</a></li>
    3.49 +    <li><a href="#wget">Télécharger des fichiers.</a></li>
    3.50 +    <li><a href="#partitions">Lister les partitions disponibles.</a></li>
    3.51 +    <li><a href="#mount">Monter une partition, un cdrom ou une clé USB.</a></li>
    3.52 +    <li><a href="#halt">Eteindre le système, ou redémarrer.</a></li>
    3.53 +</ul>
    3.54 +
    3.55 +<a name="intro"></a>
    3.56 +<h3><font color="#6c0023">Introduction aux commandes</font></h3>
    3.57 +<p>
    3.58 +Ce document se veut être un rapide référentiel pour utiliser SliTaz en ligne
    3.59 +commandes via un terminal Linux ou un terminal graphique (XTerm).
    3.60 +Vous disposez de nombreuses commandes GNU/Linux de manipulation des fichiers,
    3.61 +de maintenance système ou de gestion du réseau. Vous pouvez aussi naviguer sur
    3.62 +le web, chatter sur l'IRC, télécharger, éditer des scripts et même jouer en
    3.63 +mode texte. Note : il faut être <em>root</em> pour les opérations de montage 
    3.64 +de disques durs ou de cdrom. Vous pouvez utiliser la commande <code>su</code>
    3.65 +pour devenir administrateur système.
    3.66 +</p>
    3.67 +<a name="help"></a>
    3.68 +<h3><font color="#6c0023">Aide et liste des commandes disponibles</font></h3>
    3.69 +<p>
    3.70 +La plupart des commandes des systèmes GNU/Linux ont une option d'aide pour des
    3.71 +infos sur leur utilisation. Pour avoir de l'aide et connaître des informations 
    3.72 +sur l'utilisation d'une commande il faut taper le nom de la commande suivie 
    3.73 +de l'option <code>--help</code>. Exemple avec la commande de copie de fichiers
    3.74 +<code>cp</code> :
    3.75 +</p>
    3.76 +<pre>
    3.77 + $ cp --help
    3.78 +</pre>
    3.79 +<p>
    3.80 +Pour lister les commandes disponibles sur le système, vous pouvez simplement
    3.81 +taper 2 fois sur la touche de tabulation qui se trouve à gauche du clavier
    3.82 +et comporte 2 flèches horizontales et opposées. Pour connaître les commandes
    3.83 +fournient par Busybox, vous pouvez taper <code>help</code>.
    3.84 +</p>
    3.85 +<a name="ls"></a>
    3.86 +<h3><font color="#6c0023">Lister les fichiers contenus dans un répertoire</font></h3>
    3.87 +<p>
    3.88 +Pour lister les fichiers et les dossiers contenus dans un répertoire, vous 
    3.89 +pouvez utiliser la commande <code>ls</code>.  Pour connaître toutes les
    3.90 +possibilités, n'oubliez pas d'utiliser l'option <code>--help</code>. Pour
    3.91 +simplement lister les fichiers du répertoire courant :
    3.92 +</p>
    3.93 +<pre>
    3.94 + $ ls
    3.95 +</pre>
    3.96 +<p>
    3.97 +Lister tous les fichiers en utilisant l'option <code>-al</code> :
    3.98 +</p>
    3.99 +<pre>
   3.100 + $ ls -al
   3.101 +</pre>
   3.102 +<p>
   3.103 +Lister un répertoire donné:
   3.104 +</p>
   3.105 +<pre>
   3.106 + $ ls /home/slitaz
   3.107 +</pre>
   3.108 +<a name="cd"></a>
   3.109 +<h3><font color="#6c0023">Se déplacer dans les répertoires</font></h3>
   3.110 +<p>
   3.111 +Pour naviguer dans les fichiers vous pouvez utiliser la commande 
   3.112 +<code>cd</code> :
   3.113 +</p>
   3.114 +<pre>
   3.115 + $ cd /usr/share/doc
   3.116 + Revenir au réperoire parent :
   3.117 + $ cd ..
   3.118 +</pre>
   3.119 +<p>
   3.120 +Pour aller dans le répertoire de l'utilisateur (root = /root) :
   3.121 +</p>
   3.122 +<pre>
   3.123 + $ cd
   3.124 + Ou :
   3.125 + $ cd ~
   3.126 + Ou encore :
   3.127 + $ cd $HOME
   3.128 +</pre>
   3.129 +
   3.130 +<a name="cp"></a>
   3.131 +<h3><font color="#6c0023">Copier des fichiers</font></h3>
   3.132 +<p>
   3.133 +La commande <code>cp</code> copier des fichiers ou des dossiers. L'exemple
   3.134 +copie le fichier info.txt se trouve dans le répertoire courant, vers le 
   3.135 +répertoire Documents/ :
   3.136 +</p>
   3.137 +<pre>
   3.138 + $ cp info.txt Documents/
   3.139 +</pre>
   3.140 +<p>
   3.141 +Copier un répertoire entier. Ici la commande copie le répertoire Templates/
   3.142 +dans /home/hacker :
   3.143 +</p>
   3.144 +<pre>
   3.145 + $ cp -a Templates /home/hacker
   3.146 +</pre>
   3.147 +
   3.148 +<a name="mkdir"></a>
   3.149 +<h3><font color="#6c0023">Créer de nouveaux répertoires</font></h3>
   3.150 +<p>
   3.151 +mkdir de l'Anglais make a directory. Cette commande permet de créer un nouveau
   3.152 +répertoire. La commande ci-dessous crée un répertoire qui se nomme Projects.
   3.153 +Il se créera dans le répértoite /home de l'utilisateur courant ou dans le 
   3.154 +répertoire dans lequel on se trouve :
   3.155 +</p>
   3.156 +<pre>
   3.157 + $ mkdir Projects
   3.158 +</pre>
   3.159 +<p>
   3.160 +Création d'un répertoire qui se nomme script-1.0 dans le dossier Projects/ :
   3.161 +</p>
   3.162 +<pre>
   3.163 + $ mkdir Projects/script-1.0
   3.164 +</pre>
   3.165 +
   3.166 +<a name="rm"></a>
   3.167 +<h3><font color="#6c0023">Supprimer des fichiers ou des répertoires</font></h3>
   3.168 +<p>
   3.169 +La commande <code>rm</code> permet de supprimer un fichier. Imaginons que 
   3.170 +nous allons supprimer le fichier fichier.txt et qui se trouve dans le 
   3.171 +répertoire courant :
   3.172 +</p>
   3.173 +<pre>
   3.174 + $ rm fichier.txt
   3.175 +</pre>
   3.176 +<p>
   3.177 +La commande <code>rm</code> a plusieurs options. Pour supprimer tout un
   3.178 +répertoire avec son contenu, il faut utiliser l'option <code>-rf</code>.
   3.179 +Exemple :
   3.180 +</p>
   3.181 +<pre>
   3.182 + $ rm -rf /home/hacker/Templates
   3.183 +</pre>
   3.184 +
   3.185 +<a name="read"></a>
   3.186 +<h3><font color="#6c0023">Lire des fichiers</font></h3>
   3.187 +<p>
   3.188 +Pour lire le contenu d'un fichier ou d'un script, vous pouvez utiliser les
   3.189 +commandes <code>less</code>, <code>more</code>, <code>cat</code>, ou encore 
   3.190 +le navigateur web Retawq. Exemples avec un fichier README, essential.txt, et 
   3.191 +script.sh :
   3.192 +</p>
   3.193 +<pre>
   3.194 + $ less -EM essential.txt
   3.195 + ou:
   3.196 + $ more README
   3.197 + ou encore:
   3.198 + $ cat /chemin/script.sh
   3.199 +</pre>
   3.200 +<p>
   3.201 +Afficher un fichier texte ou html avec le navigateur web Retawq :
   3.202 +</p>
   3.203 +<pre>
   3.204 + $ retawq /usr/share/doc/index.html
   3.205 +</pre>
   3.206 +
   3.207 +<a name="edit"></a>
   3.208 +<h3><font color="#6c0023">Editer des fichiers</font></h3>
   3.209 +<p>
   3.210 +L'édition de fichiers texte, scripts, fichier de configurations, etc, peut se
   3.211 +faire facilement avec l'éditeur GNU Nano dans une console ou un terminal 
   3.212 +graphique. Exemple avec un fichier bookmarks.html (&lt;Ctrl+X&gt; pour quitter
   3.213 +et enregistrer) :
   3.214 +</p>
   3.215 +<pre>
   3.216 + $ nano Public/bookmarks.html
   3.217 +</pre>
   3.218 +
   3.219 +<a name="cat"></a>
   3.220 +<h3><font color="#6c0023">Cat</font></h3>
   3.221 +<p>
   3.222 +Vous pouvez utiliser la commande <code>cat</code> pour créer divers 
   3.223 +fichiers texte. EOF signifie End Of File, c'est là que le fichier se termine.
   3.224 +Exemple avec un fichier packages.list, cette commande supprime le contenu
   3.225 +actuel du fichier :
   3.226 +</p>
   3.227 +<pre>
   3.228 + $ cat &gt; packages.list &lt;&lt; "EOF"
   3.229 + Du texte...
   3.230 + et encore texte
   3.231 + 
   3.232 + EOF
   3.233 +</pre>
   3.234 +<p>
   3.235 +Pour ajouter du texte à la suite du fichier, mettez 2 fois: plus grand que
   3.236 +(&gt;&gt;) après <code>cat</code>, exemple :
   3.237 +</p>
   3.238 +<pre>
   3.239 + $ cat &gt;&gt; packages.list &lt;&lt; "EOF"
   3.240 + Du texte...
   3.241 + 
   3.242 + EOF
   3.243 +</pre>
   3.244 +
   3.245 +<a name="web-nav"></a>
   3.246 +<h3><font color="#6c0023">Naviguer sur le web</font></h3>
   3.247 +<p>
   3.248 +Surfer sur la toile avec SliTaz simplement et rapidement avec 'retawq', 
   3.249 +navigateur web en mode texte. A noter que vous pouvez aussi utiliser
   3.250 +le navigateur en local. Vous naviguerez ensuite facilement avec les flèches
   3.251 +de votre clavier, les liens sont en bleu et il faut taper &lt;ENTER&gt; pour
   3.252 +les suivre :
   3.253 +</p>
   3.254 +<pre>
   3.255 + $ retawq http://slitaz.libordux.org/
   3.256 + ou:
   3.257 + $ retawq http://localhost/
   3.258 +</pre>
   3.259 +<a name="irc-chat"></a>
   3.260 +<h3><font color="#6c0023">Discuter sur les canaux IRC</font></h3>
   3.261 +<p>
   3.262 +Pour discuter et transférer des fichiers via les multiples serveurs IRC
   3.263 +de la planète, SliTaz fournit Rhapsody. Ce client IRC est simple, rapide,
   3.264 +léger, fournissant un menu de configuration ncurses très agréable et facile à
   3.265 +prendre en main. Pour lancer l'application depuis un terminal, se connecter
   3.266 +à un serveur (irc.tuxfamily.org) et joindre le canal #tuxfamily :
   3.267 +</p>
   3.268 +<pre>
   3.269 + $ rhapsody
   3.270 + /connect irc.tuxfamily.org
   3.271 + /join #tuxfamily
   3.272 +</pre>
   3.273 +<a name="wget"></a>
   3.274 +<h3><font color="#6c0023">Télécharger des fichiers</font></h3>
   3.275 +<p>
   3.276 +Pour télécharger divers formats de fichiers sur internet, vous disposez de la
   3.277 +commande <code>wget</code>. Vous pouvez rapatrier une simple page html,
   3.278 +le contenu de tout un répertoire ou tout un site web :
   3.279 +</p>
   3.280 +<pre>
   3.281 + $ wget http://www.slitaz.org/doc/handbook/
   3.282 +</pre>
   3.283 +<a name="partitions"></a>
   3.284 +<h3><font color="#6c0023">Lister les partitions disponibles</font></h3>
   3.285 +<p>
   3.286 +Pour lister les partitions d'un disque dur interne ou externe, vous pouvez
   3.287 +utiliser la commande cat pour afficher le contenu du fichier
   3.288 +<code>/proc/partitions</code> ou utiliser l'utilitaire <code>fdisk</code>
   3.289 +avec l'option <code>-l</code> signifiant <em>list</em>. Vous pouvez ensuite
   3.290 +monter la (les) partitions que vous désirez utiliser :
   3.291 +</p>
   3.292 +<pre>
   3.293 + $ cat /proc/partitions
   3.294 + ou
   3.295 + # fdisk -l
   3.296 +</pre>
   3.297 +<a name="mount"></a>
   3.298 +<h3><font color="#6c0023">Monter une partition, un cdrom ou une clé USB</font></h3>
   3.299 +<p>
   3.300 +Pour monter une partition locale, dans le système de fichier SliTaz, nous vous
   3.301 +conseillons d'utiliser le répertoire /mnt. Dans l'exemple nous créons les
   3.302 +répertoires nécessaires, et nous montons la partition <code>hda6</code> du 
   3.303 +premier disque dur local sur /mnt/hda6 :
   3.304 +</p>
   3.305 +<pre>
   3.306 + # mkdir -p /mnt/hda6
   3.307 + # mount -t ext3 /dev/hda6 /mnt/hda6
   3.308 +</pre>
   3.309 +<p>
   3.310 +SliTaz fonctionne en RAM, vous pouvez monter ce même cdrom ou le retirer
   3.311 +pour en monter un autre (/dev/cdrom est un lien sur le premier lecteur de 
   3.312 +cdrom). A noter qu'un cdrom est un média amovible, il devrait donc se
   3.313 +monter sur /media :
   3.314 +</p>
   3.315 +<pre>
   3.316 + # mount -t iso9660 /dev/cdrom /media/cdrom
   3.317 +</pre>
   3.318 +<p>
   3.319 +Pour monter une clé USB ou flash disk il faut spécifier le bon système de 
   3.320 +fichiers. Normalement une clé USB achetée dans le marché est formatée en 
   3.321 +FAT32 ce qui permet de la lire depuis GNU/Linux et Windows. Sur un système
   3.322 +GNU/Linux elle est reconnue généralement comme le disque sda1, nous avons 
   3.323 +donc préparer un lien <code>sda1</code> sur <code>flash</code>, pour se 
   3.324 +faciliter la tâche. C'est aussi un média amovible et devrait se monter sur
   3.325 +/media :
   3.326 +</p>
   3.327 +<pre>
   3.328 + # mount -t vfat /dev/flash /media/flash
   3.329 +</pre>
   3.330 +<a name="halt"></a>
   3.331 +<h3><font color="#6c0023">Eteindre le système, ou redémarrer</font></h3>
   3.332 +<p>
   3.333 +Pour arrêter SliTaz ou redémarrer, vous pouvez utiliser la commande 
   3.334 +<code>halt</code>, <code>reboot</code> ou utiliser la combinaison des touches
   3.335 +&lt;Ctrl+Alt+Delete&gt;, ce qui correspond à un redémarrage système. En cas de 
   3.336 +problèmes, essayez d'utiliser l'option <code>-f</code>, signifiant 
   3.337 +<em>forced</em> :
   3.338 +</p>
   3.339 +<pre>
   3.340 + # halt
   3.341 + Pour redémarrer :
   3.342 + # reboot
   3.343 + Ou :
   3.344 + # reboot -f
   3.345 +</pre>
   3.346 +
   3.347 +<!-- End of content -->
   3.348 +</div>
   3.349 +
   3.350 +<!-- Footer. -->
   3.351 +<div id="footer">
   3.352 +	<div class="footer-right"></div>
   3.353 +	<a href="#top">Haut de la page</a> | 
   3.354 +	<a href="index.html">Table des matières</a>
   3.355 +</div>
   3.356 +
   3.357 +<div id="copy">
   3.358 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   3.359 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   3.360 +    Documentation publiées sous
   3.361 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   3.362 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   3.363 +</div>
   3.364 +
   3.365 +</body>
   3.366 +</html>

     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/doc/handbook-stable/development.html	Fri Feb 06 23:20:14 2009 +0100
     4.3 @@ -0,0 +1,332 @@
     4.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     4.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     4.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     4.7 +<head>
     4.8 +    <title>SliTaz Handbook - Developpement</title>
     4.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    4.10 +    <meta name="description" content="developpement sur Slitaz Geany scripts dialog toolchain gcc make" />
    4.11 +    <meta name="expires" content="never" />
    4.12 +    <meta name="modified" content="2007-12-03 12:30:00" />
    4.13 +    <meta name="publisher" content="www.slitaz.org" />
    4.14 +    <meta name="author" content="Christophe Lincoln"/>
    4.15 +    <link rel="shortcut icon" href="favicon.ico" />
    4.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    4.17 +</head>
    4.18 +<body bgcolor="#ffffff">
    4.19 +
    4.20 +<!-- Header and quick navigation -->
    4.21 +<div id="header">
    4.22 +<div align="right" id="quicknav">
    4.23 +    <a name="top"></a>
    4.24 +    <a href="secure-shell.html">SHell sécurisé</a> |
    4.25 +    <a href="index.html">Table des matières</a>
    4.26 +</div>
    4.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    4.28 +</div>
    4.29 +
    4.30 +<!-- Content. -->
    4.31 +<div id="content">
    4.32 +<div class="content-right"></div>
    4.33 +
    4.34 +<h2><font color="#DF8F06">Développement</font></h2>
    4.35 +
    4.36 +<ul>
    4.37 +    <li><a href="#about">&Agrave; propos du développement</a> - Sur SliTaz
    4.38 +    et de SliTaz.</li>
    4.39 +    <li><a href="#shell-scripts">Scripts SHell</a> - #!/bin/sh</li>
    4.40 +    <li><a href="#dialog">Dialog</a> - Création d'interface graphique
    4.41 +    basée sur la console.</li>
    4.42 +    <li><a href="#geany">Geany</a> - IDE ou Environnement de Développement
    4.43 +    Intégré.</li>
    4.44 +    <li><a href="#perl">Perl ou Microperl</a> - Coder et utiliser des scripts
    4.45 +    Perl et/ou CGI propulsés par microperl.</li>
    4.46 +    <li><a href="#python">Python</a> - Le langage Python</li>
    4.47 +    <li><a href="#toolchain">Toolchain</a> - Bibliothèques, compilateur C
    4.48 +    et outils associés.</li>
    4.49 +</ul>
    4.50 +
    4.51 +<a name="about"></a>
    4.52 +<h3><font color="#6c0023">&Agrave; propos du dévelopement</font></h3>
    4.53 +<p>
    4.54 +SliTaz fournit quelques outils de développement, conception de sites web,
    4.55 +édition avancée de scripts, et de code source avec l'IDE 'geany'. Création
    4.56 +d'interface graphique à vos scripts SHell avec 'dialog'.
    4.57 +</p>
    4.58 +<p>
    4.59 +Si vous cherchez des informations sur le développement de SliTaz,
    4.60 +le <a href="http://www.slitaz.org/doc/cookbook/">cookbook</a> (livre de
    4.61 +cuisine) vous décrira toutes les étapes de construction du système. Sur le
    4.62 +site web de SliTaz, la partie <a href="http://www.slitaz.org/devel/">devel</a>
    4.63 +vous donnera des informations générales au sujet des développeurs et des
    4.64 +possibilités de participation.
    4.65 +</p>
    4.66 +<a name="shell-scripts"></a>
    4.67 +<h3><font color="#6c0023">Scripts SHell</font></h3>
    4.68 +<p>
    4.69 +L'écriture de scripts SHell est la manière la plus simple pour commencer à
    4.70 +coder, ils permettent d'avoir rapidement un résultat et les seuls prérequis
    4.71 +sont de savoir ouvrir un terminal et utiliser un éditeur de texte tels
    4.72 +que Nano, LeafPad ou Geany. Les scripts SHell permettent de faire énomérement
    4.73 +de choses sur un système GNU/Linux, initialiser le système, faire des
    4.74 +sauvegardes, exécuter des tâches répétitives, afficher des informations sur
    4.75 +l'état du système, créer ou modifier des fichier, etc. Dans un script SHell,
    4.76 +vous pouvez aussi utiliser des variables, des fonctions ou encore des appels
    4.77 +pour inclure un fichier. A noter que vous pouvez nommer vos scripts comme bon
    4.78 +vous semble et que l'utilisation de l'extension <code>.sh</code> est largement
    4.79 +utilisée.
    4.80 +</p>
    4.81 +<h4>Créer un script SHell</h4>
    4.82 +<p>
    4.83 +Avant de commencer un nouveau script SHell, vous devez faire attention
    4.84 +à l'interprétateur utilisé. La plus part du temps les scripts SHell
    4.85 +utilisent <code>/bin/sh</code>, cela permet d'être plus portable.
    4.86 +Il y a aussi des scripts qui appelent <code>/bin/bash</code>, mais cela
    4.87 +implique que Bash soit installé sur le système. Pour qu'un script SHell
    4.88 +fonctionne il doit être exécutable par l'utilisateur courant, le changement
    4.89 +des permissions sur un fichier peut se faire en ligne de commande via
    4.90 +l'outils <code>chmod</code>. Pour créer un <code>script.sh</code> et le
    4.91 +rendre exécutable :
    4.92 +</p>
    4.93 +<pre>
    4.94 + $ touch script.sh
    4.95 + $ chmod +x script.sh
    4.96 +</pre>
    4.97 +<p>
    4.98 +Maintenant que vous avez un nouveau fichier exécutable, vous allez pouvoir
    4.99 +l'éditer. Vous pouvez continuer en restant dans le terminal et en utilisant
   4.100 +l'éditeur Nano (Ctrl+X pour enregistrer) ou en ouvrant l'IDE Geany sur le
   4.101 +fichier :
   4.102 +</p>
   4.103 +<pre>
   4.104 + $ nano script.sh
   4.105 + Ou :
   4.106 + $ geany script.sh &amp;
   4.107 +</pre>
   4.108 +<p>
   4.109 +Voici un &micro;script qui contient une variable <code>NAME</code> et qui en
   4.110 +affiche la valeur avec la commande <code>echo</code> :
   4.111 +</p>
   4.112 +<pre class="script">
   4.113 +#!/bin/sh
   4.114 +
   4.115 +NAME="kayam"
   4.116 +
   4.117 +echo "$NAME est sympa."
   4.118 +
   4.119 +</pre>
   4.120 +<p>
   4.121 +Une fois que vous avez créé/modifié votre <code>script.sh</code>, il suffit
   4.122 +d'enregistrer et d'exécuter le script pour voir le résultat :
   4.123 +</p>
   4.124 +<pre>
   4.125 + $ ./script.sh
   4.126 +</pre>
   4.127 +<p>
   4.128 +Voilà pour cette brève introduction au scripts SHell. Pour aller plus loin, le
   4.129 +web regorge d'informations à ce sujet et regarder ce qu'on fait les autres
   4.130 +peut aussi aider.
   4.131 +</p>
   4.132 +<a name="dialog"></a>
   4.133 +<h3><font color="#6c0023">Dialog</font></h3>
   4.134 +<p>
   4.135 +Dialog permet de créer des interfaces graphique basées sur la console, telles
   4.136 +que 'tazkmap'. Le fichier de configuration de dialog est /etc/dialogrc, et/ou
   4.137 + ~/.dialogrc pour chaque utilisateur. Voici un simple exemple d'utilisation de
   4.138 + dialog via une console ou un terminal :
   4.139 +</p>
   4.140 +<pre>
   4.141 + $ dialog --title "Hello $USER" \
   4.142 +   --msgbox "Message propulsé par dialog." 5 54
   4.143 +</pre>
   4.144 +<p>
   4.145 +Vous trouverez pleins d'exemples de scripts dans le répertoire /sample des
   4.146 +sources de dialog, que vous pouvez télécharger depuis:
   4.147 +<a href="http://invisible-island.net/dialog/dialog.html"
   4.148 + >invisible-island.net/dialog/dialog.html</a>. Download des sources avec
   4.149 +'wget' et décompression :
   4.150 +</p>
   4.151 +<pre>
   4.152 + $ wget ftp://invisible-island.net/dialog/dialog.tar.gz
   4.153 + $ tar xzf dialog.tar.gz
   4.154 +</pre>
   4.155 +<a name="geany"></a>
   4.156 +<h3><font color="#6c0023">Geany IDE</font></h3>
   4.157 +<p>
   4.158 +Geany est un IDE ou Environnement de Dévelopement Intégré, il est simple,
   4.159 +léger, et rapide, proposant la coloration syntaxique, les onglets,
   4.160 +pliage/dépliage du code, la complétion automatique, de l'aide à l'écriture.
   4.161 +Vous avez une liste des symboles, fonctions, méthodes, variables très utiles,
   4.162 +avec une petite flèche de signalisation. Et encore, sélecteur de couleurs
   4.163 +intégré, fenêtre de messages, lancement du script courant via le bouton
   4.164 +Exécuter, etc. C'est avec lui que nous avons créé cette page,
   4.165 +la documentation, et presque tout le site web (un peu avec Nano aussi).
   4.166 +</p>
   4.167 +<h4>Lancer Geany</h4>
   4.168 +<p>
   4.169 +Vous trouverez Geany dans le menu de JWM --&gt; Development --&gt; Geany.
   4.170 +Un fois lancé pour la première fois, vous pouvez ajuster vos préférences
   4.171 +via --&gt; Editer --&gt; Préférences. Vous pouvez aussi lancer Geany via un
   4.172 +terminal X et la commande :
   4.173 +</p>
   4.174 +<pre>
   4.175 + $ geany &amp;
   4.176 +</pre>
   4.177 +<p>
   4.178 +Note : Lors de la compilation des sources, le scripts <code>./configure</code>
   4.179 +propose l'option : <code>--enable-the-force</code>... Que l'on peut utiliser
   4.180 +si l'on penser avoir la force et être Luc Skywalker!
   4.181 +</p>
   4.182 +<a name="perl"></a>
   4.183 +<h3><font color="#6c0023">Perl ou Microperl - Coder/utiliser des scripts Perl</font></h3>
   4.184 +<p>
   4.185 +Sur SliTaz vous pouvez coder et utiliser le puissant langage de scripts Perl
   4.186 +via le binaire <code>perl</code> ou <code>microperl</code>. Microperl est une
   4.187 +version très allégée de Perl compilée à partir des sources officielles de Perl,
   4.188 +les scripts fonctionnant avec microperl sont complètement compatible avec la
   4.189 +version complète de Perl. C'est justement une des forces de Perl, il est portable
   4.190 +et fonctionne sur toutes les systèmes d'exploitations. Perl est un langage
   4.191 +interprété cela veut dire que le code n'a pas besoin d'être compilé et qu'il
   4.192 +peut être utilisé directement. A noter que sur SliTaz, <code>perl</code>
   4.193 +et/ou <code>microperl</code> se sont pas installé par défaut sur le LiveCD, vous
   4.194 +pouvez soit reconstruire votre propore ISO en incluant Perl ou installer via
   4.195 +le gestionnaire de paquets. A noter que le paquet Microperl fait mois d'1 Mb
   4.196 +et ne fournit aucun modules, juste le minimum :
   4.197 +</p>
   4.198 +<pre>
   4.199 + # tazpkg install perl
   4.200 + Ou :
   4.201 + # tazpkg install microperl
   4.202 +</pre>
   4.203 +
   4.204 +<h4>Hello world!</h4>
   4.205 +<p>
   4.206 +Le but de ce &micro;script est d'afficher <em>Hello World</em>. Vous pouvez
   4.207 +commencer par créer le fichier et le rendre exécutable depuis la ligne de
   4.208 +commandes et l'éditer ensuite graphiquement avec l'IDE Geany. A noter que nous
   4.209 +nommons le scripts <code>hello.pl</code> mais que vous pouvez nommer un
   4.210 +script Perl comme bon vous semble, avec ou sans l'extension <code>.pl</code> :
   4.211 +</p>
   4.212 +<pre>
   4.213 + $ touch hello.pl
   4.214 + $ chmod +x hello.pl
   4.215 + $ geany hello.pl &amp;
   4.216 +</pre>
   4.217 +<p>
   4.218 +La première ligne d'un scripts Perl commence par définir le chemin vers
   4.219 +l'interprétateur Perl, généralement <code>/usr/bin/perl</code> et pour
   4.220 +afficher du texte il suffit d'utiliser la commande <code>print</code>.
   4.221 +Code à copier/coller. A noter que le langage Perl est sensible à la casse et
   4.222 +qu'une instruction devrait toujours se terminer par un point-virgule :
   4.223 +</p>
   4.224 +<pre class="script">
   4.225 +#!/usr/bin/perl
   4.226 +#
   4.227 +
   4.228 +print "Hello World!\n";
   4.229 +
   4.230 +</pre>
   4.231 +<p>
   4.232 +Pour exécuter et tester le script :
   4.233 +</p>
   4.234 +<pre>
   4.235 + $ ./hello.pl
   4.236 +</pre>
   4.237 +
   4.238 +<h4>Scripts CGI et Perl</h4>
   4.239 +<p>
   4.240 +Les scripts CGI ont pour but d'afficher des pages web générées dynamiquement.
   4.241 +Le langage Perl assoicié au serveur web LightTPD vous permet d'utiliser
   4.242 +des scripts CGI via votre espace public ou via des hôtes virtuels. Perl est
   4.243 +tout à fait adapté au web 2.0 et permet de générer rapidement des pages xHTML.
   4.244 +Sur Slitaz, vous devez avoir installé Perl ou Microperl et
   4.245 +<a href="web-server.html#cgi-perl">configuré le serveur Web LightTPD</a> avant
   4.246 +de pouvoir utiliser des scripts CGI codé en Perl. A noter que par défaut vous
   4.247 +pouvez utiliser des scripts SHell (.sh) et les placer dans /cgi-bin/).
   4.248 +</p>
   4.249 +<p>
   4.250 +Une fois le server bien configuré, vous pouvez directement placer des scripts
   4.251 +CGI dans votre répertoire <code>$HOME/Public/cgi-bin</code> en utilisant
   4.252 +l'extension <code>.pl</code> ou <code>.cgi</code> et les visualiser en local
   4.253 +ou à distance. Exemple de script CGI utilisant Perl :
   4.254 +</p>
   4.255 +<pre class="script">
   4.256 +#!/usr/bin/perl
   4.257 +#
   4.258 +print "content-type : text/html\n\n";
   4.259 +
   4.260 +print "Hello World!\n";
   4.261 +
   4.262 +</pre>
   4.263 +
   4.264 +<a name="python"></a>
   4.265 +<h3><font color="#6c0023">Python</font></h3>
   4.266 +<p>
   4.267 +Le langage de programmation Python est disponible sous forme de paquet
   4.268 +facilement installable. Un fois Python installé vous pouvez créer vos propre
   4.269 +scripts/programmes et utiliser des applications CGI via le serveur Web LightTPD
   4.270 +en prenant soin de <a href="web-server.html#cgi-python">configurer le serveur</a>
   4.271 +correctement. A noter que le dépôt Mercurial officiel de SliTaz fourni une 
   4.272 +interface Web CGI/Python, c'est une solution adaptée à la production, robuste
   4.273 +et fiable. Pour installer le paquet <code>python</code> avec Tazpkg :
   4.274 +</p>
   4.275 +<pre>
   4.276 + # tazpkg get-install python
   4.277 +</pre>
   4.278 +
   4.279 +<a name="toolchain"></a>
   4.280 +<h3><font color="#6c0023">Toolchain - Bibliothèques, compilateur C et outils associés</font></h3>
   4.281 +<p>
   4.282 +Pour compiler des logiciels depuis les sources ou son propre code, vous avez
   4.283 +au minimum, besoin de la chaîne d'outils de base (<em>toolchain</em>),
   4.284 +composée des outils Binutils, de la bibliothèque Glibc , du compilateur
   4.285 +GCC, des <em>headers</em> du noyau et de l'utilitaire Make. Cette chaîne
   4.286 +d'outils peut être installée via le gestionnaire de paquets Tazpkg et une
   4.287 +seule commande. A noter que cette <em>toolchain</em> est utilisée par les
   4.288 +développeurs de SliTaz pour compiler le système entier depuis les sources.
   4.289 +Pour installer les paquets via l'installation d'un meta paquet créant les
   4.290 +dépendances qu'il faut :
   4.291 +</p>
   4.292 +<pre>
   4.293 + # tazpkg get-install slitaz-toolchain
   4.294 +</pre>
   4.295 +<p>
   4.296 +L'installation de la toolchain permet de compiler beaucoup d'applications
   4.297 +de base et en mode texte. A noter que beaucoup de paquets compileront sans
   4.298 +problème en utilisant le SHell Ash de Busybox, mais d'autres paquets ne
   4.299 +compileront pas sans Bash. GNU bash est disponnible sous forme de paquet
   4.300 +ainsi que divers outils de développement de base tels que Flex, M4, Bison,
   4.301 +ou encore Pkg-config. Si vous cherchez pkg-config par exemple :
   4.302 +</p>
   4.303 +<pre>
   4.304 + $ tazpkg search pkg-config
   4.305 +</pre>
   4.306 +<p>
   4.307 +Si vous désirez compiler des applications utilsant les bibliothèques Ncurses,
   4.308 +vous devez installer le paquet <code>ncurses-dev</code> complet (par défaut
   4.309 +il n'y a que le paquet minimum installé). A noter que le paquet ncurses fournit
   4.310 +aussi divers petits programmes tels que <code>tic</code> ou <code>tack</code> :
   4.311 +</p>
   4.312 +<pre>
   4.313 + $ tazpkg search ncurses
   4.314 +</pre>
   4.315 +
   4.316 +<!-- End of content -->
   4.317 +</div>
   4.318 +
   4.319 +<!-- Footer. -->
   4.320 +<div id="footer">
   4.321 +	<div class="footer-right"></div>
   4.322 +	<a href="#top">Haut de la page</a> | 
   4.323 +	<a href="index.html">Table des matières</a>
   4.324 +</div>
   4.325 +
   4.326 +<div id="copy">
   4.327 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   4.328 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   4.329 +    Documentation publiées sous
   4.330 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   4.331 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   4.332 +</div>
   4.333 +
   4.334 +</body>
   4.335 +</html>

     5.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     5.2 +++ b/doc/handbook-stable/enlightenment.html	Fri Feb 06 23:20:14 2009 +0100
     5.3 @@ -0,0 +1,190 @@
     5.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     5.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     5.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     5.7 +<head>
     5.8 +    <title>SliTaz Handbook - Enlightenment</title>
     5.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    5.10 +    <meta name="description" content="" />
    5.11 +    <meta name="expires" content="never" />
    5.12 +    <meta name="modified" content="2000-02-03 19:30:00" />
    5.13 +    <meta name="publisher" content="www.slitaz.org" />
    5.14 +    <meta name="author" content="Christophe Lincoln"/>
    5.15 +    <link rel="shortcut icon" href="favicon.ico" />
    5.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    5.17 +</head>
    5.18 +<body bgcolor="#ffffff">
    5.19 +
    5.20 +<!-- Header and quick navigation -->
    5.21 +<div id="header">
    5.22 +<div align="right" id="quicknav">
    5.23 +    <a name="top"></a>
    5.24 +    <a href="utilities.html">Utilitaires</a> |
    5.25 +    <a href="index.html">Table des matières</a>
    5.26 +</div>
    5.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    5.28 +</div>
    5.29 +
    5.30 +<!-- Content. -->
    5.31 +<div id="content">
    5.32 +<div class="content-right"></div>
    5.33 +
    5.34 +<h2><font color="#DF8F06">Enlightenment (e17)</font></h2>
    5.35 +
    5.36 +<ul>
    5.37 +    <li><a href="#intro">Introduction et présentation.</a></li>
    5.38 +    <li><a href="#install">Installation et lancement.</a></li>
    5.39 +    <li><a href="#menu-icons">Menu et icônes de bureau.</a></li>
    5.40 +    <li><a href="#themes">Thèmes graphiques.</a></li>
    5.41 +</ul>
    5.42 +
    5.43 +<a name="intro"></a>
    5.44 +<h3><font color="#6c0023">Introduction et présentation de e17</font></h3>
    5.45 +<p>
    5.46 +Enlightenment est un environnement de bureau complet, entièrement configurable
    5.47 +à la souris et proposant de nombreux thèmes. La version fournie par le projet
    5.48 +SliTaz est une version encore en développement connue sous le nom de e17,
    5.49 +cette version est considérée suffisament stable pour être intégrée dans la
    5.50 +distribution et travailler en production. Cela dit, SliTaz ne propose pas des
    5.51 +outils tels que Rage ou Entrance, mais ce qu'il faut pour  disposer d'un 
    5.52 +d'environnement de bureau complet, simple d'utilisation, stable, réactif et 
    5.53 +efficace. Tous les réglages peuvent se faire graphiquement via le panneau de 
    5.54 +configuration intégrés au bureau, le menu s'affiche via un clique de gauche
    5.55 +sur l'écran ou depuis une gondole. Il est entre autres possible d'utiliser le 
    5.56 +glisser/déposer depuis un gestionnaire de fichiers et le bureau ou d'afficher
    5.57 +des icônes pour lancer ses applications préférées.
    5.58 +</p>
    5.59 +<p>
    5.60 +Enlightenment a été conçu pour être déployable sur des systèmes avec peu de 
    5.61 +ressources comme sur les systèmes plus puissants. IL permet d'avoir des fonds 
    5.62 +d'écran, des éléments du menus et des gadgets animés et interactifs, sait
    5.63 +gérer les bureaux virtuels (Alt + roulette de la souris). D'autres 
    5.64 +fonctionnalités très pratiques permettent de gagner du temps sur des tâches 
    5.65 +simples, comme par exemple le fait de déplacer une fenêtre d'un bureau à un 
    5.66 +autre via le pager ou le fait d'enrouler une fenêtre avec la molette sur sa
    5.67 +bordure.
    5.68 +</p>
    5.69 +<p>
    5.70 +Site Web : <a href="http://www.enlightenment.org/">www.enlightenment.org</a>
    5.71 +</p>
    5.72 +
    5.73 +<a name="install"></a>
    5.74 +<h3><font color="#6c0023">Installation et lancement</font></h3>
    5.75 +<p>
    5.76 +Installer et lancer Enlightenment sur SliTaz se résume à exécuter une commande
    5.77 +et éditer un fichier. Si vous n'avez pas rechargé votre liste de paquets depuis
    5.78 +quelques temps, pensez à la mettre à jour. Pour installer Enlightenment et ses
    5.79 +dépendances :
    5.80 +</p>
    5.81 +<pre>
    5.82 + # tazpkg get-install enlightenment
    5.83 +</pre>
    5.84 +<p>
    5.85 +Une fois tous les paquets installés, vous pouvez reconfigurer votre session X
    5.86 +avec <code>tazx</code> en spécifiant e17 en argument :
    5.87 +</p>
    5.88 +<pre>
    5.89 + $ tazx e17
    5.90 +</pre>
    5.91 +<p>
    5.92 +Pour commencer à utiliser Enlightenment il faut sauver le fichier, sortir de 
    5.93 +sa session X courante et redémarrer une session graphique avec :
    5.94 +</p>
    5.95 +<pre>
    5.96 + $ startx
    5.97 +</pre>
    5.98 +<h4>&Eacute;diter ~/.xsession</h4>
    5.99 +<p>
   5.100 +Pour configurer manuellement votre session X via le fichier de configuration
   5.101 +de votre session X (<code>~/.xsession</code>). Il faut modifier la ligne 
   5.102 +lançant le serveur Xvesa, commenter ou supprimer la ligne exécutant
   5.103 +JWM et ajouter <code>exec enlightenment_start</code> à la fin du fichier. 
   5.104 +~/.Xsession peut être édité depuis le menu de JWM et la catégorie 
   5.105 +<em>Preferences</em> ou avec Nano dans un terminal. N'oubliez pas d'ajouter
   5.106 +<code>-terminate</code> à la ligne lançant Xvesa. Simple exemple :
   5.107 +</p>
   5.108 +<pre class="script">
   5.109 +# ~/.xsession: Start X window session on your system.
   5.110 +#
   5.111 +Xvesa -ac -shadow -terminate -screen 1280x800x24 -mouse /dev/input/mice,5 &
   5.112 +#exec jwm
   5.113 +exec enlightenment_start
   5.114 +</pre>
   5.115 +<p>
   5.116 +Sortez de votre session est relancez <code>startx</code>.
   5.117 +</p>
   5.118 +
   5.119 +<a name="menu-icons"></a>
   5.120 +<h3><font color="#6c0023">Menu et icônes de bureau</font></h3>
   5.121 +<p>
   5.122 +Enlightenment respect les standards de Freedesktop, les applications sont 
   5.123 +classées par catégorie et apparaîssent automatiquement lors de leur
   5.124 +installation si un un fichier de bureau est fournit. Les fichiers de bureau 
   5.125 +(<code>.desktop</code>) du système sont contenu dans le répertoire 
   5.126 +<code>/usr/share/applications</code> ou le repértoire personnel 
   5.127 +<code>~/.local/share/applications</code>. Ces fichiers de bureau ont une
   5.128 +syntaxe simple, sont éditables depuis le panneau de configuration ou avec
   5.129 +un simple éditeur de texte. Les fichiers des menus affichant les catégories
   5.130 +dans le menu d'Enlightenment sont contenus dans le paquet 
   5.131 +<code>slitaz-menus</code> :
   5.132 +</p>
   5.133 +<pre>
   5.134 + # tazpkg get-install slitaz-menus
   5.135 +</pre>
   5.136 +<h4>Un icône sur le bureau</h4>
   5.137 +<p>
   5.138 +Pour avoir un icône sur le bureau lançant une application vous pouvez créer
   5.139 +à la main un fichier <code>.desktop</code> dans votre répertoire personnel
   5.140 +<code>~/Desktop</code>, les fichiers de bureau placés dans ce réperoire sont
   5.141 +automatiquement reconnus par Enlightenment. Un simple fichier de bureau peut
   5.142 +tenir sur huit lignes avec respectivement le nom (<code>Name</code>), le nom
   5.143 +généric, un commentaire, la commande à exécuter (<code>Exec</code>), l'icône,
   5.144 +le type et les catégories Freedesktop. Exemple d'un fichier de bureau pour
   5.145 +Xterm :
   5.146 +</p>
   5.147 +<pre class="script">
   5.148 +[Desktop Entry]
   5.149 +Name=XTerm (sb)
   5.150 +GenericName=Terminal
   5.151 +Comment=Run commands in a shell
   5.152 +Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar
   5.153 +Icon=xterm.png
   5.154 +Type=Application
   5.155 +Categories=Utility;Terminal;
   5.156 +</pre>
   5.157 +
   5.158 +<a name="themes"></a>
   5.159 +<h3><font color="#6c0023">Thèmes graphiques</font></h3>
   5.160 +<p>
   5.161 +Enlightenment est conçu de manière à pouvoir tout configurer en fonctions de
   5.162 +ses préférences. Vous pouvez facilement modifier l'apparence des fenêtres, 
   5.163 +de l'image de démarrage, du fond d'écran, les mouvements des fenêtres, les 
   5.164 +gondoles et autres gadjgets. Vous trouverez plusieurs thèmes complet ou 
   5.165 +fonds décran sur le site Web dédié aux outils et graphisme du bureau get-e.org.
   5.166 +Les thèmes s'installent graphiquement via le menu et l'interface de 
   5.167 +configuration des thèmes, vous pouvez aussi les mettre manuellement dans vos
   5.168 +répertoires de configuration personnel de Enlightenment : <code>~/.e/e</code>.
   5.169 +</p>
   5.170 +<p>
   5.171 +Enlightenment users art : <a href="http://www1.get-e.org/">www1.get-e.org</a>
   5.172 +</p>
   5.173 +
   5.174 +<!-- End of content -->
   5.175 +</div>
   5.176 +
   5.177 +<!-- Footer. -->
   5.178 +<div id="footer">
   5.179 +	<div class="footer-right"></div>
   5.180 +	<a href="#top">Haut de la page</a> | 
   5.181 +	<a href="index.html">Table des matières</a>
   5.182 +</div>
   5.183 +
   5.184 +<div id="copy">
   5.185 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   5.186 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   5.187 +    Documentation publiées sous
   5.188 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   5.189 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   5.190 +</div>
   5.191 +
   5.192 +</body>
   5.193 +</html>

     6.1 Binary file doc/handbook-stable/favicon.ico has changed

     7.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.2 +++ b/doc/handbook-stable/gen-livecd.html	Fri Feb 06 23:20:14 2009 +0100
     7.3 @@ -0,0 +1,294 @@
     7.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     7.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     7.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     7.7 +<head>
     7.8 +    <title>SliTaz Handbook - Générer son propre LiveCD à saveur</title>
     7.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    7.10 +    <meta name="description" content="créer son propre livecd de slitaz gnu linux tazlito" />
    7.11 +    <meta name="expires" content="never" />
    7.12 +    <meta name="modified" content="2008-01-30 13:30:00" />
    7.13 +    <meta name="publisher" content="www.slitaz.org" />
    7.14 +    <meta name="author" content="Christophe Lincoln"/>
    7.15 +    <link rel="shortcut icon" href="favicon.ico" />
    7.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    7.17 +</head>
    7.18 +<body bgcolor="#ffffff">
    7.19 +
    7.20 +<!-- Header and quick navigation -->
    7.21 +<div id="header">
    7.22 +<div align="right" id="quicknav">
    7.23 +    <a name="top"></a>
    7.24 +    <a href="liveusb.html">LiveUSB</a> |
    7.25 +    <a href="index.html">Table des matières</a>
    7.26 +</div>
    7.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    7.28 +</div>
    7.29 +
    7.30 +<!-- Content. -->
    7.31 +<div id="content">
    7.32 +<div class="content-right"></div>
    7.33 +
    7.34 +<h2><font color="#DF8F06">Générer un LiveCD à saveur</font></h2>
    7.35 +<p>
    7.36 +Comment créer son propre LiveCD facilement est rapidement avec Tazlito.
    7.37 +</p>
    7.38 +
    7.39 +<ul>
    7.40 +	<li><a href="#intro">Pour commencer.</a></li>
    7.41 +	<li><a href="#2cmds">Un LiveCD en 2 commandes.</a></li>
    7.42 +	<li><a href="#get-flavor">Récupérer une saveur.</a></li>
    7.43 +	<li><a href="#gen-distro">Générer la distribution.</a></li>
    7.44 +	<li><a href="#gen-flavor">Créer une saveur.</a></li>
    7.45 +	<li><a href="#addfiles">Fichiers additionnels.</a></li>
    7.46 +	<li><a href="#pkgs">Paquets utilisés.</a></li>
    7.47 +	<li><a href="#configure">Fichier de configuration.</a></li>
    7.48 +</ul>
    7.49 +
    7.50 +<a name="intro"></a>
    7.51 +<h3><font color="#6c0023">Pour commencer</font></h3>
    7.52 +<p>
    7.53 +Créer sa propre version du LiveCD de SliTaz avec Tazlito (<em>SliTaz Live 
    7.54 +Tool</em>) prend peu de temps et permet de choisir précisément les paquets
    7.55 +logiciels que l'on veut retrouver dans le système. Le support des saveurs
    7.56 +vous pemet de générer un LiveCD personnalisé en modifiant une liste de paquets
    7.57 +ou en utilisant des saveurs crées et envoyées sur slitaz.org par des
    7.58 +utilisateurs ou contributeurs. Tazlito est un outil en ligne de commande, il
    7.59 +ne faut pas que cela vous repousse, vous aurez votre propre image ISO en 2 
    7.60 +commandes et la graverez en 1 commande.
    7.61 +</p>
    7.62 +<p>
    7.63 +La génération du LiveCD demande un minimum de 256 Mb de RAM et la compression
    7.64 +du système avec LZMA peut prendre un certain temps. Il est possible de créer
    7.65 +une distribution depuis le mode LiveCD ou depuis un système installé. En mode
    7.66 +LiveCD, il est conseillé d'utiliser un media USB ou un disque dur pour stocker
    7.67 +les fichiers générés, conserver le travail et gagner de la place en RAM.
    7.68 +</p>
    7.69 +<p>
    7.70 +Tazlito est aussi utilsé par les développeurs SliTaz pour générer le LiveCD
    7.71 +officiel. Les seuls prérequis sont d'avoir Tazlito d'installé, c'est le cas
    7.72 +par défaut sur SliTaz, mais vous pouvez générer le LiveCD depuis une autre
    7.73 +distribution à condition d'avoir les paquets voulus sous la main ou de le
    7.74 +télécharger. 
    7.75 +</p>
    7.76 +<h4>Installer Tazlito sur une autre distribution</h4>
    7.77 +<p>
    7.78 +Tazlito n'a aucune dépendance particulière pour générer le LiveCD, mais il 
    7.79 +dépend de Cdrkit pour graver l'image et de Tazpkg pour regénérer des paquets
    7.80 +SliTaz depuis ceux qui sont installés. Pour récupérer Tazlito et l'installer
    7.81 +en suivant les instructions du fichier README contenu dans <a 
    7.82 +	href="http://download.tuxfamily.org/slitaz/sources/tazlito/"
    7.83 +	>les sources de Tazlito</a>.
    7.84 +</p>
    7.85 +
    7.86 +<a name="2cmds"></a>
    7.87 +<h3><font color="#6c0023">Un LiveCD en 2 commandes</font></h3>
    7.88 +<ul>
    7.89 +	<li>Récupérer une saveur : <code>tazlito get-flavor core</code></li>
    7.90 +	<li>En option : Modifier la liste des paquets ou ajouter Fichiers 
    7.91 +	additionnels.</li>
    7.92 +	<li>Générer la distribution : <code>tazlito gen-distro</code></li>
    7.93 +</ul>
    7.94 +<p>
    7.95 +Une fois le travail fini, vous trouvez l'image ISO du LiveCD dans le répertoire 
    7.96 +<code>/home/slitaz/distro</code>.
    7.97 +</p>
    7.98 +
    7.99 +
   7.100 +<a name="get-flavor"></a>
   7.101 +<h3><font color="#6c0023">Récupérer une saveur</font></h3>
   7.102 +<p>
   7.103 +Une saveur est un fichier <code>.flavor</code> contenant toutes les informations
   7.104 +nécessaires à la création du LiveCD. La saveur fournit une liste des paquets
   7.105 +(<code>distro-packages.list</code>), une description et des fichiers 
   7.106 +additionnels propres à la saveur choisie. La liste des saveurs peut être
   7.107 +téléchargées et mise à jour avec Tazlito :
   7.108 +</p>
   7.109 +<pre>
   7.110 + # tazlito list-flavors
   7.111 + Ou :
   7.112 + # tazlito list-flavors --recharge
   7.113 +</pre>
   7.114 +<p>
   7.115 +La liste des saveurs va automatiquement s'afficher, donnant la taille du 
   7.116 +LiveCD et une brève description. Pour la suite, la commande 
   7.117 +<code>get-flavor</code> va télécharger le fichier de saveur <code>.flavor</code>
   7.118 +extraire automatiquement la liste des paquets et la description dans le 
   7.119 +répertoire courant et mettre les fichiers additionnels dans le répertoire
   7.120 +<code>/home/slitaz/distro/addfiles</code>. Pour stocker les saveurs nous vous
   7.121 +proposons d'utiliser un répertoire spécifique tel que 
   7.122 +<code>/home/slitaz/flavors</code>, vous pouvez créer ce répertoire et vous y
   7.123 +placer avec les commandes :
   7.124 +</p>
   7.125 +<pre>
   7.126 + # mkdir -p /home/slitaz/flavors
   7.127 + # cd /home/slitaz/flavors
   7.128 +</pre>
   7.129 +<p>
   7.130 +Pour télécharger et/ou extraire les fichiers d'une saveur particulière :
   7.131 +</p>
   7.132 +<pre>
   7.133 + # tazlito get-flavor saveur-particuliere
   7.134 +</pre>
   7.135 +<p>
   7.136 +La description d'une saveur peut être affichée avec la commande 
   7.137 +<code>show-flavor</code> de Tazlito. Une fois la saveur choisie téléchargée
   7.138 +et/ou extraite, vous pouvez générer la distribution.
   7.139 +</p>
   7.140 +
   7.141 +<a name="gen-distro"></a>
   7.142 +<h3><font color="#6c0023">Générer la distribution</font></h3>
   7.143 +<p>
   7.144 +Pour une première ISO nous vous conseillons de tester sans modifier la liste,
   7.145 +ensuite vous pourrez supprimer ou ajouter des paquets à volonté. Mais attention,
   7.146 +les paquets du système de base sont indispensables. La commande 
   7.147 +<code>gen-distro</code> génère une image ISO avec tous les paquets de la 
   7.148 +liste, il faut être root et être dans le même répertoire que liste et le
   7.149 +fichier de configuration. Pour générer un LiveCD :
   7.150 +</p>
   7.151 +<pre>
   7.152 + # tazlito gen-distro
   7.153 +</pre>
   7.154 +<p>
   7.155 +Voilà, votre première image ISO du LiveCD est générée dans
   7.156 +<code>/home/slitaz/distro</code>, sans compte pour l'utilisateur hacker.
   7.157 +<p>
   7.158 +<h4>L'utilisateur hacker</h4>
   7.159 +</p>
   7.160 +Si vous désirez avoir un compte utilisateur avec hacker, il faut l'ajouter
   7.161 +et recréer le système de fichier racine compressé :
   7.162 +</p>
   7.163 +<pre>
   7.164 + # tazlito addhacker
   7.165 + # tazlito gen-initiso
   7.166 +</pre>
   7.167 +<h4>Nettoyer, regénérer et aller plus loins</h4>
   7.168 +<p>
   7.169 +Pour continuer et aller plus loin,
   7.170 +vous pouvez simplement ajouter un ou deux paquets à la liste, nettoyer la distro
   7.171 +et regénérer le système de fichier racine avec une nouvelle image ISO :
   7.172 +</p>
   7.173 +<pre>
   7.174 + # tazlito clean-distro
   7.175 + # tazlito gen-distro
   7.176 +</pre>
   7.177 +<p>
   7.178 +Tazlito fournit encore plusieurs possibilités, telles que la gravure de l'ISO
   7.179 +ou la copie de fichiers additionnels dans le système ou directement sur le cdrom.
   7.180 +Pour connaître toutes les commandes disponibles, vous pouvez vous référer au
   7.181 +<a href="http://www.slitaz.org/doc/manuals/tazlito.html">manuel de Tazlito</a>
   7.182 +installé par défaut sur tous les systèmes SliTaz et accessible depuis le menu
   7.183 +de JWM
   7.184 +</p>
   7.185 +
   7.186 +<a name="gen-flavor"></a>
   7.187 +<h3><font color="#6c0023">Créer une saveur</font></h3>
   7.188 +<p>
   7.189 +Tazlito permet de facilement créer une saveur particulière à partir des 
   7.190 +résultats de fabrication de la distribution (<code>gen-distro</code>). Le
   7.191 +fichier de saveur produit contiendra tous les fichiers additionnels, la
   7.192 +decription et la liste de paquets et réutilisé ultérieurement et mis à jour
   7.193 +en fonction des versions des paquets. Pour générer une saveur en répondant à
   7.194 +une ou deux questions :
   7.195 +</p>
   7.196 +<pre>
   7.197 + # tazlito gen-flavor nouvelle-saveur
   7.198 +</pre>
   7.199 +<p>
   7.200 +Une fois que votre saveur est fonctionnel et bien testées, vous avez la 
   7.201 +possibilité de l'envoyer sur slitaz.org afin qu'elle soit mise à disposition
   7.202 +de tous, listée via <code>list-flavor</code> et utilisable via 
   7.203 +<code>get-flavor</code>. Pour envoyer une saveur vous avez plusieurs moyens,
   7.204 +passer par la liste de discussion, mettre le fichier en ligne et le signaler 
   7.205 +sur le forum ou directement l'envoyer par mail à un contributeur du projet. 
   7.206 +</p>
   7.207 +
   7.208 +
   7.209 +<a name="addfiles"></a>
   7.210 +<h3><font color="#6c0023">Fichiers additionnels</font></h3>
   7.211 +<p>
   7.212 +Les fichiers de saveurs contiennent généralement des fichiers additionnels
   7.213 +copiés directement dans le système de fichier racine ou dans la racine du
   7.214 +cdrom. Le chemin vers les fichiers à utiliser est spécifié dans le fichier
   7.215 +de configuration <code>tazlito.conf</code>, logiquement et par défaut, les 
   7.216 +fichiers sont situé dans <code>/home/slitaz/distro/addfiles</code>. Les
   7.217 +fichiers additionnels de la saveur <code>core</code> fournissent par exemple
   7.218 +le menu du gestionnaire de fenêtres <a href="jwm.html">JWM</a> et les fonds
   7.219 +d'écrans. Il suffit de modifier, ajouter ou supprimer des fichiers dans le 
   7.220 +pseudo système racine (<code>rootfs</code>) ou la racine du CD 
   7.221 +(<code>rootcd</code>) et de regénérer la distribution pour retouver les
   7.222 +fichiers dans l'ISO. Pour nettoyer et regénérer la distribution :
   7.223 +</p>
   7.224 +<pre>
   7.225 + # tazlito clean-distro
   7.226 + # tazlito gen-distro
   7.227 +</pre>
   7.228 +
   7.229 +<a name="pkgs"></a>
   7.230 +<h3><font color="#6c0023">Paquets utilisés</font></h3>
   7.231 +<p>
   7.232 +Pour créer votre distro il vous faut des paquets SliTaz. Tazlito et Tazpkg 
   7.233 +permettent de recréer les paquets depuis un système SliTaz en fonctionnement 
   7.234 +ou de télécharger les paquets directement en fonction de la saveur choisie. 
   7.235 +Par logique, sur SliTaz, les paquets se mettent dans le répertoire
   7.236 +<code>/home/slitaz/packages</code>, mais vous pouvez chager cela via un 
   7.237 +fichier de configutation de Tazlito (tazlito.conf).
   7.238 +</p>
   7.239 +<p>
   7.240 +Si vous voulez récupérer des paquets à la main, vous pouvez utiliser un
   7.241 +logiciel FTP tel que gFTP (installé par défaut sur SliTaz) ou la ligne de 
   7.242 +commande et <code>wget</code> pour  télécharger des paquets officiels. L'URL 
   7.243 +direct vers les versions des paquets : 
   7.244 +<a href="ftp://download.tuxfamily.org/slitaz/packages/"
   7.245 +	>ftp://download.tuxfamily.org/slitaz/packages/</a>
   7.246 +</p>
   7.247 +<p>
   7.248 +Vous pouvez aussi utiliser vos propre paquets en les mettant dans le répertoire
   7.249 +des paquets. Si vous cherchez de la documentation au sujet de la création de
   7.250 +paquets SliTaz, vous pouvez vous référer au livre de cuisine ou 
   7.251 +<a href="http://www.slitaz.org/doc/cookbook/">Cookbook</a>.
   7.252 +</p>
   7.253 +
   7.254 +<a name="configure"></a>
   7.255 +<h3><font color="#6c0023">Fichier de configuration</font></h3>
   7.256 +<p>
   7.257 +Par défaut Tazlito utilise le fichier de configuration système 
   7.258 +<code>/etc/tazlito/tazlito.conf</code> ou un fichier <code>tazlito.conf</code>
   7.259 +situé dans le répertoire courant. C'est à dire que vous pouvez utiliser le
   7.260 +fichier par défaut ou avoir un fichier de configuration spécifique à chaque
   7.261 +distro que vous créez. Ce fichier de configuration permet de changer le nom
   7.262 +de l'image ISO, le nom du préparateur et les chemins vers les répertoires de
   7.263 +travail. Pour créer et configurer directement un fichier de configuration, il
   7.264 +suffit de lancer Tazlito avec la commande <code>configure</code> et cela depuis
   7.265 +le répertoire de la distro (vous pouvez le créer ailleur). En supposant que
   7.266 +avez l'arbre de la distro dans <code>/home/slitaz/distro</code> et que vous
   7.267 +vous y êtes placé avec <code>cd</code>&nbsp;:
   7.268 +</p>
   7.269 +<pre>
   7.270 + $ tazlito configure
   7.271 +</pre>
   7.272 +<p>
   7.273 +Une fois que vous avez répondu aux questions, vous pouvez soit recréer l'image
   7.274 +ISO, reconstruire le système racine et l'ISO ou générer une nouvelle distro
   7.275 +avec la liste des paquets.
   7.276 +</p>
   7.277 +
   7.278 +<!-- End of content -->
   7.279 +</div>
   7.280 +
   7.281 +<!-- Footer. -->
   7.282 +<div id="footer">
   7.283 +	<div class="footer-right"></div>
   7.284 +	<a href="#top">Haut de la page</a> | 
   7.285 +	<a href="index.html">Table des matières</a>
   7.286 +</div>
   7.287 +
   7.288 +<div id="copy">
   7.289 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   7.290 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   7.291 +    Documentation publiées sous
   7.292 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   7.293 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   7.294 +</div>
   7.295 +
   7.296 +</body>
   7.297 +</html>

     8.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     8.2 +++ b/doc/handbook-stable/graphics.html	Fri Feb 06 23:20:14 2009 +0100
     8.3 @@ -0,0 +1,138 @@
     8.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     8.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     8.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     8.7 +<head>
     8.8 +    <title>SliTaz Handbook - Graphisme</title>
     8.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    8.10 +    <meta name="description" content="Graphisme sur SliTaz mtPaint GQview GIMP" />
    8.11 +    <meta name="expires" content="never" />
    8.12 +    <meta name="modified" content="2007-12-03 12:30:00" />
    8.13 +    <meta name="publisher" content="www.slitaz.org" />
    8.14 +    <meta name="author" content="Christophe Lincoln"/>
    8.15 +    <link rel="shortcut icon" href="favicon.ico" />
    8.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    8.17 +</head>
    8.18 +<body bgcolor="#ffffff">
    8.19 +
    8.20 +<!-- Header and quick navigation -->
    8.21 +<div id="header">
    8.22 +<div align="right" id="quicknav">
    8.23 +    <a name="top"></a>
    8.24 +    <a href="multimedia.html">Multimedia</a> |
    8.25 +    <a href="index.html">Table des matières</a>
    8.26 +</div>
    8.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    8.28 +</div>
    8.29 +
    8.30 +<!-- Content. -->
    8.31 +<div id="content">
    8.32 +<div class="content-right"></div>
    8.33 +
    8.34 +<h2><font color="#DF8F06">Graphisme et gestion d'images</font></h2>
    8.35 +
    8.36 +<ul>
    8.37 +	<li><a href="#gcolor2">Gcolor2</a> - Selecteur et gestionnaire de colors.</li>
    8.38 +	<li><a href="#gqview">GQview</a> - Gestionnaire d'images.</li>
    8.39 +	<li><a href="#gimp">Gimp</a> - Manipulation et création d'images.</li>
    8.40 +	<li><a href="#jpeg">jpeg</a> - Outils JPEG en ligne de commande.</li>
    8.41 +	<li><a href="#bluefish">mtPaint</a> -  Création et traitement d'images.</li>
    8.42 +</ul>
    8.43 +
    8.44 +<a name="gcolor2"></a>
    8.45 +<h3><font color="#6c0023">Gcolor2 - Selecteur et gestionnaire de colors</font></h3>
    8.46 +<p>
    8.47 +Gcolor2 est un petit outils permettant de séléctionner et conserver des
    8.48 +palettes de couleures. C'est très utile lors de la créations de thèmes pour
    8.49 +SliTaz par exemple. Vous trouverez l'application dans la catégorie
    8.50 +<code>Graphics</code> ou vous pouvez la lancer via la commande :
    8.51 +</p>
    8.52 +<pre>
    8.53 + $ gcolor2 &amp;
    8.54 +</pre>
    8.55 +
    8.56 +<a name="gimp"></a>
    8.57 +<h3><font color="#6c0023">Gimp - Manipulation et création d'images</font></h3>
    8.58 +<p>
    8.59 +The GIMP (GNU Image Manipulation) est un logiciel de manipulation d'images de
    8.60 +très haute qualité. Il permet de faire tous ce qu'on peut attendre d'une
    8.61 +application de traitement d'images, gestion avançée des calques, filtres,
    8.62 +chemin, outils divers, dégradés, ou encore le support des scripts ajoutant des 
    8.63 +fonctionnalités. Gimp support un très grand nombre de format d'images tel que
    8.64 +PNG, JPEG, XPM, PPM, TIFF, PostScript, PSD, il propose aussi son propre format
    8.65 +XCF pemettant de conserver par exemple les claques. Pour installer Gimp :
    8.66 +</p>
    8.67 +<pre>
    8.68 + # tazpkg get-install gimp
    8.69 +</pre>
    8.70 +<p>
    8.71 +Gimp est extensible et peut se configurer via l'interface principale, les
    8.72 +fichiers de configurations, brosses ou scripts personnels vont dans le
    8.73 +répertoire caché <code>~/.gimp-2.2</code>.
    8.74 +</p>
    8.75 +
    8.76 +<a name="gqview"></a>
    8.77 +<h3><font color="#6c0023">GQview - Gestionnaire d'images</font></h3>
    8.78 +<p>
    8.79 +GQview est rapide et léger, il permet une navigation très rapide entre les 
    8.80 +images, par sélection des dossiers se trouvant dans votre arborescence, et
    8.81 +cela se fait en un seul clic de souris. Il intègre la possibilité de faire des
    8.82 +diaporamas, des rotations d'images et d'afficher les données EXIF, d'ajouter 
    8.83 +des mots clés ou tags, de configurer les actions, de glisser-déposer. Il 
    8.84 +donne aussi la possibilité d'éditer les images dans un logiciel externe de 
    8.85 +son choix (mtPaint ou Gimp par exemple), l'interface est entièrement traduite
    8.86 +en français, et est très simple d'utilisation.
    8.87 +</p>
    8.88 +
    8.89 +<a name="jpeg"></a>
    8.90 +<h3><font color="#6c0023">jpeg - Outils JPEG en ligne de commande</font></h3>
    8.91 +<p>
    8.92 +Pour que les applications utilisant les images JPEG fonctionnent, elles
    8.93 +doivent êtres liée aux bibliothèques fournies par le paquet jpeg-6b, ce paquet
    8.94 +propose aussi quelques petits utilitaires à utiliser en ligne de commande.
    8.95 +Pour modifier des images JPEG en ligne de commande, vous pouvez utiliser
    8.96 +<code>jpegtran</code>, installé par défaut sur SliTaz. L'utilitaire
    8.97 +<code>jpegtran</code> permet par exemple de faire une rotation de 
    8.98 +l'image via l'option <code>-rotate</code>. Le paquet jpeg-6b fournit aussi les
    8.99 +outils <code>cjpeg</code> et <code>djpeg</code>. Pour connaître les options
   8.100 +disponibles avec tous ces outils, vous pouvez utiliser l'option 
   8.101 +<code>--help</code> propre à chaque application. Exemple avec 
   8.102 +<code>cjpeg</code> :
   8.103 +</p>
   8.104 +<pre>
   8.105 + $ cjpeg --help
   8.106 +</pre>
   8.107 +
   8.108 +<a name="mtPaint"></a>
   8.109 +<h3><font color="#6c0023">mtPaint -  Création et traitement d'images</font></h3>
   8.110 +<p>
   8.111 +mtPaint est une application de création et de retouche d'images, PNG, TIFF, 
   8.112 +XPM, BMP. Il est presque entièrement traduit en français, offre beaucoup de 
   8.113 +fonctions, simple, léger, et rapide. L'outil mtPaint fournit une fonction de 
   8.114 +capture d'écran (screenshot), que vous pouvez utiliser via le menu 
   8.115 +--&gt; Graphics --&gt; Grab screenshot, ou en tapant la commande ci-dessous
   8.116 +dans un terminal:
   8.117 +</p>
   8.118 +<pre>
   8.119 + $ mtpaint -s
   8.120 +</pre>
   8.121 +
   8.122 +<!-- End of content -->
   8.123 +</div>
   8.124 +
   8.125 +<!-- Footer. -->
   8.126 +<div id="footer">
   8.127 +	<div class="footer-right"></div>
   8.128 +	<a href="#top">Haut de la page</a> | 
   8.129 +	<a href="index.html">Table des matières</a>
   8.130 +</div>
   8.131 +
   8.132 +<div id="copy">
   8.133 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   8.134 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   8.135 +    Documentation publiées sous
   8.136 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   8.137 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   8.138 +</div>
   8.139 +
   8.140 +</body>
   8.141 +</html>

     9.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     9.2 +++ b/doc/handbook-stable/hacking-livecd.html	Fri Feb 06 23:20:14 2009 +0100
     9.3 @@ -0,0 +1,444 @@
     9.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     9.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     9.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     9.7 +<head>
     9.8 +    <title>SliTaz Handbook - Hacking LiveCD</title>
     9.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    9.10 +    <meta name="description" content="modifier generer le livecd manuellement ligne de commande" />
    9.11 +    <meta name="expires" content="never" />
    9.12 +    <meta name="modified" content="2007-12-03 12:30:00" />
    9.13 +    <meta name="publisher" content="www.slitaz.org" />
    9.14 +    <meta name="author" content="Christophe Lincoln"/>
    9.15 +    <link rel="shortcut icon" href="favicon.ico" />
    9.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    9.17 +</head>
    9.18 +<body bgcolor="#ffffff">
    9.19 +
    9.20 +<!-- Header and quick navigation -->
    9.21 +<div id="header">
    9.22 +<div align="right" id="quicknav">
    9.23 +    <a name="top"></a>
    9.24 +    <a href="gen-livecd.html">Générer un LiveCD</a> |
    9.25 +    <a href="index.html">Table des matières</a>
    9.26 +</div>
    9.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
    9.28 +</div>
    9.29 +
    9.30 +<!-- Content. -->
    9.31 +<div id="content">
    9.32 +<div class="content-right"></div>
    9.33 +
    9.34 +<h2><font color="#DF8F06">Hacking SliTaz LiveCD</font></h2>
    9.35 +
    9.36 +<ul>
    9.37 +    <li><a href="#intro">Introduction.</a></li>
    9.38 +    <li><a href="#pre">Organisation et préparation.</a></li>
    9.39 +    <li><a href="#add-files">Ajouter des fichiers dans l'ISO.</a></li>
    9.40 +    <li><a href="#isolinux">Modifier la configuration d'isolinux.</a></li>
    9.41 +    <li><a href="#memtest">Installer et utiliser Memtest86.</a></li>
    9.42 +    <li><a href="#rootfs">Manipuler la racine du système Live.</a></li>
    9.43 +    <li><a href="#gen-iso">Générer une image ISO bootable avec isolinux.</a></li>
    9.44 +</ul>
    9.45 +
    9.46 +<a name="intro"></a>
    9.47 +<h3><font color="#6c0023">Introduction</font></h3>
    9.48 +<p>
    9.49 +<em>Hacking SliTaz LiveCD</em> ou comment s'amuser avec l'image ISO du LiveCD,
    9.50 +la modifier, la personnaliser et la reconstruire à la main. A noter que vous
    9.51 +avez aussi la possibilité de 
    9.52 +<a href="gen-livecd.html">créer une saveur avec Tazlito</a> et cela de. Créer 
    9.53 +sa propre image ISO bootable ne demande que peut de temps, les étapes à suivre
    9.54 +sont soigneusement décrites dans ce document et sont faciles à réaliser. La 
    9.55 +manipulation de l'images ISO permet d'ajouter des nouveaux fichiers ou de 
    9.56 +modifier les fichiers existants sur le cdrom. L'image ISO de SliTaz fait moins
    9.57 +de 30 Mb et un CD-R ou CD-RW classique fournit 700 Mb, il reste donc pas mal
    9.58 +de place, pour mettre par exemple, vos photos afin de les montrer en 
    9.59 +<em>live</em> via SliTaz et un diaporama propulsé par le gestionnaire
    9.60 +d'images GQview. Le <em>hacking</em> de l'image ISO permet de modifier les
    9.61 +fichiers de configuration du chargeur de démarrage (<em>boot loader</em>) et
    9.62 +son image <em>splash</em> ou d'en utiliser un autre tel que GRUB. Vous pouvez
    9.63 +aussi facilement et directement ajouter des utilitaire tel que Memtest86 (outil
    9.64 +servant à tester la RAM d'une machine). En utilisant les mêmes techniques, il
    9.65 +est également possible de modifier le contenu du système en soit, cela demande
    9.66 +quelques manipulations supplémentaires et un peu plus de temps... libre.
    9.67 +</p>
    9.68 +<a name="pre"></a>
    9.69 +<h3><font color="#6c0023">Organisation et préparation</font></h3>
    9.70 +<p>
    9.71 +Pour commencer il faut définir l'endroit ou l'on va travailler, créer un
    9.72 +répertoire de travail et plusieurs sous-répertoires destinés à accueillir les
    9.73 +différents fichiers. Le <em>hacking</em> de l'ISO peut se faire depuis un
    9.74 +système SliTaz ou tous autres système GNU/Linux tels que Debian, Fedora,
    9.75 +PCLinuxOS, Slackware, etc. Si vous utilisez SliTaz en mode LiveCD (vous pouvez
    9.76 +retirer le cdrom une fois SliTaz lancée en RAM et graver votre nouvelle ISO),
    9.77 +nous vous conseillons d'utiliser un media USB pour conserver le travail, sinon
    9.78 +il sera perdu à l'arrêt du système. Pour travailler nous vous proposons 
    9.79 +d'utiliser un répertoire <code>hacked/</code> que vous pouvez créer dans
    9.80 +un répertoire <code>/home/slitaz</code>, à la racine de votre espace
    9.81 +utilisateur, ou ailleurs si vous le désirez. Utiliser un répertoire
    9.82 +<code>/home/slitaz</code> vous permet de stocker une image ISO originale et
    9.83 +de créer en options un répertoire <code>src/</code> pour télécharger
    9.84 +d'éventuelles paquets sources. Toutes les étapes de <em>hacking</em> peuvent
    9.85 +se faire en lignes de commandes via un termial X tel que XTerm ou en mode
    9.86 +texte et un  terminal Linux. A noter que nous vous conseillons de faire les
    9.87 +opérations en tant que <em>root</em> afin d'éviter tous problèmes de
    9.88 +permissions. Pour devenir administrateur (<em>root</em>), créer le
    9.89 +répertoire de travail dans <code>/home/slitaz/hacked</code> et se placer
    9.90 +dedans&nbsp;:
    9.91 +</p>
    9.92 +<pre>
    9.93 + $ su
    9.94 + # mkdir -p /home/slitaz/hacked
    9.95 + (# mkdir -p /home/slitaz/src)
    9.96 + # cd /home/slitaz/hacked
    9.97 +</pre>
    9.98 +<h4>Récupérer les fichiers contenus sur l'ISO</h4>
    9.99 +<p>
   9.100 +Maintenant que vous êtes dans le répertoire de travail, il faut créer la
   9.101 +racine de votre cdrom modifié et récupérer les fichiers contenu dans l'ISO
   9.102 +original du LiveCD. C'est à dire le noyau Linux (<code>bzImage</code>), le
   9.103 +système de fichiers compressé (<code>rootfs.gz</code>) et les fichiers du
   9.104 +chargeur de démarrage Isolinux. Pour récupérer ces fichiers vous avez deux
   9.105 +solutions, soit les prendre depuis un cdrom gravé, soit directement depuis
   9.106 +une image ISO local. Pour créer la racine de votre CD (<code>rootcd</code>)
   9.107 +et copier les fichiers depuis un périphérique cdrom reconnu comme
   9.108 +<code>/dev/cdrom</code> et monté sur <code>/media/cdrom</code>&nbsp;:
   9.109 +</p>
   9.110 +<pre>
   9.111 + # mount -t iso9660 /dev/cdrom /media/cdrom
   9.112 + # mkdir rootcd
   9.113 + # cp -a /media/cdrom/* rootcd
   9.114 +</pre>
   9.115 +<p>
   9.116 +Pour monter une image ISO en <em>loop</em> sur le répertoire temporaire
   9.117 +nommé <code>/tmp/loop</code> (avec l'image ISO <code>slitaz-cooking.iso</code>
   9.118 +préalablement téléchargée ou copiée), créer la racine du CD, copier les
   9.119 +fichiers et démonter l'image ISO&nbsp;:
   9.120 +</p>
   9.121 +<pre>
   9.122 + # mkdir /tmp/loop
   9.123 + # mount -o loop slitaz-cooking.iso /tmp/loop
   9.124 + # mkdir rootcd
   9.125 + # cp -a /tmp/loop/* rootcd
   9.126 + # umount /tmp/loop
   9.127 +</pre>
   9.128 +<p>
   9.129 +Voilà, tous les fichiers nécessaires devraient être présents dans le répertoire
   9.130 +<code>rootcd/</code>, pour vous en assurer, vous pouvez pouver lister
   9.131 +récursivement les fichiers via la commande <code>ls</code>&nbsp;:
   9.132 +</p>
   9.133 +<pre>
   9.134 + # ls -R rootcd
   9.135 +</pre>
   9.136 +<a name="add-files"></a>
   9.137 +<h3><font color="#6c0023">Ajouter des fichiers dans l'ISO</font></h3>
   9.138 +<p>
   9.139 +L'ajout de divers fichiers et répertoires dans l'image ISO consiste
   9.140 +simplement à copier des données à la racine du cdrom (<code>rootcd/</code>)
   9.141 +et à générer une nouvelle image. Les données ajoutées peuvent être classées
   9.142 +dans un ou des répertoires préalablement créés à la racine du CD. Une fois
   9.143 +l'image ISO gravée sur un CD-R/CD-RW vous pourrez utiliser SliTaz comme
   9.144 +avant, monter le cdrom sur <code>/media/cdrom</code> et naviguer dans vos
   9.145 +données graphiquement avec emelFM2, dans un terminal avec Clex ou en ligne de
   9.146 +commandes. Vos données seront aussi lisibles depuis tous les systèmes GNU/Linux,
   9.147 +BSD, et même... Windows.
   9.148 +</p>
   9.149 +<h4>Créer un ou des répertoires et copier des données</h4>
   9.150 +<p>
   9.151 +Pour créer et copier des fichiers vous pouvez commencer par utiliser la
   9.152 +ligne de commande et continuer graphiquement en tant que simple utilisateur.
   9.153 +Nous allons créer un répertoires <code>images/</code> en tant que <em>root</em>
   9.154 +et changer les permissions pour que tous les utilisateurs puissent écrire
   9.155 +dedans&nbsp;:
   9.156 +</p>
   9.157 +<pre>
   9.158 + # mkdir rootcd/images
   9.159 + # chmod 777 rootcd/images
   9.160 +</pre>
   9.161 +<p>
   9.162 +Maintenant qu'un nouveau répertoire existe en écriture pour tous, il faut le
   9.163 +remplir. Une fois que vous avez fini de copier vos données, il suffit de
   9.164 +<a href="#gen-iso">générer une nouvelle image ISO bootable</a>.
   9.165 +</p>
   9.166 +<a name="isolinux"></a>
   9.167 +<h3><font color="#6c0023">Modifier la configuration d'isolinux</font></h3>
   9.168 +<p>
   9.169 +Modifier la configuration d'isolinux vous permet de créer des entrées
   9.170 +personnalisées avec des options de <em>boot</em> prédéfinies, vous pouvez par
   9.171 +exemple ajouter un <code>label</code> lançant SliTaz avec les options
   9.172 +<code>lang=fr</code> et <code>kmap=fr_CH</code>. Au niveau graphisme, vous
   9.173 +pouvez facilement changer l'image <em>splash</em> s'affichant au démarrage.
   9.174 +L'application <code>isolinux</code> est le chargeur de démarrage 
   9.175 +(<em>boot loader</em>) du LiveCD, il est fournit par le paquet Syslinux.
   9.176 +L'archive source de Syslinux fournit diverses applications dont le rôle est
   9.177 +de démarrer un système GNU/Linux. La version binaire <code>isolinux.bin</code>
   9.178 +est déstinée aux image ISO, ce chargeur de démarrage est simple, rapide et
   9.179 +facilement configurable via un fichier de configuration principale, éditable
   9.180 +graphiquement ou dans un terminal avec votre éditeur de texte préféré.
   9.181 +La syntaxe du fichier de configuration <code>isolinux.cfg</code> est facile
   9.182 +à comprendre, pour ajouter de nouvelles entrées il suffit de copier/coller
   9.183 +en utilisant le fichier original. Pour éditer graphiquement le fichier
   9.184 +<code>isolinux.cfg</code> avec Leafpad&nbsp;:
   9.185 +</p>
   9.186 +<pre>
   9.187 + # leafpad rootcd/boot/isolinux/isolinux.cfg &amp;
   9.188 +</pre>
   9.189 +<h4>Fichier de configuration isolinux.cfg</h4>
   9.190 +<p>
   9.191 +Le fichier <code>isolinux.cfg</code>, fourni en standard sur le LiveCD de 
   9.192 +SliTaz, commence par la valeur <code>display</code>, cette valeur permet
   9.193 +d'afficher tel quel un fichier texte ou d'afficher un fichier 
   9.194 +(<code>isolinux.msg</code>) utilisant des caractères ASCII 24 et permettant
   9.195 +d'afficher du texte avec une image <em>splash</em>. La valeur 
   9.196 +<code>default</code> défini le nom du <code>label</code> à démarrer par
   9.197 +défaut après le temps d'attente (<code>timeout</code>). <em>Timeout</em>
   9.198 +correspond au nombre de secondes à attendre avant de booter, vous pouvez le
   9.199 +mettre à 0, hôter la ligne pour démarrer instantanément ou choisir un temps
   9.200 +d'attente plus long tel que 80 s. Pour finir, le <code>prompt</code> peut
   9.201 +être désactivé via la valeur <code>0</code>, les valeurs F1, F2, F3
   9.202 +affichent des fichiers d'aides et F4 est un display au format texte&nbsp;:
   9.203 +</p>
   9.204 +<pre class="script">
   9.205 +display isolinux.msg
   9.206 +default slitaz
   9.207 +label slitaz
   9.208 +      kernel /boot/bzImage
   9.209 +      append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
   9.210 +implicit 0	
   9.211 +prompt 1	
   9.212 +timeout 80
   9.213 +F1 help.txt
   9.214 +F2 options.txt
   9.215 +F3 isolinux.msg
   9.216 +F4 display.txt
   9.217 +</pre>
   9.218 +<p>
   9.219 +Exemple d'un label <code>slitazfr</code> que vous pouvez ajouter à l'orginal,
   9.220 +pour configurer directement la langue du système en français et avoir le
   9.221 +clavier Belge&nbsp;:
   9.222 +</p>
   9.223 +<pre class="script">
   9.224 +label slitazfr
   9.225 +      kernel /boot/bzImage
   9.226 +      append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=be
   9.227 +</pre>
   9.228 +<p>
   9.229 +Une fois que vous avez fini de modifier le fichier de configuration, il ne 
   9.230 +faut pas oublier d'enregistrer vos changements avant de 
   9.231 +<a href="#gen-iso">générer une nouvelle image ISO bootable</a> avec isolinux.
   9.232 +</p>
   9.233 +<a name="memtest"></a>
   9.234 +<h3><font color="#6c0023">Installer et utiliser Memtest86</font></h3>
   9.235 +<p>
   9.236 +L'application memtest86 (92 ko) est un outil autonome de test de mémoire vive
   9.237 +(RAM). Memetes86 permet de tester en profondeur l'état des barrettes de RAM et
   9.238 +de déceler une quelconque défaillance. L'outil s'installe dans le répertoire
   9.239 +<code>boot/</code> de la racine du cdrom et se lance directement au démarrage
   9.240 +de la machine en tapant simplement <code>memtest</code> au prompt d'isolinux.
   9.241 +Direction <code>/home/slitaz/src</code> (si le répertoire n'existe pas&nbsp;:
   9.242 +<code>mkdir -p /home/slitaz/src</code>) pour télécharger les sources et les
   9.243 +désarchiver&nbsp;:
   9.244 +</p>
   9.245 +<pre>
   9.246 + # cd /home/slitaz/src
   9.247 + # wget http://www.memtest86.com/memtest86-3.3.tar.gz
   9.248 + # tar xzf memtest86-3.3.tar.gz
   9.249 +</pre>
   9.250 +<p>
   9.251 +Le paquet source de Memtest86 étant désarchivé (vous y trouverez un fichier
   9.252 +<code>README</code> en anglais donnant des informations sur l'outil), vous
   9.253 +allez pouvoir l'installer dans le <em>root CD</em> de votre ISO hackée. En
   9.254 +partant du principe que vous utilisez un répertoire de travail 
   9.255 +<code>/home/slitaz/hacked</code>, nous allons copier le binaire précompilé
   9.256 +dans le répertoire <code>boot/</code> de la racine du CD&nbsp;:
   9.257 +</p>
   9.258 +<pre>
   9.259 + # cp memtest86-3.3/precomp.bin \
   9.260 +   /home/slitaz/hacked/rootcd/boot/memtest
   9.261 +</pre>
   9.262 +<p>
   9.263 +Maintenant que le binaire est installé dans le <em>root CD</em>, il suffit
   9.264 +d'ajouter une entrée pour Memtest86 dans le fichier de configuration d'isolinux
   9.265 +et de <a href="#gen-iso">générer une nouvelle image ISO bootable</a>.
   9.266 +Direction <code>/home/slitaz/hacked</code> pour éditer le fichier
   9.267 +<code>isolinux.cfg</code> avec LeafPad par exemple&nbsp;:
   9.268 +</p>
   9.269 +<pre>
   9.270 + # cd /home/slitaz/hacked
   9.271 + # leafpad rootcd/boot/isolinux/isolinux.cfg &amp;
   9.272 +</pre>
   9.273 +<pre class="script">
   9.274 +label memtest
   9.275 +      kernel /boot/memtest
   9.276 +</pre>
   9.277 +<p>
   9.278 +Site web officiel de Memtest86&nbsp;:
   9.279 +<a href="http://www.memtest86.com/">http://www.memtest86.com/</a>
   9.280 +</p>
   9.281 +<a name="rootfs"></a>
   9.282 +<h3><font color="#6c0023">Manipuler la racine du système Live</font></h3>
   9.283 +<p>
   9.284 +La modification du système Live vous permet par exemple d'ajouter rapidement
   9.285 +un nouvel utilisateur avec mot de passe, de personnaliser le graphisme ou
   9.286 +d'ajouter des commandes exécutées automatiquement au démarrage du LiveCD. Les
   9.287 +opérations nécessaires à la modification du système de fichier racine (
   9.288 +<em>root file system</em>) sont&nbsp;: extraire le système du fichier compresé
   9.289 +<code>rootfs.gz</code>, modfier, reconstruire l'image du système compressé
   9.290 +et générer une nouvelle ISO. En partant du principe que vous avez déjà
   9.291 +<a href="#pre">préparé votre répertoire de travail</a>, il faut commencer
   9.292 +par créer un répertoire destiné à contenir les fichiers du système modifiable.
   9.293 +Le système racine compressé étant nommé <code>rootfs.gz</code>, nous vous
   9.294 +proposons d'utiliser un répertoire <code>rootfs/</code> pour l'extraire. 
   9.295 +Direction le répertoire de travail <code>hacked/</code>, création du
   9.296 +répertoire racine et copie du système compressé depuis le répertoire
   9.297 +<code>rootcd/boot/</code> (la racine du cdrom)&nbsp;:
   9.298 +</p>
   9.299 +<pre>
   9.300 + # cd /home/slitaz/hacked
   9.301 + # mkdir rootfs
   9.302 + # cp rootcd/boot/rootfs.gz rootfs
   9.303 +</pre>
   9.304 +<p>
   9.305 +Maintenant que vous avez une copie du système compressé, il suffit de le
   9.306 +décompresser et de le désarchiver avec <code>cpio</code>. Techniquement : Le
   9.307 +fichier <code>rootfs.gz</code> est une archive Cpio compressé avec LZMA ou
   9.308 +Gzip, elle est reconnue comme une image <code>initramfs</code> par le noyau
   9.309 +Linux. Lors du démarrage de la machine, le noyau se charge en mémoire et
   9.310 +décompresse l'image du système en mémoire vive pour finir par exécuter les
   9.311 +scripts d'initialisation. Pour extraire le système dans le répertoire 
   9.312 +<code>rootfs/</code> et supprimer la copie désarchivée (Rappel : vous pouvez
   9.313 +copier/coller les commandes) :
   9.314 +</p>
   9.315 +<pre>
   9.316 + # cd rootfs
   9.317 + # (zcat rootfs.gz 2&gt;/dev/null || lzma d rootfs.gz -so) | cpio -id
   9.318 + # rm rootfs rootfs.gz
   9.319 +</pre>
   9.320 +<p>
   9.321 +Le système est prêt à être modifié, vous pouvez lister les fichiers contenus
   9.322 +à la racine de votre système hackable en utilisant la commande <code>ls</code>.
   9.323 +</p>
   9.324 +<h4>Modifier un fichier</h4>
   9.325 +<p>
   9.326 +Pour faire simple et vous aider comprendre le principe, nous allons modifier
   9.327 +un fichier script dans le but d'ajouter deux commandes exécutées
   9.328 +automatiquement à chaque démarrage du LiveCD. La cible est&nbsp;:
   9.329 +<code>etc/init.d/local.sh</code>, il suffit de l'ouvrir avec votre éditeur de
   9.330 +texte préféré tel que Geany&nbsp;:
   9.331 +</p>
   9.332 +<pre>
   9.333 + # geany etc/init.d/local.sh &amp;
   9.334 +</pre>
   9.335 +<p>
   9.336 +Nous allons ajouter une commande affichant un message et faisant dormir le
   9.337 +système 4 secondes (c'est juste pour se faire la main). Example de lignes à
   9.338 +ajouter au script déstiné aux commandes locales&nbsp;:
   9.339 +</p>
   9.340 +<pre class="script">
   9.341 +echo "* Hacked SliTaz version booting..."
   9.342 +sleep 4
   9.343 +</pre>
   9.344 +<h4>Reconstruire l'image du système compressée</h4>
   9.345 +<p>
   9.346 +Une fois les modifications terminées, vous pouvez reconstruire une image
   9.347 +compressée de votre système modifié en utilisant <code>find</code> pour 
   9.348 +trouver les fichiers, <code>cpio</code> pour archiver, <code>lzma</code> ou
   9.349 +<code>gzip </code> pour compresser et des pipes <code>|</code> pour connecter
   9.350 +le tout. Cette commande doit être lancée depuis le répertoire racine du
   9.351 +système (<code>rootfs/</code>) et crée un fichier compressé 
   9.352 +<code>rootfs.gz</code> dans le répertoire précédant :
   9.353 +</p>
   9.354 +<pre>
   9.355 + # find . -print | cpio -o -H newc | lzma e -si -so &gt; ../rootfs.gz
   9.356 + Ou avec gzip :
   9.357 + # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
   9.358 +</pre>
   9.359 +<p>
   9.360 +Pour finir il suffit de copier votre système compressé dans le répertoire
   9.361 +<code>boot/</code> de la racine du CD et de <a href="#gen-iso"
   9.362 +>générer une nouvelle image ISO bootable</a> avec isolinux. Pour copier le
   9.363 +<em>rootfs</em> en écrasant l'actuel, direction le répertoire de travail :
   9.364 +</p>
   9.365 +<pre>
   9.366 + # cd ../
   9.367 + # cp -a rootfs.gz rootcd/boot
   9.368 +</pre>
   9.369 +<a name="gen-iso"></a>
   9.370 +<h3><font color="#6c0023">Générer une image ISO bootable avec isolinux</font></h3>
   9.371 +<p>
   9.372 +La suite de commandes permettant de créer une image avec le 
   9.373 +<em>boot loader</em> <code>isolinux</code>, utilise l'application
   9.374 +<code>genisoimage</code> suivie de nombreuses options. Le nom de l'ISO est
   9.375 +spécifié au début, après l'option <code>-o</code> et le répertoire racine
   9.376 +(<code>rootcd/</code>) tout à la fin, après l'option
   9.377 +<code>-boot-info-table</code> :
   9.378 +</p>
   9.379 +<pre>
   9.380 + # genisoimage -R -o slitaz-hacked.iso -b boot/isolinux/isolinux.bin \
   9.381 +   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
   9.382 +   -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table rootcd
   9.383 +</pre>
   9.384 +<p>
   9.385 +Si vous désirez vérifier le contenu de l'ISO avant gravage, il suffit
   9.386 +de monter l'image en <code>loop</code> et de lister les fichiers. Sur SliTaz
   9.387 +et la plupart des systèmes GNU/Linux, vous pouvez graver des images au
   9.388 +format ISO avec l'utilitaire <code>wodim</code> fournit par <a 
   9.389 +href="utilities.html#cdrkit">cdrkit</a>.
   9.390 +</p>
   9.391 +<h4>Générer de nouvelles ISO via un script</h4>
   9.392 +<p>
   9.393 +Si vous testez plusieurs possibilités et que vous êtes amené à souvent générer
   9.394 +des nouvelles images ISO, vous aurez peut être envie de semi-automatiser les
   9.395 +opérations via un simple petit script SHell. Ce petit script peut être créé
   9.396 +en ligne de commandes ou édité graphiquement, mais il ne faut oublier de le
   9.397 +rendre exécutable. Vous pouvez créer le script avec la commande 
   9.398 +<code>cat</code>, à noter que <code>EOF</code> signifie <em>End Of File</em>,
   9.399 +c'est la que le fichier se termine. Nous vous proposons de nommer le script
   9.400 +<code>gen_hacked_iso.sh</code> et d'utiliser deux variables permettant de 
   9.401 +rapidement changer le nom de l'image ISO et le chemin vers le répertoire
   9.402 +racine du cdrom :
   9.403 +</p>
   9.404 +<pre>
   9.405 + # cat &gt; gen_hacked_iso.sh &lt;&lt; "EOF"
   9.406 +</pre>
   9.407 +<pre class="script">
   9.408 +#!/bin/sh
   9.409 +# Gen a new hacked ISO image.
   9.410 +#
   9.411 +ISO_NAME="slitaz-hacked.iso"
   9.412 +ROOTCD="rootcd"
   9.413 +
   9.414 +genisoimage -R -o $ISO_NAME -b boot/isolinux/isolinux.bin \
   9.415 +   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
   9.416 +   -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table $ROOTCD
   9.417 +
   9.418 +EOF
   9.419 +</pre>
   9.420 +<p>
   9.421 +Pour utiliser le script, il suffit de le rendre exécutable et de l'exécuter :
   9.422 +</p>
   9.423 +<pre>
   9.424 + # chmod +x gen_hacked_iso.sh
   9.425 + # ./gen_hacked_iso.sh
   9.426 +</pre>
   9.427 +
   9.428 +<!-- End of content -->
   9.429 +</div>
   9.430 +
   9.431 +<!-- Footer. -->
   9.432 +<div id="footer">
   9.433 +	<div class="footer-right"></div>
   9.434 +	<a href="#top">Haut de la page</a> | 
   9.435 +	<a href="index.html">Table des matières</a>
   9.436 +</div>
   9.437 +
   9.438 +<div id="copy">
   9.439 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
   9.440 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   9.441 +    Documentation publiées sous
   9.442 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   9.443 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
   9.444 +</div>
   9.445 +
   9.446 +</body>
   9.447 +</html>

    10.1 --- a/doc/handbook-stable/handbook/book.css	Fri Feb 06 23:17:00 2009 +0100
    10.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    10.3 @@ -1,170 +0,0 @@
    10.4 -/* 
    10.5 -	CSS style for SliTaz GNU/Linux *book.
    10.6 -	Pankso 2007 - www.slitaz.org
    10.7 -*/
    10.8 -
    10.9 -body {
   10.10 -	font: 13px sans-serif, vernada, arial;
   10.11 -	background: #222222;
   10.12 -	margin: 0;
   10.13 -	padding-bottom: 100%;
   10.14 -}
   10.15 -
   10.16 -#header {
   10.17 -	background: #BFB06B url(images/css/header.png) repeat-x top;
   10.18 -	color: black;
   10.19 -	height: 50px;
   10.20 -	border-top: 1px solid black;
   10.21 -	border-bottom: 1px solid black;
   10.22 -}
   10.23 -#quicknav {
   10.24 -	margin-right: 6px;
   10.25 -	text-align: right;
   10.26 -	font-size: 12px;
   10.27 -	}
   10.28 -#quicknav {
   10.29 -	margin-right: 6px;
   10.30 -}
   10.31 -
   10.32 -#quicknav a {
   10.33 -	background: inherit;
   10.34 -	color: #222222;
   10.35 -}
   10.36 -
   10.37 -#quicknav a:hover {
   10.38 -	background: inherit;
   10.39 -	color: #EDEDED;
   10.40 -}
   10.41 -
   10.42 -/*  content. */
   10.43 -
   10.44 -#content {
   10.45 -	background: white url(images/css/content-tl.png) no-repeat top left;
   10.46 -	color: black;
   10.47 -	padding: 20px;
   10.48 -	margin: 30px 50px 0px 50px;
   10.49 -	width: auto;
   10.50 -	text-align: justify;
   10.51 -}
   10.52 -
   10.53 -#content li {
   10.54 -	line-height: 1.5em;
   10.55 -	text-align: left;
   10.56 -}
   10.57 -
   10.58 -/*  Footer. */
   10.59 -
   10.60 -#footer {
   10.61 -	font-size: 11px;
   10.62 -	font-weight: bold;
   10.63 -	background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left;
   10.64 -	color: black;
   10.65 -	height: 20px;
   10.66 -	padding: 6px 0px 0px 10px;
   10.67 -	margin: 0px 50px 0px 50px;
   10.68 -	width: auto;
   10.69 -	text-align: center ;
   10.70 -}
   10.71 -
   10.72 -#footer a {
   10.73 -	text-decoration: none;
   10.74 -	background: #eaeaea;
   10.75 -	color: #3E1220;
   10.76 -}
   10.77 -
   10.78 -#footer a:hover {
   10.79 -	background: #eaeaea;
   10.80 -	color: #DF8F06;
   10.81 -}
   10.82 -
   10.83 -/* Legal information */
   10.84 -
   10.85 -#copy {
   10.86 -	font-size: 11px ;
   10.87 -	text-align: center ;
   10.88 -	background: transparent;
   10.89 -	color: #a8a8a8;
   10.90 -	padding-top: 20px;
   10.91 -}
   10.92 -
   10.93 -#copy a {
   10.94 -	background: inherit;
   10.95 -	color: #a8a8a8;
   10.96 -}
   10.97 -
   10.98 -#copy a:hover {
   10.99 -	background: inherit;
  10.100 -	color: #EDEDED;
  10.101 -}
  10.102 -
  10.103 -/* Div for round corners. */
  10.104 -
  10.105 -.content-right, .footer-right {
  10.106 -	width: 16px;
  10.107 -	color: white;
  10.108 -	background-color: #333333;
  10.109 -}
  10.110 -.content-right {
  10.111 -	background: url(images/css/content-tr.png) no-repeat top right;
  10.112 -	height: 16px;
  10.113 -	right: 50px;
  10.114 -	top: 82px;
  10.115 -	position: absolute;
  10.116 -}
  10.117 -
  10.118 -.footer-right {
  10.119 -	background: url(images/css/footer-br.png) no-repeat bottom right;
  10.120 -	height: 20px;
  10.121 -	float: right;
  10.122 -}
  10.123 -
  10.124 -/* General HTML entities for  content. */
  10.125 -
  10.126 -h1 {
  10.127 -	margin: 0px 0px 0px 16px;
  10.128 -}
  10.129 -
  10.130 -h2 {
  10.131 -	margin: 12px 0;
  10.132 -	color: #484B7C;
  10.133 -	background: white;
  10.134 -}
  10.135 -
  10.136 -h3 {
  10.137 -	font-weight: bold;
  10.138 -	color: #6c0023;
  10.139 -	background: white;
  10.140 -}
  10.141 -
  10.142 -a {
  10.143 -	text-decoration: underline;
  10.144 -}
  10.145 -a:hover {
  10.146 -	text-decoration: none;
  10.147 -}
  10.148 -
  10.149 -pre {
  10.150 -	padding: 5px;
  10.151 -	color: black;
  10.152 -	background: #e1e0b0;
  10.153 -}
  10.154 -pre.script {
  10.155 -	padding: 10px;
  10.156 -	color: black;
  10.157 -	background: #e8e8e8;
  10.158 -	border: 1px inset #333333;
  10.159 -}
  10.160 -
  10.161 -code {
  10.162 -	font-size: 12px;
  10.163 -	color: #669900;
  10.164 -	background: transparent;
  10.165 -}
  10.166 -
  10.167 -li {
  10.168 -	line-height: 1.4em;
  10.169 -}
  10.170 -
  10.171 -hr {
  10.172 -	border: 0pt none;
  10.173 -}

    11.1 --- a/doc/handbook-stable/handbook/chroot-env.html	Fri Feb 06 23:17:00 2009 +0100
    11.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    11.3 @@ -1,196 +0,0 @@
    11.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    11.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    11.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    11.7 -<head>
    11.8 -    <title>SliTaz Handbook - Chroot env</title>
    11.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   11.10 -    <meta name="description" content="SliTaz chroot environnement chrooté développer tester" />
   11.11 -    <meta name="expires" content="never" />
   11.12 -    <meta name="modified" content="2007-12-03 12:30:00" />
   11.13 -    <meta name="publisher" content="www.slitaz.org" />
   11.14 -    <meta name="author" content="Christophe Lincoln"/>
   11.15 -    <link rel="shortcut icon" href="favicon.ico" />
   11.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   11.17 -</head>
   11.18 -<body bgcolor="#ffffff">
   11.19 -
   11.20 -<!-- Header and quick navigation -->
   11.21 -<div id="header">
   11.22 -<div align="right" id="quicknav">
   11.23 -    <a name="top"></a>
   11.24 -    <a href="hacking-livecd.html">Hacking LiveCD</a> |
   11.25 -    <a href="index.html">Table des matières</a>
   11.26 -</div>
   11.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   11.28 -</div>
   11.29 -
   11.30 -<!-- Content. -->
   11.31 -<div id="content">
   11.32 -<div class="content-right"></div>
   11.33 -
   11.34 -<h2><font color="#DF8F06">Chroot environment</font></h2>
   11.35 -
   11.36 -<p>
   11.37 -Ce document décrit les étapes à réaliser pour créer un environnement chrooté,
   11.38 -afin de changer la racine du système pour travailler. Cela permet de compiler,
   11.39 -tester et développer SliTaz sans risques pour le système hôte depuis lequel
   11.40 -on travaille. Ce système hôte peut être SliTaz installée en dur ou tout autre
   11.41 -système GNU/Linux tel que Debian, Fedora, PCLinuxOS, etc. On peut aussi créer
   11.42 -un environnement chrooté en mode LiveCD associé à un media USB. Les seuls
   11.43 -prérequis sont d'avoir une image ISO de SliTaz à disposition et un peu de
   11.44 -temps. A noter que toutes les opérations sont réalisées en tant
   11.45 -qu'administrateur (<em>root</em>).
   11.46 -</p>
   11.47 -<h3><font color="#6c0023">Préparer l'environnement</font></h3>
   11.48 -<p>
   11.49 -Pour commencer, il faut extraire le contenu de l'image ISO dans le répertoire
   11.50 -qui va servir au chroot. Le répertoire de chroot peut se créer à l'endroit que
   11.51 -l'on veut, nous utilisons un répertoire <code>/home/slitaz/chroot-env</code>.
   11.52 -Pour extraire le contenu d'une image ISO, il faut la monter en <em>loop</em>
   11.53 -sur un répertoire, pour ensuite copier le système de fichiers racine
   11.54 -compressé (<code>rootfs.gz</code>) dans le répertoire de chroot. En
   11.55 -supposant que l'ISO est dans le répertoire courant :
   11.56 -</p>
   11.57 -<pre>
   11.58 - # mkdir /tmp/loop
   11.59 - # mount -o loop slitaz-cooking.iso /tmp/loop
   11.60 - # mkdir -p /home/slitaz/chroot-env
   11.61 - # cp /tmp/loop/boot/rootfs.gz \
   11.62 -   /home/slitaz/chroot-env
   11.63 - # umount /tmp/loop
   11.64 -</pre>
   11.65 -<p>
   11.66 -Maintenant qu'on a une copie du système de fichiers compressé, il faut le
   11.67 -décompresser et le désarchiver (c'est une archive <code>cpio</code> compressée
   11.68 -avec lzma ou gzip). Pour finir cette étape de préparation et continuer, on 
   11.69 -peut retirer le <code>rootfs</code> qui n'est plus utilisé :
   11.70 -</p>
   11.71 -<pre>
   11.72 - # cd /home/slitaz/chroot-env
   11.73 - # (zcat rootfs.gz 2>/dev/null || lzma d rootfs.gz -so) | cpio -id
   11.74 - # rm rootfs rootfs.gz
   11.75 -</pre>
   11.76 -<p>
   11.77 -Si le désarchivage du rootfs compressé avec LZMA échoue  en utilisant la 
   11.78 -première méthode vous pouvez utiliser:
   11.79 -</p>
   11.80 -<pre>
   11.81 - # unlzma rootfs.gz -S .gz 
   11.82 - # cat rootfs | cpio -id
   11.83 -</pre>
   11.84 -
   11.85 -<h3><font color="#6c0023">Utiliser l'environnement</font></h3>
   11.86 -<p>
   11.87 -Pour utiliser l'environnemnt chrooté, il suffit de monter quelques systèmes
   11.88 -de fichier virtuels et d'utiliser la commande <code>chroot</code>. Pour se
   11.89 -simplifier la vie on peut rapidement créer un petit script automatisant
   11.90 -le chroot. Exemple en utilisant le répertoire de chroot
   11.91 -<code>/home/slitaz/chroot-env</code> et en créant un script nommé
   11.92 -<code>chroot_in_env.sh</code> dans <code>/home/slitaz</code>. A noter que
   11.93 -le contenu du script n'a pas besoin d'être tapé mais simplement copié/coller
   11.94 -dans le terminal et que sur un autre système que SliTaz vous pouvez
   11.95 -décommenter les lignes montant/démontant <code>/dev</code> et
   11.96 -<code>/tmp</code> :
   11.97 -</p>
   11.98 -<pre>
   11.99 - # cat &gt; /home/slitaz/chroot_in_env.sh &lt;&lt; "EOF"
  11.100 -</pre>
  11.101 -<pre class="script">
  11.102 -#!/bin/sh
  11.103 -# Chroot in SliTaz to hack.
  11.104 -#
  11.105 -ROOTFS="/home/slitaz/chroot-env"
  11.106 -
  11.107 -# Mount virtual Kernel file systems and chroot.
  11.108 -#
  11.109 -#mount --bind /dev $ROOTFS/dev
  11.110 -#mount --bind /tmp $ROOTFS/tmp
  11.111 -mount -t proc proc $ROOTFS/proc
  11.112 -mount -t sysfs sysfs $ROOTFS/sys
  11.113 -mount -t devpts devpts $ROOTFS/dev/pts
  11.114 -mount -t tmpfs shm $ROOTFS/dev/shm
  11.115 -
  11.116 -echo "Chrooting in $ROOTFS... "
  11.117 -chroot $ROOTFS /bin/sh --login
  11.118 -
  11.119 -# Unmount virtual Kernel file systems on exit.
  11.120 -#
  11.121 -umount $ROOTFS/dev/shm
  11.122 -umount $ROOTFS/dev/pts
  11.123 -umount $ROOTFS/sys
  11.124 -umount $ROOTFS/proc
  11.125 -#umount $ROOTFS/tmp
  11.126 -#umount $ROOTFS/dev
  11.127 -
  11.128 -echo "Exiting of $ROOTFS chroot environment... "
  11.129 -
  11.130 -EOF
  11.131 -</pre>
  11.132 -<p>
  11.133 -Pour finir et tester l'environnement, il suffit de rendre le script exécutable
  11.134 -et le lancer :
  11.135 -</p>
  11.136 -<pre>
  11.137 - # chmod +x /home/slitaz/chroot_in_env.sh
  11.138 - # sh /home/slitaz/chroot_in_env.sh
  11.139 -</pre>
  11.140 -<h4>Activer le réseau</h4>
  11.141 -<p>
  11.142 -Pour avoir le réseau afin de télécharger, naviguer en mode texte et installer
  11.143 -des paquets de développement, il suffit de lancer le client DHCP sur la bonne
  11.144 -interface, exemple avec <code>eth1</code> :
  11.145 -</p>
  11.146 -<pre>
  11.147 - /# udhcpc -i eth1
  11.148 -</pre>
  11.149 -<h4>Installer des paquets</h4>
  11.150 -<p>
  11.151 -Si le réseau est fonctionnel, il suffit de recharger la liste des paquets et
  11.152 -utiliser <code>tazpkg get-install</code> pour installer de nouveaux paquets.
  11.153 -Si la connexion n'est pas possible, on peut télécharger les paquets du miroir
  11.154 -depuis un autre système, les copier dans l'environnement chrooté et les
  11.155 -installer via la commande <code>tazpkg install</code>. Pour installer la base
  11.156 -des outils de compilation :
  11.157 -</p>
  11.158 -<pre>
  11.159 - /# tazpkg recharge
  11.160 - /# tazpkg get-install slitaz-toolchain
  11.161 -</pre>
  11.162 -<p>
  11.163 -Une fois l'environnement configuré, on peut complier des applications
  11.164 -depuis les sources pour en créer des paquets, tester des scripts et autre.
  11.165 -Le chapitre <a href="development.html">développement</a> du Handbook et le
  11.166 -<a href="http://www.slitaz.org/doc/cookbook/">Cookbook</a> devraient aider à
  11.167 -aller plus loin.
  11.168 -</p>
  11.169 -<h4>Sortir de l'environnement</h4>
  11.170 -<p>
  11.171 -Pour sortir de l'environnement chrooté il suffit de taper <code>exit</code>,
  11.172 -le script <code>chroot_in_env.sh</code> va finir son rôle en démontant
  11.173 -le systèmes de fichiers virtuels propre au Kernel Linux :
  11.174 -</p>
  11.175 -<pre>
  11.176 - /# exit
  11.177 - #
  11.178 -</pre>
  11.179 -
  11.180 -<!-- End of content -->
  11.181 -</div>
  11.182 -
  11.183 -<!-- Footer. -->
  11.184 -<div id="footer">
  11.185 -	<div class="footer-right"></div>
  11.186 -	<a href="#top">Haut de la page</a> | 
  11.187 -	<a href="index.html">Table des matières</a>
  11.188 -</div>
  11.189 -
  11.190 -<div id="copy">
  11.191 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  11.192 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  11.193 -    Documentation publiées sous
  11.194 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  11.195 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  11.196 -</div>
  11.197 -
  11.198 -</body>
  11.199 -</html>

    12.1 --- a/doc/handbook-stable/handbook/cmdline.html	Fri Feb 06 23:17:00 2009 +0100
    12.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    12.3 @@ -1,363 +0,0 @@
    12.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    12.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    12.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    12.7 -<head>
    12.8 -    <title>SliTaz Handbook - Ligne de commandes</title>
    12.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   12.10 -    <meta name="description" content="commande de base linux SliTaz help ls cd wget ligne de commandes console terminal xterm" />
   12.11 -    <meta name="expires" content="never" />
   12.12 -    <meta name="modified" content="2007-12-03 12:30:00" />
   12.13 -    <meta name="publisher" content="www.slitaz.org" />
   12.14 -    <meta name="author" content="Christophe Lincoln"/>
   12.15 -    <link rel="shortcut icon" href="favicon.ico" />
   12.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   12.17 -</head>
   12.18 -<body bgcolor="#ffffff">
   12.19 -
   12.20 -<!-- Header and quick navigation -->
   12.21 -<div id="header">
   12.22 -<div align="right" id="quicknav">
   12.23 -    <a name="top"></a>
   12.24 -    <a href="jwm.html">JWM</a> |
   12.25 -    <a href="index.html">Table des matières</a>
   12.26 -</div>
   12.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   12.28 -</div>
   12.29 -
   12.30 -<!-- Content. -->
   12.31 -<div id="content">
   12.32 -<div class="content-right"></div>
   12.33 -
   12.34 -<h2><font color="#DF8F06">Références en ligne de commandes (<em>cmdline</em>)</font></h2>
   12.35 -
   12.36 -<ul>
   12.37 -    <li><a href="#intro">Introduction aux commandes.</a></li>
   12.38 -    <li><a href="#help">Aide et liste des commandes disponibles.</a></li>
   12.39 -    <li><a href="#ls">Lister les fichiers contenus dans un répertoire.</a></li>
   12.40 -    <li><a href="#cd">Se déplacer dans les répertoires.</a></li>
   12.41 -    <li><a href="#cp">Copier des fichiers.</a></li>
   12.42 -    <li><a href="#mkdir">Créer de nouveaux répertoires.</a></li>
   12.43 -    <li><a href="#rm">Supprimer des fichiers ou des répertoires.</a></li>
   12.44 -    <li><a href="#read">Lire des fichiers.</a></li>
   12.45 -    <li><a href="#edit">Editer des fichiers en mode ncurses.</a></li>
   12.46 -    <li><a href="#cat">Cat</a> - &Eacute;diter en ligne de commandes.</li>
   12.47 -    <li><a href="#web-nav">Naviguer sur le web.</a></li>
   12.48 -    <li><a href="#irc-chat">Discuter sur les canaux IRC.</a></li>
   12.49 -    <li><a href="#wget">Télécharger des fichiers.</a></li>
   12.50 -    <li><a href="#partitions">Lister les partitions disponibles.</a></li>
   12.51 -    <li><a href="#mount">Monter une partition, un cdrom ou une clé USB.</a></li>
   12.52 -    <li><a href="#halt">Eteindre le système, ou redémarrer.</a></li>
   12.53 -</ul>
   12.54 -
   12.55 -<a name="intro"></a>
   12.56 -<h3><font color="#6c0023">Introduction aux commandes</font></h3>
   12.57 -<p>
   12.58 -Ce document se veut être un rapide référentiel pour utiliser SliTaz en ligne
   12.59 -commandes via un terminal Linux ou un terminal graphique (XTerm).
   12.60 -Vous disposez de nombreuses commandes GNU/Linux de manipulation des fichiers,
   12.61 -de maintenance système ou de gestion du réseau. Vous pouvez aussi naviguer sur
   12.62 -le web, chatter sur l'IRC, télécharger, éditer des scripts et même jouer en
   12.63 -mode texte. Note : il faut être <em>root</em> pour les opérations de montage 
   12.64 -de disques durs ou de cdrom. Vous pouvez utiliser la commande <code>su</code>
   12.65 -pour devenir administrateur système.
   12.66 -</p>
   12.67 -<a name="help"></a>
   12.68 -<h3><font color="#6c0023">Aide et liste des commandes disponibles</font></h3>
   12.69 -<p>
   12.70 -La plupart des commandes des systèmes GNU/Linux ont une option d'aide pour des
   12.71 -infos sur leur utilisation. Pour avoir de l'aide et connaître des informations 
   12.72 -sur l'utilisation d'une commande il faut taper le nom de la commande suivie 
   12.73 -de l'option <code>--help</code>. Exemple avec la commande de copie de fichiers
   12.74 -<code>cp</code> :
   12.75 -</p>
   12.76 -<pre>
   12.77 - $ cp --help
   12.78 -</pre>
   12.79 -<p>
   12.80 -Pour lister les commandes disponibles sur le système, vous pouvez simplement
   12.81 -taper 2 fois sur la touche de tabulation qui se trouve à gauche du clavier
   12.82 -et comporte 2 flèches horizontales et opposées. Pour connaître les commandes
   12.83 -fournient par Busybox, vous pouvez taper <code>help</code>.
   12.84 -</p>
   12.85 -<a name="ls"></a>
   12.86 -<h3><font color="#6c0023">Lister les fichiers contenus dans un répertoire</font></h3>
   12.87 -<p>
   12.88 -Pour lister les fichiers et les dossiers contenus dans un répertoire, vous 
   12.89 -pouvez utiliser la commande <code>ls</code>.  Pour connaître toutes les
   12.90 -possibilités, n'oubliez pas d'utiliser l'option <code>--help</code>. Pour
   12.91 -simplement lister les fichiers du répertoire courant :
   12.92 -</p>
   12.93 -<pre>
   12.94 - $ ls
   12.95 -</pre>
   12.96 -<p>
   12.97 -Lister tous les fichiers en utilisant l'option <code>-al</code> :
   12.98 -</p>
   12.99 -<pre>
  12.100 - $ ls -al
  12.101 -</pre>
  12.102 -<p>
  12.103 -Lister un répertoire donné:
  12.104 -</p>
  12.105 -<pre>
  12.106 - $ ls /home/slitaz
  12.107 -</pre>
  12.108 -<a name="cd"></a>
  12.109 -<h3><font color="#6c0023">Se déplacer dans les répertoires</font></h3>
  12.110 -<p>
  12.111 -Pour naviguer dans les fichiers vous pouvez utiliser la commande 
  12.112 -<code>cd</code> :
  12.113 -</p>
  12.114 -<pre>
  12.115 - $ cd /usr/share/doc
  12.116 - Revenir au réperoire parent :
  12.117 - $ cd ..
  12.118 -</pre>
  12.119 -<p>
  12.120 -Pour aller dans le répertoire de l'utilisateur (root = /root) :
  12.121 -</p>
  12.122 -<pre>
  12.123 - $ cd
  12.124 - Ou :
  12.125 - $ cd ~
  12.126 - Ou encore :
  12.127 - $ cd $HOME
  12.128 -</pre>
  12.129 -
  12.130 -<a name="cp"></a>
  12.131 -<h3><font color="#6c0023">Copier des fichiers</font></h3>
  12.132 -<p>
  12.133 -La commande <code>cp</code> copier des fichiers ou des dossiers. L'exemple
  12.134 -copie le fichier info.txt se trouve dans le répertoire courant, vers le 
  12.135 -répertoire Documents/ :
  12.136 -</p>
  12.137 -<pre>
  12.138 - $ cp info.txt Documents/
  12.139 -</pre>
  12.140 -<p>
  12.141 -Copier un répertoire entier. Ici la commande copie le répertoire Templates/
  12.142 -dans /home/hacker :
  12.143 -</p>
  12.144 -<pre>
  12.145 - $ cp -a Templates /home/hacker
  12.146 -</pre>
  12.147 -
  12.148 -<a name="mkdir"></a>
  12.149 -<h3><font color="#6c0023">Créer de nouveaux répertoires</font></h3>
  12.150 -<p>
  12.151 -mkdir de l'Anglais make a directory. Cette commande permet de créer un nouveau
  12.152 -répertoire. La commande ci-dessous crée un répertoire qui se nomme Projects.
  12.153 -Il se créera dans le répértoite /home de l'utilisateur courant ou dans le 
  12.154 -répertoire dans lequel on se trouve :
  12.155 -</p>
  12.156 -<pre>
  12.157 - $ mkdir Projects
  12.158 -</pre>
  12.159 -<p>
  12.160 -Création d'un répertoire qui se nomme script-1.0 dans le dossier Projects/ :
  12.161 -</p>
  12.162 -<pre>
  12.163 - $ mkdir Projects/script-1.0
  12.164 -</pre>
  12.165 -
  12.166 -<a name="rm"></a>
  12.167 -<h3><font color="#6c0023">Supprimer des fichiers ou des répertoires</font></h3>
  12.168 -<p>
  12.169 -La commande <code>rm</code> permet de supprimer un fichier. Imaginons que 
  12.170 -nous allons supprimer le fichier fichier.txt et qui se trouve dans le 
  12.171 -répertoire courant :
  12.172 -</p>
  12.173 -<pre>
  12.174 - $ rm fichier.txt
  12.175 -</pre>
  12.176 -<p>
  12.177 -La commande <code>rm</code> a plusieurs options. Pour supprimer tout un
  12.178 -répertoire avec son contenu, il faut utiliser l'option <code>-rf</code>.
  12.179 -Exemple :
  12.180 -</p>
  12.181 -<pre>
  12.182 - $ rm -rf /home/hacker/Templates
  12.183 -</pre>
  12.184 -
  12.185 -<a name="read"></a>
  12.186 -<h3><font color="#6c0023">Lire des fichiers</font></h3>
  12.187 -<p>
  12.188 -Pour lire le contenu d'un fichier ou d'un script, vous pouvez utiliser les
  12.189 -commandes <code>less</code>, <code>more</code>, <code>cat</code>, ou encore 
  12.190 -le navigateur web Retawq. Exemples avec un fichier README, essential.txt, et 
  12.191 -script.sh :
  12.192 -</p>
  12.193 -<pre>
  12.194 - $ less -EM essential.txt
  12.195 - ou:
  12.196 - $ more README
  12.197 - ou encore:
  12.198 - $ cat /chemin/script.sh
  12.199 -</pre>
  12.200 -<p>
  12.201 -Afficher un fichier texte ou html avec le navigateur web Retawq :
  12.202 -</p>
  12.203 -<pre>
  12.204 - $ retawq /usr/share/doc/index.html
  12.205 -</pre>
  12.206 -
  12.207 -<a name="edit"></a>
  12.208 -<h3><font color="#6c0023">Editer des fichiers</font></h3>
  12.209 -<p>
  12.210 -L'édition de fichiers texte, scripts, fichier de configurations, etc, peut se
  12.211 -faire facilement avec l'éditeur GNU Nano dans une console ou un terminal 
  12.212 -graphique. Exemple avec un fichier bookmarks.html (&lt;Ctrl+X&gt; pour quitter
  12.213 -et enregistrer) :
  12.214 -</p>
  12.215 -<pre>
  12.216 - $ nano Public/bookmarks.html
  12.217 -</pre>
  12.218 -
  12.219 -<a name="cat"></a>
  12.220 -<h3><font color="#6c0023">Cat</font></h3>
  12.221 -<p>
  12.222 -Vous pouvez utiliser la commande <code>cat</code> pour créer divers 
  12.223 -fichiers texte. EOF signifie End Of File, c'est là que le fichier se termine.
  12.224 -Exemple avec un fichier packages.list, cette commande supprime le contenu
  12.225 -actuel du fichier :
  12.226 -</p>
  12.227 -<pre>
  12.228 - $ cat &gt; packages.list &lt;&lt; "EOF"
  12.229 - Du texte...
  12.230 - et encore texte
  12.231 - 
  12.232 - EOF
  12.233 -</pre>
  12.234 -<p>
  12.235 -Pour ajouter du texte à la suite du fichier, mettez 2 fois: plus grand que
  12.236 -(&gt;&gt;) après <code>cat</code>, exemple :
  12.237 -</p>
  12.238 -<pre>
  12.239 - $ cat &gt;&gt; packages.list &lt;&lt; "EOF"
  12.240 - Du texte...
  12.241 - 
  12.242 - EOF
  12.243 -</pre>
  12.244 -
  12.245 -<a name="web-nav"></a>
  12.246 -<h3><font color="#6c0023">Naviguer sur le web</font></h3>
  12.247 -<p>
  12.248 -Surfer sur la toile avec SliTaz simplement et rapidement avec 'retawq', 
  12.249 -navigateur web en mode texte. A noter que vous pouvez aussi utiliser
  12.250 -le navigateur en local. Vous naviguerez ensuite facilement avec les flèches
  12.251 -de votre clavier, les liens sont en bleu et il faut taper &lt;ENTER&gt; pour
  12.252 -les suivre :
  12.253 -</p>
  12.254 -<pre>
  12.255 - $ retawq http://slitaz.libordux.org/
  12.256 - ou:
  12.257 - $ retawq http://localhost/
  12.258 -</pre>
  12.259 -<a name="irc-chat"></a>
  12.260 -<h3><font color="#6c0023">Discuter sur les canaux IRC</font></h3>
  12.261 -<p>
  12.262 -Pour discuter et transférer des fichiers via les multiples serveurs IRC
  12.263 -de la planète, SliTaz fournit Rhapsody. Ce client IRC est simple, rapide,
  12.264 -léger, fournissant un menu de configuration ncurses très agréable et facile à
  12.265 -prendre en main. Pour lancer l'application depuis un terminal, se connecter
  12.266 -à un serveur (irc.tuxfamily.org) et joindre le canal #tuxfamily :
  12.267 -</p>
  12.268 -<pre>
  12.269 - $ rhapsody
  12.270 - /connect irc.tuxfamily.org
  12.271 - /join #tuxfamily
  12.272 -</pre>
  12.273 -<a name="wget"></a>
  12.274 -<h3><font color="#6c0023">Télécharger des fichiers</font></h3>
  12.275 -<p>
  12.276 -Pour télécharger divers formats de fichiers sur internet, vous disposez de la
  12.277 -commande <code>wget</code>. Vous pouvez rapatrier une simple page html,
  12.278 -le contenu de tout un répertoire ou tout un site web :
  12.279 -</p>
  12.280 -<pre>
  12.281 - $ wget http://www.slitaz.org/doc/handbook/
  12.282 -</pre>
  12.283 -<a name="partitions"></a>
  12.284 -<h3><font color="#6c0023">Lister les partitions disponibles</font></h3>
  12.285 -<p>
  12.286 -Pour lister les partitions d'un disque dur interne ou externe, vous pouvez
  12.287 -utiliser la commande cat pour afficher le contenu du fichier
  12.288 -<code>/proc/partitions</code> ou utiliser l'utilitaire <code>fdisk</code>
  12.289 -avec l'option <code>-l</code> signifiant <em>list</em>. Vous pouvez ensuite
  12.290 -monter la (les) partitions que vous désirez utiliser :
  12.291 -</p>
  12.292 -<pre>
  12.293 - $ cat /proc/partitions
  12.294 - ou
  12.295 - # fdisk -l
  12.296 -</pre>
  12.297 -<a name="mount"></a>
  12.298 -<h3><font color="#6c0023">Monter une partition, un cdrom ou une clé USB</font></h3>
  12.299 -<p>
  12.300 -Pour monter une partition locale, dans le système de fichier SliTaz, nous vous
  12.301 -conseillons d'utiliser le répertoire /mnt. Dans l'exemple nous créons les
  12.302 -répertoires nécessaires, et nous montons la partition <code>hda6</code> du 
  12.303 -premier disque dur local sur /mnt/hda6 :
  12.304 -</p>
  12.305 -<pre>
  12.306 - # mkdir -p /mnt/hda6
  12.307 - # mount -t ext3 /dev/hda6 /mnt/hda6
  12.308 -</pre>
  12.309 -<p>
  12.310 -SliTaz fonctionne en RAM, vous pouvez monter ce même cdrom ou le retirer
  12.311 -pour en monter un autre (/dev/cdrom est un lien sur le premier lecteur de 
  12.312 -cdrom). A noter qu'un cdrom est un média amovible, il devrait donc se
  12.313 -monter sur /media :
  12.314 -</p>
  12.315 -<pre>
  12.316 - # mount -t iso9660 /dev/cdrom /media/cdrom
  12.317 -</pre>
  12.318 -<p>
  12.319 -Pour monter une clé USB ou flash disk il faut spécifier le bon système de 
  12.320 -fichiers. Normalement une clé USB achetée dans le marché est formatée en 
  12.321 -FAT32 ce qui permet de la lire depuis GNU/Linux et Windows. Sur un système
  12.322 -GNU/Linux elle est reconnue généralement comme le disque sda1, nous avons 
  12.323 -donc préparer un lien <code>sda1</code> sur <code>flash</code>, pour se 
  12.324 -faciliter la tâche. C'est aussi un média amovible et devrait se monter sur
  12.325 -/media :
  12.326 -</p>
  12.327 -<pre>
  12.328 - # mount -t vfat /dev/flash /media/flash
  12.329 -</pre>
  12.330 -<a name="halt"></a>
  12.331 -<h3><font color="#6c0023">Eteindre le système, ou redémarrer</font></h3>
  12.332 -<p>
  12.333 -Pour arrêter SliTaz ou redémarrer, vous pouvez utiliser la commande 
  12.334 -<code>halt</code>, <code>reboot</code> ou utiliser la combinaison des touches
  12.335 -&lt;Ctrl+Alt+Delete&gt;, ce qui correspond à un redémarrage système. En cas de 
  12.336 -problèmes, essayez d'utiliser l'option <code>-f</code>, signifiant 
  12.337 -<em>forced</em> :
  12.338 -</p>
  12.339 -<pre>
  12.340 - # halt
  12.341 - Pour redémarrer :
  12.342 - # reboot
  12.343 - Ou :
  12.344 - # reboot -f
  12.345 -</pre>
  12.346 -
  12.347 -<!-- End of content -->
  12.348 -</div>
  12.349 -
  12.350 -<!-- Footer. -->
  12.351 -<div id="footer">
  12.352 -	<div class="footer-right"></div>
  12.353 -	<a href="#top">Haut de la page</a> | 
  12.354 -	<a href="index.html">Table des matières</a>
  12.355 -</div>
  12.356 -
  12.357 -<div id="copy">
  12.358 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  12.359 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  12.360 -    Documentation publiées sous
  12.361 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  12.362 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  12.363 -</div>
  12.364 -
  12.365 -</body>
  12.366 -</html>

    13.1 --- a/doc/handbook-stable/handbook/development.html	Fri Feb 06 23:17:00 2009 +0100
    13.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    13.3 @@ -1,332 +0,0 @@
    13.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    13.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    13.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    13.7 -<head>
    13.8 -    <title>SliTaz Handbook - Developpement</title>
    13.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   13.10 -    <meta name="description" content="developpement sur Slitaz Geany scripts dialog toolchain gcc make" />
   13.11 -    <meta name="expires" content="never" />
   13.12 -    <meta name="modified" content="2007-12-03 12:30:00" />
   13.13 -    <meta name="publisher" content="www.slitaz.org" />
   13.14 -    <meta name="author" content="Christophe Lincoln"/>
   13.15 -    <link rel="shortcut icon" href="favicon.ico" />
   13.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   13.17 -</head>
   13.18 -<body bgcolor="#ffffff">
   13.19 -
   13.20 -<!-- Header and quick navigation -->
   13.21 -<div id="header">
   13.22 -<div align="right" id="quicknav">
   13.23 -    <a name="top"></a>
   13.24 -    <a href="secure-shell.html">SHell sécurisé</a> |
   13.25 -    <a href="index.html">Table des matières</a>
   13.26 -</div>
   13.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   13.28 -</div>
   13.29 -
   13.30 -<!-- Content. -->
   13.31 -<div id="content">
   13.32 -<div class="content-right"></div>
   13.33 -
   13.34 -<h2><font color="#DF8F06">Développement</font></h2>
   13.35 -
   13.36 -<ul>
   13.37 -    <li><a href="#about">&Agrave; propos du développement</a> - Sur SliTaz
   13.38 -    et de SliTaz.</li>
   13.39 -    <li><a href="#shell-scripts">Scripts SHell</a> - #!/bin/sh</li>
   13.40 -    <li><a href="#dialog">Dialog</a> - Création d'interface graphique
   13.41 -    basée sur la console.</li>
   13.42 -    <li><a href="#geany">Geany</a> - IDE ou Environnement de Développement
   13.43 -    Intégré.</li>
   13.44 -    <li><a href="#perl">Perl ou Microperl</a> - Coder et utiliser des scripts
   13.45 -    Perl et/ou CGI propulsés par microperl.</li>
   13.46 -    <li><a href="#python">Python</a> - Le langage Python</li>
   13.47 -    <li><a href="#toolchain">Toolchain</a> - Bibliothèques, compilateur C
   13.48 -    et outils associés.</li>
   13.49 -</ul>
   13.50 -
   13.51 -<a name="about"></a>
   13.52 -<h3><font color="#6c0023">&Agrave; propos du dévelopement</font></h3>
   13.53 -<p>
   13.54 -SliTaz fournit quelques outils de développement, conception de sites web,
   13.55 -édition avancée de scripts, et de code source avec l'IDE 'geany'. Création
   13.56 -d'interface graphique à vos scripts SHell avec 'dialog'.
   13.57 -</p>
   13.58 -<p>
   13.59 -Si vous cherchez des informations sur le développement de SliTaz,
   13.60 -le <a href="http://www.slitaz.org/doc/cookbook/">cookbook</a> (livre de
   13.61 -cuisine) vous décrira toutes les étapes de construction du système. Sur le
   13.62 -site web de SliTaz, la partie <a href="http://www.slitaz.org/devel/">devel</a>
   13.63 -vous donnera des informations générales au sujet des développeurs et des
   13.64 -possibilités de participation.
   13.65 -</p>
   13.66 -<a name="shell-scripts"></a>
   13.67 -<h3><font color="#6c0023">Scripts SHell</font></h3>
   13.68 -<p>
   13.69 -L'écriture de scripts SHell est la manière la plus simple pour commencer à
   13.70 -coder, ils permettent d'avoir rapidement un résultat et les seuls prérequis
   13.71 -sont de savoir ouvrir un terminal et utiliser un éditeur de texte tels
   13.72 -que Nano, LeafPad ou Geany. Les scripts SHell permettent de faire énomérement
   13.73 -de choses sur un système GNU/Linux, initialiser le système, faire des
   13.74 -sauvegardes, exécuter des tâches répétitives, afficher des informations sur
   13.75 -l'état du système, créer ou modifier des fichier, etc. Dans un script SHell,
   13.76 -vous pouvez aussi utiliser des variables, des fonctions ou encore des appels
   13.77 -pour inclure un fichier. A noter que vous pouvez nommer vos scripts comme bon
   13.78 -vous semble et que l'utilisation de l'extension <code>.sh</code> est largement
   13.79 -utilisée.
   13.80 -</p>
   13.81 -<h4>Créer un script SHell</h4>
   13.82 -<p>
   13.83 -Avant de commencer un nouveau script SHell, vous devez faire attention
   13.84 -à l'interprétateur utilisé. La plus part du temps les scripts SHell
   13.85 -utilisent <code>/bin/sh</code>, cela permet d'être plus portable.
   13.86 -Il y a aussi des scripts qui appelent <code>/bin/bash</code>, mais cela
   13.87 -implique que Bash soit installé sur le système. Pour qu'un script SHell
   13.88 -fonctionne il doit être exécutable par l'utilisateur courant, le changement
   13.89 -des permissions sur un fichier peut se faire en ligne de commande via
   13.90 -l'outils <code>chmod</code>. Pour créer un <code>script.sh</code> et le
   13.91 -rendre exécutable :
   13.92 -</p>
   13.93 -<pre>
   13.94 - $ touch script.sh
   13.95 - $ chmod +x script.sh
   13.96 -</pre>
   13.97 -<p>
   13.98 -Maintenant que vous avez un nouveau fichier exécutable, vous allez pouvoir
   13.99 -l'éditer. Vous pouvez continuer en restant dans le terminal et en utilisant
  13.100 -l'éditeur Nano (Ctrl+X pour enregistrer) ou en ouvrant l'IDE Geany sur le
  13.101 -fichier :
  13.102 -</p>
  13.103 -<pre>
  13.104 - $ nano script.sh
  13.105 - Ou :
  13.106 - $ geany script.sh &amp;
  13.107 -</pre>
  13.108 -<p>
  13.109 -Voici un &micro;script qui contient une variable <code>NAME</code> et qui en
  13.110 -affiche la valeur avec la commande <code>echo</code> :
  13.111 -</p>
  13.112 -<pre class="script">
  13.113 -#!/bin/sh
  13.114 -
  13.115 -NAME="kayam"
  13.116 -
  13.117 -echo "$NAME est sympa."
  13.118 -
  13.119 -</pre>
  13.120 -<p>
  13.121 -Une fois que vous avez créé/modifié votre <code>script.sh</code>, il suffit
  13.122 -d'enregistrer et d'exécuter le script pour voir le résultat :
  13.123 -</p>
  13.124 -<pre>
  13.125 - $ ./script.sh
  13.126 -</pre>
  13.127 -<p>
  13.128 -Voilà pour cette brève introduction au scripts SHell. Pour aller plus loin, le
  13.129 -web regorge d'informations à ce sujet et regarder ce qu'on fait les autres
  13.130 -peut aussi aider.
  13.131 -</p>
  13.132 -<a name="dialog"></a>
  13.133 -<h3><font color="#6c0023">Dialog</font></h3>
  13.134 -<p>
  13.135 -Dialog permet de créer des interfaces graphique basées sur la console, telles
  13.136 -que 'tazkmap'. Le fichier de configuration de dialog est /etc/dialogrc, et/ou
  13.137 - ~/.dialogrc pour chaque utilisateur. Voici un simple exemple d'utilisation de
  13.138 - dialog via une console ou un terminal :
  13.139 -</p>
  13.140 -<pre>
  13.141 - $ dialog --title "Hello $USER" \
  13.142 -   --msgbox "Message propulsé par dialog." 5 54
  13.143 -</pre>
  13.144 -<p>
  13.145 -Vous trouverez pleins d'exemples de scripts dans le répertoire /sample des
  13.146 -sources de dialog, que vous pouvez télécharger depuis:
  13.147 -<a href="http://invisible-island.net/dialog/dialog.html"
  13.148 - >invisible-island.net/dialog/dialog.html</a>. Download des sources avec
  13.149 -'wget' et décompression :
  13.150 -</p>
  13.151 -<pre>
  13.152 - $ wget ftp://invisible-island.net/dialog/dialog.tar.gz
  13.153 - $ tar xzf dialog.tar.gz
  13.154 -</pre>
  13.155 -<a name="geany"></a>
  13.156 -<h3><font color="#6c0023">Geany IDE</font></h3>
  13.157 -<p>
  13.158 -Geany est un IDE ou Environnement de Dévelopement Intégré, il est simple,
  13.159 -léger, et rapide, proposant la coloration syntaxique, les onglets,
  13.160 -pliage/dépliage du code, la complétion automatique, de l'aide à l'écriture.
  13.161 -Vous avez une liste des symboles, fonctions, méthodes, variables très utiles,
  13.162 -avec une petite flèche de signalisation. Et encore, sélecteur de couleurs
  13.163 -intégré, fenêtre de messages, lancement du script courant via le bouton
  13.164 -Exécuter, etc. C'est avec lui que nous avons créé cette page,
  13.165 -la documentation, et presque tout le site web (un peu avec Nano aussi).
  13.166 -</p>
  13.167 -<h4>Lancer Geany</h4>
  13.168 -<p>
  13.169 -Vous trouverez Geany dans le menu de JWM --&gt; Development --&gt; Geany.
  13.170 -Un fois lancé pour la première fois, vous pouvez ajuster vos préférences
  13.171 -via --&gt; Editer --&gt; Préférences. Vous pouvez aussi lancer Geany via un
  13.172 -terminal X et la commande :
  13.173 -</p>
  13.174 -<pre>
  13.175 - $ geany &amp;
  13.176 -</pre>
  13.177 -<p>
  13.178 -Note : Lors de la compilation des sources, le scripts <code>./configure</code>
  13.179 -propose l'option : <code>--enable-the-force</code>... Que l'on peut utiliser
  13.180 -si l'on penser avoir la force et être Luc Skywalker!
  13.181 -</p>
  13.182 -<a name="perl"></a>
  13.183 -<h3><font color="#6c0023">Perl ou Microperl - Coder/utiliser des scripts Perl</font></h3>
  13.184 -<p>
  13.185 -Sur SliTaz vous pouvez coder et utiliser le puissant langage de scripts Perl
  13.186 -via le binaire <code>perl</code> ou <code>microperl</code>. Microperl est une
  13.187 -version très allégée de Perl compilée à partir des sources officielles de Perl,
  13.188 -les scripts fonctionnant avec microperl sont complètement compatible avec la
  13.189 -version complète de Perl. C'est justement une des forces de Perl, il est portable
  13.190 -et fonctionne sur toutes les systèmes d'exploitations. Perl est un langage
  13.191 -interprété cela veut dire que le code n'a pas besoin d'être compilé et qu'il
  13.192 -peut être utilisé directement. A noter que sur SliTaz, <code>perl</code>
  13.193 -et/ou <code>microperl</code> se sont pas installé par défaut sur le LiveCD, vous
  13.194 -pouvez soit reconstruire votre propore ISO en incluant Perl ou installer via
  13.195 -le gestionnaire de paquets. A noter que le paquet Microperl fait mois d'1 Mb
  13.196 -et ne fournit aucun modules, juste le minimum :
  13.197 -</p>
  13.198 -<pre>
  13.199 - # tazpkg install perl
  13.200 - Ou :
  13.201 - # tazpkg install microperl
  13.202 -</pre>
  13.203 -
  13.204 -<h4>Hello world!</h4>
  13.205 -<p>
  13.206 -Le but de ce &micro;script est d'afficher <em>Hello World</em>. Vous pouvez
  13.207 -commencer par créer le fichier et le rendre exécutable depuis la ligne de
  13.208 -commandes et l'éditer ensuite graphiquement avec l'IDE Geany. A noter que nous
  13.209 -nommons le scripts <code>hello.pl</code> mais que vous pouvez nommer un
  13.210 -script Perl comme bon vous semble, avec ou sans l'extension <code>.pl</code> :
  13.211 -</p>
  13.212 -<pre>
  13.213 - $ touch hello.pl
  13.214 - $ chmod +x hello.pl
  13.215 - $ geany hello.pl &amp;
  13.216 -</pre>
  13.217 -<p>
  13.218 -La première ligne d'un scripts Perl commence par définir le chemin vers
  13.219 -l'interprétateur Perl, généralement <code>/usr/bin/perl</code> et pour
  13.220 -afficher du texte il suffit d'utiliser la commande <code>print</code>.
  13.221 -Code à copier/coller. A noter que le langage Perl est sensible à la casse et
  13.222 -qu'une instruction devrait toujours se terminer par un point-virgule :
  13.223 -</p>
  13.224 -<pre class="script">
  13.225 -#!/usr/bin/perl
  13.226 -#
  13.227 -
  13.228 -print "Hello World!\n";
  13.229 -
  13.230 -</pre>
  13.231 -<p>
  13.232 -Pour exécuter et tester le script :
  13.233 -</p>
  13.234 -<pre>
  13.235 - $ ./hello.pl
  13.236 -</pre>
  13.237 -
  13.238 -<h4>Scripts CGI et Perl</h4>
  13.239 -<p>
  13.240 -Les scripts CGI ont pour but d'afficher des pages web générées dynamiquement.
  13.241 -Le langage Perl assoicié au serveur web LightTPD vous permet d'utiliser
  13.242 -des scripts CGI via votre espace public ou via des hôtes virtuels. Perl est
  13.243 -tout à fait adapté au web 2.0 et permet de générer rapidement des pages xHTML.
  13.244 -Sur Slitaz, vous devez avoir installé Perl ou Microperl et
  13.245 -<a href="web-server.html#cgi-perl">configuré le serveur Web LightTPD</a> avant
  13.246 -de pouvoir utiliser des scripts CGI codé en Perl. A noter que par défaut vous
  13.247 -pouvez utiliser des scripts SHell (.sh) et les placer dans /cgi-bin/).
  13.248 -</p>
  13.249 -<p>
  13.250 -Une fois le server bien configuré, vous pouvez directement placer des scripts
  13.251 -CGI dans votre répertoire <code>$HOME/Public/cgi-bin</code> en utilisant
  13.252 -l'extension <code>.pl</code> ou <code>.cgi</code> et les visualiser en local
  13.253 -ou à distance. Exemple de script CGI utilisant Perl :
  13.254 -</p>
  13.255 -<pre class="script">
  13.256 -#!/usr/bin/perl
  13.257 -#
  13.258 -print "content-type : text/html\n\n";
  13.259 -
  13.260 -print "Hello World!\n";
  13.261 -
  13.262 -</pre>
  13.263 -
  13.264 -<a name="python"></a>
  13.265 -<h3><font color="#6c0023">Python</font></h3>
  13.266 -<p>
  13.267 -Le langage de programmation Python est disponible sous forme de paquet
  13.268 -facilement installable. Un fois Python installé vous pouvez créer vos propre
  13.269 -scripts/programmes et utiliser des applications CGI via le serveur Web LightTPD
  13.270 -en prenant soin de <a href="web-server.html#cgi-python">configurer le serveur</a>
  13.271 -correctement. A noter que le dépôt Mercurial officiel de SliTaz fourni une 
  13.272 -interface Web CGI/Python, c'est une solution adaptée à la production, robuste
  13.273 -et fiable. Pour installer le paquet <code>python</code> avec Tazpkg :
  13.274 -</p>
  13.275 -<pre>
  13.276 - # tazpkg get-install python
  13.277 -</pre>
  13.278 -
  13.279 -<a name="toolchain"></a>
  13.280 -<h3><font color="#6c0023">Toolchain - Bibliothèques, compilateur C et outils associés</font></h3>
  13.281 -<p>
  13.282 -Pour compiler des logiciels depuis les sources ou son propre code, vous avez
  13.283 -au minimum, besoin de la chaîne d'outils de base (<em>toolchain</em>),
  13.284 -composée des outils Binutils, de la bibliothèque Glibc , du compilateur
  13.285 -GCC, des <em>headers</em> du noyau et de l'utilitaire Make. Cette chaîne
  13.286 -d'outils peut être installée via le gestionnaire de paquets Tazpkg et une
  13.287 -seule commande. A noter que cette <em>toolchain</em> est utilisée par les
  13.288 -développeurs de SliTaz pour compiler le système entier depuis les sources.
  13.289 -Pour installer les paquets via l'installation d'un meta paquet créant les
  13.290 -dépendances qu'il faut :
  13.291 -</p>
  13.292 -<pre>
  13.293 - # tazpkg get-install slitaz-toolchain
  13.294 -</pre>
  13.295 -<p>
  13.296 -L'installation de la toolchain permet de compiler beaucoup d'applications
  13.297 -de base et en mode texte. A noter que beaucoup de paquets compileront sans
  13.298 -problème en utilisant le SHell Ash de Busybox, mais d'autres paquets ne
  13.299 -compileront pas sans Bash. GNU bash est disponnible sous forme de paquet
  13.300 -ainsi que divers outils de développement de base tels que Flex, M4, Bison,
  13.301 -ou encore Pkg-config. Si vous cherchez pkg-config par exemple :
  13.302 -</p>
  13.303 -<pre>
  13.304 - $ tazpkg search pkg-config
  13.305 -</pre>
  13.306 -<p>
  13.307 -Si vous désirez compiler des applications utilsant les bibliothèques Ncurses,
  13.308 -vous devez installer le paquet <code>ncurses-dev</code> complet (par défaut
  13.309 -il n'y a que le paquet minimum installé). A noter que le paquet ncurses fournit
  13.310 -aussi divers petits programmes tels que <code>tic</code> ou <code>tack</code> :
  13.311 -</p>
  13.312 -<pre>
  13.313 - $ tazpkg search ncurses
  13.314 -</pre>
  13.315 -
  13.316 -<!-- End of content -->
  13.317 -</div>
  13.318 -
  13.319 -<!-- Footer. -->
  13.320 -<div id="footer">
  13.321 -	<div class="footer-right"></div>
  13.322 -	<a href="#top">Haut de la page</a> | 
  13.323 -	<a href="index.html">Table des matières</a>
  13.324 -</div>
  13.325 -
  13.326 -<div id="copy">
  13.327 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  13.328 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  13.329 -    Documentation publiées sous
  13.330 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  13.331 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  13.332 -</div>
  13.333 -
  13.334 -</body>
  13.335 -</html>

    14.1 --- a/doc/handbook-stable/handbook/enlightenment.html	Fri Feb 06 23:17:00 2009 +0100
    14.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    14.3 @@ -1,190 +0,0 @@
    14.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    14.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    14.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    14.7 -<head>
    14.8 -    <title>SliTaz Handbook - Enlightenment</title>
    14.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   14.10 -    <meta name="description" content="" />
   14.11 -    <meta name="expires" content="never" />
   14.12 -    <meta name="modified" content="2000-02-03 19:30:00" />
   14.13 -    <meta name="publisher" content="www.slitaz.org" />
   14.14 -    <meta name="author" content="Christophe Lincoln"/>
   14.15 -    <link rel="shortcut icon" href="favicon.ico" />
   14.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   14.17 -</head>
   14.18 -<body bgcolor="#ffffff">
   14.19 -
   14.20 -<!-- Header and quick navigation -->
   14.21 -<div id="header">
   14.22 -<div align="right" id="quicknav">
   14.23 -    <a name="top"></a>
   14.24 -    <a href="utilities.html">Utilitaires</a> |
   14.25 -    <a href="index.html">Table des matières</a>
   14.26 -</div>
   14.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   14.28 -</div>
   14.29 -
   14.30 -<!-- Content. -->
   14.31 -<div id="content">
   14.32 -<div class="content-right"></div>
   14.33 -
   14.34 -<h2><font color="#DF8F06">Enlightenment (e17)</font></h2>
   14.35 -
   14.36 -<ul>
   14.37 -    <li><a href="#intro">Introduction et présentation.</a></li>
   14.38 -    <li><a href="#install">Installation et lancement.</a></li>
   14.39 -    <li><a href="#menu-icons">Menu et icônes de bureau.</a></li>
   14.40 -    <li><a href="#themes">Thèmes graphiques.</a></li>
   14.41 -</ul>
   14.42 -
   14.43 -<a name="intro"></a>
   14.44 -<h3><font color="#6c0023">Introduction et présentation de e17</font></h3>
   14.45 -<p>
   14.46 -Enlightenment est un environnement de bureau complet, entièrement configurable
   14.47 -à la souris et proposant de nombreux thèmes. La version fournie par le projet
   14.48 -SliTaz est une version encore en développement connue sous le nom de e17,
   14.49 -cette version est considérée suffisament stable pour être intégrée dans la
   14.50 -distribution et travailler en production. Cela dit, SliTaz ne propose pas des
   14.51 -outils tels que Rage ou Entrance, mais ce qu'il faut pour  disposer d'un 
   14.52 -d'environnement de bureau complet, simple d'utilisation, stable, réactif et 
   14.53 -efficace. Tous les réglages peuvent se faire graphiquement via le panneau de 
   14.54 -configuration intégrés au bureau, le menu s'affiche via un clique de gauche
   14.55 -sur l'écran ou depuis une gondole. Il est entre autres possible d'utiliser le 
   14.56 -glisser/déposer depuis un gestionnaire de fichiers et le bureau ou d'afficher
   14.57 -des icônes pour lancer ses applications préférées.
   14.58 -</p>
   14.59 -<p>
   14.60 -Enlightenment a été conçu pour être déployable sur des systèmes avec peu de 
   14.61 -ressources comme sur les systèmes plus puissants. IL permet d'avoir des fonds 
   14.62 -d'écran, des éléments du menus et des gadgets animés et interactifs, sait
   14.63 -gérer les bureaux virtuels (Alt + roulette de la souris). D'autres 
   14.64 -fonctionnalités très pratiques permettent de gagner du temps sur des tâches 
   14.65 -simples, comme par exemple le fait de déplacer une fenêtre d'un bureau à un 
   14.66 -autre via le pager ou le fait d'enrouler une fenêtre avec la molette sur sa
   14.67 -bordure.
   14.68 -</p>
   14.69 -<p>
   14.70 -Site Web : <a href="http://www.enlightenment.org/">www.enlightenment.org</a>
   14.71 -</p>
   14.72 -
   14.73 -<a name="install"></a>
   14.74 -<h3><font color="#6c0023">Installation et lancement</font></h3>
   14.75 -<p>
   14.76 -Installer et lancer Enlightenment sur SliTaz se résume à exécuter une commande
   14.77 -et éditer un fichier. Si vous n'avez pas rechargé votre liste de paquets depuis
   14.78 -quelques temps, pensez à la mettre à jour. Pour installer Enlightenment et ses
   14.79 -dépendances :
   14.80 -</p>
   14.81 -<pre>
   14.82 - # tazpkg get-install enlightenment
   14.83 -</pre>
   14.84 -<p>
   14.85 -Une fois tous les paquets installés, vous pouvez reconfigurer votre session X
   14.86 -avec <code>tazx</code> en spécifiant e17 en argument :
   14.87 -</p>
   14.88 -<pre>
   14.89 - $ tazx e17
   14.90 -</pre>
   14.91 -<p>
   14.92 -Pour commencer à utiliser Enlightenment il faut sauver le fichier, sortir de 
   14.93 -sa session X courante et redémarrer une session graphique avec :
   14.94 -</p>
   14.95 -<pre>
   14.96 - $ startx
   14.97 -</pre>
   14.98 -<h4>&Eacute;diter ~/.xsession</h4>
   14.99 -<p>
  14.100 -Pour configurer manuellement votre session X via le fichier de configuration
  14.101 -de votre session X (<code>~/.xsession</code>). Il faut modifier la ligne 
  14.102 -lançant le serveur Xvesa, commenter ou supprimer la ligne exécutant
  14.103 -JWM et ajouter <code>exec enlightenment_start</code> à la fin du fichier. 
  14.104 -~/.Xsession peut être édité depuis le menu de JWM et la catégorie 
  14.105 -<em>Preferences</em> ou avec Nano dans un terminal. N'oubliez pas d'ajouter
  14.106 -<code>-terminate</code> à la ligne lançant Xvesa. Simple exemple :
  14.107 -</p>
  14.108 -<pre class="script">
  14.109 -# ~/.xsession: Start X window session on your system.
  14.110 -#
  14.111 -Xvesa -ac -shadow -terminate -screen 1280x800x24 -mouse /dev/input/mice,5 &
  14.112 -#exec jwm
  14.113 -exec enlightenment_start
  14.114 -</pre>
  14.115 -<p>
  14.116 -Sortez de votre session est relancez <code>startx</code>.
  14.117 -</p>
  14.118 -
  14.119 -<a name="menu-icons"></a>
  14.120 -<h3><font color="#6c0023">Menu et icônes de bureau</font></h3>
  14.121 -<p>
  14.122 -Enlightenment respect les standards de Freedesktop, les applications sont 
  14.123 -classées par catégorie et apparaîssent automatiquement lors de leur
  14.124 -installation si un un fichier de bureau est fournit. Les fichiers de bureau 
  14.125 -(<code>.desktop</code>) du système sont contenu dans le répertoire 
  14.126 -<code>/usr/share/applications</code> ou le repértoire personnel 
  14.127 -<code>~/.local/share/applications</code>. Ces fichiers de bureau ont une
  14.128 -syntaxe simple, sont éditables depuis le panneau de configuration ou avec
  14.129 -un simple éditeur de texte. Les fichiers des menus affichant les catégories
  14.130 -dans le menu d'Enlightenment sont contenus dans le paquet 
  14.131 -<code>slitaz-menus</code> :
  14.132 -</p>
  14.133 -<pre>
  14.134 - # tazpkg get-install slitaz-menus
  14.135 -</pre>
  14.136 -<h4>Un icône sur le bureau</h4>
  14.137 -<p>
  14.138 -Pour avoir un icône sur le bureau lançant une application vous pouvez créer
  14.139 -à la main un fichier <code>.desktop</code> dans votre répertoire personnel
  14.140 -<code>~/Desktop</code>, les fichiers de bureau placés dans ce réperoire sont
  14.141 -automatiquement reconnus par Enlightenment. Un simple fichier de bureau peut
  14.142 -tenir sur huit lignes avec respectivement le nom (<code>Name</code>), le nom
  14.143 -généric, un commentaire, la commande à exécuter (<code>Exec</code>), l'icône,
  14.144 -le type et les catégories Freedesktop. Exemple d'un fichier de bureau pour
  14.145 -Xterm :
  14.146 -</p>
  14.147 -<pre class="script">
  14.148 -[Desktop Entry]
  14.149 -Name=XTerm (sb)
  14.150 -GenericName=Terminal
  14.151 -Comment=Run commands in a shell
  14.152 -Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar
  14.153 -Icon=xterm.png
  14.154 -Type=Application
  14.155 -Categories=Utility;Terminal;
  14.156 -</pre>
  14.157 -
  14.158 -<a name="themes"></a>
  14.159 -<h3><font color="#6c0023">Thèmes graphiques</font></h3>
  14.160 -<p>
  14.161 -Enlightenment est conçu de manière à pouvoir tout configurer en fonctions de
  14.162 -ses préférences. Vous pouvez facilement modifier l'apparence des fenêtres, 
  14.163 -de l'image de démarrage, du fond d'écran, les mouvements des fenêtres, les 
  14.164 -gondoles et autres gadjgets. Vous trouverez plusieurs thèmes complet ou 
  14.165 -fonds décran sur le site Web dédié aux outils et graphisme du bureau get-e.org.
  14.166 -Les thèmes s'installent graphiquement via le menu et l'interface de 
  14.167 -configuration des thèmes, vous pouvez aussi les mettre manuellement dans vos
  14.168 -répertoires de configuration personnel de Enlightenment : <code>~/.e/e</code>.
  14.169 -</p>
  14.170 -<p>
  14.171 -Enlightenment users art : <a href="http://www1.get-e.org/">www1.get-e.org</a>
  14.172 -</p>
  14.173 -
  14.174 -<!-- End of content -->
  14.175 -</div>
  14.176 -
  14.177 -<!-- Footer. -->
  14.178 -<div id="footer">
  14.179 -	<div class="footer-right"></div>
  14.180 -	<a href="#top">Haut de la page</a> | 
  14.181 -	<a href="index.html">Table des matières</a>
  14.182 -</div>
  14.183 -
  14.184 -<div id="copy">
  14.185 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  14.186 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  14.187 -    Documentation publiées sous
  14.188 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  14.189 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  14.190 -</div>
  14.191 -
  14.192 -</body>
  14.193 -</html>

    15.1 Binary file doc/handbook-stable/handbook/favicon.ico has changed

    16.1 --- a/doc/handbook-stable/handbook/gen-livecd.html	Fri Feb 06 23:17:00 2009 +0100
    16.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    16.3 @@ -1,294 +0,0 @@
    16.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    16.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    16.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    16.7 -<head>
    16.8 -    <title>SliTaz Handbook - Générer son propre LiveCD à saveur</title>
    16.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   16.10 -    <meta name="description" content="créer son propre livecd de slitaz gnu linux tazlito" />
   16.11 -    <meta name="expires" content="never" />
   16.12 -    <meta name="modified" content="2008-01-30 13:30:00" />
   16.13 -    <meta name="publisher" content="www.slitaz.org" />
   16.14 -    <meta name="author" content="Christophe Lincoln"/>
   16.15 -    <link rel="shortcut icon" href="favicon.ico" />
   16.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   16.17 -</head>
   16.18 -<body bgcolor="#ffffff">
   16.19 -
   16.20 -<!-- Header and quick navigation -->
   16.21 -<div id="header">
   16.22 -<div align="right" id="quicknav">
   16.23 -    <a name="top"></a>
   16.24 -    <a href="liveusb.html">LiveUSB</a> |
   16.25 -    <a href="index.html">Table des matières</a>
   16.26 -</div>
   16.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   16.28 -</div>
   16.29 -
   16.30 -<!-- Content. -->
   16.31 -<div id="content">
   16.32 -<div class="content-right"></div>
   16.33 -
   16.34 -<h2><font color="#DF8F06">Générer un LiveCD à saveur</font></h2>
   16.35 -<p>
   16.36 -Comment créer son propre LiveCD facilement est rapidement avec Tazlito.
   16.37 -</p>
   16.38 -
   16.39 -<ul>
   16.40 -	<li><a href="#intro">Pour commencer.</a></li>
   16.41 -	<li><a href="#2cmds">Un LiveCD en 2 commandes.</a></li>
   16.42 -	<li><a href="#get-flavor">Récupérer une saveur.</a></li>
   16.43 -	<li><a href="#gen-distro">Générer la distribution.</a></li>
   16.44 -	<li><a href="#gen-flavor">Créer une saveur.</a></li>
   16.45 -	<li><a href="#addfiles">Fichiers additionnels.</a></li>
   16.46 -	<li><a href="#pkgs">Paquets utilisés.</a></li>
   16.47 -	<li><a href="#configure">Fichier de configuration.</a></li>
   16.48 -</ul>
   16.49 -
   16.50 -<a name="intro"></a>
   16.51 -<h3><font color="#6c0023">Pour commencer</font></h3>
   16.52 -<p>
   16.53 -Créer sa propre version du LiveCD de SliTaz avec Tazlito (<em>SliTaz Live 
   16.54 -Tool</em>) prend peu de temps et permet de choisir précisément les paquets
   16.55 -logiciels que l'on veut retrouver dans le système. Le support des saveurs
   16.56 -vous pemet de générer un LiveCD personnalisé en modifiant une liste de paquets
   16.57 -ou en utilisant des saveurs crées et envoyées sur slitaz.org par des
   16.58 -utilisateurs ou contributeurs. Tazlito est un outil en ligne de commande, il
   16.59 -ne faut pas que cela vous repousse, vous aurez votre propre image ISO en 2 
   16.60 -commandes et la graverez en 1 commande.
   16.61 -</p>
   16.62 -<p>
   16.63 -La génération du LiveCD demande un minimum de 256 Mb de RAM et la compression
   16.64 -du système avec LZMA peut prendre un certain temps. Il est possible de créer
   16.65 -une distribution depuis le mode LiveCD ou depuis un système installé. En mode
   16.66 -LiveCD, il est conseillé d'utiliser un media USB ou un disque dur pour stocker
   16.67 -les fichiers générés, conserver le travail et gagner de la place en RAM.
   16.68 -</p>
   16.69 -<p>
   16.70 -Tazlito est aussi utilsé par les développeurs SliTaz pour générer le LiveCD
   16.71 -officiel. Les seuls prérequis sont d'avoir Tazlito d'installé, c'est le cas
   16.72 -par défaut sur SliTaz, mais vous pouvez générer le LiveCD depuis une autre
   16.73 -distribution à condition d'avoir les paquets voulus sous la main ou de le
   16.74 -télécharger. 
   16.75 -</p>
   16.76 -<h4>Installer Tazlito sur une autre distribution</h4>
   16.77 -<p>
   16.78 -Tazlito n'a aucune dépendance particulière pour générer le LiveCD, mais il 
   16.79 -dépend de Cdrkit pour graver l'image et de Tazpkg pour regénérer des paquets
   16.80 -SliTaz depuis ceux qui sont installés. Pour récupérer Tazlito et l'installer
   16.81 -en suivant les instructions du fichier README contenu dans <a 
   16.82 -	href="http://download.tuxfamily.org/slitaz/sources/tazlito/"
   16.83 -	>les sources de Tazlito</a>.
   16.84 -</p>
   16.85 -
   16.86 -<a name="2cmds"></a>
   16.87 -<h3><font color="#6c0023">Un LiveCD en 2 commandes</font></h3>
   16.88 -<ul>
   16.89 -	<li>Récupérer une saveur : <code>tazlito get-flavor core</code></li>
   16.90 -	<li>En option : Modifier la liste des paquets ou ajouter Fichiers 
   16.91 -	additionnels.</li>
   16.92 -	<li>Générer la distribution : <code>tazlito gen-distro</code></li>
   16.93 -</ul>
   16.94 -<p>
   16.95 -Une fois le travail fini, vous trouvez l'image ISO du LiveCD dans le répertoire 
   16.96 -<code>/home/slitaz/distro</code>.
   16.97 -</p>
   16.98 -
   16.99 -
  16.100 -<a name="get-flavor"></a>
  16.101 -<h3><font color="#6c0023">Récupérer une saveur</font></h3>
  16.102 -<p>
  16.103 -Une saveur est un fichier <code>.flavor</code> contenant toutes les informations
  16.104 -nécessaires à la création du LiveCD. La saveur fournit une liste des paquets
  16.105 -(<code>distro-packages.list</code>), une description et des fichiers 
  16.106 -additionnels propres à la saveur choisie. La liste des saveurs peut être
  16.107 -téléchargées et mise à jour avec Tazlito :
  16.108 -</p>
  16.109 -<pre>
  16.110 - # tazlito list-flavors
  16.111 - Ou :
  16.112 - # tazlito list-flavors --recharge
  16.113 -</pre>
  16.114 -<p>
  16.115 -La liste des saveurs va automatiquement s'afficher, donnant la taille du 
  16.116 -LiveCD et une brève description. Pour la suite, la commande 
  16.117 -<code>get-flavor</code> va télécharger le fichier de saveur <code>.flavor</code>
  16.118 -extraire automatiquement la liste des paquets et la description dans le 
  16.119 -répertoire courant et mettre les fichiers additionnels dans le répertoire
  16.120 -<code>/home/slitaz/distro/addfiles</code>. Pour stocker les saveurs nous vous
  16.121 -proposons d'utiliser un répertoire spécifique tel que 
  16.122 -<code>/home/slitaz/flavors</code>, vous pouvez créer ce répertoire et vous y
  16.123 -placer avec les commandes :
  16.124 -</p>
  16.125 -<pre>
  16.126 - # mkdir -p /home/slitaz/flavors
  16.127 - # cd /home/slitaz/flavors
  16.128 -</pre>
  16.129 -<p>
  16.130 -Pour télécharger et/ou extraire les fichiers d'une saveur particulière :
  16.131 -</p>
  16.132 -<pre>
  16.133 - # tazlito get-flavor saveur-particuliere
  16.134 -</pre>
  16.135 -<p>
  16.136 -La description d'une saveur peut être affichée avec la commande 
  16.137 -<code>show-flavor</code> de Tazlito. Une fois la saveur choisie téléchargée
  16.138 -et/ou extraite, vous pouvez générer la distribution.
  16.139 -</p>
  16.140 -
  16.141 -<a name="gen-distro"></a>
  16.142 -<h3><font color="#6c0023">Générer la distribution</font></h3>
  16.143 -<p>
  16.144 -Pour une première ISO nous vous conseillons de tester sans modifier la liste,
  16.145 -ensuite vous pourrez supprimer ou ajouter des paquets à volonté. Mais attention,
  16.146 -les paquets du système de base sont indispensables. La commande 
  16.147 -<code>gen-distro</code> génère une image ISO avec tous les paquets de la 
  16.148 -liste, il faut être root et être dans le même répertoire que liste et le
  16.149 -fichier de configuration. Pour générer un LiveCD :
  16.150 -</p>
  16.151 -<pre>
  16.152 - # tazlito gen-distro
  16.153 -</pre>
  16.154 -<p>
  16.155 -Voilà, votre première image ISO du LiveCD est générée dans
  16.156 -<code>/home/slitaz/distro</code>, sans compte pour l'utilisateur hacker.
  16.157 -<p>
  16.158 -<h4>L'utilisateur hacker</h4>
  16.159 -</p>
  16.160 -Si vous désirez avoir un compte utilisateur avec hacker, il faut l'ajouter
  16.161 -et recréer le système de fichier racine compressé :
  16.162 -</p>
  16.163 -<pre>
  16.164 - # tazlito addhacker
  16.165 - # tazlito gen-initiso
  16.166 -</pre>
  16.167 -<h4>Nettoyer, regénérer et aller plus loins</h4>
  16.168 -<p>
  16.169 -Pour continuer et aller plus loin,
  16.170 -vous pouvez simplement ajouter un ou deux paquets à la liste, nettoyer la distro
  16.171 -et regénérer le système de fichier racine avec une nouvelle image ISO :
  16.172 -</p>
  16.173 -<pre>
  16.174 - # tazlito clean-distro
  16.175 - # tazlito gen-distro
  16.176 -</pre>
  16.177 -<p>
  16.178 -Tazlito fournit encore plusieurs possibilités, telles que la gravure de l'ISO
  16.179 -ou la copie de fichiers additionnels dans le système ou directement sur le cdrom.
  16.180 -Pour connaître toutes les commandes disponibles, vous pouvez vous référer au
  16.181 -<a href="http://www.slitaz.org/doc/manuals/tazlito.html">manuel de Tazlito</a>
  16.182 -installé par défaut sur tous les systèmes SliTaz et accessible depuis le menu
  16.183 -de JWM
  16.184 -</p>
  16.185 -
  16.186 -<a name="gen-flavor"></a>
  16.187 -<h3><font color="#6c0023">Créer une saveur</font></h3>
  16.188 -<p>
  16.189 -Tazlito permet de facilement créer une saveur particulière à partir des 
  16.190 -résultats de fabrication de la distribution (<code>gen-distro</code>). Le
  16.191 -fichier de saveur produit contiendra tous les fichiers additionnels, la
  16.192 -decription et la liste de paquets et réutilisé ultérieurement et mis à jour
  16.193 -en fonction des versions des paquets. Pour générer une saveur en répondant à
  16.194 -une ou deux questions :
  16.195 -</p>
  16.196 -<pre>
  16.197 - # tazlito gen-flavor nouvelle-saveur
  16.198 -</pre>
  16.199 -<p>
  16.200 -Une fois que votre saveur est fonctionnel et bien testées, vous avez la 
  16.201 -possibilité de l'envoyer sur slitaz.org afin qu'elle soit mise à disposition
  16.202 -de tous, listée via <code>list-flavor</code> et utilisable via 
  16.203 -<code>get-flavor</code>. Pour envoyer une saveur vous avez plusieurs moyens,
  16.204 -passer par la liste de discussion, mettre le fichier en ligne et le signaler 
  16.205 -sur le forum ou directement l'envoyer par mail à un contributeur du projet. 
  16.206 -</p>
  16.207 -
  16.208 -
  16.209 -<a name="addfiles"></a>
  16.210 -<h3><font color="#6c0023">Fichiers additionnels</font></h3>
  16.211 -<p>
  16.212 -Les fichiers de saveurs contiennent généralement des fichiers additionnels
  16.213 -copiés directement dans le système de fichier racine ou dans la racine du
  16.214 -cdrom. Le chemin vers les fichiers à utiliser est spécifié dans le fichier
  16.215 -de configuration <code>tazlito.conf</code>, logiquement et par défaut, les 
  16.216 -fichiers sont situé dans <code>/home/slitaz/distro/addfiles</code>. Les
  16.217 -fichiers additionnels de la saveur <code>core</code> fournissent par exemple
  16.218 -le menu du gestionnaire de fenêtres <a href="jwm.html">JWM</a> et les fonds
  16.219 -d'écrans. Il suffit de modifier, ajouter ou supprimer des fichiers dans le 
  16.220 -pseudo système racine (<code>rootfs</code>) ou la racine du CD 
  16.221 -(<code>rootcd</code>) et de regénérer la distribution pour retouver les
  16.222 -fichiers dans l'ISO. Pour nettoyer et regénérer la distribution :
  16.223 -</p>
  16.224 -<pre>
  16.225 - # tazlito clean-distro
  16.226 - # tazlito gen-distro
  16.227 -</pre>
  16.228 -
  16.229 -<a name="pkgs"></a>
  16.230 -<h3><font color="#6c0023">Paquets utilisés</font></h3>
  16.231 -<p>
  16.232 -Pour créer votre distro il vous faut des paquets SliTaz. Tazlito et Tazpkg 
  16.233 -permettent de recréer les paquets depuis un système SliTaz en fonctionnement 
  16.234 -ou de télécharger les paquets directement en fonction de la saveur choisie. 
  16.235 -Par logique, sur SliTaz, les paquets se mettent dans le répertoire
  16.236 -<code>/home/slitaz/packages</code>, mais vous pouvez chager cela via un 
  16.237 -fichier de configutation de Tazlito (tazlito.conf).
  16.238 -</p>
  16.239 -<p>
  16.240 -Si vous voulez récupérer des paquets à la main, vous pouvez utiliser un
  16.241 -logiciel FTP tel que gFTP (installé par défaut sur SliTaz) ou la ligne de 
  16.242 -commande et <code>wget</code> pour  télécharger des paquets officiels. L'URL 
  16.243 -direct vers les versions des paquets : 
  16.244 -<a href="ftp://download.tuxfamily.org/slitaz/packages/"
  16.245 -	>ftp://download.tuxfamily.org/slitaz/packages/</a>
  16.246 -</p>
  16.247 -<p>
  16.248 -Vous pouvez aussi utiliser vos propre paquets en les mettant dans le répertoire
  16.249 -des paquets. Si vous cherchez de la documentation au sujet de la création de
  16.250 -paquets SliTaz, vous pouvez vous référer au livre de cuisine ou 
  16.251 -<a href="http://www.slitaz.org/doc/cookbook/">Cookbook</a>.
  16.252 -</p>
  16.253 -
  16.254 -<a name="configure"></a>
  16.255 -<h3><font color="#6c0023">Fichier de configuration</font></h3>
  16.256 -<p>
  16.257 -Par défaut Tazlito utilise le fichier de configuration système 
  16.258 -<code>/etc/tazlito/tazlito.conf</code> ou un fichier <code>tazlito.conf</code>
  16.259 -situé dans le répertoire courant. C'est à dire que vous pouvez utiliser le
  16.260 -fichier par défaut ou avoir un fichier de configuration spécifique à chaque
  16.261 -distro que vous créez. Ce fichier de configuration permet de changer le nom
  16.262 -de l'image ISO, le nom du préparateur et les chemins vers les répertoires de
  16.263 -travail. Pour créer et configurer directement un fichier de configuration, il
  16.264 -suffit de lancer Tazlito avec la commande <code>configure</code> et cela depuis
  16.265 -le répertoire de la distro (vous pouvez le créer ailleur). En supposant que
  16.266 -avez l'arbre de la distro dans <code>/home/slitaz/distro</code> et que vous
  16.267 -vous y êtes placé avec <code>cd</code>&nbsp;:
  16.268 -</p>
  16.269 -<pre>
  16.270 - $ tazlito configure
  16.271 -</pre>
  16.272 -<p>
  16.273 -Une fois que vous avez répondu aux questions, vous pouvez soit recréer l'image
  16.274 -ISO, reconstruire le système racine et l'ISO ou générer une nouvelle distro
  16.275 -avec la liste des paquets.
  16.276 -</p>
  16.277 -
  16.278 -<!-- End of content -->
  16.279 -</div>
  16.280 -
  16.281 -<!-- Footer. -->
  16.282 -<div id="footer">
  16.283 -	<div class="footer-right"></div>
  16.284 -	<a href="#top">Haut de la page</a> | 
  16.285 -	<a href="index.html">Table des matières</a>
  16.286 -</div>
  16.287 -
  16.288 -<div id="copy">
  16.289 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  16.290 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  16.291 -    Documentation publiées sous
  16.292 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  16.293 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  16.294 -</div>
  16.295 -
  16.296 -</body>
  16.297 -</html>

    17.1 --- a/doc/handbook-stable/handbook/graphics.html	Fri Feb 06 23:17:00 2009 +0100
    17.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    17.3 @@ -1,138 +0,0 @@
    17.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    17.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    17.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    17.7 -<head>
    17.8 -    <title>SliTaz Handbook - Graphisme</title>
    17.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   17.10 -    <meta name="description" content="Graphisme sur SliTaz mtPaint GQview GIMP" />
   17.11 -    <meta name="expires" content="never" />
   17.12 -    <meta name="modified" content="2007-12-03 12:30:00" />
   17.13 -    <meta name="publisher" content="www.slitaz.org" />
   17.14 -    <meta name="author" content="Christophe Lincoln"/>
   17.15 -    <link rel="shortcut icon" href="favicon.ico" />
   17.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   17.17 -</head>
   17.18 -<body bgcolor="#ffffff">
   17.19 -
   17.20 -<!-- Header and quick navigation -->
   17.21 -<div id="header">
   17.22 -<div align="right" id="quicknav">
   17.23 -    <a name="top"></a>
   17.24 -    <a href="multimedia.html">Multimedia</a> |
   17.25 -    <a href="index.html">Table des matières</a>
   17.26 -</div>
   17.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   17.28 -</div>
   17.29 -
   17.30 -<!-- Content. -->
   17.31 -<div id="content">
   17.32 -<div class="content-right"></div>
   17.33 -
   17.34 -<h2><font color="#DF8F06">Graphisme et gestion d'images</font></h2>
   17.35 -
   17.36 -<ul>
   17.37 -	<li><a href="#gcolor2">Gcolor2</a> - Selecteur et gestionnaire de colors.</li>
   17.38 -	<li><a href="#gqview">GQview</a> - Gestionnaire d'images.</li>
   17.39 -	<li><a href="#gimp">Gimp</a> - Manipulation et création d'images.</li>
   17.40 -	<li><a href="#jpeg">jpeg</a> - Outils JPEG en ligne de commande.</li>
   17.41 -	<li><a href="#bluefish">mtPaint</a> -  Création et traitement d'images.</li>
   17.42 -</ul>
   17.43 -
   17.44 -<a name="gcolor2"></a>
   17.45 -<h3><font color="#6c0023">Gcolor2 - Selecteur et gestionnaire de colors</font></h3>
   17.46 -<p>
   17.47 -Gcolor2 est un petit outils permettant de séléctionner et conserver des
   17.48 -palettes de couleures. C'est très utile lors de la créations de thèmes pour
   17.49 -SliTaz par exemple. Vous trouverez l'application dans la catégorie
   17.50 -<code>Graphics</code> ou vous pouvez la lancer via la commande :
   17.51 -</p>
   17.52 -<pre>
   17.53 - $ gcolor2 &amp;
   17.54 -</pre>
   17.55 -
   17.56 -<a name="gimp"></a>
   17.57 -<h3><font color="#6c0023">Gimp - Manipulation et création d'images</font></h3>
   17.58 -<p>
   17.59 -The GIMP (GNU Image Manipulation) est un logiciel de manipulation d'images de
   17.60 -très haute qualité. Il permet de faire tous ce qu'on peut attendre d'une
   17.61 -application de traitement d'images, gestion avançée des calques, filtres,
   17.62 -chemin, outils divers, dégradés, ou encore le support des scripts ajoutant des 
   17.63 -fonctionnalités. Gimp support un très grand nombre de format d'images tel que
   17.64 -PNG, JPEG, XPM, PPM, TIFF, PostScript, PSD, il propose aussi son propre format
   17.65 -XCF pemettant de conserver par exemple les claques. Pour installer Gimp :
   17.66 -</p>
   17.67 -<pre>
   17.68 - # tazpkg get-install gimp
   17.69 -</pre>
   17.70 -<p>
   17.71 -Gimp est extensible et peut se configurer via l'interface principale, les
   17.72 -fichiers de configurations, brosses ou scripts personnels vont dans le
   17.73 -répertoire caché <code>~/.gimp-2.2</code>.
   17.74 -</p>
   17.75 -
   17.76 -<a name="gqview"></a>
   17.77 -<h3><font color="#6c0023">GQview - Gestionnaire d'images</font></h3>
   17.78 -<p>
   17.79 -GQview est rapide et léger, il permet une navigation très rapide entre les 
   17.80 -images, par sélection des dossiers se trouvant dans votre arborescence, et
   17.81 -cela se fait en un seul clic de souris. Il intègre la possibilité de faire des
   17.82 -diaporamas, des rotations d'images et d'afficher les données EXIF, d'ajouter 
   17.83 -des mots clés ou tags, de configurer les actions, de glisser-déposer. Il 
   17.84 -donne aussi la possibilité d'éditer les images dans un logiciel externe de 
   17.85 -son choix (mtPaint ou Gimp par exemple), l'interface est entièrement traduite
   17.86 -en français, et est très simple d'utilisation.
   17.87 -</p>
   17.88 -
   17.89 -<a name="jpeg"></a>
   17.90 -<h3><font color="#6c0023">jpeg - Outils JPEG en ligne de commande</font></h3>
   17.91 -<p>
   17.92 -Pour que les applications utilisant les images JPEG fonctionnent, elles
   17.93 -doivent êtres liée aux bibliothèques fournies par le paquet jpeg-6b, ce paquet
   17.94 -propose aussi quelques petits utilitaires à utiliser en ligne de commande.
   17.95 -Pour modifier des images JPEG en ligne de commande, vous pouvez utiliser
   17.96 -<code>jpegtran</code>, installé par défaut sur SliTaz. L'utilitaire
   17.97 -<code>jpegtran</code> permet par exemple de faire une rotation de 
   17.98 -l'image via l'option <code>-rotate</code>. Le paquet jpeg-6b fournit aussi les
   17.99 -outils <code>cjpeg</code> et <code>djpeg</code>. Pour connaître les options
  17.100 -disponibles avec tous ces outils, vous pouvez utiliser l'option 
  17.101 -<code>--help</code> propre à chaque application. Exemple avec 
  17.102 -<code>cjpeg</code> :
  17.103 -</p>
  17.104 -<pre>
  17.105 - $ cjpeg --help
  17.106 -</pre>
  17.107 -
  17.108 -<a name="mtPaint"></a>
  17.109 -<h3><font color="#6c0023">mtPaint -  Création et traitement d'images</font></h3>
  17.110 -<p>
  17.111 -mtPaint est une application de création et de retouche d'images, PNG, TIFF, 
  17.112 -XPM, BMP. Il est presque entièrement traduit en français, offre beaucoup de 
  17.113 -fonctions, simple, léger, et rapide. L'outil mtPaint fournit une fonction de 
  17.114 -capture d'écran (screenshot), que vous pouvez utiliser via le menu 
  17.115 ---&gt; Graphics --&gt; Grab screenshot, ou en tapant la commande ci-dessous
  17.116 -dans un terminal:
  17.117 -</p>
  17.118 -<pre>
  17.119 - $ mtpaint -s
  17.120 -</pre>
  17.121 -
  17.122 -<!-- End of content -->
  17.123 -</div>
  17.124 -
  17.125 -<!-- Footer. -->
  17.126 -<div id="footer">
  17.127 -	<div class="footer-right"></div>
  17.128 -	<a href="#top">Haut de la page</a> | 
  17.129 -	<a href="index.html">Table des matières</a>
  17.130 -</div>
  17.131 -
  17.132 -<div id="copy">
  17.133 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  17.134 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  17.135 -    Documentation publiées sous
  17.136 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  17.137 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  17.138 -</div>
  17.139 -
  17.140 -</body>
  17.141 -</html>

    18.1 --- a/doc/handbook-stable/handbook/hacking-livecd.html	Fri Feb 06 23:17:00 2009 +0100
    18.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.3 @@ -1,444 +0,0 @@
    18.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    18.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    18.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    18.7 -<head>
    18.8 -    <title>SliTaz Handbook - Hacking LiveCD</title>
    18.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   18.10 -    <meta name="description" content="modifier generer le livecd manuellement ligne de commande" />
   18.11 -    <meta name="expires" content="never" />
   18.12 -    <meta name="modified" content="2007-12-03 12:30:00" />
   18.13 -    <meta name="publisher" content="www.slitaz.org" />
   18.14 -    <meta name="author" content="Christophe Lincoln"/>
   18.15 -    <link rel="shortcut icon" href="favicon.ico" />
   18.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   18.17 -</head>
   18.18 -<body bgcolor="#ffffff">
   18.19 -
   18.20 -<!-- Header and quick navigation -->
   18.21 -<div id="header">
   18.22 -<div align="right" id="quicknav">
   18.23 -    <a name="top"></a>
   18.24 -    <a href="gen-livecd.html">Générer un LiveCD</a> |
   18.25 -    <a href="index.html">Table des matières</a>
   18.26 -</div>
   18.27 -<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   18.28 -</div>
   18.29 -
   18.30 -<!-- Content. -->
   18.31 -<div id="content">
   18.32 -<div class="content-right"></div>
   18.33 -
   18.34 -<h2><font color="#DF8F06">Hacking SliTaz LiveCD</font></h2>
   18.35 -
   18.36 -<ul>
   18.37 -    <li><a href="#intro">Introduction.</a></li>
   18.38 -    <li><a href="#pre">Organisation et préparation.</a></li>
   18.39 -    <li><a href="#add-files">Ajouter des fichiers dans l'ISO.</a></li>
   18.40 -    <li><a href="#isolinux">Modifier la configuration d'isolinux.</a></li>
   18.41 -    <li><a href="#memtest">Installer et utiliser Memtest86.</a></li>
   18.42 -    <li><a href="#rootfs">Manipuler la racine du système Live.</a></li>
   18.43 -    <li><a href="#gen-iso">Générer une image ISO bootable avec isolinux.</a></li>
   18.44 -</ul>
   18.45 -
   18.46 -<a name="intro"></a>
   18.47 -<h3><font color="#6c0023">Introduction</font></h3>
   18.48 -<p>
   18.49 -<em>Hacking SliTaz LiveCD</em> ou comment s'amuser avec l'image ISO du LiveCD,
   18.50 -la modifier, la personnaliser et la reconstruire à la main. A noter que vous
   18.51 -avez aussi la possibilité de 
   18.52 -<a href="gen-livecd.html">créer une saveur avec Tazlito</a> et cela de. Créer 
   18.53 -sa propre image ISO bootable ne demande que peut de temps, les étapes à suivre
   18.54 -sont soigneusement décrites dans ce document et sont faciles à réaliser. La 
   18.55 -manipulation de l'images ISO permet d'ajouter des nouveaux fichiers ou de 
   18.56 -modifier les fichiers existants sur le cdrom. L'image ISO de SliTaz fait moins
   18.57 -de 30 Mb et un CD-R ou CD-RW classique fournit 700 Mb, il reste donc pas mal
   18.58 -de place, pour mettre par exemple, vos photos afin de les montrer en 
   18.59 -<em>live</em> via SliTaz et un diaporama propulsé par le gestionnaire
   18.60 -d'images GQview. Le <em>hacking</em> de l'image ISO permet de modifier les
   18.61 -fichiers de configuration du chargeur de démarrage (<em>boot loader</em>) et
   18.62 -son image <em>splash</em> ou d'en utiliser un autre tel que GRUB. Vous pouvez
   18.63 -aussi facilement et directement ajouter des utilitaire tel que Memtest86 (outil
   18.64 -servant à tester la RAM d'une machine). En utilisant les mêmes techniques, il
   18.65 -est également possible de modifier le contenu du système en soit, cela demande
   18.66 -quelques manipulations supplémentaires et un peu plus de temps... libre.
   18.67 -</p>
   18.68 -<a name="pre"></a>
   18.69 -<h3><font color="#6c0023">Organisation et préparation</font></h3>
   18.70 -<p>
   18.71 -Pour commencer il faut définir l'endroit ou l'on va travailler, créer un
   18.72 -répertoire de travail et plusieurs sous-répertoires destinés à accueillir les
   18.73 -différents fichiers. Le <em>hacking</em> de l'ISO peut se faire depuis un
   18.74 -système SliTaz ou tous autres système GNU/Linux tels que Debian, Fedora,
   18.75 -PCLinuxOS, Slackware, etc. Si vous utilisez SliTaz en mode LiveCD (vous pouvez
   18.76 -retirer le cdrom une fois SliTaz lancée en RAM et graver votre nouvelle ISO),
   18.77 -nous vous conseillons d'utiliser un media USB pour conserver le travail, sinon
   18.78 -il sera perdu à l'arrêt du système. Pour travailler nous vous proposons 
   18.79 -d'utiliser un répertoire <code>hacked/</code> que vous pouvez créer dans
   18.80 -un répertoire <code>/home/slitaz</code>, à la racine de votre espace
   18.81 -utilisateur, ou ailleurs si vous le désirez. Utiliser un répertoire
   18.82 -<code>/home/slitaz</code> vous permet de stocker une image ISO originale et
   18.83 -de créer en options un répertoire <code>src/</code> pour télécharger
   18.84 -d'éventuelles paquets sources. Toutes les étapes de <em>hacking</em> peuvent
   18.85 -se faire en lignes de commandes via un termial X tel que XTerm ou en mode
   18.86 -texte et un  terminal Linux. A noter que nous vous conseillons de faire les
   18.87 -opérations en tant que <em>root</em> afin d'éviter tous problèmes de
   18.88 -permissions. Pour devenir administrateur (<em>root</em>), créer le
   18.89 -répertoire de travail dans <code>/home/slitaz/hacked</code> et se placer
   18.90 -dedans&nbsp;:
   18.91 -</p>
   18.92 -<pre>
   18.93 - $ su
   18.94 - # mkdir -p /home/slitaz/hacked
   18.95 - (# mkdir -p /home/slitaz/src)
   18.96 - # cd /home/slitaz/hacked
   18.97 -</pre>
   18.98 -<h4>Récupérer les fichiers contenus sur l'ISO</h4>
   18.99 -<p>
  18.100 -Maintenant que vous êtes dans le répertoire de travail, il faut créer la
  18.101 -racine de votre cdrom modifié et récupérer les fichiers contenu dans l'ISO
  18.102 -original du LiveCD. C'est à dire le noyau Linux (<code>bzImage</code>), le
  18.103 -système de fichiers compressé (<code>rootfs.gz</code>) et les fichiers du
  18.104 -chargeur de démarrage Isolinux. Pour récupérer ces fichiers vous avez deux
  18.105 -solutions, soit les prendre depuis un cdrom gravé, soit directement depuis
  18.106 -une image ISO local. Pour créer la racine de votre CD (<code>rootcd</code>)
  18.107 -et copier les fichiers depuis un périphérique cdrom reconnu comme
  18.108 -<code>/dev/cdrom</code> et monté sur <code>/media/cdrom</code>&nbsp;:
  18.109 -</p>
  18.110 -<pre>
  18.111 - # mount -t iso9660 /dev/cdrom /media/cdrom
  18.112 - # mkdir rootcd
  18.113 - # cp -a /media/cdrom/* rootcd
  18.114 -</pre>
  18.115 -<p>
  18.116 -Pour monter une image ISO en <em>loop</em> sur le répertoire temporaire
  18.117 -nommé <code>/tmp/loop</code> (avec l'image ISO <code>slitaz-cooking.iso</code>
  18.118 -préalablement téléchargée ou copiée), créer la racine du CD, copier les
  18.119 -fichiers et démonter l'image ISO&nbsp;:
  18.120 -</p>
  18.121 -<pre>
  18.122 - # mkdir /tmp/loop
  18.123 - # mount -o loop slitaz-cooking.iso /tmp/loop
  18.124 - # mkdir rootcd
  18.125 - # cp -a /tmp/loop/* rootcd
  18.126 - # umount /tmp/loop
  18.127 -</pre>
  18.128 -<p>
  18.129 -Voilà, tous les fichiers nécessaires devraient être présents dans le répertoire
  18.130 -<code>rootcd/</code>, pour vous en assurer, vous pouvez pouver lister
  18.131 -récursivement les fichiers via la commande <code>ls</code>&nbsp;:
  18.132 -</p>
  18.133 -<pre>
  18.134 - # ls -R rootcd
  18.135 -</pre>
  18.136 -<a name="add-files"></a>
  18.137 -<h3><font color="#6c0023">Ajouter des fichiers dans l'ISO</font></h3>
  18.138 -<p>
  18.139 -L'ajout de divers fichiers et répertoires dans l'image ISO consiste
  18.140 -simplement à copier des données à la racine du cdrom (<code>rootcd/</code>)
  18.141 -et à générer une nouvelle image. Les données ajoutées peuvent être classées
  18.142 -dans un ou des répertoires préalablement créés à la racine du CD. Une fois
  18.143 -l'image ISO gravée sur un CD-R/CD-RW vous pourrez utiliser SliTaz comme
  18.144 -avant, monter le cdrom sur <code>/media/cdrom</code> et naviguer dans vos
  18.145 -données graphiquement avec emelFM2, dans un terminal avec Clex ou en ligne de
  18.146 -commandes. Vos données seront aussi lisibles depuis tous les systèmes GNU/Linux,
  18.147 -BSD, et même... Windows.
  18.148 -</p>
  18.149 -<h4>Créer un ou des répertoires et copier des données</h4>
  18.150 -<p>
  18.151 -Pour créer et copier des fichiers vous pouvez commencer par utiliser la
  18.152 -ligne de commande et continuer graphiquement en tant que simple utilisateur.
  18.153 -Nous allons créer un répertoires <code>images/</code> en tant que <em>root</em>
  18.154 -et changer les permissions pour que tous les utilisateurs puissent écrire
  18.155 -dedans&nbsp;:
  18.156 -</p>
  18.157 -<pre>
  18.158 - # mkdir rootcd/images
  18.159 - # chmod 777 rootcd/images
  18.160 -</pre>
  18.161 -<p>
  18.162 -Maintenant qu'un nouveau répertoire existe en écriture pour tous, il faut le
  18.163 -remplir. Une fois que vous avez fini de copier vos données, il suffit de
  18.164 -<a href="#gen-iso">générer une nouvelle image ISO bootable</a>.
  18.165 -</p>
  18.166 -<a name="isolinux"></a>
  18.167 -<h3><font color="#6c0023">Modifier la configuration d'isolinux</font></h3>
  18.168 -<p>
  18.169 -Modifier la configuration d'isolinux vous permet de créer des entrées
  18.170 -personnalisées avec des options de <em>boot</em> prédéfinies, vous pouvez par
  18.171 -exemple ajouter un <code>label</code> lançant SliTaz avec les options
  18.172 -<code>lang=fr</code> et <code>kmap=fr_CH</code>. Au niveau graphisme, vous
  18.173 -pouvez facilement changer l'image <em>splash</em> s'affichant au démarrage.
  18.174 -L'application <code>isolinux</code> est le chargeur de démarrage 
  18.175 -(<em>boot loader</em>) du LiveCD, il est fournit par le paquet Syslinux.
  18.176 -L'archive source de Syslinux fournit diverses applications dont le rôle est
  18.177 -de démarrer un système GNU/Linux. La version binaire <code>isolinux.bin</code>
  18.178 -est déstinée aux image ISO, ce chargeur de démarrage est simple, rapide et
  18.179 -facilement configurable via un fichier de configuration principale, éditable
  18.180 -graphiquement ou dans un terminal avec votre éditeur de texte préféré.
  18.181 -La syntaxe du fichier de configuration <code>isolinux.cfg</code> est facile
  18.182 -à comprendre, pour ajouter de nouvelles entrées il suffit de copier/coller
  18.183 -en utilisant le fichier original. Pour éditer graphiquement le fichier
  18.184 -<code>isolinux.cfg</code> avec Leafpad&nbsp;:
  18.185 -</p>
  18.186 -<pre>
  18.187 - # leafpad rootcd/boot/isolinux/isolinux.cfg &amp;
  18.188 -</pre>
  18.189 -<h4>Fichier de configuration isolinux.cfg</h4>
  18.190 -<p>
  18.191 -Le fichier <code>isolinux.cfg</code>, fourni en standard sur le LiveCD de 
  18.192 -SliTaz, commence par la valeur <code>display</code>, cette valeur permet
  18.193 -d'afficher tel quel un fichier texte ou d'afficher un fichier 
  18.194 -(<code>isolinux.msg</code>) utilisant des caractères ASCII 24 et permettant
  18.195 -d'afficher du texte avec une image <em>splash</em>. La valeur 
  18.196 -<code>default</code> défini le nom du <code>label</code> à démarrer par
  18.197 -défaut après le temps d'attente (<code>timeout</code>). <em>Timeout</em>
  18.198 -correspond au nombre de secondes à attendre avant de booter, vous pouvez le
  18.199 -mettre à 0, hôter la ligne pour démarrer instantanément ou choisir un temps
  18.200 -d'attente plus long tel que 80 s. Pour finir, le <code>prompt</code> peut
  18.201 -être désactivé via la valeur <code>0</code>, les valeurs F1, F2, F3
  18.202 -affichent des fichiers d'aides et F4 est un display au format texte&nbsp;:
  18.203 -</p>
  18.204 -<pre class="script">
  18.205 -display isolinux.msg
  18.206 -default slitaz
  18.207 -label slitaz
  18.208 -      kernel /boot/bzImage
  18.209 -      append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
  18.210 -implicit 0	
  18.211 -prompt 1	
  18.212 -timeout 80
  18.213 -F1 help.txt
  18.214 -F2 options.txt
  18.215 -F3 isolinux.msg
  18.216 -F4 display.txt
  18.217 -</pre>
  18.218 -<p>
  18.219 -Exemple d'un label <code>slitazfr</code> que vous pouvez ajouter à l'orginal,
  18.220 -pour configurer directement la langue du système en français et avoir le
  18.221 -clavier Belge&nbsp;:
  18.222 -</p>
  18.223 -<pre class="script">
  18.224 -label slitazfr
  18.225 -      kernel /boot/bzImage
  18.226 -      append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=be
  18.227 -</pre>
  18.228 -<p>
  18.229 -Une fois que vous avez fini de modifier le fichier de configuration, il ne 
  18.230 -faut pas oublier d'enregistrer vos changements avant de 
  18.231 -<a href="#gen-iso">générer une nouvelle image ISO bootable</a> avec isolinux.
  18.232 -</p>
  18.233 -<a name="memtest"></a>
  18.234 -<h3><font color="#6c0023">Installer et utiliser Memtest86</font></h3>
  18.235 -<p>
  18.236 -L'application memtest86 (92 ko) est un outil autonome de test de mémoire vive
  18.237 -(RAM). Memetes86 permet de tester en profondeur l'état des barrettes de RAM et
  18.238 -de déceler une quelconque défaillance. L'outil s'installe dans le répertoire
  18.239 -<code>boot/</code> de la racine du cdrom et se lance directement au démarrage
  18.240 -de la machine en tapant simplement <code>memtest</code> au prompt d'isolinux.
  18.241 -Direction <code>/home/slitaz/src</code> (si le répertoire n'existe pas&nbsp;:
  18.242 -<code>mkdir -p /home/slitaz/src</code>) pour télécharger les sources et les
  18.243 -désarchiver&nbsp;:
  18.244 -</p>
  18.245 -<pre>
  18.246 - # cd /home/slitaz/src
  18.247 - # wget http://www.memtest86.com/memtest86-3.3.tar.gz
  18.248 - # tar xzf memtest86-3.3.tar.gz
  18.249 -</pre>
  18.250 -<p>
  18.251 -Le paquet source de Memtest86 étant désarchivé (vous y trouverez un fichier
  18.252 -<code>README</code> en anglais donnant des informations sur l'outil), vous
  18.253 -allez pouvoir l'installer dans le <em>root CD</em> de votre ISO hackée. En
  18.254 -partant du principe que vous utilisez un répertoire de travail 
  18.255 -<code>/home/slitaz/hacked</code>, nous allons copier le binaire précompilé
  18.256 -dans le répertoire <code>boot/</code> de la racine du CD&nbsp;:
  18.257 -</p>
  18.258 -<pre>
  18.259 - # cp memtest86-3.3/precomp.bin \
  18.260 -   /home/slitaz/hacked/rootcd/boot/memtest
  18.261 -</pre>
  18.262 -<p>
  18.263 -Maintenant que le binaire est installé dans le <em>root CD</em>, il suffit
  18.264 -d'ajouter une entrée pour Memtest86 dans le fichier de configuration d'isolinux
  18.265 -et de <a href="#gen-iso">générer une nouvelle image ISO bootable</a>.
  18.266 -Direction <code>/home/slitaz/hacked</code> pour éditer le fichier
  18.267 -<code>isolinux.cfg</code> avec LeafPad par exemple&nbsp;:
  18.268 -</p>
  18.269 -<pre>
  18.270 - # cd /home/slitaz/hacked
  18.271 - # leafpad rootcd/boot/isolinux/isolinux.cfg &amp;
  18.272 -</pre>
  18.273 -<pre class="script">
  18.274 -label memtest
  18.275 -      kernel /boot/memtest
  18.276 -</pre>
  18.277 -<p>
  18.278 -Site web officiel de Memtest86&nbsp;:
  18.279 -<a href="http://www.memtest86.com/">http://www.memtest86.com/</a>
  18.280 -</p>
  18.281 -<a name="rootfs"></a>
  18.282 -<h3><font color="#6c0023">Manipuler la racine du système Live</font></h3>
  18.283 -<p>
  18.284 -La modification du système Live vous permet par exemple d'ajouter rapidement
  18.285 -un nouvel utilisateur avec mot de passe, de personnaliser le graphisme ou
  18.286 -d'ajouter des commandes exécutées automatiquement au démarrage du LiveCD. Les
  18.287 -opérations nécessaires à la modification du système de fichier racine (
  18.288 -<em>root file system</em>) sont&nbsp;: extraire le système du fichier compresé
  18.289 -<code>rootfs.gz</code>, modfier, reconstruire l'image du système compressé
  18.290 -et générer une nouvelle ISO. En partant du principe que vous avez déjà
  18.291 -<a href="#pre">préparé votre répertoire de travail</a>, il faut commencer
  18.292 -par créer un répertoire destiné à contenir les fichiers du système modifiable.
  18.293 -Le système racine compressé étant nommé <code>rootfs.gz</code>, nous vous
  18.294 -proposons d'utiliser un répertoire <code>rootfs/</code> pour l'extraire. 
  18.295 -Direction le répertoire de travail <code>hacked/</code>, création du
  18.296 -répertoire racine et copie du système compressé depuis le répertoire
  18.297 -<code>rootcd/boot/</code> (la racine du cdrom)&nbsp;:
  18.298 -</p>
  18.299 -<pre>
  18.300 - # cd /home/slitaz/hacked
  18.301 - # mkdir rootfs
  18.302 - # cp rootcd/boot/rootfs.gz rootfs
  18.303 -</pre>
  18.304 -<p>
  18.305 -Maintenant que vous avez une copie du système compressé, il suffit de le
  18.306 -décompresser et de le désarchiver avec <code>cpio</code>. Techniquement : Le
  18.307 -fichier <code>rootfs.gz</code> est une archive Cpio compressé avec LZMA ou
  18.308 -Gzip, elle est reconnue comme une image <code>initramfs</code> par le noyau
  18.309 -Linux. Lors du démarrage de la machine, le noyau se charge en mémoire et
  18.310 -décompresse l'image du système en mémoire vive pour finir par exécuter les
  18.311 -scripts d'initialisation. Pour extraire le système dans le répertoire 
  18.312 -<code>rootfs/</code> et supprimer la copie désarchivée (Rappel : vous pouvez
  18.313 -copier/coller les commandes) :
  18.314 -</p>
  18.315 -<pre>
  18.316 - # cd rootfs
  18.317 - # (zcat rootfs.gz 2&gt;/dev/null || lzma d rootfs.gz -so) | cpio -id
  18.318 - # rm rootfs rootfs.gz
  18.319 -</pre>
  18.320 -<p>
  18.321 -Le système est prêt à être modifié, vous pouvez lister les fichiers contenus
  18.322 -à la racine de votre système hackable en utilisant la commande <code>ls</code>.
  18.323 -</p>
  18.324 -<h4>Modifier un fichier</h4>
  18.325 -<p>
  18.326 -Pour faire simple et vous aider comprendre le principe, nous allons modifier
  18.327 -un fichier script dans le but d'ajouter deux commandes exécutées
  18.328 -automatiquement à chaque démarrage du LiveCD. La cible est&nbsp;:
  18.329 -<code>etc/init.d/local.sh</code>, il suffit de l'ouvrir avec votre éditeur de
  18.330 -texte préféré tel que Geany&nbsp;:
  18.331 -</p>
  18.332 -<pre>
  18.333 - # geany etc/init.d/local.sh &amp;
  18.334 -</pre>
  18.335 -<p>
  18.336 -Nous allons ajouter une commande affichant un message et faisant dormir le
  18.337 -système 4 secondes (c'est juste pour se faire la main). Example de lignes à
  18.338 -ajouter au script déstiné aux commandes locales&nbsp;:
  18.339 -</p>
  18.340 -<pre class="script">
  18.341 -echo "* Hacked SliTaz version booting..."
  18.342 -sleep 4
  18.343 -</pre>
  18.344 -<h4>Reconstruire l'image du système compressée</h4>
  18.345 -<p>
  18.346 -Une fois les modifications terminées, vous pouvez reconstruire une image
  18.347 -compressée de votre système modifié en utilisant <code>find</code> pour 
  18.348 -trouver les fichiers, <code>cpio</code> pour archiver, <code>lzma</code> ou
  18.349 -<code>gzip </code> pour compresser et des pipes <code>|</code> pour connecter
  18.350 -le tout. Cette commande doit être lancée depuis le répertoire racine du
  18.351 -système (<code>rootfs/</code>) et crée un fichier compressé 
  18.352 -<code>rootfs.gz</code> dans le répertoire précédant :
  18.353 -</p>
  18.354 -<pre>
  18.355 - # find . -print | cpio -o -H newc | lzma e -si -so &gt; ../rootfs.gz
  18.356 - Ou avec gzip :
  18.357 - # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
  18.358 -</pre>
  18.359 -<p>
  18.360 -Pour finir il suffit de copier votre système compressé dans le répertoire
  18.361 -<code>boot/</code> de la racine du CD et de <a href="#gen-iso"
  18.362 ->générer une nouvelle image ISO bootable</a> avec isolinux. Pour copier le
  18.363 -<em>rootfs</em> en écrasant l'actuel, direction le répertoire de travail :
  18.364 -</p>
  18.365 -<pre>
  18.366 - # cd ../
  18.367 - # cp -a rootfs.gz rootcd/boot
  18.368 -</pre>
  18.369 -<a name="gen-iso"></a>
  18.370 -<h3><font color="#6c0023">Générer une image ISO bootable avec isolinux</font></h3>
  18.371 -<p>
  18.372 -La suite de commandes permettant de créer une image avec le 
  18.373 -<em>boot loader</em> <code>isolinux</code>, utilise l'application
  18.374 -<code>genisoimage</code> suivie de nombreuses options. Le nom de l'ISO est
  18.375 -spécifié au début, après l'option <code>-o</code> et le répertoire racine
  18.376 -(<code>rootcd/</code>) tout à la fin, après l'option
  18.377 -<code>-boot-info-table</code> :
  18.378 -</p>
  18.379 -<pre>
  18.380 - # genisoimage -R -o slitaz-hacked.iso -b boot/isolinux/isolinux.bin \
  18.381 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
  18.382 -   -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table rootcd
  18.383 -</pre>
  18.384 -<p>
  18.385 -Si vous désirez vérifier le contenu de l'ISO avant gravage, il suffit
  18.386 -de monter l'image en <code>loop</code> et de lister les fichiers. Sur SliTaz
  18.387 -et la plupart des systèmes GNU/Linux, vous pouvez graver des images au
  18.388 -format ISO avec l'utilitaire <code>wodim</code> fournit par <a 
  18.389 -href="utilities.html#cdrkit">cdrkit</a>.
  18.390 -</p>
  18.391 -<h4>Générer de nouvelles ISO via un script</h4>
  18.392 -<p>
  18.393 -Si vous testez plusieurs possibilités et que vous êtes amené à souvent générer
  18.394 -des nouvelles images ISO, vous aurez peut être envie de semi-automatiser les
  18.395 -opérations via un simple petit script SHell. Ce petit script peut être créé
  18.396 -en ligne de commandes ou édité graphiquement, mais il ne faut oublier de le
  18.397 -rendre exécutable. Vous pouvez créer le script avec la commande 
  18.398 -<code>cat</code>, à noter que <code>EOF</code> signifie <em>End Of File</em>,
  18.399 -c'est la que le fichier se termine. Nous vous proposons de nommer le script
  18.400 -<code>gen_hacked_iso.sh</code> et d'utiliser deux variables permettant de 
  18.401 -rapidement changer le nom de l'image ISO et le chemin vers le répertoire
  18.402 -racine du cdrom :
  18.403 -</p>
  18.404 -<pre>
  18.405 - # cat &gt; gen_hacked_iso.sh &lt;&lt; "EOF"
  18.406 -</pre>
  18.407 -<pre class="script">
  18.408 -#!/bin/sh
  18.409 -# Gen a new hacked ISO image.
  18.410 -#
  18.411 -ISO_NAME="slitaz-hacked.iso"
  18.412 -ROOTCD="rootcd"
  18.413 -
  18.414 -genisoimage -R -o $ISO_NAME -b boot/isolinux/isolinux.bin \
  18.415 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
  18.416 -   -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table $ROOTCD
  18.417 -
  18.418 -EOF
  18.419 -</pre>
  18.420 -<p>
  18.421 -Pour utiliser le script, il suffit de le rendre exécutable et de l'exécuter :
  18.422 -</p>
  18.423 -<pre>
  18.424 - # chmod +x gen_hacked_iso.sh
  18.425 - # ./gen_hacked_iso.sh
  18.426 -</pre>
  18.427 -
  18.428 -<!-- End of content -->
  18.429 -</div>
  18.430 -
  18.431 -<!-- Footer. -->
  18.432 -<div id="footer">
  18.433 -	<div class="footer-right"></div>
  18.434 -	<a href="#top">Haut de la page</a> | 
  18.435 -	<a href="index.html">Table des matières</a>
  18.436 -</div>
  18.437 -
  18.438 -<div id="copy">
  18.439 -    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  18.440 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  18.441 -    Documentation publiées sous
  18.442 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  18.443 -    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  18.444 -</div>
  18.445 -
  18.446 -</body>
  18.447 -</html>