SliTaz Repositories

     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/handbook-stable/handbook/book.css	Fri Feb 06 23:17:00 2009 +0100
     1.3 @@ -0,0 +1,170 @@
     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/handbook/chroot-env.html	Fri Feb 06 23:17:00 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/handbook/cmdline.html	Fri Feb 06 23:17:00 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/handbook/development.html	Fri Feb 06 23:17:00 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/handbook/enlightenment.html	Fri Feb 06 23:17:00 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/handbook/favicon.ico has changed

     7.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.2 +++ b/doc/handbook-stable/handbook/gen-livecd.html	Fri Feb 06 23:17:00 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/handbook/graphics.html	Fri Feb 06 23:17:00 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/handbook/hacking-livecd.html	Fri Feb 06 23:17:00 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 Binary file doc/handbook-stable/handbook/images/css/content-tl.png has changed

    11.1 Binary file doc/handbook-stable/handbook/images/css/content-tr.png has changed

    12.1 Binary file doc/handbook-stable/handbook/images/css/footer-bl.png has changed

    13.1 Binary file doc/handbook-stable/handbook/images/css/footer-br.png has changed

    14.1 Binary file doc/handbook-stable/handbook/images/css/header.png has changed

    15.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    15.2 +++ b/doc/handbook-stable/handbook/index.html	Fri Feb 06 23:17:00 2009 +0100
    15.3 @@ -0,0 +1,176 @@
    15.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    15.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    15.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    15.7 +<head>
    15.8 +    <title>SliTaz Handbook</title>
    15.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   15.10 +    <meta name="description" content="" />
   15.11 +    <meta name="expires" content="never" />
   15.12 +    <meta name="modified" content="2007-12-04 12:30:00" />
   15.13 +    <meta name="publisher" content="www.slitaz.org" />
   15.14 +    <meta name="author" content="Christophe Lincoln"/>
   15.15 +    <link rel="shortcut icon" href="favicon.ico" />
   15.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
   15.17 +</head>
   15.18 +<body bgcolor="#ffffff">
   15.19 +
   15.20 +<!-- Header and quick navigation -->
   15.21 +<div id="header">
   15.22 +<div align="right" id="quicknav">
   15.23 +    <a name="top"></a>
   15.24 +    <a href="http://www.slitaz.org/doc/">www.slitaz.org/doc/</a> |
   15.25 +    <a href="http://www.slitaz.org/en/doc/handbook/">English Handbook</a>
   15.26 +</div>
   15.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   15.28 +</div>
   15.29 +
   15.30 +<!-- Content. -->
   15.31 +<div id="content">
   15.32 +<div class="content-right"></div>
   15.33 +
   15.34 +<h2><font color="#DF8F06">Livre de main de SliTaz</font></h2>
   15.35 +
   15.36 +<h3><font color="#6c0023">Table des matières</font></h3>
   15.37 +<ul>
   15.38 +    <li><a href="livecd.html">Utiliser le LiveCD</a> -  Comment démarrer ?
   15.39 +    Conserver ses données en utilisant un media externe (clé USB). Login,
   15.40 +    des mots de passes et session graphique (X).</li>
   15.41 +    <li><a href="install.html">Instructions d'installation</a> - Déscription
   15.42 +    des étapes à réaliser manuellement pour installer Slitaz sur un disque
   15.43 +    dur.</li>
   15.44 +    <li><a href="cmdline.html">Références en ligne de commandes</a> - Utiliser
   15.45 +    SliTaz en ligne commandes via un terminal Linux ou graphique.</li>
   15.46 +    <li><a href="jwm.html">JWM</a> - Présentation, utilisation et
   15.47 +    configuration du gestionnaire de fenêtres <em>Joe Window Manager</em>.
   15.48 +    Ce document fournit les instructions pour créer un thème ou/et modifier
   15.49 +    le menu en fonction de ses goûts, envies et besoins.</li>
   15.50 +    <li><a href="enlightenment.html">Enlightenment (e17)</a> - Environnement
   15.51 +    de bureau complet, léger, rapide, facilement configurable et simplement
   15.52 +    beau.</li>
   15.53 +</ul>
   15.54 +<h4>Applications</h4>
   15.55 +<ul>
   15.56 +    <li><a href="utilities.html">Utilitaires</a> - Navigateurs de fichiers,
   15.57 +    base de données SQL, calculatrice, gravure de CD/DVD et créations ISO.</li>
   15.58 +    <li><a href="office.html">Bureautique</a> - Traitement de texte, Organiseur
   15.59 +    personnel, lecteur PDF, Wiki, etc.</li>
   15.60 +    <li><a href="network.html">Internet</a> - Navigateurs web,
   15.61 +    client de chat IRC, client mail, client BitTorrent et FTP.</li>
   15.62 +    <li><a href="graphics.html">Graphisme</a> - Infographie, et gestion
   15.63 +    d'images.</li>
   15.64 +    <li><a href="multimedia.html">Multimedia</a> - Son, musique et video</li>
   15.65 +    <li><a href="development.html">Développement</a> - Créer des interfaces
   15.66 +    graphiques avec Dialog, IDE ou Environnement de Développement Intégré,
   15.67 +    scripts SHell et Perl.
   15.68 +    Installer la <em>toolchain</em> et compiler des sources.</li>
   15.69 +    <li><a href="secure-shell.html">SHell sécurisé (SSH)</a> - Contrôle et
   15.70 +    admin à distance avec Dropbear, client/serveur SSH et fournissant aussi
   15.71 +    l'utilitaire de copie scp.</li>
   15.72 +    <li><a href="system-tools.html">Outils système</a> - Visionneur de
   15.73 +    processus système, mountage et gestion d'un disque dur.</li>
   15.74 +    <li>Jeux - Clone du jeu Space in Vaders : nInvaders. Et un petit tetris :
   15.75 +    Bastet.</li>
   15.76 +</ul>
   15.77 +<h4>Système</h4>
   15.78 +<ul>
   15.79 +    <li><a href="x-window.html">Système de fenêtres X</a> - Utilisation du
   15.80 +    serveur Xvesa ou Xorg, polices (<em>fonts</em>) et configuration d'une 
   15.81 +    session graphique.</li>
   15.82 +    <li><a href="system-admin.html">Administration du système</a> -  Configurer
   15.83 +    la langue, le clavier, régler l'horloge et le fuseau horaire. Utiliser
   15.84 +    Crond et Crontab, gestion des utilisateurs et groupes.</li>
   15.85 +    <li><a href="network-config.html">Configuration du réseau</a> -  Connexion au web,
   15.86 +    réseau local, et pare-feu (firewall).</li>
   15.87 +    <li><a href="web-server.html">Serveur web</a> - Utiliser et configurer le
   15.88 +    serveur web LightTPD.</li>
   15.89 +    <li><a href="packages.html">Gestion des paquets</a> - Liste des paquets
   15.90 +    logiciels, installation, désinstallation, et infos sur les paquets de
   15.91 +    SliTaz.</li>
   15.92 +    <li><a href="security.html">Sécurité du système</a> - SliTaz et la sécurité
   15.93 +	du système en général.</li>
   15.94 +    <li><a href="chroot-env.html">Environnement chrooté</a> - Construire un
   15.95 +    <em>chroot</em> pour protéger le système hôte, tester, compiler et/ou
   15.96 +    développer SliTaz.</li>
   15.97 +    <li><a href="hacking-livecd.html">Hacking LiveCD</a> - Manipuler et
   15.98 +    s'amuser avec l'image ISO du LiveCD de SliTaz.</li>
   15.99 +    <li><a href="gen-livecd.html">Générer un LiveCD à saveur</a> - Créer 
  15.100 +    votre propre saveur du LiveCD en utilisant les paquets et Tazlito.</li>
  15.101 +    <li><a href="liveusb.html">LiveUSB</a> - Installer et démarrer SliTaz
  15.102 +    depuis un media USB.</li>
  15.103 +</ul>
  15.104 +
  15.105 +<a name="about"></a>
  15.106 +<h3><font color="#6c0023">&Agrave; propos de ce Handbook</font></h3>
  15.107 +<p>
  15.108 +Le Handbook de SliTaz est le livre de référence au sujet de l'utilisation du
  15.109 +système au niveau utilisateur, administrateur et développeur en général. Ce
  15.110 +Handbook réunit des travaux de référence, des mini manuels et une collection
  15.111 +d'instructions destinées à fournir un livre complet, de haute qualité, 
  15.112 +facilement consultable et fournissant des réponses rapides sur un sujet
  15.113 +spécifique. Le Handbook est écrit au format xHTML 1.0 avec l'IDE Geany et
  15.114 +l'éditeur de texte GNU Nano.
  15.115 +</p>
  15.116 +<p>
  15.117 +Vous pouvez vous référer à la table des matières de cette page pour un
  15.118 +accès aux divers documents à thèmes. Pour commencer en mode LiveCD, nous vous
  15.119 +conseillons de jeter un coup d'oeil au chapître :
  15.120 +<a href="livecd.html">Utiliser le LiveCD</a>. Vous pouvez lire le Handbook
  15.121 +de manière linéaire en utilisant le liens de navigation rapide situés dans le
  15.122 +coin droite en haut de chaque pages ou naviguer dans les pages en fonction de
  15.123 +vos besoins.
  15.124 +</p>
  15.125 +<p>
  15.126 +La dernière version du <a href="http://www.slitaz.org/doc/handbook/"
  15.127 +>Handbook</a> de SliTaz est lisible via la partie 
  15.128 +<a href="http://www.slitaz.org/doc/">documentation</a> du site web de 
  15.129 +<a href="http://www.slitaz.org/">www.slitaz.org</a>. Au moment de la
  15.130 +publication d'une nouvelle version de SliTaz, le Handbook est archivé et
  15.131 +prend le même numéro de version que SliTaz. Il est alors inclus en standard,
  15.132 +dans la distribution de base officielle.
  15.133 +</p>
  15.134 +<h4>Participer/collaborer/réclamer</h4>
  15.135 +<p>
  15.136 +La documentation du projet se veut une oeuvre collaborative. Vous pouvez
  15.137 +facilement participer à l'écriture ou à la relecture de documents, nous faire
  15.138 +part de vos suggestions et commentaires. Si vous avez besoin d'une description
  15.139 +supplémentaire, d'un texte de référence ou autre, vous pouvez, sans hésiter,
  15.140 +nous contacter et nous faire une demande spécifique. 
  15.141 +</p>
  15.142 +<p>
  15.143 +Si vous avez remarqué des erreurs dans les textes ou si vous avez fait une
  15.144 +relecture complète d'un chapître, vous pouvez envoyer/attacher vos 
  15.145 +correctifs sous forme de patch ou envoyer toute la page relue ou encore
  15.146 +signaler les erreurs directement dans le contenu du mail.
  15.147 +</p>
  15.148 +<p>
  15.149 +Pour écrire un nouveau document ou un bout de texte à rajouter dans un
  15.150 +chapître existant, vous pouvez utiliser la page modèle du Handbook
  15.151 +(<a href="template.html">template.html</a>) associée à sa feuille de style
  15.152 +CSS (<a href="book.css">handbook.css</a>) ou simplement utiliser un
  15.153 +fichier texte (une personne de la liste se chargera de la mise en page). Une
  15.154 +fois votre texte mis en page, vous pouvez l'envoyer sur la liste afin qu'il
  15.155 +soit relu et corrigé. Votre documents sera ensuite intégré au Handbook
  15.156 +officiel de SliTaz. Par la suite, vous avez le choix de rester le mainteneur
  15.157 +du document ou de passer la main.
  15.158 +</p>
  15.159 +
  15.160 +<!-- End of content -->
  15.161 +</div>
  15.162 +
  15.163 +<!-- Footer. -->
  15.164 +<div id="footer">
  15.165 +	<div class="footer-right"></div>
  15.166 +	<a href="#top">Haut de la page</a> | 
  15.167 +	<a href="index.html">Table des matières</a>
  15.168 +</div>
  15.169 +
  15.170 +<div id="copy">
  15.171 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  15.172 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  15.173 +    Documentation publiées sous
  15.174 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  15.175 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  15.176 +</div>
  15.177 +
  15.178 +</body>
  15.179 +</html>

    16.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    16.2 +++ b/doc/handbook-stable/handbook/install.html	Fri Feb 06 23:17:00 2009 +0100
    16.3 @@ -0,0 +1,240 @@
    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 - Installation</title>
    16.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   16.10 +    <meta name="description" content="installation de SliTaz GNU/Linux sur disque dur hd grub boot" />
   16.11 +    <meta name="expires" content="never" />
   16.12 +    <meta name="modified" content="2007-12-18 12: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="cmdline.html">Ligne de commandes</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">Instructions d'installation sur HD</font></h2>
   16.35 +
   16.36 +<ul>
   16.37 +	<li><a href="#apropos">A propos de ce document.</a></li>
   16.38 +	<li><a href="#prerequis">Prérequis.</a></li>
   16.39 +	<li><a href="#installer">Installateur.</a></li>
   16.40 +	<li><a href="#byhand">Installation à la main.</a>
   16.41 +		<ul>
   16.42 +			<li><a href="#cdrom">Monter le cdrom.</a></li>
   16.43 +			<li><a href="#install">Installation du système.</a></li>
   16.44 +		</ul></li>
   16.45 +	<li><a href="#grub">Installer le bootloader GRUB.</a></li>
   16.46 +	<li><a href="#reboot">Redémarrer (<em>reboot</em>).</a></li>
   16.47 +</ul>
   16.48 +
   16.49 +<a name="apropos"></a>
   16.50 +<h3><font color="#6c0023">A propos de ce document</font></h3>
   16.51 +<p>
   16.52 +Ce document fournit les instructions pour une installation de SliTaz GNU/Linux
   16.53 +sur un disque dur (HD). Il vous faudra passer quelques commandes et éditer
   16.54 +quelques fichiers au format texte. Le temps à consacrer pour une
   16.55 +installation de base est d'environ 10 min. A noter que vous pouvez toujours
   16.56 +utiliser une clé USB ou un disque dur externe en tant que partition
   16.57 +<code>/home</code>, comme avec <a href="livecd.html">le mode LiveCD</a>. A noter
   16.58 +que vous avez le choix entre un installation semi-automatisée ou une
   16.59 +installation à la main, commande par commande.
   16.60 +</p>
   16.61 +
   16.62 +<a name="prerequis"></a>
   16.63 +<h3><font color="#6c0023">Prérequis</font></h3>
   16.64 +<p>
   16.65 +Il vous faut un cdrom ou une image ISO de SliTaz et environ 80 Mb de libre
   16.66 +sur un disque dur de votre ordinateur. Si le mode liveCD fonctionne c'est
   16.67 +que vous pouvez installer SliTaz facilement et sans aucun problèmes.
   16.68 +</p>
   16.69 +<p>
   16.70 +Pour commencer, vous devez avoir une partition montée pour installer SliTaz
   16.71 +et avoir ouvert un terminal avec un SHell administrateur (<em>root</em>).
   16.72 +En mode LiveCD, vous pouvez devenir <em>root</em> avec la commande
   16.73 +<code>su</code> suivi du mot de passe <code>root</code>. Pour lister les
   16.74 +partitions disponibles, vous pouvez utiliser les commandes :
   16.75 +<code>cat /proc/partitions</code> ou <code>fdisk -l</code>. Pour créer un
   16.76 +système de fichiers sur une partition, vous pouvez utiliser l'utilitaire
   16.77 +<code>mkfs</code>. Exemple avec la partition <code>hda1</code> et le système
   16.78 +de fichiers journalisé <code>ext3</code>, attention cette commande détruit
   16.79 +définitivement toutes les données de la partition spécifiée :
   16.80 +</p>
   16.81 +<pre>
   16.82 + # mkfs.ext3 /dev/hda1
   16.83 +</pre>
   16.84 +
   16.85 +<a name="installer"></a>
   16.86 +<h3><font color="#6c0023">Installateur</font></h3>
   16.87 +<p>
   16.88 +SliTaz fourni un installateur en mode ncurses, simple, intutif et en français.
   16.89 +Il fournit les instructions nécessaires, pas à pas, pour que l'installation
   16.90 +du système se passe sans soucis et que vous puissiez redémarrer sur votre
   16.91 +nouveau système SliTaz GNU/Linux. Les étapes sont toutes automatisées, vous
   16.92 +pourrez installer le gestionnaire de démarrage GRUB si besoin est, ou
   16.93 +ajouter une ligne au fichier de configuration de votre gestionnaire de
   16.94 +démarrage actuel. Pour afficher le premier message et commencer l'installation :
   16.95 +</p>
   16.96 +<pre>
   16.97 + # slitaz-installer
   16.98 +</pre>
   16.99 +
  16.100 +<a name="byhand"></a>
  16.101 +<h3><font color="#6c0023">Installation à la main</font></h3>
  16.102 +<p>
  16.103 +Si vous avez utilisé l'installateur, vous pouvez directement passer au
  16.104 +<a href="#grub">bootloader GRUB.</a>
  16.105 +</p>
  16.106 +<p>
  16.107 +A noter que vous pouvez copier/coller les commandes depuis Firefox dans le
  16.108 +terminal, en utilisant le bouton du milieu. A noter aussi que ce document ne
  16.109 +demande qu'a être amélioré, toute contribution est la bienvenue.
  16.110 +</p>
  16.111 +<h4>Monter la partition cible</h4>
  16.112 +<p>
  16.113 +Pour monter la partition cible sur un point de montage tel que le répertoire
  16.114 +<code>/mnt/target</code>, vous pouvez utiliser la commande <code>mount</code>.
  16.115 +Exemple :
  16.116 +</p>
  16.117 +<pre>
  16.118 + # mkdir /mnt/target
  16.119 + # mount -t ext3 /dev/hda1 /mnt/target
  16.120 +</pre>
  16.121 +
  16.122 +<a name="cdrom"></a>
  16.123 +<h4>Monter le cdrom</h4>
  16.124 +<p>
  16.125 +Tous les fichiers utiles se trouvent sur le cdrom de SliTaz. Il faut le noyau
  16.126 +Linux, le système de fichiers racine compressé (rootfs.gz), et des packages
  16.127 +additionnels si vous le désirez. Pour monter le périphérique de cdrom sur
  16.128 +le point de montage <code>/media/cdrom</code> :
  16.129 +</p>
  16.130 +<pre>
  16.131 + # mount -t iso9660 /dev/cdrom /media/cdrom
  16.132 + ou
  16.133 + # mount -t iso9660 /dev/hdd /media/cdrom
  16.134 +</pre>
  16.135 +
  16.136 +<a name="install"></a>
  16.137 +<h4>Installation du système</h4>
  16.138 +<p>
  16.139 +Création du répertoire /boot et copie du noyau Linux, qui se nomme bzImage
  16.140 +sur le cdrom. Nous allons renommer le noyau en vmlinuz suivi de son numéro
  16.141 +de version, que l'on peut obtenir avec la commande
  16.142 +<code>uname -r</code> en mode live :
  16.143 +</p>
  16.144 +<pre>
  16.145 + # mkdir /mnt/target/boot
  16.146 + # cd /media/cdrom/boot
  16.147 + # cp bzImage /mnt/target/boot/vmlinuz-2.6.22.9-slitaz
  16.148 +</pre>
  16.149 +<p>
  16.150 +Copie du rootfs:
  16.151 +</p>
  16.152 +<pre>
  16.153 + # cp rootfs.gz /mnt/target
  16.154 +</pre>
  16.155 +<p>
  16.156 +Nous allons maintenant nous déplacer dans la cible, et décompressé l'archive
  16.157 +rootfs.lf avec lzma et cpio. Nous supprimons ensuite le fichier rootfs et le
  16.158 +lien init, utilisé par le mode liveCD :
  16.159 +</p>
  16.160 +<pre>
  16.161 + # cd /mnt/target
  16.162 + # lzma d rootfs.lz -so | cpio -id 
  16.163 + # rm rootfs.lz init
  16.164 +</pre>
  16.165 +<p>
  16.166 +Voilà SliTaz est installé. Si vous avez déjà GRUB ou Lilo d'installé, vous
  16.167 +pouvez ajouter les lignes nécessaires pour faire booter SliTaz, et redémarrer.
  16.168 +Sinon il vous faut installer le boot loader GRUB.
  16.169 +</p>
  16.170 +<a name="grub"></a>
  16.171 +<h3><font color="#6c0023">Installer le bootloader GRUB</font></h3>
  16.172 +<p>
  16.173 +Le paquet GRUB devrait être installé sur le LiveCD de SliTaz. GRUB est un
  16.174 +chargeur de démarrage (<em>boot loader</em>) permettant de lancer les systèmes
  16.175 +GNU/Linux, BSD et même Windows, via de simple entrée dans un fichier texte.
  16.176 +Ce fichier texte se nomme <code>menu.list</code>, il permet de finement
  16.177 +configurer le chargeur de démarrage, il peut être modifié manuellement et à
  16.178 +tous moments.
  16.179 +</p>
  16.180 +<p>
  16.181 +Installation de GRUB sur le mbr, avec comme racine /mnt/target (la cible), et
  16.182 +comme disque <code>hda</code> :
  16.183 +</p>
  16.184 +<pre>
  16.185 + # grub-install --root-directory=/mnt/target /dev/hda
  16.186 +</pre>
  16.187 +<p>
  16.188 +Vous pouvez maintenant ajouter les lignes de configuration ci-dessous pour
  16.189 +SliTaz, au fichier menu.lst de la cible. Pour cela vous pouvez utiliser
  16.190 +l'éditeur de texte Nano ou LeafPad en mode graphique . A noter que pour
  16.191 +connaître la version du noyau Linux sur un système GNU/Linux, vous pouvez
  16.192 +utiliser la commande <code>$ uname -a</code>. Pour éditer le fichier de
  16.193 +configuration de GRUB (Un exemple est fournit) :
  16.194 +</p>
  16.195 +<pre>
  16.196 + # nano /mnt/target/boot/grub/menu.lst
  16.197 + (Ctrl+X pour quitter)
  16.198 + ou :
  16.199 + # leafpad /mnt/target/boot/grub/menu.lst
  16.200 +</pre>
  16.201 +<h4>/boot/grub/menu.lst - Exemple</h4>
  16.202 +<pre class="script">
  16.203 +
  16.204 + title  SliTaz GNU/Linux (cooking) (Kernel 2.6.22.9-slitaz)
  16.205 +        root(hd0,0)
  16.206 +        kernel /boot/vmlinuz-2.6.22.9-slitaz root=/dev/hda1 vga=788
  16.207 +
  16.208 +</pre>
  16.209 +<a name="reboot"></a>
  16.210 +<h3><font color="#6c0023">Redémarrer (<em>reboot</em>)</font></h3>
  16.211 +<p>
  16.212 +Vous devriez pouvoir redémarrer sur votre nouveau système SliTaz GNU/Linux.
  16.213 +Après l'installation de SliTaz sur un disque dur, il est recommandé de
  16.214 +commencer par configurer le système, en fonction de ses besoins, du matériel,
  16.215 +et des possibilités. Pour configurer votre système après le reboot et
  16.216 +apprendre à utiliser SliTaz, vous pouvez vous référer au Handbook. Vous pouvez
  16.217 +redémarrer via le menu du gestionnaire de fenêtres JWM ou via la commande :
  16.218 +</p>
  16.219 +<pre>
  16.220 + # reboot
  16.221 +</pre>
  16.222 +
  16.223 +
  16.224 +<!-- End of content -->
  16.225 +</div>
  16.226 +
  16.227 +<!-- Footer. -->
  16.228 +<div id="footer">
  16.229 +	<div class="footer-right"></div>
  16.230 +	<a href="#top">Haut de la page</a> | 
  16.231 +	<a href="index.html">Table des matières</a>
  16.232 +</div>
  16.233 +
  16.234 +<div id="copy">
  16.235 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  16.236 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  16.237 +    Documentation publiées sous
  16.238 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  16.239 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  16.240 +</div>
  16.241 +
  16.242 +</body>
  16.243 +</html>

    17.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    17.2 +++ b/doc/handbook-stable/handbook/jwm.html	Fri Feb 06 23:17:00 2009 +0100
    17.3 @@ -0,0 +1,215 @@
    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 - JWM</title>
    17.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   17.10 +    <meta name="description" content="SliTaz desktop bureau graphique JWM light window manager léger rapide simple gestion fenêtres" />
   17.11 +    <meta name="expires" content="never" />
   17.12 +    <meta name="modified" content="2007-12-04 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="enlightenment.html">Enlightenment</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">JWM le gestionnaire de fenêtres</font></h2>
   17.35 +
   17.36 +<ul>
   17.37 +    <li><a href="#intro">Introduction et présentation de JWM.</a></li>
   17.38 +    <li><a href="#usage-config">Utilisation et configuration de JWM.</a></li>
   17.39 +    <li><a href="#style">Créer son propre style pour JWM.</a></li>
   17.40 +    <li><a href="#ontheweb">JWM sur le web.</a></li>
   17.41 +</ul>
   17.42 +
   17.43 +<a name="intro"></a>
   17.44 +<h3><font color="#6c0023">Introduction et présentation de JWM</font></h3>
   17.45 +<p>
   17.46 +Le gestionnaire de fenêtres (en anglais <em>window manager</em> ou <em>WM</em>)
   17.47 +fourni de base avec SliTaz, se nomme&nbsp;: JWM (<em>Joe's Window Manager</em>).
   17.48 +Un gestionnaire de fenêtres est une application tournant au dessus du serveur
   17.49 +X, permetant de contrôler l'apparence des fenêtres, d'ouvrir un terminal X ou
   17.50 +d'afficher des applications. Il permet ensuite de placer, de réduire, et de 
   17.51 +dimensionner les fenêtres à son propre gré. JWM sais aussi gérer plusieurs
   17.52 +bureaux virtuels, fournit des raccourcis clavier configurables, et propose un
   17.53 +joli menu supportant les icônes. JWM est un gestionnaire de fenêtres très
   17.54 +léger, c'est un bureau graphique efficace, ne consommant pas toutes les
   17.55 +ressources du système, il est relativement facile d'accès à un débutant dans
   17.56 +le monde libre de GNU/Linux. Côté développeur l'utilisation d'un gestionnaire
   17.57 +de fenêtres léger est appréciable, l'économie des ressources système
   17.58 +signifiant un gain en rapidité, même sur des machines puissantes.
   17.59 +</p>
   17.60 +<p>
   17.61 +<em>Joe's Window Manager</em> est écrit en C, simple, rapide, épuré, stable et
   17.62 +efficace. JWM propose une ou plusieurs barre(s) des tâches, un menu avec des
   17.63 +icônes et un pager pour la gestion des bureaux virtuels, la barre des tâches
   17.64 +peut aussi afficher l'heure en différents formats et un dock par instance de
   17.65 +JWM. De plus il est facilement configurable via un seul fichier texte vous
   17.66 +permettant de changer le menu, les polices et leurs tailles, et les
   17.67 +différentes couleurs. Le projet est en actif développement et les 
   17.68 +fonctionnalités s'additionnent avec le temps, depuis la version 2.0 vous
   17.69 +bénéficiez, par exemple, du support des couleurs dégradées (<em>gradient</em>),
   17.70 +de la gestion du fond d'écran ou de la possibilité de déplacer les fenêtres
   17.71 +via le pager.
   17.72 +</p>
   17.73 +<a name="usage-config"></a>
   17.74 +<h3><font color="#6c0023">Utilisation et configuration de JWM</font></h3>
   17.75 +<p>
   17.76 +La prise en main de  Joe's Window Manager est très rapide. Pour afficher le
   17.77 +menu il suffit de cliquer quelque part sur le bureau ou sur le bouton du menu
   17.78 +qui se trouve, par défaut, en bas à gauche de l'écran. Vous pouvez
   17.79 +redimensionner une fenêtre via une des bordures ou un des coins, les passer
   17.80 +d'un bureau virtuel à l'autre via le pager, les réduire ou encore les
   17.81 +maximiser. Vous disposez aussi de raccourcis clavier configurables pour un 
   17.82 +accès plus rapide aux applications que vous utilisez le plus souvent. Sur 
   17.83 +SliTaz le fichier de configuration système est&nbsp;: 
   17.84 +<code>/etc/jwm/system.jwmrc</code>. A part ce fichier de configuration
   17.85 +système, chaque utilisateur peut utiliser son propre fichier de configuration
   17.86 +caché <code>~/.jwmrc</code>. Ce fichier est un fichier texte utilisant la 
   17.87 +syntaxe XML, il peut être modifié avec un simple éditeur de texte, les lignes
   17.88 +commençant par&nbsp;: <code>&lt;!--</code> sont des commentaires qui vous aiderons
   17.89 +à savoir quelle balise fait quoi.
   17.90 +</p>
   17.91 +<p>
   17.92 +Pour faciliter la personnalisation de son bureau, SliTaz copie automatiquement,
   17.93 +lors du lancement de la première session graphique, un fichier de configuration
   17.94 +système à la racine du répertoire personnel de l'utilisateur. Vous pouvez
   17.95 +directement modifier ce fichier et faire vos essais sans risques. Pour l'éditer
   17.96 +avec votre éditeur de texte préféré&nbsp;:
   17.97 +</p>
   17.98 +<pre>
   17.99 + $ geany $HOME/.jwmrc &amp;
  17.100 +</pre>
  17.101 +<p>
  17.102 +Pour récupérer un fichier de configuration original, il faut copier celui du 
  17.103 +système dans son répertoire personnel en le renommant par <code>.jwmrc</code>,
  17.104 +vous pourez ensuite (re)commencer à l'éditer&nbsp;:
  17.105 +</p>
  17.106 +<pre>
  17.107 + $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc
  17.108 +</pre>
  17.109 +<p>
  17.110 +Maintenant que vous avez un fichier de configuration personnel vous allez
  17.111 +pouvoir créer votre propre menu en utilisant les icônes dont vous avez envie.
  17.112 +La balise&nbsp;: <code>RootMenu</code> correspond au menu affiché par un clique
  17.113 +sur un des trois boutons de la souris. Pour ajouter une catégorie vous devez
  17.114 +utiliser la balise&nbsp;: Menu contenant elle même des entrées pour divers
  17.115 +programmes. Une entrée dans le menu de JWM peut tenir sur une seule ligne,
  17.116 +exemple avec l'application de gestion d'images GQview&nbsp;:
  17.117 +</p>
  17.118 +<pre class="script">
  17.119 +&lt;Program icon="gqview.png" label="GQview"&gt;gqview&lt;/Program&gt;
  17.120 +</pre>
  17.121 +<p>
  17.122 +Il existe encore de nombreuses possibilités de configuration comme 
  17.123 +l'utilisation de plusieurs <code>RootMenu</code> en fonction des boutons de 
  17.124 +la souris, le choix du mode utilisé pour déplacer les fenêtres, la création
  17.125 +de groupes, etc. Le manuel disponible en ligne sur le site web officiel du 
  17.126 +projet devrait vous aider à aller plus loin, pour afficher une liste des
  17.127 +options possibles en ligne de commandes il suffit de taper&nbsp;: 
  17.128 +<code>jwm -h</code> dans un terminal.
  17.129 +</p>
  17.130 +<a name="style"></a>
  17.131 +<h3><font color="#6c0023">Créer son propre style pour JWM</font></h3>
  17.132 +<p>
  17.133 +Créer son style graphique avec JWM est relativement facile et se fait
  17.134 +rapidement, les balises sont claires et les attributs possibles sont donnés
  17.135 +dans les commentaires. Lors de l'élaboration de votre travail, vous pouvez
  17.136 +voir vos modification au fur et à mesure en redémarrant le gestionnaire de
  17.137 +fenêtres via le menu ou la commande&nbsp;: <code>jwm  -restart</code>. Dans le
  17.138 +fichier de configuration les balises de styles débutent après  la ligne de 
  17.139 +commentaires&nbsp;: &lt;!-- Visual Styles --&gt;. Pour commencer voici une petite
  17.140 +liste des balises de styles principales avec une courte description&nbsp;:
  17.141 +</p>
  17.142 +<ul>
  17.143 +    <li><code>Background</code> gére le fond d'écran. Ce tag supporte les
  17.144 +    attributs&nbsp;: <code>solid, gradient, image</code> ou <code>tile</code>,
  17.145 +    permettant respectivement d'utiliser une couleur solide, de créer un
  17.146 +    dégradé, d'afficher une image redimensinnée ou en mode tuile.</li>
  17.147 +    <li><code>BorderStyle</code> contrôle le style de la bordure des fenêtres</li>
  17.148 +    <li><code>TrayStyle</code> contrôle une barre des tâches. Vous pouvez en
  17.149 +    mettre plusieurs (en haut et en bas par exemple). La barre des tâches peut,
  17.150 +    entre autre, être cachée automatiquement ou ne remplir qu'une partie de
  17.151 +    l'écran via l'attribut <code>width</code>.</li>
  17.152 +    <li><code>TaskListStyle</code> contrôle le style de la liste des fenêtres 
  17.153 +    ouvertes sur le bureau courant.</li>
  17.154 +    <li><code>PagerStyle</code> contrôle le pager affichant les différents 
  17.155 +    bureaux virtuels (quatre par défaut).</li>
  17.156 +    <li><code>MenuStyle</code> définit le style du menu.</li>
  17.157 +    <li>Les icônes sont définies par le tag <code>IconPath</code>, vous pouvez
  17.158 +    facilement utiliser vos icônes personnelles en spécifiant le chemin
  17.159 +    complet vers le répertoire qui les contient. A noter que vous pouvez
  17.160 +    spécifier plus d'un chemin, si vous voulez par exemple utiliser vos
  17.161 +    images et celles du système contenues dans&nbsp;: 
  17.162 +    <code>/usr/share/pixmaps</code> et <code>/usr/share/icons</code>. SliTaz 
  17.163 +    utilise les icons du thème Tango: <a href="http://tango.freedesktop.org/"
  17.164 +    >tango.freedesktop.org</a> pour le menu. Ils sont de taille 16x16 et se
  17.165 +    trouvent dans le répertoire&nbsp;: <code>/usr/share/icons/Tango</code>.
  17.166 +    Vous pouvez en rajouter, les modifier, les supprimer, etc. Si vous désirez
  17.167 +    installer de nouvelles icônes en espace utilisateur, nous vous conseillons
  17.168 +    d'utiliser un répertoire personnel <code>~/Images/Icons</code> (configurer
  17.169 +    par défaut) ou un répertoire caché <code>~/.icons</code>.
  17.170 +</li>
  17.171 +</ul>
  17.172 +<p>
  17.173 +Les couleurs peuvent être définies avec leur nom ou leur numéro RGB, tel que&nbsp;:
  17.174 +<code>#3A4956</code>. Pour utiliser de belles couleurs en mode dégradé
  17.175 +(<em>gradient</em>), vous devez spécifier deux couleurs séparées par
  17.176 +deux points, exemple&nbsp;: <code>#6C0023:#3E1220</code>. Vous pouvez aussi changer
  17.177 +les polices et leurs tailles en utilisant la balise&nbsp;: <code>Font</code>. Il y
  17.178 +a encore quelques petites choses que vous pouvez modifier pour personnaliser
  17.179 +votre bureau, telles que le format de l'horloge ou le nom du bouton et son icône.
  17.180 +Avant de redémarrer JWM avec votre nouveau fichier de configuration, vous
  17.181 +pouvez vérifier sa syntaxe en utilisant la commande&nbsp;: <code>jwm -p</code>.
  17.182 +Pour aller plus loin, le manuel officiel décrit tous les tags, les options
  17.183 +possibles et les attributs valides. Vous pouvez le consulter en ligne sur le
  17.184 +site web de JWM. 
  17.185 +</p>
  17.186 +<a name="ontheweb"></a>
  17.187 +<h3><font color="#6c0023">JWM sur le web</font></h3>
  17.188 +<ul>
  17.189 +    <li><a href="http://www.joewing.net/programs/jwm/"
  17.190 +    >www.joewing.net/programs/jwm/</a> - Le site web officiel de Joe's 
  17.191 +    Window Manager, fournissant des news et le manuel complet.</li>
  17.192 +    <li><a href="http://joesnet.sytes.net/">joesnet.sytes.net</a> - Site web
  17.193 +    de JoesBox, proposant des thèmes et divers petits utilitaires à utiliser
  17.194 +    avec JWM.</li>
  17.195 +    <li>#jwm sur irc.freenode.net - Le canal de discussions IRC de JWM sur
  17.196 +    les serveurs de Freenode.</li>
  17.197 +</ul>
  17.198 +
  17.199 +<!-- End of content -->
  17.200 +</div>
  17.201 +
  17.202 +<!-- Footer. -->
  17.203 +<div id="footer">
  17.204 +	<div class="footer-right"></div>
  17.205 +	<a href="#top">Haut de la page</a> | 
  17.206 +	<a href="index.html">Table des matières</a>
  17.207 +</div>
  17.208 +
  17.209 +<div id="copy">
  17.210 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  17.211 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  17.212 +    Documentation publiées sous
  17.213 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  17.214 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  17.215 +</div>
  17.216 +
  17.217 +</body>
  17.218 +</html>

    18.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.2 +++ b/doc/handbook-stable/handbook/livecd.html	Fri Feb 06 23:17:00 2009 +0100
    18.3 @@ -0,0 +1,347 @@
    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 - LiveCD</title>
    18.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   18.10 +    <meta name="description" content="utiliser le livecd options login utilisateur session X" />
   18.11 +    <meta name="expires" content="never" />
   18.12 +    <meta name="modified" content="2007-12-04 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="install.html">Installation</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">Utiliser le LiveCD et ses options</font></h2>
   18.35 +
   18.36 +<ul>
   18.37 +    <li><a href="#quick-intro">Rapide introduction au LiveCD.</a></li>
   18.38 +    <li><a href="#boot">Démarrer sur le CD (<em>boot</em>).</a></li>
   18.39 +    <li><a href="#options">Options à passer au démarrage.</a></li>
   18.40 +    <li><a href="#kernel-param">Paramètres du noyau Linux</a> - Matériel
   18.41 +    et modes VGA.</li>
   18.42 +    <li><a href="#home">Option : home=usb</a> - Conserver ses donnés sur un
   18.43 +    media USB.</li>
   18.44 +    <li><a href="#i18n">Options : lang=XX et kmap=XX</a> - Spécifier la langue
   18.45 +    et le clavier.</li>
   18.46 +    <li><a href="#config">Option : config=&lt;device&gt;,&lt;path&gt;</a> -
   18.47 +    Lancer un script au démarrage du LiveCD.</li>
   18.48 +    <li><a href="#sound">Option : sound=*</a> - Supprimer le support du son ou
   18.49 +    saute la configuration automatique.</li>
   18.50 +    <li><a href="#modprobe">Option : modprobe=modules</a> - Charger des modules
   18.51 +    à la volée.</li>
   18.52 +    <li><a href="#sessions">Sessions</a> - Login, mots de passes et X.</li>
   18.53 +</ul>
   18.54 +
   18.55 +<a name="quick-intro"></a>
   18.56 +<h3><font color="#6c0023">Rapide introduction au LiveCD</font></h3>
   18.57 +<p>
   18.58 +Le LiveCD de SliTaz GNU/Linux est une distribution libre fonctionnant depuis
   18.59 +un cdrom. La distribution vous permet d'emporter avec vous un mini système
   18.60 +ultra rapide, léger et sans rien installer. L'utilisation du LiveCD de SliTaz
   18.61 +est absolument sans risques pour le système d'exploitation existant sur
   18.62 +l'ordinateur hôte et SliTaz ne touche pas aux disques durs. Le LiveCD est
   18.63 +disponible sous forme d'image au format ISO contenant le système 
   18.64 +d'exploitation complet et compressé. Cette image ISO peut être gravée sur
   18.65 +un cdrom (CD-RW ou un CD-R), ensuite, il suffit de redémarrer la machine
   18.66 +avec le cdrom dans le lecteur de CD ou DVD pour lancer SliTaz en mémoire vive
   18.67 +(RAM). Une fois en fonctionnement, SliTaz est autonome, vous pouvez retirer le
   18.68 +cdrom et utiliser le système pendant des mois sans redémarrer...
   18.69 +</p>
   18.70 +
   18.71 +<a name="boot"></a>
   18.72 +<h3><font color="#6c0023">Démarrer sur le CD (<em>boot</em>)</font></h3>
   18.73 +<p>
   18.74 +L'utilisation de SliTaz nécessite que votre machine démarre (<em>boot</em>)
   18.75 +depuis le périphérique de CD/DVD et non pas depuis le disque dur. Dans la
   18.76 +plupart des cas votre ordinateur est déjà configuré pour amorcer sur cdrom, si
   18.77 +ce n'est pas le cas, il faut modifier l'ordre de démarrage via l'interface de
   18.78 +configuration du BIOS accessible, en général, en pressant une touche
   18.79 +(<code>F10</code>, <code>F12</code>, <code>esc</code> ou autre) dans les
   18.80 +premières secondes qui suivent l'allumage de la machine. Quand vous êtes dans
   18.81 +le BIOS, il faut chercher les paramètres relatifs à la séquence de démarrage
   18.82 +tels que <em>Boot Order</em> ou <em>Boot Device</em> et changer l'ordre pour
   18.83 +que le cdrom arrive en premier. Pour finir, n'oubliez pas d'enregistrer les
   18.84 +modifications avant de quitter l'interface de configuration du BIOS.
   18.85 +</p>
   18.86 +<p>
   18.87 +Quand la machine a réussi à démarrer sur le cdrom, vous vous retrouvez avec
   18.88 +une image <em>splash</em> du logo de Slitaz et une invite de commande
   18.89 +permettant de passer différentes options au noyau Linux et aux scripts de
   18.90 +démarrage (<em>boot scripts</em>) utilisés par SliTaz. Il suffit alors de
   18.91 +taper sur la touche <code>ENTER</code> pour lancer le système avec ou sans
   18.92 +options, la touche <code>F1</code> affichera un texte d'aide et d'informations.
   18.93 +</p>
   18.94 +
   18.95 +<a name="options"></a>
   18.96 +<h3><font color="#6c0023">Options et paramètre à passer au démarrage</font></h3>
   18.97 +<p>
   18.98 +Le système LiveCD de SliTaz propose diverses options à passer au démarrage
   18.99 +(<em>boot</em>), via l'invite de commandes propulsé par Syslinux. Il y deux
  18.100 +types d'options : celles de SliTaz et celles du noyau Linux. Les options
  18.101 +propres à SliTaz sont utilisées par les scripts de démarrage et les paramètres
  18.102 +du noyau Linux (<em>kernel boot parameters</em>), tel que le mode VGA, sont
  18.103 +gérés directement par le noyau. Pour passer des options au démarrage vous devez
  18.104 +commencer par taper <code>slitaz</code> suivit des options, pour vous simplifier
  18.105 +la vie vous pouvez simplement taper par exemple <code>fr</code> et ENTER pour 
  18.106 +charger un fichier de clavier (en clavier qwerty <code>slitaz</code> 
  18.107 +correspond à : <code>slitqw</code>). Exemple :
  18.108 +</p>
  18.109 +<pre>
  18.110 + slitaz vga=791 no387
  18.111 +</pre>
  18.112 +<p>
  18.113 +A noter que le noyau Linux conserve les données passées au <em>boot</em> dans
  18.114 +le fichier texte <code>/proc/cmdline</code>. Sur un système GNU/Linux en
  18.115 +fonctionnement, ce fichier est facilement lisible depuis un terminal et via la
  18.116 +commande :
  18.117 +</p>
  18.118 +<pre>
  18.119 + $ cat /proc/cmdline 
  18.120 +</pre>
  18.121 +
  18.122 +<a name="kernel-param"></a>
  18.123 +<h3><font color="#6c0023">Paramètres du noyau Linux</font></h3>
  18.124 +<p>
  18.125 +Sur les systèmes GNU/Linux, les paramètres spécifiques au noyau Linux varient
  18.126 +en fonction de la configuration utilisée lors de la compilation de celui-ci.
  18.127 +Le noyau utilisé par SliTaz est construit avec un minimum de modules et
  18.128 +propose peu de paramètres modifiables au démarrage. Cela dit, vous avez
  18.129 +la possibilité de désactiver l'émulation d'un coprocesseur mathématique via
  18.130 +le code : <code>no387</code> et/ou d'activer <code>irqpoll</code> en cas de
  18.131 +problèmes d'interruption avec le matértiel (lecteur CD/DVD par exemple). Le
  18.132 +noyau Linux de SliTaz fournit aussi un mode de sortie video vga VESA pour le
  18.133 +<em>framebuffer</em>. C'est lui qui affiche le petit logo Tux et gère la
  18.134 +taille d'affichage du terminal Linux. A noter qu'une fois le système démarré,
  18.135 +vous avez accès à six pseudo terminaux Linux via les combinaisons de touches : 
  18.136 +<code>Ctrl+alt+F1</code>, <code>Ctrl+alt+F2</code>, etc.
  18.137 +</p>
  18.138 +
  18.139 +<h4>vga=XXX - Modes VGA du noyau</h4>
  18.140 +<pre class="script">
  18.141 +Colors | 640x480  800x600  1024x768  1280x1024  1600x1200
  18.142 +-------------------------------------------------------
  18.143 +256    |  769      771       773       775        796
  18.144 +32768  |  784      787       790       793        797
  18.145 +65536  |  785      788       791       794        798
  18.146 +16,8M  |  786      789       792       795        799
  18.147 +</pre>
  18.148 +
  18.149 +<a name="home"></a>
  18.150 +<h3><font color="#6c0023">Option : home=usb - Conserver ses donnés</font></h3>
  18.151 +<p>
  18.152 +L'option <code>home=usb</code> ou <code>home=*</code> active
  18.153 +le montage d'une partition d'un périphérique USB externe sur le répertoire
  18.154 +<code>/home</code> (maison) destiné aux utilisateurs du système.
  18.155 +L'utilisation d'une clé USB, d'un disque dur externe ou d'une carte SD, 
  18.156 +permet de conserver les informations utilisateur sur un support persistant.
  18.157 +Associer le LiveCD de Slitaz à un support de stockage a de gros avantages,
  18.158 +tels que de conserver la configuration de vos applications préférées, vos
  18.159 +marques pages, vos documents, vos images, etc. Cette technique vous permet
  18.160 +aussi de créer votre propre menu et votre propre thème pour le gestionnaire de
  18.161 +fenêtres JWM. Vous pouvez par exemple facilement utiliser une image en fond
  18.162 +d'écran et la retrouver à chaque fois que vous utiliser le cdrom de SliTaz.
  18.163 +Ces informations sont stockées dans des fichiers de configurations cachés
  18.164 +propre à chaque compte du système. La plupart des applications destinées aux
  18.165 +utilisateurs ont un fichier/répertoire de configuration système généralement
  18.166 +situé dans <code>/etc</code> et un fichier/répertoire caché (commençant par
  18.167 +un point) appartenant à l'utilisateur. Pour utiliser cette option il faut une
  18.168 +partition formatée en <code>ext3</code> et située sur un périphérique USB tel
  18.169 +qu'une clé USB <em>flash memory</em>, le format <code>ext3</code> est un
  18.170 +système de fichiers journalisé, supportant la gestion des permissions et
  18.171 +offrant donc bien plus de sécurité que le format <code>FAT32</code> ou
  18.172 +<code>NTFS</code> utilisé par Windows. A noter que la lecture ou l'écriture
  18.173 +sur un système de fichiers <code>ext3</code> n'est pas supportée nativement
  18.174 +par Windows mais que SliTaz peut lire et écrire sur un système de fichiers
  18.175 +<code>FAT32</code> grâce au support natif fourni par le noyau Linux.
  18.176 +</p>
  18.177 +<p>
  18.178 +Si vous avez déjà un media externe formaté en <code>ext3</code>, vide ou
  18.179 +contenant des données mais ayant assez d'espace libre, vous pouvez directement
  18.180 +l'utiliser. Aucune donnée existante ne sera détruite, il y aura juste un
  18.181 +répertoire <code>hacker/</code> créé automatiquement lors de la première
  18.182 +utilisation du LiveCD avec le périphérique et la partition en question.
  18.183 +</p>
  18.184 +<h4>Partitions et formatage d'un media</h4>
  18.185 +<p>
  18.186 +Dans la plupart des cas les clés USB et les cartes de type SD <em>card</em>
  18.187 +n'ont qu'une seule partition, généralement reconnue comme <code>sda1</code>
  18.188 +par le noyau Linux. Une fois formatée, vous pouvez utiliser cette première
  18.189 +partition en passant l'option <code>home=sda1</code> ou plus simplement 
  18.190 +<code>home=usb</code> à l'invite de commandes disponible au démarrage du
  18.191 +système. Si vous désirez utiliser une partition d'un disque dur externe, 
  18.192 +composé de multiples partitions, vous pouvez utiliser l'option 
  18.193 +<code>home=sda[1-9]</code> en spécifiant la bonne partition. A noter que vous
  18.194 +pouvez aussi partitionner une clé USB en différentes partitions et utiliser
  18.195 +une de ces partitions comme <em>home</em>. Pour savoir si votre media a bien
  18.196 +été reconnu et connaître l'emplacement depuis lequel il est accessible, vous
  18.197 +pouvez utiliser l'utilitaire <code>fdisk</code> avec l'option <code>-l</code>.
  18.198 +Pour utiliser cette commande vous devez avoir les droits d'administrateur
  18.199 +système (<em>root</em>), que vous pouvez obtenir via la commande
  18.200 +<code>su</code> suivi du mot de passe <em>root</em>. Exemple :
  18.201 +</p>
  18.202 +<pre>
  18.203 + $ su
  18.204 + # fdisk -l
  18.205 +</pre>
  18.206 +<p>
  18.207 +Le formatage en <code>ext3</code> va détruire toutes les données contenues sur
  18.208 +la partition en question, attention à ne pas vous tromper de disque ou de
  18.209 +partition. Une fois que le media sera formaté, il sera prêt à être utilisé
  18.210 +pour stocker vos données personnelles. Pour formater la première partition
  18.211 +d'un périphérique <code>sda</code>, vous pouvez utiliser la commande 
  18.212 +<code>mkfs.ext3</code> ou l'utilitaire Tazusb :
  18.213 +</p>
  18.214 +<pre>
  18.215 + # mkfs.ext3 /dev/sda1
  18.216 + ou:
  18.217 + # tazusb format /dev/sda1
  18.218 +</pre>
  18.219 +<h4>Utiliser un media</h4>
  18.220 +<p>
  18.221 +L'utilisation d'un périphérique externe commence lors du démarrage
  18.222 +(<em>boot</em>) du système LiveCD, il faut spécifier l'option 
  18.223 +<code>home=usb</code> ou <code>home=*</code> précédée par
  18.224 +<code>slitaz</code>. La partition peut aussi être spécifiée en utilisant
  18.225 +l'UUID ou le label de la partition. Exemple :
  18.226 +</p>
  18.227 +<pre>
  18.228 + slitaz home=usb
  18.229 + slitaz home=sdb1
  18.230 + slitaz home=UUID/LABEL
  18.231 +</pre>
  18.232 +<p>
  18.233 +Lors de l'exécution des scripts de démarrage, SliTaz lit le fichier 
  18.234 +<code>/proc/cmdline</code> pour savoir si une partition doit être montée sur
  18.235 +<code>/home</code>. Si l'option existe, le script va commencer par attendre
  18.236 +environ 10 secondes que le media soit bien détecté par le noyau Linux et
  18.237 +tenter de monter la partition. Lors de la première utilisation le contenu
  18.238 +original du répertoire <code>/home/hacker</code> est copié sur la nouvelle
  18.239 +partition préalablement montée. Vous aurez alors un système fonctionnant en
  18.240 +mémoire vive et des données personnelles sur votre media de type USB.
  18.241 +</p>
  18.242 +
  18.243 +<a name="i18n"></a>
  18.244 +<h3><font color="#6c0023">Options : lang=XX et kmap=XX - Langue et clavier</font></h3>
  18.245 +<p>
  18.246 +Le LiveCD de Slitaz vous propose de configurer la langue et le clavier
  18.247 +directement au <em>boot</em> ou graphiquement pendant l'initialisation du
  18.248 +système. Cela veut dire que si vous ne spécifiez pas la langue ou le clavier
  18.249 +via l'invite de commandes, le système lancera automatiquement une interface
  18.250 +de configuration lors de l'exécution des scripts de démarrage. SliTaz est
  18.251 +en français <code>fr</code> et en anglais <code>en</code>, les claviers
  18.252 +<code>be ca de en es fr_CH fr it jp us </code>. Exemple d'utilisation de
  18.253 +ces options :
  18.254 +</p>
  18.255 +<pre>
  18.256 + slitaz lang=fr kmap=be
  18.257 +</pre>
  18.258 +
  18.259 +<a name="config"></a>
  18.260 +<h3><font color="#6c0023">Option : config=&lt;device&gt;,&lt;path&gt;</font></h3>
  18.261 +<p>
  18.262 +L'option <code>config=</code> vous permet de lancer un script au démarrage
  18.263 +du LiveCD, ce script peur être situé sur une partition d'un disque dur local
  18.264 +ou sur un media de type USB. Cette option permet par exemple, de monter une
  18.265 +image ISO sur <code>/usr</code> afin de pouvoir éconnomiser le la mémoire
  18.266 +vive et utilisé SliTaz sur de machines ayant 32 Mb RAM. Exemple avec un script
  18.267 +nommé <code>slitaz.sh</code> et sutué sur la première partition du premier
  18.268 +disque dur local :
  18.269 +</p>
  18.270 +<pre>
  18.271 + slitaz config=/dev/hda1,slitaz.sh
  18.272 +</pre>
  18.273 +
  18.274 +<a name="sound"></a>
  18.275 +<h3><font color="#6c0023">Option : sound=*</font></h3>
  18.276 +<p>
  18.277 +L'option <code>sound=no</code> ou <code>sound=noconf</code> vous permettent
  18.278 +respéctivement, de supprimer tous les modules et applications en rapport au
  18.279 +support du son pour gagner de la mémoire vive (RAM), ou de sauter la
  18.280 +configuration automatique au démarrage si vous ne désirez pas configurer le son
  18.281 +mais quand même conserver le nécessaire pour un configuration manuel par
  18.282 +la suite.
  18.283 +</p>
  18.284 +<pre>
  18.285 + slitaz sound=no
  18.286 +</pre>
  18.287 +
  18.288 +<a name="modprobe"></a>
  18.289 +<h3><font color="#6c0023">Option : modprobe=modules</font></h3>
  18.290 +<p>
  18.291 +L'option <code>mdprobe=modules</code> vous permettent de charger des modules
  18.292 +du noyau à la volée lors du démarrage du système. Cette options est utile par
  18.293 +exemple si un driver compilé en modules est nécessaire à la configuration de
  18.294 +la carte réseau ou son. A noter que sur un système en fonction, vous pouvez
  18.295 +lister les modules disponibles via la commande : <code>modprobe -l</code> et
  18.296 +que la commande <code>lspci</code> peut vous aider à connaître votre matériel
  18.297 +et le nom du bon driver. Pour charger un ou des modules :
  18.298 +</p>
  18.299 +<pre>
  18.300 + slitaz modprobe=modules1,modules2
  18.301 +</pre>
  18.302 +
  18.303 +<a name="sessions"></a>
  18.304 +<h3><font color="#6c0023">Sessions - Login, mots de passes et X</font></h3>
  18.305 +<p>
  18.306 +Quand le système a finit son initialisation, l'écran est nettoyé et l'invite
  18.307 +de <em>login</em> ou le gestionnaire de connexion Slim s'affiche. Sur un 
  18.308 +système GNU/Linux il y a un administrateur système nommé <em>root</em>, il 
  18.309 +a tous les droits et ne devrait pas être utilisé pour se loguer directement.
  18.310 +SliTaz a donc un compte <em>root</em> et propose un utilisateur <em>hacker</em>
  18.311 +sans mot de passe. Pour devenir <em>root</em> au sein d'une session utilisateur,
  18.312 +vous pouvez utiliser la commande <code>su</code> suivie du mot de passe root.
  18.313 +En mode LiveCD, le mot de passe <em>root</em> est <code>root</code>. 
  18.314 +</p>
  18.315 +<p>
  18.316 +Une fois logué dans une session, vous pouvez utiliser les nombreuses commandes
  18.317 +disponibles, les outils en mode texte tels que l'éditeur GNU Nano ou le
  18.318 +gestionnaire de fichiers Clex. Vous pouvez aussi lancer une session graphique
  18.319 +(X) via la commande <code>startx</code> ou encore vous connecter à une machine
  18.320 +distante via une session SSH ou X. La commande <code>startx</code> va lancer
  18.321 +le serveur graphique (Xvesa) et démarrer le gestionnaire de fenêtres JWM, vous
  18.322 +aurez alors la possibilité d'utiliser des applications graphiques via le menu
  18.323 +fourni par SliTaz et propulsé par JWM (Joe Window Manager). Pour lancer une 
  18.324 +session X depuis une console Linux, dans le cas par exemple ou vous avez utilisé
  18.325 +l'option <code>screen=text</code> et que Slim n'est pas lançé :
  18.326 +</p>
  18.327 +<pre>
  18.328 + $ startx
  18.329 +</pre>
  18.330 +
  18.331 +<!-- End of content -->
  18.332 +</div>
  18.333 +
  18.334 +<!-- Footer. -->
  18.335 +<div id="footer">
  18.336 +	<div class="footer-right"></div>
  18.337 +	<a href="#top">Haut de la page</a> | 
  18.338 +	<a href="index.html">Table des matières</a>
  18.339 +</div>
  18.340 +
  18.341 +<div id="copy">
  18.342 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  18.343 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  18.344 +    Documentation publiées sous
  18.345 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  18.346 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  18.347 +</div>
  18.348 +
  18.349 +</body>
  18.350 +</html>

    19.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    19.2 +++ b/doc/handbook-stable/handbook/liveusb.html	Fri Feb 06 23:17:00 2009 +0100
    19.3 @@ -0,0 +1,492 @@
    19.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    19.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    19.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    19.7 +<head>
    19.8 +    <title>SliTaz Handbook - LiveUSB</title>
    19.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   19.10 +    <meta name="description" content="" />
   19.11 +    <meta name="expires" content="never" />
   19.12 +    <meta name="modified" content="2007-12-04 12:30:00" />
   19.13 +    <meta name="publisher" content="www.slitaz.org" />
   19.14 +    <meta name="author" content="Christophe Lincoln"/>
   19.15 +    <link rel="shortcut icon" href="favicon.ico" />
   19.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
   19.17 +</head>
   19.18 +<body bgcolor="#ffffff">
   19.19 +
   19.20 +<!-- Header and quick navigation -->
   19.21 +<div id="header">
   19.22 +<div align="right" id="quicknav">
   19.23 +    <a name="top"></a>
   19.24 +    <a href="index.html">Table des matières</a>
   19.25 +</div>
   19.26 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   19.27 +</div>
   19.28 +
   19.29 +<!-- Content. -->
   19.30 +<div id="content">
   19.31 +<div class="content-right"></div>
   19.32 +
   19.33 +<h2><font color="#DF8F06">LiveUSB - SliTaz sur un media USB</font></h2>
   19.34 +
   19.35 +<ul>
   19.36 +	<li><a href="#method">Methodes, type de media et notes</a> - Introduction,
   19.37 +	système de fichiers, résumé des étapes.</li>
   19.38 +	<li><a href="#tazusb">LiveUSB en 2 commandes</a> - Utiliser TazUSB pour
   19.39 +	créer un LiveUSB facilement.</li>
   19.40 +	<li><a href="#prepa">Préparer le media USB</a> - Formater si besoin est,
   19.41 +	copier les fichiers du LiveCD.</li>
   19.42 +	<li><a href="#grub">Installer et utiliser GRUB</a> - Installer le
   19.43 +	gestionnaire de démarrage GRUB sur le media USB.</li>
   19.44 +	<li><a href="#grubiso">GRUB sur cdrom</a> - Utiliser le media via un cdrom
   19.45 +	bootable contenant GRUB.</li>
   19.46 +	<li><a href="#extlinux">Installer et utiliser EXTLINUX</a> - Installer le
   19.47 +	gestionnaire de démarrage EXTLINUX sur le media USB.</li>
   19.48 +	<li><a href="#windows">Installer SliTaz sur USB depuis Windows</a> - Installer
   19.49 +	SliTaz sur un media USB en utilisanr Syslinux depuis Windows.</li>
   19.50 +</ul>
   19.51 +
   19.52 +<a name="method"></a>
   19.53 +<h3><font color="#6c0023">Methodes, type de media et notes</font></h3>
   19.54 +<p>
   19.55 +Ce document décrit les étapes à réaliser pour installer les fichiers nécessaires
   19.56 +afin de démarrer SliTaz depuis un périphérique de type USB (clé, carte SD,
   19.57 +disque dur externe). Ce n'est pas une installation du système à proprement
   19.58 +parler, le mode de fonctionnemnt de SliTaz reste le même qu'en mode LiveCD,
   19.59 +c'est à dire que le système sera entièrement chargé en mémoire vive (RAM)
   19.60 +lors du démarrage. Avoir SliTaz sur un media USB vous permet de vous passer
   19.61 +du cdrom sur les machines capables de démarrer depuis un périphérique USB et
   19.62 +l'utiliser le même media pour stocker vos données personnelles de manière
   19.63 +persistante. Il faut aussi savoir que tous les PC ne sont pas capables de 
   19.64 +démarrer directement sur USB et que le démarrage du système est plus long
   19.65 +que depuis un cdrom.
   19.66 +</p>
   19.67 +<h4>Disque dur externe, carte SD ou clé USB</h4>
   19.68 +<p>
   19.69 +Un media de stockage USB peut être un disque dur externe de grande ou petite
   19.70 +capacité, une carte de type SD/flash ou une clé USB. Vous pouvez par exemple,
   19.71 +utiliser l'ancienne carte d'un appareil de photos numérique ayant au 
   19.72 +minimum une capacité de 32 Mb. Cela dit, l'utilisation de 
   19.73 +<a href="#grub">GRUB</a> avec les clés USB ne réussi pas toujours et dépend
   19.74 +du type de clé. Si l'utilisation de GRUB échoue, il est conseillé d'utiliser
   19.75 +le gestionaire de démarrage <a href="#extlinux">EXTLINUX</a> et d'installer
   19.76 +un MBR fonctionnel sur la clé USB.
   19.77 +</p>
   19.78 +<p>
   19.79 +Pour commencer nous vous conseillons d'utiliser une partition formatée en ext3
   19.80 +et non au format natif FAT32. Le système de fichiers ext3 est un système de
   19.81 +fichiers propre à GNU/Linux, robuste, fiable et illisible nativement depuis
   19.82 +Windows, ce qui peut être un point positif ou négatif. A noter que vous pourrez
   19.83 +aussi utiliser cette même partition pour stocker vos données de manière
   19.84 +persistante via l'option <code>home=usb</code> proposée par SliTaz. Cela dit,
   19.85 +vous pouvez aussi installer SliTaz sur une clé USB au format FAT32 comme
   19.86 +suggéré sur le forum de SliTaz : 
   19.87 +<a href="http://forum.slitaz.org/viewtopic.php?pid=28#p28">SliTaz sur clé USB FAT32</a>.
   19.88 +</p>
   19.89 +<h4>&Eacute;tapes à réaliser</h4>
   19.90 +<p>
   19.91 +En gros, il faut récupérer les fichiers contenus sur le LiveCD, les
   19.92 +copier sur le media USB et installer un gestionnaire de démarrage. A noter
   19.93 +qu'il existe plusieurs gestionnaires de démarrage, Syslinux, GRUB ou encore
   19.94 +Lilo. SliTaz fournit GRUB sur la version standard du LiveCD et dans les paquets
   19.95 +du miroir, il a l'avantage de pouvoir aussi être utilisé pour démarrer
   19.96 +d'autres systèmes d'expoitations et de proposer un SHell permettant par exemple
   19.97 +de réinstaller GRUB dans le MBR (Master Boot Record) d'un disque dur.
   19.98 +</p>
   19.99 +
  19.100 +<a name="tazusb"></a>
  19.101 +<h3><font color="#6c0023">LiveUSB en 2 commandes</font></h3>
  19.102 +<p>
  19.103 +Pour créer facilement un système Live tenant sur un media USB, vous pouvez
  19.104 +utiliser TazUSB ou installer les fichiers manuellement. TazUSB est un 
  19.105 +utilitaire simple, efficace et bien testé. Vous pouvez créer un media en une ou
  19.106 +deux commandes. Pour cela il vous faut un LiveCD de SliTaz et biensûr un media
  19.107 +USB dont vous devez connaître le nom (<code>fdisk -l</code> ou <code>blkid</code>).
  19.108 +Formatage optionnel et génération d'un media bootable reconnu comme /dev/sdb1:
  19.109 +</p>
  19.110 +<pre>
  19.111 + # tazusb format /dev/sdb1
  19.112 + # tazusb gen-liveusb /dev/sdb1
  19.113 +</pre>
  19.114 +<p>
  19.115 +Une fois le media généré, vous pouvez redémarrer sur votre media USB. Si vous 
  19.116 +désirez installer des applications, mettre à jour ou configurer le système et
  19.117 +retouver vos modifications lors de a prochaine utilisation, il vous faut
  19.118 +recréer le système compressé en utilisant la commande <code>writefs</code> de
  19.119 +TazUSB. A noter que le menu de JWM propose par défaut des entrées pour écrire
  19.120 +le système sur le media en utilisant gzip, lzma ou aucune compression (prend 
  19.121 +plus de place mais démarre beaucoup plus rapidement).
  19.122 +</p>
  19.123 +
  19.124 +<a name="prepa"></a>
  19.125 +<h3><font color="#6c0023">Préparer le media USB</font></h3>
  19.126 +<p>
  19.127 +Si vous avez déjà une partition au format ext3, vous n'avez pas besoin de
  19.128 +reformater, sinon il faut créer un système de fichier avec l'utilitaire
  19.129 +<code>mkfs.ext3</code>. Attention le formatage d'une partition détruit toutes
  19.130 +les données qui s'y trouvent. Généralement, la première ou unique partition 
  19.131 +d'un media USB est reconnu par le noyau Linux comme <code>/dev/sda</code>, pour
  19.132 +lister les périphériques et partitions disponibles vous pouvez utiliser la
  19.133 +commande <code>fdisk -l</code> avant de créer le système de fichiers ext3 :
  19.134 +</p>
  19.135 +<pre>
  19.136 + # mkfs.ext3 /dev/sda1
  19.137 + # mount -t ext3 /dev/sda1 /media/flash
  19.138 +</pre>
  19.139 +<p>
  19.140 +Le formatage de la partition va créer un répertoire système nommé
  19.141 +<code>lost+found</code> (perdu et trouvé), ce répertoire est utiliser par le
  19.142 +système de fichier en cas de problèmes. Maintenant que le media est formaté 
  19.143 +et monté, vous pouvez copier le contenu du cdrom sur le périphérique, soit
  19.144 +depuis un cdrom gravé, soit depuis une image ISO locale :
  19.145 +</p>
  19.146 +<pre>
  19.147 + # mount -t iso9660 /dev/cdrom /media/cdrom
  19.148 + Ou :
  19.149 + # mount -o loop slitaz-cooking.iso /media/cdrom
  19.150 +</pre>
  19.151 +<p>
  19.152 +Copie de tous les fichiers contenu dans le répertoire <code>boot/</code>
  19.153 +du LiveCD, il se peut que le système de fichiers compressé soit nommé 
  19.154 +<code>rootfs.lz</code>, si c'est le cas, il faut le renommer en 
  19.155 +<code>rootfs.gz</code> :
  19.156 +</p>
  19.157 +<pre>
  19.158 + # cp -a /media/cdrom/boot /media/flash
  19.159 + # mv /media/flash/boot/rootfs.lz /media/flash/boot/rootfs.gz
  19.160 +</pre>
  19.161 +
  19.162 +<a name="grub"></a>
  19.163 +<h3><font color="#6c0023">Installer et utiliser GRUB</font></h3>
  19.164 +<p>
  19.165 +Pour installer GRUB (GRand Unified Bootloader) il faut commencer par copier 
  19.166 +les fichiers <code>stage1</code> et <code>stage2</code> depuis 
  19.167 +<code>/usr/lib/grub/i386-pc</code> dans le répertoire <code>boot/grub</code> 
  19.168 +du media USB. Une fois les fichiers copiés et le media trouvé par GRUB, vous
  19.169 +allez pouvoir installer le gestionnaire de démarrage dans le MBR du
  19.170 +périphérique. Copie des fichiers, lancement du SHell GRUB et recherche de
  19.171 +<code>stage1</code> fraîchement copié :
  19.172 +</p>
  19.173 +<pre>
  19.174 + # cp /usr/lib/grub/i386-pc/stage[1-2] /media/flash/boot/grub
  19.175 + # grub
  19.176 + grub> find /boot/grub/stage1
  19.177 +</pre>
  19.178 +<p>
  19.179 +Ce qui peut donner (hd0,0), (hd1,0) ou encore (hd2,0), GRUB voit le premier
  19.180 +disque <code>hda</code> comme <code>hd0</code>, il faut donc modifier les 
  19.181 +valeures en fonction de votre configuration. Il se peut aussi que votre media 
  19.182 +ne soit pas trouvé, dans ce cas vous pouvez utiliser le <em>bootloader</em>
  19.183 +<a href="#extlinux">EXTLINUX</a>. Pour installer GRUB vous pouvez
  19.184 +utiliser les commandes <code>root</code> et <code>setup</code>. Pour quitter 
  19.185 +le SHell GRUB c'est la commande <code>quit</code> :
  19.186 +</p>
  19.187 +<pre>
  19.188 + grub> root (hd2,0)
  19.189 + grub> setup (hd2)
  19.190 + grub> quit
  19.191 +</pre>
  19.192 +<p>
  19.193 +La dernière chose qu'il reste à faire avant de redémarrer, est de créer un
  19.194 +fichier de configuration de GRUB permettant de lancer SliTaz avec l'option
  19.195 +<code>home=usb</code>, ce qui permet d'utiliser aussi le media comme partition
  19.196 +<code>/home</code> pour stocker ses données, installer des applications en 
  19.197 +espace utilisateur et conserver vos configurations logiciels. Le fichiers
  19.198 +de configuration utilisé par GRUB peut être créé avec votre éditeur de texte
  19.199 +préféré, exemple avec LeafPad :
  19.200 +</p>
  19.201 +<pre>
  19.202 + # leafpad /media/flash/boot/grub/menu.lst
  19.203 +</pre>
  19.204 +<pre class="script">
  19.205 +# /boot/grub/menu.lst: GRUB boot loader configuration.
  19.206 +#
  19.207 +
  19.208 +# Change the colors.
  19.209 +color yellow/brown light-green/black
  19.210 +
  19.211 +# For booting SliTaz from a cdrom or USB media (LiveRAM).
  19.212 +#
  19.213 +title 	SliTaz GNU/Linux (Cooking) (Kernel 2.6.22.9)
  19.214 +kernel 	/boot/bzImage root=/dev/null vga=771 home=usb
  19.215 +initrd 	/boot/rootfs.gz
  19.216 +</pre>
  19.217 +<p>
  19.218 +Vous pouvez encore ajouter ces quelques lignes, pour avoir une entrée
  19.219 +permettant de réinstaller GRUB dans un MBR (utile en cas problèmes) :
  19.220 +</p>
  19.221 +<pre class="script">
  19.222 +# For installing GRUB into the hard disk
  19.223 +#
  19.224 +title Install GRUB into the hard disk
  19.225 +root 	(hd0,0)
  19.226 +setup 	(hd0)
  19.227 +</pre>
  19.228 +<p>
  19.229 +Voilà, vous pouvez démonter le cdrom et le media. ET redémarrer sur votre
  19.230 +clé USB en prenant soins de configurer correctement le BIOS de votre machine
  19.231 +pour qu'elle démarre depuis le media USB et non depuis le disque dur :
  19.232 +</p>
  19.233 +<pre>
  19.234 + # umount /media/cdrom
  19.235 + # umount /media/flash
  19.236 + # reboot
  19.237 +</pre>
  19.238 +
  19.239 +<a name="grubiso"></a>
  19.240 +<h3><font color="#6c0023">GRUB sur cdrom</font></h3>
  19.241 +<p>
  19.242 +Il est possible de créer rapidement une image ISO contenant GRUB, servant à 
  19.243 +démarrer SliTaz depuis un media USB et cela sur des machines ne pouvant pas
  19.244 +démarrer directement sur USB. Pour ce faire GRUB fourni une image nommée
  19.245 +<code>stage2_eltorito</code> permettant de rendre un cdrom bootable. Pour créer
  19.246 +une image ISO gravable il faut créer la racine du cdrom, copier le fichier
  19.247 +<code>stage2_eltorito</code> et générer une ISO avec <code>genisoimage</code>.
  19.248 +Les commandes peuvent être copiées/collées ligne par ligne. Pour créer la
  19.249 +racine du cdrom (<code>rootcd</code> et copier l'image eltorito de GRUB :
  19.250 +</p>
  19.251 +<pre>
  19.252 + $ mkdir -p rootcd/boot/grub
  19.253 + $ cp /usr/lib/grub/i386-pc/stage2_eltorito \
  19.254 +   rootcd/boot/grub
  19.255 +</pre>
  19.256 +<p>
  19.257 +Le fichier de configuration de grub se nomme toujours <code>menu.lst</code>,
  19.258 +c'est un fichier texte éditable avec votre éditeur de texte préféré. Vous
  19.259 +pouvez mettre le nombre d'entrées que vous désirez, pour démarrer SliTaz il
  19.260 +faut spécifier la bonne racine <code>root (hd2,0)</code> pour que GRUB trouve
  19.261 +le noyau (<code>bzImage</code>) et le système compressé (<code>roottf.gz</code>).
  19.262 +Un petit fichier de configuration minimaliste :
  19.263 +</p>
  19.264 +<pre class="script">
  19.265 +# /boot/grub/menu.lst: GRUB boot loader configuration.
  19.266 +#
  19.267 +
  19.268 +title 	SliTaz GNU/Linux (Cooking)
  19.269 +root 	(hd2,0)
  19.270 +kernel 	/boot/bzImage root=/dev/null home=usb
  19.271 +initrd 	/boot/rootfs.gz
  19.272 +</pre>
  19.273 +<h4>Générer un ISO bootable</h4>
  19.274 +<p>
  19.275 +Pour générer une image ISO vous pouvez utiliser <code>genisoimage</code>
  19.276 +fourni en standard sur le LiveCD de SliTaz. Cette commande est relativement 
  19.277 +longue, les <em>backslash</em> en fin de ligne permettent de continuer la 
  19.278 +commande sur la ligne suivante. Dans l'exemple, l'image se nomme
  19.279 +<code>grub.iso</code>, le volume Grub et la racine du cdrom 
  19.280 +<code>rootcd</code> :
  19.281 +</p>
  19.282 +<pre>
  19.283 + $ genisoimage -R -o grub.iso \
  19.284 +       -b boot/grub/stage2_eltorito \
  19.285 +       -no-emul-boot -V "Grub" -boot-load-size 4 \
  19.286 +       -input-charset iso8859-1 -boot-info-table \
  19.287 +       rootcd
  19.288 +</pre>
  19.289 +
  19.290 +<a name="extlinux"></a>
  19.291 +<h3><font color="#6c0023">Installer et utiliser EXTLINUX</font></h3>
  19.292 +<p>
  19.293 +Extlinux est un gestionnaire de démarrage provenant du paquet Syslinux, il 
  19.294 +permet de démarrer un système GNU/Linux depuis un système de fichiers ext2 ou 
  19.295 +ext3. C'est un gestionnaire de démarrage simple et fiable, il fonctionne bien
  19.296 +pour les clés USB. Pour commencer il faut récupérer la dernière version
  19.297 +du paquet Syslinux depuis le site du noyau Linux et installer le binaire 
  19.298 +<code>extlinux</code> dans votre répertoire personnel <code>~/Bin</code> ou
  19.299 +dans un répertoire système tel que <code>/usr/bin</code>. Pour télécharger,
  19.300 +désarchiver et installer EXTLINUX en espace utilisateur :
  19.301 +</p>
  19.302 +<pre>
  19.303 + $ wget http://www.kernel.org/pub/linux/utils/boot/syslinux/syslinux-3.61.tar.gz
  19.304 + $ tar xzf syslinux-3.61.tar.gz
  19.305 + $ cp syslinux-3.61/extlinux/extlinux ~/.local/bin
  19.306 +</pre>
  19.307 +<p>
  19.308 +Maintenant que le binaire <code>extlinux</code> est disponible, vous pouvez
  19.309 +l'installer dans sur un media monté et cela via un SHell administrateur 
  19.310 +<em>root</em> obtenu via la commande <code>su</code>. Nous vous conseillons
  19.311 +d'installer EXTLINUX dans un répertoire dédié, c'est à dire 
  19.312 +<code>/boot/extlinux</code> du media USB :
  19.313 +</p>
  19.314 +<pre>
  19.315 + # mkdir -p /media/flash/boot/extlinux
  19.316 + # extlinux --install /media/flash/boot/extlinux
  19.317 +</pre>
  19.318 +<p>
  19.319 +Sur les clé USB il faut encore installer un MBR pour s'assurer de rendre le 
  19.320 +media bootable. Attention à spécifier le bon périphérique, dans la plus part 
  19.321 +des cas une clé USB est reconnue comme sda :
  19.322 +</p>
  19.323 +<pre>
  19.324 + # cat syslinux-3.61/mbr/mbr.bin > /dev/sda
  19.325 +</pre>
  19.326 +<p>
  19.327 +Le fichier de configuration se nomme <code>extlinux.conf</code> et doit se
  19.328 +trouver dans le même répertoire que le binaire <code>extlinux</code>. Les 
  19.329 +chemins vers les fichiers peuvent être absolus ou relatifs au répertoire 
  19.330 +d'installation d'extlinux. Ce fichier à la même syntaxe que le fichier
  19.331 +<code>isolinux.cfg</code> utilisé pour démarrer le LiveCD de SliTaz. Vous
  19.332 +utilisant votre éditeur de texte préféré ou la commande <code>cat</code> 
  19.333 +(<code>EOT</code> signifie <em>End Of Text</em>, c'est là que le fichier
  19.334 +se termine). A noter que vous pouvez copier/coller le contenu du fichier en
  19.335 +une seule fois :
  19.336 +</p>
  19.337 +<pre>
  19.338 + # cat &gt; /media/flash/boot/extlinux/extlinux.conf &lt;&lt; "EOT"
  19.339 +</pre>
  19.340 +<pre class="script">
  19.341 +display display.txt
  19.342 +default slitaz
  19.343 +label slitaz
  19.344 +    kernel /boot/bzImage
  19.345 +    append initrd=/boot/rootfs.gz rw root=/dev/null home=usb
  19.346 +</pre>
  19.347 +<pre>
  19.348 + EOT
  19.349 +</pre>
  19.350 +<h4>Afficher un message boot</h4>
  19.351 +<p>
  19.352 +La première ligne <code>display display.txt</code> permet d'afficher un fichier
  19.353 +text au démarrage de EXTLINUX, vous pouvez utiliser/modifier celui utiliser sur
  19.354 +le LiveCD ou en créer un nouveau. Si vous ne voulez pas afficher un 
  19.355 +<em>display</em>, il suffit de supprimer la ligne. Pour créer un nouveau
  19.356 +fichier <code>display.txt</code> avec <code>cat </code>:
  19.357 +</p>
  19.358 +<pre>
  19.359 + # cat &gt; /media/flash/boot/extlinux/display.txt &lt;&lt; "EOT"
  19.360 +</pre>
  19.361 +<pre class="script">
  19.362 +/*       _\|/_
  19.363 +         (o o)
  19.364 + +----oOO-{_}-OOo---------------------------------------------------+
  19.365 +     ____  _ _ _____
  19.366 +    / ___|| (_)_   _|_ _ ____
  19.367 +    \___ \| | | | |/ _` |_  /
  19.368 +     ___) | | | | | (_| |/ /
  19.369 +    |____/|_|_| |_|\__,_/___|
  19.370 +
  19.371 + SliTaz GNU/Linux LiveUSB
  19.372 +
  19.373 + Simple Light Incredible Temporary Autonomus Zone
  19.374 +
  19.375 +                                                                   */
  19.376 +</pre>
  19.377 +<pre>
  19.378 + EOT
  19.379 +</pre>
  19.380 +<p>
  19.381 +Reste plus qu'a redémarrer sur votre clé USB en prenant soins de configurer 
  19.382 +correctement le BIOS de votre machine pour qu'elle démarre depuis le media USB
  19.383 +et non depuis le disque dur :
  19.384 +</p>
  19.385 +<pre>
  19.386 + # umount /media/flash
  19.387 + # reboot
  19.388 +</pre>
  19.389 +
  19.390 +<a name="windows"></a>
  19.391 +<h3><font color="#6c0023">Installer SliTaz sur USB depuis Windows</font></h3>
  19.392 +<p>
  19.393 +Il est possible d'installer SliTaz sur un media USB depuis un système 
  19.394 +Windows, cette procédure a été testé sur Windows XP et Vista. Avant de 
  19.395 +commercer, téléchargez la dernière version de SliTaz sur le site : 
  19.396 +<a href="http://www.slitaz.org/get/">Obtenir SliTaz</a>. Il vous faut aussi 
  19.397 +récupérer l'utilitaire syslnux <a 
  19.398 +	href="http://www.eu.kernel.org/pub/linux/boot/syslinux/syslinux-3.60.zip"
  19.399 +	>syslinux-3.60.zip</a>.
  19.400 +</p>
  19.401 +<p>
  19.402 +1. Extraire l'image sur la clé USB. L'image ISO peut être extraite avec des 
  19.403 +outils comme <a href="http://www.7-zip.org">7-Zip</a> ou Winimage (shareware)
  19.404 +par exemple. Normallement vous devriez obtenir l'arborescence suivante :
  19.405 +</p>
  19.406 +<pre class="script">
  19.407 +\boot
  19.408 +\boot\isolinux
  19.409 +\boot\grub
  19.410 +\boot\syslinux
  19.411 +</pre>
  19.412 +<p>
  19.413 +2. Sur la clé USB, copier les fichiers du gestionnaire de démarrage dans le 
  19.414 +répertoire <code>\boot\syslinux</code> :
  19.415 +</p>
  19.416 +<pre class="script">
  19.417 +\boot\isolinux\*.txt 
  19.418 +\boot\isolinux\*.msg
  19.419 +\boot\isolinux\*.cfg
  19.420 +\boot\isolinux\*.lss
  19.421 +</pre>
  19.422 +<p>
  19.423 +3. Toujours dans le répertoire <code>\boot\syslinux</code>, renommer 
  19.424 +<code>isolinux.cfg</code> en <code>syslinux.cfg</code> et 
  19.425 +<code>isolinux.msg</code> en <code>syslinux.msg</code>. Ce n'est pas 
  19.426 +indipensable pour isolinux.msg, mais c'est plus cohérent.
  19.427 +</p>
  19.428 +<p>
  19.429 +4. Extraire le fichier syslinux.exe de l'archive téléchargée sur kernel.org et 
  19.430 +le copier dans <code>\boot\syslinux</code> sur la clé.
  19.431 +</p>
  19.432 +<p>
  19.433 +5. Modifiez le fichier <code>syslinux.cfg</code> pour qu'il corresponde à vos 
  19.434 +besoin. Exemple:
  19.435 +</p>
  19.436 +<pre class="script">
  19.437 +display syslinux.msg
  19.438 +default slitaz
  19.439 +label slitaz
  19.440 +	kernel /boot/bzImage
  19.441 +	append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=fr vga=normal
  19.442 +implicit 0	
  19.443 +prompt 1	
  19.444 +timeout 80
  19.445 +F1 help.txt
  19.446 +F2 options.txt
  19.447 +F3 isolinux.msg
  19.448 +F4 display.txt
  19.449 +</pre>
  19.450 +<p>
  19.451 +<strong>Note :</strong> Par rapport au fichier d'origine la ligne 
  19.452 +<code>display isolinux.msg</code> a été remplaçée par 
  19.453 +<code>display syslinux.cfg</code>. Et les paramètres 
  19.454 +<code>lang=fr kmap=fr</code> on été rajouté sur la ligne <code>append</code>.
  19.455 +</p>
  19.456 +<p>
  19.457 +6. Il ne reste plus qu'à exécuter <code>syslinux.exe</code> pour installer le 
  19.458 +<em>bootloader</em>. Exemple dans le cas où la clé est désignée par la lettre
  19.459 +K :
  19.460 +</p>
  19.461 +<pre>
  19.462 +K:
  19.463 +cd \boot\syslinux
  19.464 +syslinux -ma -d \boot\syslinux K:
  19.465 +</pre>
  19.466 +
  19.467 +<h4>Version rapide</h4>
  19.468 +<ol>
  19.469 +	<li>Télécharchez l'achive <a 
  19.470 +	href="http://files.openomy.com/public/Erjo/syslinux.zip">syslnux.zip</a>.</li>
  19.471 +	<li>Extrayez le répertoire syslinux et copiez le dans le répertoire 
  19.472 +	boot de la clé USB.</li>
  19.473 +	<li>Exécutez le script <code>\boot\syslinux\bootusb.bat</code>.</li>
  19.474 +</ol>
  19.475 +
  19.476 +<!-- End of content -->
  19.477 +</div>
  19.478 +
  19.479 +<!-- Footer. -->
  19.480 +<div id="footer">
  19.481 +	<div class="footer-right"></div>
  19.482 +	<a href="#top">Haut de la page</a> | 
  19.483 +	<a href="index.html">Table des matières</a>
  19.484 +</div>
  19.485 +
  19.486 +<div id="copy">
  19.487 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  19.488 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  19.489 +    Documentation publiées sous
  19.490 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  19.491 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  19.492 +</div>
  19.493 +
  19.494 +</body>
  19.495 +</html>

    20.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    20.2 +++ b/doc/handbook-stable/handbook/multimedia.html	Fri Feb 06 23:17:00 2009 +0100
    20.3 @@ -0,0 +1,202 @@
    20.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    20.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    20.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    20.7 +<head>
    20.8 +    <title>SliTaz Handbook - Multimedia</title>
    20.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   20.10 +    <meta name="description" content="slitaz *book template" />
   20.11 +    <meta name="expires" content="never" />
   20.12 +    <meta name="modified" content="2007-12-03 12:30:00" />
   20.13 +    <meta name="publisher" content="www.slitaz.org" />
   20.14 +    <meta name="author" content="Christophe Lincoln"/>
   20.15 +    <link rel="shortcut icon" href="favicon.ico" />
   20.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
   20.17 +</head>
   20.18 +<body bgcolor="#ffffff">
   20.19 +
   20.20 +<!-- Header and quick navigation -->
   20.21 +<div id="header">
   20.22 +<div align="right" id="quicknav">
   20.23 +    <a name="top"></a>
   20.24 +    <a href="development.html">Developpement</a> |
   20.25 +    <a href="index.html">Table des matières</a>
   20.26 +</div>
   20.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   20.28 +</div>
   20.29 +
   20.30 +<!-- Content. -->
   20.31 +<div id="content">
   20.32 +<div class="content-right"></div>
   20.33 +
   20.34 +<h2><font color="#DF8F06">Multimedia</font></h2>
   20.35 +
   20.36 +<ul>
   20.37 +	<li><a href="#intro">Slitaz le son et la video.</a></li>
   20.38 +	<li><a href="#config">Configurer une carte son.</a></li>
   20.39 +	<li><a href="#alsamixer">Alsamixer</a> - Mixer simple et efficace.</li>
   20.40 +	<li><a href="#alsaplayer">Alsaplayer</a> - Lecteur de musique.</li>
   20.41 +	<li><a href="#asunder">Asunder</a> - Audio CD Ripper.</li>
   20.42 +	<li><a href="#xine">Xine</a> - Lecteur multimedia.</li>
   20.43 +	<li><a href="#mpg123">mpg123</a> - Lecteur audio et encodeur en ligne de
   20.44 +	commande.</li>
   20.45 +</ul>
   20.46 +
   20.47 +<a name="intro"></a>
   20.48 +<h3><font color="#6c0023">Slitaz le son et la video</font></h3>
   20.49 +<p>
   20.50 +En mode LiveCD SliTaz fournit le support du son mais pas de lecteur video, 
   20.51 +cela dit vous pouvez visionner des videos en flash sur Youtube par exemple. 
   20.52 +Pour regarder des videos vous pouvez utiliser Xine, il supporte la plus part des
   20.53 +formats tels que OGG ou AVI, à noter que Xine peut aussi faire office de
   20.54 +lecteur de musique. Au niveau du son, vous avez un mixer avec Alsamixer et un
   20.55 +lecteur avec Alsaplayer, ils sont tous deux installée par défaut sur la version
   20.56 +standard du LiveCD et permettent d'écouter des fichiers OGG, MP3 ou WAV. Pour
   20.57 +configurer ou reconfigurer votre carte son, vous avez le choix entre deux 
   20.58 +petit programmes permettant de configurer le son simplement via des boîtes de
   20.59 +dialogue.
   20.60 +</p>
   20.61 +
   20.62 +<a name="conf"></a>
   20.63 +<h3><font color="#6c0023">Configurer une carte son</font></h3>
   20.64 +<p>
   20.65 +En mode LiveCD SliTaz configure automatiquement le son au démarrage en lançant
   20.66 +une boîte de dialogue, dans la majeur partie des cas, la carte son est reconnue
   20.67 +et il suffit d'appuyer sur ENTER pour continuer, se loguer et avoir le son
   20.68 +fonctionnel. Cela dit, il se peut que votre carte son ne soit pas reconnue au
   20.69 +démarrage ou simplement pas supportée. Avant de jeter l'éponge, vous pouvez
   20.70 +tenter de configurer manuellement votre carte et demander le l'aide sur la liste
   20.71 +de discussion ou le forum de support matériel.
   20.72 +</p>
   20.73 +<h4>Soundconf</h4>
   20.74 +<p>
   20.75 +Pour configurer ou reconfigurer une carte son, SliTaz fournit le script
   20.76 +<code>soundconf</code>, cet utilitaire est utilisé au démarrage, ne pose
   20.77 +qu'une question, charge les bons modules automatiquement et configure 
   20.78 +<code>/etc/rcS.conf</code> pour que le driver soit chargé à chaque démarrage.
   20.79 +Soundconf va aussi régler les volumes automatiquement, vous pourrez modifier
   20.80 +les réglages par la suite via le mixer et alsactl. Pour lancer l'interface de
   20.81 +configuration du son, il faut avoir les droits d'administrateur et taper :
   20.82 +</p>
   20.83 +<pre>
   20.84 + # soundconf
   20.85 +</pre>
   20.86 +<h4>Alsactl</h4>
   20.87 +<p>
   20.88 +Alsactl pour <em>Alsa control</em> permet de stocker ou restaurer les réglages
   20.89 +du son, utile par exemple pour restaurer ses préférences à chaque démarrage. 
   20.90 +Lors de la configuration du son avec Soundconf les volumes sont réglés
   20.91 +automatiquement, vous pouvez utiliser <code>alsamixer</code> avec <em>root</em>
   20.92 +pour modifier les valeurs et ensuite lancer <code>alsactl</code> pour stocker
   20.93 +la configuration
   20.94 +</p>
   20.95 +<pre>
   20.96 + # alsactl store
   20.97 +</pre>
   20.98 +<p>
   20.99 +Pour restaurer ensuite la configuration vous pouvez utiliser la commande
  20.100 +<code>alsactl restore</code> et pour restaurer vos préférences à chaque
  20.101 +démarrage vous pouvez ajouter la commande au script /etc/init.d/local.sh en
  20.102 +l'éditant avec un éditeur de texte ou avec :
  20.103 +</p>
  20.104 +<pre>
  20.105 + # echo 'alsactl restore' > /etc/init.d/local.sh
  20.106 +</pre>
  20.107 +
  20.108 +<a name="alsamixer"></a>
  20.109 +<h3><font color="#6c0023">Alsamixer</font></h3>
  20.110 +<p>
  20.111 +Alsamixer et le mixer officiel du projet Alsa, il est simple et efficace. Vous
  20.112 +pouvez le lancer via le menu du gestionnaire de fenêtre ou directement depuis
  20.113 +un terminal. Les volumes se réglent avec les flèches et le mode muet se met ou 
  20.114 +s'enlève via la touche <code>m</code>. Pour lancer le mixer depuis un terminal
  20.115 +Linux ou un graphique :
  20.116 +</p>
  20.117 +<pre>
  20.118 + $ alsamixer
  20.119 +</pre>
  20.120 +
  20.121 +<a name="alsaplayer"></a>
  20.122 +<h3><font color="#6c0023">Alsaplayer</font></h3>
  20.123 +<p>
  20.124 +Le lecteur de musique Alsaplayer se veut simple, épuré et intuitif. Il est réactif
  20.125 +et se prend rapidement en main, l'interface est sobre et adaptable. Alsaplayer
  20.126 +sur SliTaz fournit le support des fichiers OGG, MP3 (via libmad) et WAV, des
  20.127 +playlists, propose des visualisateurs pour accompager le son, la possibilité
  20.128 +de régler la vitesse de lecture ou le volume. Une fois lancé via le menu du
  20.129 +gestionnaire de fenêtre, il suffit de cliquer sur le bouton play ou celui de
  20.130 +la liste de lecture pour commencer à charger un ou des morceaux.
  20.131 +</p>
  20.132 +
  20.133 +<a name="asunder"></a>
  20.134 +<h3><font color="#6c0023">Asunder -  Audio CD Ripper</font></h3>
  20.135 +<p>
  20.136 +Asunder est un logiciel d'extraction et encodage de pistes audio depuis un CD.
  20.137 +L'outils est très simple d'utilisation, permet d'encoder les morceaux au format
  20.138 +wav, ogg ou mp3 via le paquet <code>lame</code>. Il peut aussi faire une
  20.139 +recheche CDDB, créer une liste de lecture et modifier les noms des fichiers.
  20.140 +Vous trouverez Asunder dans la catégorie Multimedia, il est très rapidement
  20.141 +pris en main et efficace.
  20.142 +</p>
  20.143 +
  20.144 +<a name="xine"></a>
  20.145 +<h3><font color="#6c0023">Xine</font></h3>
  20.146 +<p>
  20.147 +Xine est un projet fournissant des bibliothèques et divers visionneurs de video,
  20.148 +SliTaz fournit les blibliothèques et un <em>media player</em> contenu dans
  20.149 +le paquet <code>xine-ui</code> (ui pour <em>User Interface</em>). Le lecteur
  20.150 +Xine propose un interface Xlib, un pannel de contrôle, une interface de
  20.151 +configuration via un clique de droite sur la fenêtre principale et des plugins.
  20.152 +Il lit la musique OGG, MP3, etc, et les videos au format OGG, AVI ou MPG. Pour
  20.153 +installer Xine et ses dépendances :
  20.154 +</p>
  20.155 +<pre>
  20.156 + # tazpkg get-install xine-ui
  20.157 +</pre>
  20.158 +<p>
  20.159 +Une fois installé vous pouvez lancer <code>xine</code> depuis la ligne de
  20.160 +commande ou ajouter un entrée dans la catégorie Multimedia du menu de JWM :
  20.161 +</p>
  20.162 +<pre class="script">
  20.163 +&lt;Program icon="xine.xpm" label="Xine media player"&gt;xine&lt;/Program&gt;
  20.164 +</pre>
  20.165 +
  20.166 +<a name="mpg123"></a>
  20.167 +<h3><font color="#6c0023">mpg123</font></h3>
  20.168 +<p>
  20.169 +mpg123 est un lecteur et convertisseur de fichiers audio et s'utilise en ligne
  20.170 +de commande. C'est à dire que vous pouvez écouter ou convertir de la musique
  20.171 +depuis un terminal, pour afficher l'aide vous pouvez utiliser l'option 
  20.172 +<code>--help</code>. Pour lire un fichier MP3 par exemple, il suffit de lancer
  20.173 +<code>mpg123</code> suivi du nom du fuchier audio :
  20.174 +</p>
  20.175 +<pre>
  20.176 + $ mpg123 sound.mp3
  20.177 +</pre>
  20.178 +<p>
  20.179 +mpg123 permet aussi de convertir et encoder un fichier audio dans un autre
  20.180 +format. Vous pouvez par exemple convertir un fichier MP3 en WAV, exemple :
  20.181 +</p>
  20.182 +<pre>
  20.183 + $ mpg123 -w sound.wav sound.mp3
  20.184 +</pre>
  20.185 +
  20.186 +<!-- End of content -->
  20.187 +</div>
  20.188 +
  20.189 +<!-- Footer. -->
  20.190 +<div id="footer">
  20.191 +	<div class="footer-right"></div>
  20.192 +	<a href="#top">Haut de la page</a> | 
  20.193 +	<a href="index.html">Table des matières</a>
  20.194 +</div>
  20.195 +
  20.196 +<div id="copy">
  20.197 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  20.198 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  20.199 +    Documentation publiée sous
  20.200 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  20.201 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  20.202 +</div>
  20.203 +
  20.204 +</body>
  20.205 +</html>

    21.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    21.2 +++ b/doc/handbook-stable/handbook/network-config.html	Fri Feb 06 23:17:00 2009 +0100
    21.3 @@ -0,0 +1,420 @@
    21.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    21.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    21.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
    21.7 +<head>
    21.8 +    <title>SliTaz Handbook - Network config</title>
    21.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   21.10 +    <meta name="description" content="DHCP ifconfig réseau sur SliTaz udhcpc masque passerelle 127.0.0.1 hostname IP fixe PPPOE" />
   21.11 +    <meta name="expires" content="never" />
   21.12 +    <meta name="modified" content="2007-12-04 12:30:00" />
   21.13 +    <meta name="publisher" content="www.slitaz.org" />
   21.14 +    <meta name="author" content="Christophe Lincoln"/>
   21.15 +    <link rel="shortcut icon" href="favicon.ico" />
   21.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
   21.17 +</head>
   21.18 +<body bgcolor="#ffffff">
   21.19 +
   21.20 +<!-- Header and quick navigation -->
   21.21 +<div id="header">
   21.22 +<div align="right" id="quicknav">
   21.23 +    <a name="top"></a>
   21.24 +    <a href="web-server.html">Serveur web</a> |
   21.25 +    <a href="index.html">Table des matières</a>
   21.26 +</div>
   21.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1>
   21.28 +</div>
   21.29 +
   21.30 +<!-- Content. -->
   21.31 +<div id="content">
   21.32 +<div class="content-right"></div>
   21.33 +
   21.34 +<h2><font color="#DF8F06">Configuration du réseau</font></h2>
   21.35 +
   21.36 +<ul>
   21.37 +	<li><a href="#about">A propos du réseau sur SliTaz.</a></li>
   21.38 +	<li><a href="#netbox">Netbox</a> - Configuration graphique du réseau.</li>
   21.39 +	<li><a href="#hostname">/etc/hostname</a> - Le nom de machine.</li>
   21.40 + 	<li><a href="#network.conf">/etc/network.conf</a> -  Fichier de
   21.41 +	configuration du réseau.</li>
   21.42 +	<li><a href="#dynamicIP">IP dynamique</a> - Client DHCP udhcpc.</li>
   21.43 +	<li><a href="#staticIP">IP static</a> - Utilisation d'un adresse fixe.</li>
   21.44 +	<li><a href="#pppoe">Connexion ADSL en pppoe kernel-mode.</a></li>
   21.45 +	<li><a href="#rp-pppoe">Connexion ADSL avec rp-pppoe.</a></li>
   21.46 +	<li><a href="#list">Liste des interfaces et des routes.</a></li>
   21.47 +	<li><a href="#firewall">Gestion du pare-feu</a> - (<em>firewall</em>).</li>
   21.48 +	<li><a href="web-server.html">Configuration du serveur web.</a></li>
   21.49 +	<li><a href="secure-shell.html">Gestion du serveur SSH.</a></li>
   21.50 +</ul>
   21.51 +
   21.52 +<a name="about"></a>
   21.53 +<h3><font color="#6c0023">A propos du réseau sur SliTaz</font></h3>
   21.54 +<p>
   21.55 +Par défaut SliTaz lance le client DHCP (udhcpc) sur eth0 lors du boot. Si
   21.56 +votre carte réseau a bien été reconnue comme une interface eth0, et que vous
   21.57 +utilisez un routeur, votre connexion devrait déjà fonctionner. C'est une
   21.58 +configuration dynamique, à chaque démarrage du système le client DHCP obtient
   21.59 +une nouvelle adresse IP depuis le serveur DHCP, qui est intégré au
   21.60 +router, ou situé sur une autre machine. Pour changer la configuration par
   21.61 +défaut vous devez passer par le fichier /etc/network.conf décrit ci-dessous.
   21.62 +Pour les personnes utilisant <a href="#pppoe">PPPOE</a>, vous pouvez utiliser
   21.63 +les outils fournis par <code>rp-pppoe</code> et installés par défaut sur SliTaz.
   21.64 +</p>
   21.65 +
   21.66 +<a name="netbox"></a>
   21.67 +<h3><font color="#6c0023">Netbox - Configuration graphique du réseau</font></h3>
   21.68 +<p>
   21.69 +Netbox est un petite interface graphique permettant de facilemnt configurer
   21.70 +une interface réseau en utilisant le protocole DHCP ou en demandant une adresse
   21.71 +IP fixe. Les onglets <em>DHCP</em> et <em>Staic IP</em> permettent de démarrer
   21.72 +ou stopper la connexion et change automatiquement les valeurs dans les fichiers
   21.73 +système. Netbox fournit aussi un onglet <em>System wide</em> depuis lequel
   21.74 +vous pouvez directement éditer les fichiers de configuration système. Vous
   21.75 +pouvez lancer Netbox depuis le menu Outils système (<em>System tools</em>) ou
   21.76 +depuis un terminal graphique :
   21.77 +</p>
   21.78 +<pre>
   21.79 + $ subox netbox
   21.80 +</pre>
   21.81 +
   21.82 +<a name="hostname"></a>
   21.83 +<h3><font color="#6c0023">/etc/hostname - Le nom de machine</font></h3>
   21.84 +<p>
   21.85 +Le fichier /etc/hostname configure le nom de la machine. Le nom de machine est
   21.86 +chargé au démarrage du système avec la commande 'hostname'. Sans argument
   21.87 +cette commande retournera le nom de machine actuel :
   21.88 +</p>
   21.89 +<pre>
   21.90 + $ hostame
   21.91 +</pre>
   21.92 +<p>
   21.93 +Pour changer le nom de machine vous pouvez utiliser la commande 
   21.94 +<code>echo</code> ou utiliser un des éditeurs de texte disponible sur SliTaz 
   21.95 +(il faut être <em>root</em>). Exemple avec <code>echo</code> et le nom 
   21.96 +de machine <code>kayam</code> :
   21.97 +</p>
   21.98 +<pre>
   21.99 + # echo "kayam" > /etc/hostname
  21.100 +</pre>
  21.101 +
  21.102 +<a name="network.conf"></a>
  21.103 +<h3><font color="#6c0023">/etc/network.conf</font></h3>
  21.104 +<p>
  21.105 +Le fichier /etc/network.conf est le fichier de configuration du réseau sur
  21.106 +votre système SliTaz. Sa syntaxe est simple, vous pouvez modifier son contenu
  21.107 +avec un éditeur de texte tel que Nano. Le fichier /etc/network.conf est
  21.108 +utilisé par le script /etc/init.d/network.sh pour configurer les interfaces
  21.109 +réseau au démarrage du système.
  21.110 +</p>
  21.111 +<p>
  21.112 +Le fichier de configuration du réseau (network.conf) vous permet de lancer ou
  21.113 +non le client DHCP au boot. Vous pouvez aussi spécifier une adresse IP fixe
  21.114 +avec son masque de sous réseau, la passerelle par défaut, et le serveur DNS à
  21.115 +utiliser.
  21.116 +</p>
  21.117 +
  21.118 +<a name="dynamicIP"></a>
  21.119 +<h3><font color="#6c0023">IP dynamique - Client DHCP udhcpc</font></h3>
  21.120 +<p>
  21.121 +Le client DHCP udhcpc fourni avec Busybox utilise le script
  21.122 +/usr/share/udhcpc/default.script pour obtenir une adresse IP dynamiquement
  21.123 +au boot. Il supporte diverses options que vous pouvez connaître avec l'option
  21.124 +<code>--help</code> :
  21.125 +</p>
  21.126 +<pre>
  21.127 + # udhcpc --help
  21.128 +</pre>
  21.129 +<p>
  21.130 +Pour ne pas lancer udhcpc sur eth0, ou modifier l'interface (ex: eth1) vous
  21.131 +devez passer par le fichier /etc/network.conf, et spécifier "no" à
  21.132 +la variable DHCP= :
  21.133 +</p>
  21.134 +<pre class="script">
  21.135 +
  21.136 +# Dynamic IP address.
  21.137 +# Enable/disable DHCP client at boot time.
  21.138 +DHCP="no"
  21.139 +
  21.140 +</pre>
  21.141 +
  21.142 +<a name="staticIP"></a>
  21.143 +<h3><font color="#6c0023">IP fixe - Utilisation d'un adresse spécifique</font></h3>
  21.144 +<p>
  21.145 +Vous pouvez spécifier une adresse IP fixe à configurer au démarrage du système,
  21.146 +en mettant la valeur "yes" à la variable STATIC= :
  21.147 +</p>
  21.148 +<pre class="script">
  21.149 +
  21.150 +# Static IP address.
  21.151 +# Enable/disable static IP at boot time.
  21.152 +STATIC="yes"
  21.153 +
  21.154 +</pre>
  21.155 +<p>
  21.156 +Pour que la configuration fonctionne, vous devez spécifier une adresse IP,
  21.157 +son masque de sous réseau, la passerelle par défaut (gateway), et le serveur
  21.158 +DNS à utiliser. Exemple :
  21.159 +</p>
  21.160 +<pre class="script">
  21.161 +
  21.162 +# Set IP address, and netmask for a static IP.
  21.163 +IP="192.168.0.6"
  21.164 +NETMASK="255.255.255.0"
  21.165 +
  21.166 +# Set route gateway for a static IP.
  21.167 +GATEWAY="192.168.0.1"
  21.168 +
  21.169 +# Set DNS server. for a static IP.
  21.170 +DNS_SERVER="192.168.0.1"
  21.171 +
  21.172 +</pre>
  21.173 +
  21.174 +<a name="pppoe"></a>
  21.175 +<h3><font color="#6c0023">Connexion internet ADSL en pppoe kernel-mode</font></h3>
  21.176 +<p>
  21.177 +Pré-requis: le support ppp et pppoe doit être activé dans le noyau (dur ou 
  21.178 +modules) et l'interface ethernet configurée. Vous devez indiquer à ppp 
  21.179 +d'utiliser le plugin rp-pppoe du noyau dans <code>/etc/ppp/options</code> :
  21.180 +</p>
  21.181 +<pre class="script">
  21.182 +plugin rp-pppoe.so
  21.183 +name &lt;votre identifiant de connexion FAI&gt;
  21.184 +noipdefault
  21.185 +defaultroute
  21.186 +mtu 1492
  21.187 +mru 1492
  21.188 +lock
  21.189 +</pre>
  21.190 +<p>
  21.191 +Si vous avez compilé le support de votre carte réseau en module dans le noyau,
  21.192 +vous devrez activer ce dernier dans /etc/rcS.conf:
  21.193 +</p>
  21.194 +<pre class="script">
  21.195 +LOAD_MODULES="&lt;votre module&gt;"
  21.196 +</pre>
  21.197 +<p>
  21.198 +Modifier le fichier /etc/ppp/pap-secrets ou /etc/ppp/chap-secrets :
  21.199 +</p>
  21.200 +<pre class="script">
  21.201 +# client	       server	       secret			IP addresses
  21.202 +"votre_login_fai"       *       "mot_de_passe"
  21.203 +</pre>
  21.204 +<p>
  21.205 +Les fichiers /etc/host.conf et /etc/resolv.conf devraient être automatiquement renseignés.
  21.206 +C'est tout ! Pour vous connecter à internet, il suffit simplement de taper :
  21.207 +</p>
  21.208 +<pre>
  21.209 +pppd eth0
  21.210 +</pre>
  21.211 +
  21.212 +<a name="rp-pppoe"></a>
  21.213 +<h3><font color="#6c0023">Connexion pppoe avec rp-pppoe</font></h3>
  21.214 +<p>
  21.215 +Pour configurer sa connexion internet ADSL via le protocole PPPOE, SliTaz
  21.216 +fournit la suite d'utilitaires du paquet <code>rp-pppoe</code>. L'utilisation
  21.217 +de <code>pppoe-setup</code> est un jeu d'enfant et vous permet de configurer
  21.218 +rapidement le réseau. Si vous utilisez DHCP c'est encore plus facile, puisque
  21.219 +c'est le serveur de votre FAI (Fournisseur d'accès internet) qui va s'occuper
  21.220 +de tout. Si vous n'avez pas le DHCP vous devez commencer par désactiver son
  21.221 +utilisation via la variable <code>DHCP="no"</code> du fichier de configuration
  21.222 +<code>/etc/network.conf</code>. A noter que pour modifier des fichiers de
  21.223 +configuration système et se connecter, vous devez devenir administrateur via
  21.224 +la commande <code>su</code>. Pour installer rp-pppoe et changer la variable 
  21.225 +DHCP avec Nano (Ctrl + x pour sauver et quitter) :
  21.226 +</p>
  21.227 +<pre>
  21.228 + $ su
  21.229 + # tazpkg get-install rp-pppoe
  21.230 + # nano /etc/network.conf
  21.231 +</pre>
  21.232 +<h4>Configurer avec pppoe-setup</h4>
  21.233 +<p>
  21.234 +Pour commencer à configurer votre connexion PPPOE, vous devez ouvrir un
  21.235 +terminal X ou utiliser la console Linux pour lancer <code>pppoe-setup</code>
  21.236 +et répondre aux questions :
  21.237 +</p>
  21.238 +<pre>
  21.239 + # pppoe-setup
  21.240 +</pre>
  21.241 +<ol>
  21.242 +	<li>Tapez votre nom d'utilisateur. A noter qu'il s'agit du nom
  21.243 +	d'utilisateur avec lequel vous communiquez avec votre FAI, ils est
  21.244 +	différent de ceux du système, bien sûr.</li>
  21.245 +	<li>Interface internet, il s'agit par défaut de eth0 sauf si vous en avez
  21.246 +	plusieurs, auquel cas vous aurez eth1, eth2, etc.. généralement la touche
  21.247 +	<strong>entree</strong> suffit.</li>
  21.248 +	<li>Si vous avez un lien ADSL permanent répondez ici par
  21.249 +	<strong>oui</strong>, sinon par <strong>non</strong> (valeur par
  21.250 +	défaut).</li>
  21.251 +	<li>Spécifiez les DNS primaire et secondaire de votre FAI, il vous
  21.252 +	les communiquera, n'hésitez pas à les lui demander.</li>
  21.253 +	<li>Tapez le mot de passe avec lequel vous communiquez avec votre FAI,
  21.254 +	à noter que vous devrez le tapez deux fois.</li>
  21.255 +	<li>Choisir le firewall ou pare-feu en fonction de votre matériel,
  21.256 +	si vous avez un routeur vous pouvez entrer 2 sinon 1. En cas de doute
  21.257 +	tapez 1.</li>
  21.258 +</ol>
  21.259 +<h4>Démarrer et arrêter la connexion</h4>
  21.260 +<p>
  21.261 +Toujours en ligne de commande, il suffit de lancer <code>pppoe-start</code>
  21.262 +pour démarrer la connexion. Quelques secondes puis le système vous dit qu'il
  21.263 +est connecté. S'il vous donne un message du genre TIMED OUT c'est que vous
  21.264 +avez mal configuré ou que les branchements sont défectueux. Revérifiez votre
  21.265 +cablage et reprenez l'installation au début. Pour démarrer sa connexion :
  21.266 +</p>
  21.267 +<pre>
  21.268 + # pppoe-start
  21.269 +</pre>
  21.270 +<p>
  21.271 +Pour arrêter la connexion vous pouvez utiliser l'utilitaire
  21.272 +<code>pppoe-stop</code>, toujours en ligne de commande.
  21.273 +</p>
  21.274 +
  21.275 +<a name="list"></a>
  21.276 +<h3><font color="#6c0023">Liste des interfaces et des routes</font></h3>
  21.277 +<p>
  21.278 +Vous pouvez lister les interfaces réseau disponibles avec la commande
  21.279 +<code>ifconfig</code> suivie de l'option <code>-a</code>, ou afficher
  21.280 +l'aide avec l'option <code>--help</code> :
  21.281 +</p>
  21.282 +<pre>
  21.283 + # ifconfig -a
  21.284 + # ifconfig --help
  21.285 +</pre>
  21.286 +<p>
  21.287 +Pour afficher la table de routage IP du noyau vous pouvez utiliser la commande
  21.288 +<code>route</code> sans arguments :
  21.289 +</p>
  21.290 +<pre>
  21.291 + $ route
  21.292 +</pre>
  21.293 +
  21.294 +<a name="firewall"></a>
  21.295 +<h3><font color="#6c0023">Gestion du pare-feu (<em>firewall</em>)</font></h3>
  21.296 +<p>
  21.297 +SliTaz fourni un pare-feu très basic, les régles de sécurité du noyau sont
  21.298 +lancées et les règles d'iptables sont désactivées par défaut. Vous pouvez
  21.299 +activer/désactiver son éxécution au démarrage, et créer de nouvelles régles
  21.300 +via le fichier de configuration : /etc/firewall.conf
  21.301 +</p>
  21.302 +<p>
  21.303 +Le script du <em>firewall</em> fournit par défaut sur SliTaz, commence par
  21.304 +configurer les options propre au noyau: les redirections ICMP, les sources de
  21.305 +routage, log des adresses impossibles et les filtres contre le spoofing. Le
  21.306 +script lance ensuite les règles d'Iptables définies dans la fonction
  21.307 +<code>iptables_rules()</code> du fichier de configuration : /etc/firewall.conf
  21.308 +</p>
  21.309 +<p>
  21.310 +Le <em>firewall</em> utilise l'application Iptables, il se compose de deux
  21.311 +fichiers : Le fichier de configuration /etc/firewall.conf et le script
  21.312 +/etc/init.d/firewall, que vous ne devriez pas avoir besoin de modifier. A
  21.313 +noter qu'il y de nombreuses options avec Iptables, pour de plus amples
  21.314 +informations, référez-vous à la documentation officielle de Netfilter/iptables
  21.315 +disponible en ligne sur :
  21.316 +<a href="http://www.netfilter.org/documentation/">www.netfilter.org/documentation/</a>
  21.317 +</p>
  21.318 +<h4>Démarrer, arrêter, redémarrer le firewall</h4>
  21.319 +<p>
  21.320 +Le script /etc/init.d/firewall vous permet de démarrer/redémarrer, d'arrêter
  21.321 +et d'afficher le status du firewall. L'option redémarrer est souvent utilisée
  21.322 +pour tester de nouvelles règles, après modification du fichier de
  21.323 +configuration. Exemple :
  21.324 +</p>
  21.325 +<pre>
  21.326 + # /etc/init.d/firewall restart
  21.327 +</pre>
  21.328 +<h4>Activer/désactiver le firewall au boot</h4>
  21.329 +<p>
  21.330 +Pour activer/désactiver les options de sécurité propre au noyau, mettez "yes"
  21.331 +ou "no" à la variable KERNEL_SECURITY= :
  21.332 +</p>
  21.333 +<pre class="script">
  21.334 +
  21.335 +# Enable/disable kernel security at boot time.
  21.336 +KERNEL_SECURITY="yes"
  21.337 +
  21.338 +</pre>
  21.339 +<p>
  21.340 +Et pour activer/désactiver les règles d'iptables, il faut modifier la variable
  21.341 +IPTABLES_RULES= :
  21.342 +</p>
  21.343 +<pre class="script">
  21.344 +
  21.345 +# Enable/disable iptables rules.
  21.346 +IPTABLES_RULES="yes"
  21.347 +
  21.348 +</pre>
  21.349 +<h4>Ajouter, supprimer, ou modifier les règles d'iptables</h4>
  21.350 +<p>
  21.351 +fichier de configuration: /etc/firewall.conf. En bas du fichier vous trouverez
  21.352 +fichier de configuration: /etc/firewall.conf. En bas du fichier vous touverez
  21.353 +une fonction : <code>iptables_rules()</code> contenant toutes les commandes
  21.354 +d'iptables à lancer lors du démarrage du firewall. Pour supprimer une règle,
  21.355 +nous vous conseillons de commenter les lignes correspondantes avec :
  21.356 +<code>#</code>. A noter qu'il ne  faut pas laisser cette fonction vide, si
  21.357 +vous voulez désactiver les règles d'iptables, il est préférable de mettre
  21.358 +"no" à la variable IPTABLES_RULES= du fichier de configuration.
  21.359 +</p>
  21.360 +<p>
  21.361 +Exemple de règles iptables. On refuse toutes les connexions entrantes, et
  21.362 +sortantes, puis on accepte les connexions sur l'hôte local, le réseau local,
  21.363 +les ports 80 et 22 utilisés respectivement par le serveur web HTTP et le
  21.364 +serveur sécurisé SSH, et le port 21 pour le FTP. C'est donc très restrictif
  21.365 +comme règles:
  21.366 +</p>
  21.367 +<pre class="script">
  21.368 +
  21.369 +# Netfilter/iptables rules.
  21.370 +# This shell function is include by /etc/init.d/firewall.sh
  21.371 +# to start iptables rules.
  21.372 +#
  21.373 +iptables_rules()
  21.374 +{
  21.375 +
  21.376 +# Drop all connexions.
  21.377 +iptables -P INPUT DROP
  21.378 +iptables -P OUTPUT DROP
  21.379 +
  21.380 +# Accept all on localhost (127.0.0.1).
  21.381 +iptables -A INPUT -i lo -j ACCEPT
  21.382 +iptables -A OUTPUT -o lo -j ACCEPT
  21.383 +
  21.384 +# Accept all on the local network (192.168.0.0/24).
  21.385 +iptables -A INPUT -s 192.168.0.0/24 -j ACCEPT
  21.386 +iptables -A OUTPUT -d 192.168.0.0/24 -j ACCEPT
  21.387 +
  21.388 +# Accept port 80 for the HTTP server.
  21.389 +iptables -A INPUT -i $INTERFACE -p tcp --sport 80 -j ACCEPT
  21.390 +iptables -A OUTPUT -o $INTERFACE -p tcp --dport 80 -j ACCEPT
  21.391 +
  21.392 +# Accept port 22 for SSH.
  21.393 +iptables -A INPUT -i $INTERFACE -p tcp --dport 22 -j ACCEPT
  21.394 +iptables -A OUTPUT -o $INTERFACE -tcp --sport 22 -j ACCEPT
  21.395 +
  21.396 +# Accept port 21 for active FTP connections.
  21.397 +iptables -A INPUT -i $INTERFACE -p tcp --dport 21 -j ACCEPT
  21.398 +iptables -A OUTPUT -i $INTERFACE -p tcp --sport 21 -j ACCEPT
  21.399 +
  21.400 +}
  21.401 +
  21.402 +</pre>
  21.403 +
  21.404 +<!-- End of content -->
  21.405 +</div>
  21.406 +
  21.407 +<!-- Footer. -->
  21.408 +<div id="footer">
  21.409 +	<div class="footer-right"></div>
  21.410 +	<a href="#top">Haut de la page</a> | 
  21.411 +	<a href="index.html">Table des matières</a>
  21.412 +</div>
  21.413 +
  21.414 +<div id="copy">
  21.415 +    Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> -
  21.416 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  21.417 +    Documentation publiées sous
  21.418 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  21.419 +    et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>.
  21.420 +</div>
  21.421 +
  21.422 +</body>
  21.423 +</html>