website rev 4
French doc with Handbook and Cookbook
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/doc/cookbook/base-apps.html Sat Mar 29 12:01:05 2008 +0100 1.3 @@ -0,0 +1,646 @@ 1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 1.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 1.7 +<head> 1.8 + <title>SliTaz Cookbook - Base apps</title> 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="applications de base du système livecd slitaz" /> 1.11 + <meta name="expires" content="never" /> 1.12 + <meta name="modified" content="2007-12-24 12:30:00" /> 1.13 + <meta name="publisher" content="www.slitaz.org" /> 1.14 + <meta name="author" content="Christophe Lincoln"/> 1.15 + <link rel="shortcut icon" href="favicon.ico" /> 1.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 1.17 +</head> 1.18 +<body bgcolor="#ffffff"> 1.19 + 1.20 +<!-- Header and quick navigation --> 1.21 +<div id="header"> 1.22 +<div align="right" id="quicknav"> 1.23 + <a name="top"></a> 1.24 + <a href="base-system.html">Base system</a> | 1.25 + <a href="index.html">Table des matières</a> | 1.26 + <a href="base-ncurses.html">Base ncurses</a> 1.27 +</div> 1.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 1.29 +</div> 1.30 + 1.31 +<!-- Content. --> 1.32 +<div id="content"> 1.33 +<div class="content-right"></div> 1.34 + 1.35 + 1.36 +<h2><font color="#DF8F06">Applications de base</font></h2> 1.37 +<p> 1.38 +Install et configuration des bibliothèques et des applications de base. 1.39 +</p> 1.40 +<ul> 1.41 + <li><a href="#about">A propos de ce chapitre</a> - Description et variable 1.42 + d'environnement ($fs)</li> 1.43 + <li><a href="#bc">bc-1.06</a> - Calculatrice en mode texte.</li> 1.44 + <li><a href="#zlib">zlib-1.2.3</a> - Bibliothèques de compression.</li> 1.45 + <li><a href="#pcre">pcre-7.4</a> - Expressions régulières compatible 1.46 + Perl.</li> 1.47 + <li><a href="#e2fsprogs">e2fsprogs-1.39</a> - Utilitaires de gestion des 1.48 + systèmes de fichiers.</li> 1.49 + <li><a href="#dropbear">dropbear-0.50</a> - Client et serveur SSH 1.50 + légé.</li> 1.51 + <li><a href="#lighttpd">lighttpd-1.4.18</a> - Serveur web HTTP, léger et 1.52 + sécurisé.</li> 1.53 + <li><a href="#iptables">iptables-1.3.7</a> - Netfilter, pare-feu 1.54 + Linux.</li> 1.55 + <li><a href="#sqlite">sqlite-3.5.1</a> - Petit moteur de base de données 1.56 + SQL.</li> 1.57 + <li><a href="#cdrkit">cdrkit-1.1.5</a> - Outils de manipulation de cdrom 1.58 + et images ISO.</li> 1.59 + <li><a href="#cpio">cpio-2.8</a> - Archiveur utilisé en autre pour les 1.60 + paquets SliTaz et l'initramfs.</li> 1.61 + <li><a href="#microperl">microperl-5.8.8</a> - Un tout petit Perl.</li> 1.62 + <li><a href="#module-init-tools">module-init-tools-3.2</a> - Outils de 1.63 + manipulation des modules du noyau.</li> 1.64 + <li><a href="#kernel-modules">Copie et compression des modules du 1.65 + Kernel.</a></li> 1.66 + <li><a href="#initramfs-iso">Génération de l'initramfs, et d'une 1.67 + image ISO.</a></li> 1.68 +</ul> 1.69 +<a name="about"></a> 1.70 +<h3><font color="#6c0023">A propos</font></h3> 1.71 +<p> 1.72 +Ce chapitre décrit l'installations des bibliothèque et des applications de 1.73 +base en mode texte, fournies avec SliTaz. 1.74 +</p> 1.75 +<h4>Affecter une variable d'environnement ($fs)</h4> 1.76 +<p> 1.77 +Une variable d'environnement permet de ne pas spécifier tout le chemin vers le 1.78 +répertoire, mais simplement $NomDeVariable. Nous allons afecter un variable '$fs' 1.79 +pour indiquer le chemin vers le système de fichier racine 'rootfs'. Pour cela vous 1.80 +pouvez vous placer dans le répertoire de travail de SliTaz, et tapez: 1.81 +</p> 1.82 +<pre> 1.83 + # export fs=$PWD/rootfs 1.84 +</pre> 1.85 +<p> 1.86 +Pour vérifier: 1.87 +</p> 1.88 +<pre> 1.89 + # echo $fs 1.90 +</pre> 1.91 +<a name="bc"></a> 1.92 +<h3><font color="#6c0023">bc-1.06 - Calculatrice en mode texte</font></h3> 1.93 +<p> 1.94 +L'application bc 1.95 +(<a href="http://www.gnu.org/software/bc/">www.gnu.org/software/bc/</a>) 1.96 +fourni une petite calculette, lors de la compilation l'utilitaire dc est 1.97 +aussi construit mais SliTaz ne l'installe pas. A noter que dc est aussi 1.98 +diponible avec Busybox. Pour la copie de dc, il faut supprimer le liens 1.99 +de dc vers BusyBox si il existe. Nous utilison un répertoire _pkg (package) 1.100 +pour l'installation. Un petit nettoyage des exécutables avec strip 1.101 +et copie des utilitaires: 1.102 +</p> 1.103 +<pre> 1.104 + # cd src 1.105 + # wget http://ftp.gnu.org/pub/gnu/bc/bc-1.06.tar.gz 1.106 + # tar xzfv bc-1.06.tar.gz 1.107 + # cd bc-1.06 1.108 + # ./configure --prefix=/usr --infodir=/usr/share/info \ 1.109 + --mandir=/usr/share/man 1.110 + # make 1.111 + # make DESTDIR=$PWD/_pkg install 1.112 + # strip -vs _pkg/usr/bin/* 1.113 + # cp -avi _pkg/usr/bin/bc $fs/usr/bin 1.114 +</pre> 1.115 +<h4>libs</h4> 1.116 +<p> 1.117 +Un petit ldd sur bc devrait donner: 1.118 +</p> 1.119 +<pre class="script"> 1.120 + libc.so.6 => /lib/libc.so.6 (0x40029000) 1.121 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 1.122 +</pre> 1.123 +<a name="zlib"></a> 1.124 +<h3><font color="#6c0023">zlib-1.2.3 - Bibliothèques de compression</font></h3> 1.125 +<p> 1.126 +Le paquet zlib (<a href="http://www.zlib.net/">http://www.zlib.net/</a>) 1.127 +fourni des fonctions de compression et de décompression, utilisées entre autre, 1.128 +par le serveur SSH dropbear et le serveur X: 1.129 +</p> 1.130 +<pre> 1.131 + # cd .. 1.132 + # wget http://www.gzip.org/zlib/zlib-1.2.3.tar.bz2 1.133 + # tar xjfv zlib-1.2.3.tar.bz2 1.134 + # cd zlib-1.2.3 1.135 + # ./configure --shared --prefix=/usr 1.136 + # make 1.137 + # strip -vs libz.so* 1.138 + # cp -av libz.so* $fs/usr/lib 1.139 +</pre> 1.140 +<a name="pcre"></a> 1.141 +<h3><font color="#6c0023">pcre-7.4 - Expressions régulières compatible perl</font></h3> 1.142 +<p> 1.143 +Le paquet pcre (<a href="http://www.pcre.org/">http://www.pcre.org/</a>) 1.144 +fourni les bibliothèques des fonctions d'expressions régulières compatible 1.145 +Perl PCRE, utilisées entre autre par le serveur web LightTPD: 1.146 +</p> 1.147 +<pre> 1.148 + # cd .. 1.149 + # wget ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-7.4.tar.gz 1.150 + # tar xzfv pcre-7.4.tar.gz 1.151 + # cd pcre-7.4 1.152 + # ./configure --prefix=/usr 1.153 + # make 1.154 + # make DESTDIR=$PWD/_pkg install 1.155 + # strip -vs _pkg/usr/bin/* 1.156 + # strip -vs _pkg/usr/lib/* 1.157 + # cp -av _pkg/usr/bin/* $fs/usr/bin 1.158 + # cp -av _pkg/usr/lib/*.so* $fs/usr/lib 1.159 +</pre> 1.160 +<a name="e2fsprogs"></a> 1.161 +<h3><font color="#6c0023">e2fsprogs-1.39 - Utilitaires de gestion des systèmes de fichiers</font></h3> 1.162 +<p> 1.163 +Le paquet e2fsprogs (<a href="http://e2fsprogs.sourceforge.net/" 1.164 +>http://e2fsprogs.sourceforge.net/</a>) fournit les utilitaires pour la 1.165 +manipulation des systèmes de fichiers ext3 et ext2. Nous n'allons pas tout 1.166 +prendre, car cela nous fait gangner de la place. A noter que nous utilisons 1.167 +fsck de Busybox: 1.168 +</p> 1.169 +<pre> 1.170 + # cd .. 1.171 + # wget http://puzzle.dl.sourceforge.net/sourceforge/e2fsprogs/e2fsprogs-1.39.tar.gz 1.172 + # tar xzf e2fsprogs-1.39.tar.gz 1.173 + # cd e2fsprogs-1.39 1.174 + # ./configure --prefix=/usr --with-root-prefix="" \ 1.175 + --enable-elf-shlibs --disable-evms --sysconfdir=/etc \ 1.176 + --infodir=/usr/share/info --mandir=/usr/share/man 1.177 + # make 1.178 + # make DESTDIR=$PWD/_pkg install 1.179 + # strip -vs _pkg/sbin/* 1.180 + # strip -vs _pkg/lib/* 1.181 + # strip -vs _pkg/usr/bin/* 1.182 + # strip -vs _pkg/usr/sbin/* 1.183 + # strip -vs _pkg/usr/lib/* 1.184 +</pre> 1.185 +<p> 1.186 +Install des utilitaires, des fichiers de configuration, et des bibliothèques 1.187 +dans le rootfs de SliTaz. Attention si vous avez décidé d'utiliser fsck, 1.188 +il ne faut pas écraser un lien Busybox: 1.189 +</p> 1.190 +<pre> 1.191 + # cp -i _pkg/sbin/{badblocks,blkid,dumpe2fs,e2fsck,e2image} $fs/sbin 1.192 + # cp -i _pkg/sbin/{e2label,findfs,logsave,mke2fs,mkfs.*} $fs/sbin 1.193 + # cp -i _pkg/sbin/{resize2fs,tune2fs} $fs/sbin 1.194 + # cp -a _pkg/lib/* $fs/lib 1.195 + # rm -rf $fs/lib/libss* 1.196 + # cp -a _pkg/etc/* $fs/etc 1.197 + # cp -a _pkg/usr/bin/* $fs/usr/bin 1.198 + # cp -a _pkg/usr/sbin/* $fs/usr/sbin 1.199 + # cp -ad _pkg/usr/lib/*.so $fs/usr/lib 1.200 + # rm -rf $fs/usr/lib/libss* 1.201 +</pre> 1.202 +<p> 1.203 +Vous pouvez aussi copier le fichier de la locale pour le français: 1.204 +</p> 1.205 +<pre> 1.206 + # mkdir $fs/usr/share/locale 1.207 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 1.208 +</pre> 1.209 +<a name="dropbear"></a> 1.210 +<h3><font color="#6c0023">dropbear-0.50 - Client et serveur SSH légé</font></h3> 1.211 +<p> 1.212 +Dropbear (<a href="http://matt.ucc.asn.au/dropbear/dropbear.html" 1.213 + >http://matt.ucc.asn.au/dropbear/dropbear.html</a>) est un petit client et 1.214 +serveur sécurisé, supportant le protocole SSH 2. Dropbear est compatible avec 1.215 +openSSH, et utilise ~/.ssh/authorized_keys pour la gestion des clés public. Dropbear 1.216 +fournit aussi une version de scp, qu'il faut compiler avec 'manke scp': 1.217 +</p> 1.218 +<pre> 1.219 + # cd .. 1.220 + # wget http://matt.ucc.asn.au/dropbear/releases/dropbear-0.50.tar.gz 1.221 + # tar xzf dropbear-0.50.tar.gz 1.222 + # cd dropbear-0.50 1.223 + # ./configure --prefix=/usr 1.224 + # make 1.225 + # make scp 1.226 + # make DESTDIR=$PWD/_pkg install 1.227 + # strip -v scp 1.228 + # strip -v _pkg/usr/bin/* 1.229 + # strip -v _pkg/usr/sbin/* 1.230 +</pre> 1.231 +<p> 1.232 +Install du client, et des outils associés dans /usr/bin, et install 1.233 +du server dans /usr/sbin: 1.234 +</p> 1.235 +<pre> 1.236 + # cp scp $fs/usr/bin 1.237 + # cp -a _pkg/usr/bin/* $fs/usr/bin 1.238 + # cp -a _pkg/usr/sbin/* $fs/usr/sbin 1.239 +</pre> 1.240 +<h4>libs</h4> 1.241 +<pre class="script"> 1.242 + libutil.so.1 => /lib/libutil.so.1 (0x40025000) 1.243 + libz.so.1 => /usr/lib/libz.so.1 (0x40028000) 1.244 + libcrypt.so.1 => /lib/libcrypt.so.1 (0x4003b000) 1.245 + libc.so.6 => /lib/libc.so.6 (0x40068000) 1.246 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 1.247 +</pre> 1.248 +<p> 1.249 +Copie de la bibliothèque libutil.so.1 dans $fs/lib, si ce n'est pas déjà le cas. 1.250 +Les autres bibliothèques devraient être présentes, suite à la construction du 1.251 +système de base: 1.252 +</p> 1.253 +<pre> 1.254 + # cp -a /lib/libutil* $fs/lib 1.255 +</pre> 1.256 +<h4>Configurer Dropbear</h4> 1.257 +<p> 1.258 +Les fichiers de configuration utilisateur sont dans ~/.ssh, contenant 1.259 +authorized_keys et known_hosts. Les répertoire ~/.ssh et le fichier 1.260 +known_hosts, sont créés automatiquement la première fois que l'utilisateur 1.261 +lance dbclient. Les fichiers de configuration système du server Dropbear sont 1.262 +par défaut dans /etc/dropbear: 1.263 + </p> 1.264 +<pre> 1.265 + # mkdir $fs/etc/dropbear 1.266 +</pre> 1.267 +<p> 1.268 +Pour que le serveur fonctionnent, il faut générer les clés sécurisées 1.269 +avant de démarrer le serveur sur SliTaz. Vous pouvez utiliser dropbearkey 1.270 +avec les commandes ci-dessous: 1.271 +</p> 1.272 +<pre> 1.273 + # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key 1.274 + # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key 1.275 +</pre> 1.276 +<p> 1.277 +Sur SliTaz vous pouvez démarrer le serveur SSH avec la commande : 1.278 +</p> 1.279 +<pre> 1.280 + # /etc/init.d/dropbear start 1.281 +</pre> 1.282 +<a name="lighttpd"></a> 1.283 +<h3><font color="#6c0023">lighttpd-1.4.18 - Serveur web HTTP</font></h3> 1.284 +<p> 1.285 +LightTPD (<a href="http://www.lighttpd.net/">www.lighttpd.net</a>) est un 1.286 +serveur web puissant, léger, et sécurisé. Le projet est très actif, et la 1.287 +configuration du serveur et simple. Il supporte les hôtes virtuels, les scripts 1.288 +CGI, et il permet une gestion intelligente de la charge CPU. 1.289 +</p> 1.290 +<pre> 1.291 + # cd .. 1.292 + # wget http://www.lighttpd.net/download/lighttpd-1.4.18.tar.gz 1.293 + # tar xzf lighttpd-1.4.18.tar.gz 1.294 + # cd lighttpd-1.4.18 1.295 + # ./configure -enable-shared --disable-ipv6 --prefix=/usr \ 1.296 + --libdir=/usr/lib/lighttpd --mandir=/usr/share/man 1.297 + # make 1.298 + # make DESTDIR=$PWD/_pkg install 1.299 + # strip -vs _pkg/usr/bin/* 1.300 + # strip -vs _pkg/usr/sbin/* 1.301 + # strip -vs _pkg/usr/lib/lighttpd/* 1.302 +</pre> 1.303 +<p> 1.304 +Installation du serveur, et des bibliothèques générées. Nous allons ensuite 1.305 +supprimer copier seulement quelques modules (9) : 1.306 +</p> 1.307 +<pre> 1.308 + # cp _pkg/usr/bin/* $fs/usr/bin 1.309 + # cp _pkg/usr/sbin/* $fs/usr/sbin 1.310 + # mkdir $fs/usr/lib/lighttpd 1.311 + Modules : 1.312 + # cp _pkg/usr/lib/lighttpd/mod_access.so $fs/usr/lib/lighttpd 1.313 + # cp _pkg/usr/lib/lighttpd/mod_accesslog.so $fs/usr/lib/lighttpd 1.314 + # cp _pkg/usr/lib/lighttpd/mod_alias.so $fs/usr/lib/lighttpd 1.315 + # cp _pkg/usr/lib/lighttpd/mod_auth.so $fs/usr/lib/lighttpd 1.316 + # cp _pkg/usr/lib/lighttpd/mod_cgi.so $fs/usr/lib/lighttpd 1.317 + # cp _pkg/usr/lib/lighttpd/mod_compress.so $fs/usr/lib/lighttpd 1.318 + # cp _pkg/usr/lib/lighttpd/mod_rewrite.so $fs/usr/lib/lighttpd 1.319 + # cp _pkg/usr/lib/lighttpd/mod_status.so $fs/usr/lib/lighttpd 1.320 + # cp _pkg/usr/lib/lighttpd/mod_userdir.so $fs/usr/lib/lighttpd 1.321 +</pre> 1.322 +<h4>libs</h4> 1.323 +<p> 1.324 +Il ne devrait vous manquer que libdl.so.2, que nous allons copier: 1.325 +</p> 1.326 +<pre> 1.327 + # cp -a /lib/libdl* $fs/lib 1.328 +</pre> 1.329 +<h4>/var/www - Racine des documents du serveur</h4> 1.330 +<p> 1.331 +Le répertoire /var/www est le répertoire racine des documents servis par 1.332 +défaut. Vous y avez accès via l'url http://localhost/. Ce répertoire peut 1.333 +contenir une page <code>index.html</code> s'affichant automatiquement lors 1.334 +d'une requête. Nous allons créer le répertoire /var/www, à vous de vois ce 1.335 +que vous vouleu y mettre : 1.336 +</p> 1.337 +<pre> 1.338 + # mkdir -p $fs/var/www 1.339 +</pre> 1.340 +<h4>lighttpd.conf - Fichier de configuration de LightTPD</h4> 1.341 +<p> 1.342 +Le fichier de configuration principale de LightTPD se trouve dans /etc/lighttpd, 1.343 +et se nomme lighttpd.conf. Le fichier de configuration fournit par SliTaz est auto 1.344 +documenté, il suffit de le parcourir. Vous trouverez d'autres exemples sur le site 1.345 +web de LightTPD. Vous trouverez aussi un exemple de configuration dans /doc 1.346 +de l'archive de LightTPD: 1.347 +</p> 1.348 +<pre> 1.349 + # cp -a ../slitaz-tools-1.1/etc/lighttpd $fs/etc 1.350 +</pre> 1.351 +<p> 1.352 +Création du répertoire contenant les fichiers de log: 1.353 +</p> 1.354 +<pre> 1.355 + # mkdir $fs/var/log/lighttpd 1.356 +</pre> 1.357 +<h4>Utilisateur et groupe www</h4> 1.358 +<p> 1.359 +Nous allons ajouter un utilisateur et un groupe pour le serveur web, cela ajoute 1.360 +de la sécurité, et il n'y a aucune raison pour qu'il tourne sous root. L'utilisateur 1.361 +par défaut sur SliTaz est 'www', mais vous pouvez changer cela dans le fichier de 1.362 +configuration lighttpd.conf. L'application adduser de Busybox ayant des limitations 1.363 +nous ajoutons l'utilisateur 'www' manuellement. Nous changeons aussi les permissions 1.364 +sur le répertoire des logs du serveur web: 1.365 +</p> 1.366 +<pre> 1.367 + # echo "www:x:80:80:www:/var/www:/bin/sh" >> $fs/etc/passwd 1.368 + # echo "www:*:13509:0:99999:7:::" >> $fs/etc/shadow 1.369 + # echo "www:*:13509:0:99999:7:::" >> $fs/etc/shadow- 1.370 + # chroot $fs /bin/ash 1.371 + /# addgroup -g 80 www 1.372 + /# chown www.www /var/log/lighttpd 1.373 + # exit 1.374 +</pre> 1.375 +<p> 1.376 +Pour démarrer le serveur web vous pouvez utiliser le script /etc/init.d/lighttpd 1.377 +fourni dans SliTaz tools, en tapant la commande <code>/etc/init.d/lighttpd start</code>. 1.378 +Vous pouvez aussi automatiser son lancement au boot avec un lien de /etc/init.d/lighttpd 1.379 +pointant vers /etc/rc.d/60lighttpd. 1.380 +</p> 1.381 +<a name="iptables"></a> 1.382 +<h3><font color="#6c0023">iptables-1.3.7 - Netfilter, pare-feu Linux</font></h3> 1.383 +<p> 1.384 +Netfilter (<a href="http://www.netfilter.org/">www.netfilter.org</a>) est le module qui 1.385 +fournit au noyau Linux les fonctions de pare-feu, de partage de connexions internet (NAT) et 1.386 +d'historisation du trafic réseau. La commande iptables permet de configurer Netfilter, 1.387 +iptables-restore et iptables-save permettent de sauvegarder/restaurer la configuration 1.388 +Netfilter: 1.389 +</p> 1.390 +<pre> 1.391 + # cd .. 1.392 + # wget http://www.netfilter.org/projects/iptables/files/iptables-1.3.7.tar.bz2 1.393 + # tar xjf iptables-1.3.7.tar.bz2 1.394 + # cd iptables-1.3.7 1.395 + # make KERNEL_DIR=../linux-2.6.20 BINDIR=/sbin \ 1.396 + LIBDIR=/lib MANDIR=/usr/share/man 1.397 + # make KERNEL_DIR=../linux-2.6.20 BINDIR=/sbin \ 1.398 + LIBDIR=/lib MANDIR=/usr/share/man \ 1.399 + DESTDIR=$PWD/_pkg install 1.400 + # strip _pkg/sbin/* 1.401 + # strip _pkg/lib/iptables/* 1.402 +</pre> 1.403 +<p> 1.404 +Installation des applications iptables*, et des bibliothèques suffisantes pour un firewall 1.405 +basique: 1.406 +</p> 1.407 +<pre> 1.408 + # cp -a _pkg/sbin/iptables* $fs/sbin 1.409 + # mkdir $fs/lib/iptables 1.410 + # cp -a _pkg/lib/iptables/{libipt_standard.so,libipt_conntrack.so} \ 1.411 + $fs/lib/iptables 1.412 + # cp -a _pkg/lib/iptables/{libipt_tcp.so,libipt_udp.so} $fs/lib/iptables 1.413 +</pre> 1.414 +<p> 1.415 +Pour satifaire les dépendances d'iptables, il faut copier la bibliothèque libnsl*: 1.416 +</p> 1.417 +<pre> 1.418 + # cp -va /lib/libnsl* $fs/lib/tls 1.419 + # strip $fs/lib/libnsl* 1.420 +</pre> 1.421 +<a name="sqlite"></a> 1.422 +<h3><font color="#6c0023">sqlite-3.5.1 - Petit moteur de base de données SQL</font></h3> 1.423 +<p> 1.424 +Ce paquet fourni <code>sqlite3</code> et les bibliothèques <code>sqlite3.so*</code> 1.425 +(<a href="http://www.sqlite.org/">www.sqlite.org</a>). SQLite est 1.426 +intégré directement aux programmes en utilisant des fichiers de bases 1.427 +de données, il est performant et rapide: 1.428 +</p> 1.429 +<pre> 1.430 + # cd .. 1.431 + # wget http://www.sqlite.org/sqlite-3.5.1.tar.gz 1.432 + # tar xzf sqlite-3.5.1.tar.gz 1.433 + # cd sqlite-3.5.1 1.434 + # ./configure --prefix=/usr --disable-tcl 1.435 + # make 1.436 + # make DESTDIR=$PWD/_pkg install 1.437 + # strip _pkg/usr/lib/*.so* 1.438 + # strip _pkg/usr/bin/* 1.439 +</pre> 1.440 +<p> 1.441 +Installation des bibliothèques et de l'utilitaire <code>sqlite3</code> 1.442 +dans le rootfs de SliTaz: 1.443 +</p> 1.444 +<pre> 1.445 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 1.446 + # cp -a _pkg/usr/bin/* $fs/usr/bin 1.447 +</pre> 1.448 +<a name="cdrkit"></a> 1.449 +<h3><font color="#6c0023">cdrkit-1.1.5 - Outils de manipulation de cdrom et images ISO</font></h3> 1.450 +<p> 1.451 +cdrkit (<a href="http://www.cdrkit.org/">www.cdrkit.org</a>) 1.452 +fournit des outils de manipulation de cdrom. SliTaz installe par défaut 1.453 +wodim pour la gravure et genisoimage pour la création d'image ISO (c'est 1.454 +le paquet cdrkit-base-1.1.5). La compilation est un peu particulière 1.455 +(cmake), mais ne devrait pas poser trop de problèmes: 1.456 +</p> 1.457 +<pre> 1.458 + # cd .. 1.459 + # wget http://cdrkit.org/releases/cdrkit-1.1.5.tar.gz 1.460 + # tar xzf cdrkit-1.1.5.tar.gz 1.461 + # cd cdrkit-1.1.5 1.462 + # make 1.463 + # make install PREFIX=$PWD/_pkg/usr 1.464 + # strip -v _pkg/usr/bin/* 1.465 + # strip -v _pkg/usr/sbin/* 1.466 + # cp _pkg/usr/bin/genisoimage $fs/usr/bin 1.467 + # cp _pkg/usr/bin/wodim $fs/usr/bin 1.468 +</pre> 1.469 +<p> 1.470 +Copie de la bibliothèque libcap.so.1 requise par wodim: 1.471 +</p> 1.472 +<pre> 1.473 + # cp -a /lib/libcap.so* $fs/lib 1.474 +</pre> 1.475 +<a name="cpio"></a> 1.476 +<h3><font color="#6c0023">cpio-2.8 - Archiveur</font></h3> 1.477 +<p> 1.478 +cpio (<a href="http://www.gnu.org/software/cpio/">http://www.gnu.org/software/cpio/</a>) 1.479 +fournit des outils de manipulation de s archives au format cpio. Ce 1.480 +format d'archive est utilisé pour les paquets SliTaz et l'image initramfs 1.481 +du cdrom. A noter que Busybox fournit aussi une version de cpio qui 1.482 +permet seulemnt de désarchiver: 1.483 +</p> 1.484 +<pre> 1.485 + # cd .. 1.486 + # wget ftp://sunsite.cnlab-switch.ch/mirror/gnu/cpio/cpio-2.8.tar.gz 1.487 + # tar xzf cpio-2.8.tar.gz 1.488 + # cd cpio-2.8 1.489 + # ./configure --prefix=/usr --bindir=/bin \ 1.490 + --libexecdir=/usr/bin --mandir=/usr/share/man \ 1.491 + --infodir=/usr/share/info 1.492 + # make 1.493 + # make DESTDIR=$PWD/_pkg install 1.494 + # strip -v _pkg/bin/* 1.495 + # strip -v _pkg/usr/bin/* 1.496 +</pre> 1.497 +<p> 1.498 +Installation de <code>cpio</code> dans /bin et de <code>rmt</code> 1.499 +dans /usr/bin. Vous pouvez aussi installer les fichiers de 1.500 +localisation pour le français: 1.501 +</p> 1.502 +<pre> 1.503 + # cp -a _pkg/bin/* $fs/bin 1.504 + # cp -a _pkg/usr/bin/* $fs/usr/bin 1.505 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 1.506 +</pre> 1.507 +<a name="microperl"></a> 1.508 +<h3><font color="#6c0023">microperl-5.8.8 - Un tout petit Perl</font></h3> 1.509 +<p> 1.510 +Microperl est une micro implémentation de Perl permettant d'utiliser la plus 1.511 +part des fonctions de base fournies par le puissant langage qu'est Perl. Vous 1.512 +trouverez plus d'infos dans l'archine source et le fichier 1.513 +<code>README.micro</code>. Nous applicaons un petit <code>sed</code> sur le 1.514 +fichier de configuration, pour que microperl cherche les modules dans 1.515 +<code>/usr/lib/perl5</code>. Nous créons aussi un lien pour que les scripts 1.516 +<code>#/usr/bin/perl</code> fonctionnent : 1.517 +</p> 1.518 +<pre> 1.519 + # wget http://ftp.funet.fi/pub/CPAN/src/perl-5.8.8.tar.gz 1.520 + # tar xzf perl-5.8.8.tar.gz 1.521 + # cd perl-5.8.8 1.522 + # sed -i s/'usr\/local'/'usr'/ uconfig.sh 1.523 + # sed -i s/'perl5\/5.9'/'perl5'/ uconfig.sh 1.524 + # sed -i s/'unknown'/'i486-pc-linux-gnu'/ uconfig.sh 1.525 + # make -f Makefile.micro regen_uconfig 1.526 + # make -f Makefile.micro 1.527 + # strip microperl 1.528 + # cp microperl $fs/usr/bin 1.529 + # chroot $fs /bin/ash 1.530 + /# cd /usr/bin 1.531 + /# ln -s microperl perl 1.532 + /# exit 1.533 +</pre> 1.534 +<a name="module-init-tools"></a> 1.535 +<h3><font color="#6c0023">module-init-tools-3.2 - Outils de manipulation des modules du noyau</font></h3> 1.536 +<p> 1.537 +Les <a href="http://ftp.kernel.org/pub/linux/utils/kernel/module-init-tools/" 1.538 + >module-init-tools</a> de kernel.org, modprobe, insmod, rmmod, lsmod, que 1.539 +BusyBox fournit aussi. Nous avons fait le choix de les utiliser car nous pouvons 1.540 +compiler modutils/modprobe pour qu'il support les modules compressés (.gz), 1.541 +afin de gagner de la place. Pour cela il faut utiliser l'option --enable-zlib. Ensuite 1.542 +c'est le nettoyage, et la copie des binaires. Nous ne prenons pas tout ce qui a 1.543 +créé, seulement ce dont nous avons besoin, depmod, insmod, modinfo, modprobe, 1.544 +rmmod dans /sbin, et lsmod dans /bin. 1.545 +</p> 1.546 +<pre> 1.547 + # cd .. 1.548 + # wget http://ftp.kernel.org/pub/linux/utils/kernel/module-init-tools/module-init-tools-3.2.tar.bz2 1.549 + # tar xjf module-init-tools-3.2.tar.bz2 1.550 + # cd module-init-tools-3.2 1.551 + # ./configure --enable-zlib --prefix=/usr --sbindir=/sbin --bindir=/bin \ 1.552 + --sysconfdir=/etc --infodir=/usr/share/info --mandir=/usr/share/man 1.553 + # make 1.554 + # make DESTDIR=$PWD/_pkg install 1.555 + # strip -v _pkg/sbin/{depmod,insmod,modinfo,modprobe,rmmod} 1.556 + # strip -v _pkg/bin/lsmod 1.557 + # cp -i _pkg/sbin/{depmod,insmod,modinfo,modprobe,rmmod} $fs/sbin 1.558 + # cp -i _pkg/bin/lsmod $fs/bin 1.559 + # cd .. 1.560 +</pre> 1.561 +<a name="kernel-modules"></a> 1.562 +<h3><font color="#6c0023">Copie des modules du kernel</font></h3> 1.563 +<p> 1.564 +Copie des fichier depuis linux-2.6.20/_pkg. 1.565 +</p> 1.566 +<pre> 1.567 + # cp -a linux-2.6.20/_pkg/lib/* $fs/lib 1.568 +</pre> 1.569 +<h4>Compression des modules du kernel</h4> 1.570 +<p> 1.571 +Compression des modules, cette opération permet de ganger 50% de 1.572 +place environ, nous commençons par nous déplacer dans le rootfs 1.573 +, puis nous chercons tous les fichiers portant l'extension <code>.ko</code> 1.574 +pour les compresser. Vous pouvez aussi faire cela avec le script 'gzmodtaz.sh' 1.575 +contenu dans SliTaz tools: 1.576 +</p> 1.577 +<pre> 1.578 + # cd $fs 1.579 +</pre> 1.580 +<p> 1.581 +Avec 'gztazmod.sh': 1.582 +</p> 1.583 +<pre> 1.584 + # cp -v ../src/slitaz-tools-1.1/utils/gztazmod.sh sbin 1.585 + # ./sbin/gztazmod.sh lib/modules/2.6.20-slitaz 1.586 +</pre> 1.587 +<p> 1.588 +Ou à la main: 1.589 +</p> 1.590 +<pre> 1.591 + # cd lib/modules/2.6.20-slitaz 1.592 + # find . -name "*.ko" -exec gzip '{}' \; 1.593 + # sed 's/\.ko/.ko.gz/g' modules.dep > tmp.dep 1.594 + # rm modules.dep 1.595 + # mv tmp.dep modules.dep 1.596 +</pre> 1.597 +<a name="initramfs-iso"></a> 1.598 +<h3><font color="#6c0023">Génération de l'initramfs, et d'une image ISO</font></h3> 1.599 +<p> 1.600 +Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' 1.601 +contenu dans 1.602 +<a href="http://www.slitaz.org/get/tools.html">SliTaz tools</a>. 1.603 +Ou vous pouvez créer un nouvelle image initramfs, et la copier dans 1.604 +/boot de la racine de cd-rom (rootcd), et pour finir créer un image 1.605 +ISO avec genisoimage: 1.606 +</p> 1.607 +<pre> 1.608 + # cd $fs 1.609 + # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz 1.610 + # cd .. 1.611 + # cp rootfs.gz rootcd/boot 1.612 + # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \ 1.613 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 1.614 + -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd 1.615 +</pre> 1.616 +<p> 1.617 +Test iso image: 1.618 +</p> 1.619 +<pre> 1.620 + # qemu -cdrom slitaz-test.iso 1.621 +</pre> 1.622 +<h4>Suite</h4> 1.623 +<p> 1.624 +Le prochain chapitre se nomme <a href="base-ncurses.html">Base ncurses.</a> Il 1.625 +décrit l'installation et la configuration des bibliothèques et d'applications 1.626 +ncurses. 1.627 +</p> 1.628 + 1.629 + 1.630 +<!-- End of content --> 1.631 +</div> 1.632 + 1.633 +<!-- Footer. --> 1.634 +<div id="footer"> 1.635 + <div class="footer-right"></div> 1.636 + <a href="#top">Haut de la page</a> | 1.637 + <a href="index.html">Table des matières</a> 1.638 +</div> 1.639 + 1.640 +<div id="copy"> 1.641 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 1.642 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 1.643 + Documentation publiées sous 1.644 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 1.645 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 1.646 +</div> 1.647 + 1.648 +</body> 1.649 +</html>
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 2.2 +++ b/doc/cookbook/base-ncurses.html Sat Mar 29 12:01:05 2008 +0100 2.3 @@ -0,0 +1,509 @@ 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 Cookbook - Base ncurses</title> 2.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 2.10 + <meta name="description" content="SliTaz installation ncurses clex htop nano retawq rhapsody dialog bibliothèques" /> 2.11 + <meta name="expires" content="never" /> 2.12 + <meta name="modified" content="2007-12-24 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="base-apps.html">Base apps</a> | 2.25 + <a href="index.html">Table des matières</a> | 2.26 + <a href="locale.html">Locale & i18n</a> 2.27 +</div> 2.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 2.29 +</div> 2.30 + 2.31 +<!-- Content. --> 2.32 +<div id="content"> 2.33 +<div class="content-right"></div> 2.34 + 2.35 + 2.36 +<h2><font color="#DF8F06">Bibliothèques et applications ncurses</font></h2> 2.37 +<p> 2.38 +Installation et config des bibliothèques et d'applications ncurses. 2.39 +</p> 2.40 +<ul> 2.41 + <li><a href="#about">A propos de ce chapitre.</a> - Description et variable 2.42 + d'environnement ($fs)</li> 2.43 + <li><a href="#ncurses">ncurses-5.6</a> - Utilitaires et bibliothèques 2.44 + pour terminal.</li> 2.45 + <li><a href="#clex">clex-3.16</a> - Gestionnaire de fichiers.</li> 2.46 + <li><a href="#nano">nano-2.0.6</a> - Editeur de texte avancé, avec 2.47 + colorisation syntaxique.</li> 2.48 + <li><a href="#retawq">retawq-0.2.6c</a> - Navigateur web en mode texte 2.49 + utilisant ncurses.</li> 2.50 + <li><a href="#htop">htop-0.6.5</a> - Visionneur de processus système.</li> 2.51 + <li><a href="#dialog">dialog-1.1-20070409</a> - Interfaces graphiques aux 2.52 + scripts shell.</li> 2.53 + <li><a href="#ninvaders">ninvaders-0.1.1</a> - Clone du jeu Space 2.54 + Invaders.</li> 2.55 + <li><a href="#bastet">bastet-0.41</a> - Bastard tetris clone.</li> 2.56 + <li><a href="#rhapsody">rhapsody-0.28b</a> - Client de chat IRC.</li> 2.57 + <li><a href="#initramfs-iso">Génération de l'initramfs, et d'une image 2.58 + ISO.</a></li> 2.59 +</ul> 2.60 +<a name="about"></a> 2.61 +<h3><font color="#6c0023">A propos</font></h3> 2.62 +<p> 2.63 +Ce chapitre décrit la construction et l'installation des bibliothèques, et 2.64 +de quelques applications ncuses dans SliTaz. La procédure consite à se 2.65 +déplacer dans le réperoire /src, télécharger les sources de l'application en 2.66 +question, les désarchiver, lire les info du (des) fichier(s) README et/ou 2.67 +INSTALL, compiler, et installer le binaire dans SliTaz. Une fois l'application 2.68 +installée il faut créer une nouvelle initramfs, la copier dans la racine du 2.69 +cdrom, et créer une nouvelle image ISO. Pour cela vous pouvez utiliser 2.70 +<code>mktaziso</code> contenu dans : 2.71 +<a href="http://www.slitaz.org/get/tools.html">SliTaz tools</a>. 2.72 +</p> 2.73 +<h4>Affecter une variable d'environnement ($fs)</h4> 2.74 +<p> 2.75 +Une variable d'environnement permet de ne pas spécifier tout le chemin vers le 2.76 +répertoire, mais simplement $NomDeVariable. Nous allons afecter un variable 2.77 +'$fs' pour indiquer le chemin vers le système de fichier racine 'rootfs'. 2.78 +Pour cela vous pouvez vous placer dans le répertoire de travail de SliTaz, 2.79 +et tapez: 2.80 +</p> 2.81 +<pre> 2.82 + # export fs=$PWD/rootfs 2.83 +</pre> 2.84 +<p> 2.85 +Pour vérifier: 2.86 +</p> 2.87 +<pre> 2.88 + # echo $fs 2.89 +</pre> 2.90 +<a name="ncurses"></a> 2.91 +<h3><font color="#6c0023">ncurses-5.6 - Utilitaires et bibliothèques pour terminal</font></h3> 2.92 +<p> 2.93 +ncurses (<a href="http://dickey.his.com/ncurses/">dickey.his.com/ncurses/</a>) 2.94 +contient des fonctions pour afficher le texte de plusieurs manières sur 2.95 +l'écran d'un terminal Linux, et il nous fourni aussi les fichier terminfo. 2.96 +Les bibliothèques ncurses, sont, entre-autre, utilisée par retawq, nano, 2.97 +et certains jeux. Nous installon les bibliothèques dans /lib et le reste dans 2.98 +/usr/bin, avec un petit strip pour nettoyer le tout: 2.99 +</p> 2.100 +<pre> 2.101 + # cd src 2.102 + # wget ftp://invisible-island.net/ncurses/ncurses-5.6.tar.gz 2.103 + # tar xzf ncurses-5.6.tar.gz 2.104 + # cd ncurses-5.6 2.105 + # ./configure --prefix=/usr \ 2.106 + --libdir=/lib --sysconfdir=/etc \ 2.107 + --infodir=/usr/share/info --mandir=/usr/share/man \ 2.108 + --with-shared --without-debug --without-ada 2.109 + # make 2.110 + # make DESTDIR=$PWD/_pkg install 2.111 + # strip -v _pkg/lib/* 2.112 + # strip -v _pkg/usr/bin/* 2.113 +</pre> 2.114 +<p> 2.115 +Copie de la bibliothèque libncurses dans SliTaz, et de quelques applications. 2.116 +L'utilitaire 'reset' est et utilisé à la fin du script d'initialisation rcS, 2.117 +pour enlever le logo Linux. Si vous le désirez, vous pouvez aussi copier tous 2.118 +les utilitaires assoiciés (tack,tic,toe,etc), attention à ne pas écraser un lien Busybox: 2.119 +</p> 2.120 +<pre> 2.121 + # cp -a _pkg/lib/libncurses.so* $fs/lib 2.122 + # cp -ia _pkg/usr/bin/{clear,ncurses5-config,tset,reset} \ 2.123 + $fs/usr/bin 2.124 +</pre> 2.125 +<p> 2.126 +Copie de quelques fichiers terminfo, nous n'utilison que quelques fichiers, si 2.127 +vous en désirez plus à vous de les copier: 2.128 +</p> 2.129 +<pre> 2.130 + # mkdir -v $fs/usr/share/terminfo 2.131 + # mkdir -v $fs/usr/share/terminfo/{a,l,r,v,x} 2.132 + # cp _pkg/usr/share/terminfo/a/ansi \ 2.133 + $fs/usr/share/terminfo/a 2.134 + # cp _pkg/usr/share/terminfo/l/linux \ 2.135 + $fs/usr/share/terminfo/l 2.136 + # cp _pkg/usr/share/terminfo/r/rxvt \ 2.137 + $fs/usr/share/terminfo/r 2.138 + # cp _pkg/usr/share/terminfo/x/{xterm,xterm-color,xterm-new,xterm-vt220} \ 2.139 + $fs/usr/share/terminfo/x 2.140 + # cp _pkg/usr/share/terminfo/v/{vt100,vt102*} \ 2.141 + $fs/usr/share/terminfo/v 2.142 +</pre> 2.143 +<p> 2.144 +Copie des fichiers tabset: 2.145 +</p> 2.146 +<pre> 2.147 + # cp -a _pkg/usr/share/tabset $fs/usr/share 2.148 +</pre> 2.149 +<a name="clex"></a> 2.150 +<h3><font color="#6c0023">clex-3.16 - Gestionnaire de fichiers</font></h3> 2.151 +<p> 2.152 +CLEX (<a href="http://www.clex.sk/">http://www.clex.sk/</a>) est un 2.153 +petit gestionnaire de fichiers ncurses (160 Ko stripé). Le fichier de configuration 2.154 +rc est ~./.clexrc et le fichier ~/.clexbm est utilisé pour les bookmarks: 2.155 +</p> 2.156 +<pre> 2.157 + # cd .. 2.158 + # wget http://www.clex.sk/download/clex-3.16.tar.gz 2.159 + # tar xzf clex-3.16.tar.gz 2.160 + # cd clex-3.16 2.161 + # ./configure --prefix=/usr --infodir=/usr/share/info \ 2.162 + --mandir=/usr/share/man 2.163 + # make 2.164 + # make DESTDIR=$PWD/_pkg install 2.165 + # strip -v _pkg/usr/bin/clex 2.166 +</pre> 2.167 +<p> 2.168 +Install du binaire clex dans le rootfs de SliTaz: 2.169 +</p> 2.170 +<pre> 2.171 + # cp _pkg/usr/bin/clex $fs/usr/bin 2.172 +</pre> 2.173 +<h4>libs</h4> 2.174 +<p> 2.175 +Si on lance la commande <code>ldd</code> sur clex, les dépendances 2.176 +suivantes devraient être affichées: 2.177 +</p> 2.178 +<pre class="script"> 2.179 + libncurses.so.5 => /lib/libncurses.so.5 (0x40025000) 2.180 + libc.so.6 => /lib/libc.so.6 (0x40064000) 2.181 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 2.182 +</pre> 2.183 +<a name="nano"></a> 2.184 +<h3><font color="#6c0023">nano-2.0.6 - Editeur de texte avancé</font></h3> 2.185 +<p> 2.186 +GNU nano (<a href="http://www.nano-editor.org/">www.nano-editor.org</a>) est un 2.187 +éditeur de texte bien connu du monde GNU/Linux, efficace et rapide, supportant 2.188 +la colorisation syntaxique. C'est l'éditeur de texte par défaut de SliTaz: 2.189 +</p> 2.190 +<pre> 2.191 + # cd .. 2.192 + # wget http://www.nano-editor.org/dist/v2.0/nano-2.0.6.tar.gz 2.193 + # tar xzf nano-2.0.6.tar.gz 2.194 + # cd nano-2.0.6 2.195 + # ./configure --enable-all --enable-extra --prefix=/usr \ 2.196 + --infodir=/usr/share/info --mandir=/usr/share/man \ 2.197 + --sysconfdir=/etc 2.198 + # make 2.199 + # make DESTDIR=$PWD/_pkg install 2.200 + # strip -v _pkg/usr/bin/nano 2.201 +</pre> 2.202 +<p> 2.203 +Copie du binaire nano et du lien rnano, dans SliTaz: 2.204 +</p> 2.205 +<pre> 2.206 + # cp -a _pkg/usr/bin/* $fs/usr/bin 2.207 +</pre> 2.208 +<p> 2.209 +Copie des fichiers de configuration de nano dans /usr/share/nano 2.210 +de notre rootfs: 2.211 +</p> 2.212 +<pre> 2.213 + # cp -a _pkg/usr/share/nano $fs/usr/share 2.214 +</pre> 2.215 +<h4>libs</h4> 2.216 +<p> 2.217 +Si on lance la commande <code>ldd</code> sur nano, les dépendances 2.218 +suivantes devraient être affichées: 2.219 +</p> 2.220 +<pre class="script"> 2.221 + libncurses.so.5 => /lib/libncurses.so.5 (0x40025000) 2.222 + libc.so.6 => /lib/libc.so.6 (0x40064000) 2.223 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 2.224 +</pre> 2.225 +<h4>locale</h4> 2.226 +<p> 2.227 +Au sujet de la langue, vous pouvez copier les fichiers .mo, créé 2.228 +lors de l'installation de nano, dans 2.229 +/usr/share/locale/{fr,en,de,es,etc}/LC_MESSAGES. Exemple pour la 2.230 +langue française: 2.231 +</p> 2.232 +<pre> 2.233 + # cp -a _pkg/usr/share/locale/fr/LC_MESSAGES $fs/usr/share/locale/fr 2.234 +</pre> 2.235 +<h4>Personnaliser nano</h4> 2.236 +<p> 2.237 +Vous pouvez personnaliser nano via le fichier /etc/nanorc, ou 2.238 +~/.nanorc propre à chaque utilisateur du système, c'est dans ce 2.239 +fichier que vous pouvez, par exemple, définir les couleur utilisées 2.240 +par nano grâce au fichiers contenus dans /usr/share/nono. Vous trouverez 2.241 +un large exemple de ce fichier dans l'archive de nano et dans 2.242 +<a href="http://www.slitaz.org/get/tools">SliTaz tools</a>. 2.243 +</p> 2.244 +<p> 2.245 +Pour un fichier de configuration système, vous pouvez copier le fichier 2.246 +nanorc de SliTaz tools, dans /etc du rootfs: 2.247 +</p> 2.248 +<pre> 2.249 + # cd .. 2.250 + # cp -a slitaz-tools-1.1/etc/nanorc $fs/etc 2.251 +</pre> 2.252 +<a name="retawq"></a> 2.253 +<h3><font color="#6c0023">retawq-0.2.6c - Navigateur web en mode texte</font></h3> 2.254 +<p> 2.255 +retawq (<a href="http://retawq.sourceforge.net/">retawq.sourceforge.net</a>) 2.256 +est petit navigateur web en mode texte. Nous passons quelques option utiles 2.257 +lors de la configuration, retawq a besoin des fichiers terminfo, des 2.258 +bibliothèques libncurses, et libpthread: 2.259 +</p> 2.260 +<pre> 2.261 + # wget http://switch.dl.sourceforge.net/sourceforge/retawq/retawq-0.2.6c.tar.gz 2.262 + # tar xzf retawq-0.2.6c.tar.gz 2.263 + # cd retawq-0.2.6c 2.264 + # ./configure --enable-i18n --enable-local-cgi --path-prefix=/usr \ 2.265 + --path-doc=/usr/share/doc/retawq --path-man=/usr/share/man 2.266 + # make 2.267 + # strip -v retawq 2.268 +</pre> 2.269 +<p> 2.270 +Copie du binaire retawq dans SliTaz: 2.271 +</p> 2.272 +<pre> 2.273 + # cp retawq $fs/usr/bin 2.274 +</pre> 2.275 +<h4>libs</h4> 2.276 +<pre class="script"> 2.277 + libncurses.so.5 => /lib/libncurses.so.5 (0x40025000) 2.278 + libpthread.so.0 => /lib/libpthread.so.0 (0x40064000) 2.279 + libc.so.6 => /lib/libc.so.6 (0x40074000) 2.280 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 2.281 +</pre> 2.282 +<p> 2.283 +Vous pouvez copier libpthread depuis votre système hôte, ou utiliser le 2.284 +paquet glibc-minimum-2.3.6 distribué par SliTaz: 2.285 +</p> 2.286 +<pre> 2.287 + # cp -a /lib/libpthread* $fs/lib 2.288 + # strip --strip-unneeded $fs/lib/* 2.289 +</pre> 2.290 +<h4>locale</h4> 2.291 +<p> 2.292 +Pour la langue, vous pouvez copier les fichiers .mo, contenu dans 2.293 +/i18n de l'archive de retawq, dans /usr/share/locale/{fr,en,de,es, 2.294 +etc}/LC_MESSAGES. Exemple pour la langue française, en renommant le 2.295 +fichier fr.mo en retawq.mo: 2.296 +</p> 2.297 +<pre> 2.298 + # cp -v i18n/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/retawq.mo 2.299 +</pre> 2.300 +<h4>Personnaliser retawq</h4> 2.301 +<p> 2.302 +Pour personnalisé retawq, vous pouvez utiliser un répertoire personnel 2.303 +~/.retawq, contenant un fichier config. Vous pouvez aussi mettre un 2.304 +fichier bookmarks (pour les marques pages) à la racine du répertoire 2.305 +de l'utilisateur. Vous trouverez un large exemple dans l'archive de 2.306 +retawq, ou dans SliTaz tools, contenant un fichier bookmarks.html avec 2.307 +une liste de favorits web. Vous pouvez aussi copier la doc (/docu) de retawq 2.308 +dans /usr/share/doc/retawq. 2.309 +</p> 2.310 +<a name="htop"></a> 2.311 +<h3><font color="#6c0023">htop-0.6.5 - Visionneur de processus système</font></h3> 2.312 +<p> 2.313 +htop (<a href="http://htop.sourceforge.net/">htop.sourceforge.net/</a>) 2.314 +est un logiciel qui pemet d'afficher les processus du système, avec 2.315 +une interface ncurses. 2.316 +</p> 2.317 +<p> 2.318 +Retour au répertoire /src, téléchargement, détarrage, configuration, 2.319 +compilation, et nettoyage avec strip: 2.320 +</p> 2.321 +<pre> 2.322 + # cd .. 2.323 + # wget http://switch.dl.sourceforge.net/sourceforge/htop/htop-0.6.5.tar.gz 2.324 + # tar xzf htop-0.6.5.tar.gz 2.325 + # cd htop-0.6.5 2.326 + # ./configure --prefix=/usr --mandir=/usr/share/man 2.327 + # make 2.328 + # make DESTDIR=$PWD/_pkg install 2.329 + # strip -v _pkg/usr/bin/htop 2.330 +</pre> 2.331 +<p> 2.332 +Copie du binaire htop dans SliTaz: 2.333 +</p> 2.334 +<pre> 2.335 + # cp _pkg/usr/bin/htop $fs/usr/bin 2.336 +</pre> 2.337 +<p> 2.338 +Vous pouvez encore copier l'icone d'htop, ce trouvant dans: 2.339 +_pkg/usr/share/pixmaps. 2.340 +</p> 2.341 +<h4>libs</h4> 2.342 +<pre class="script"> 2.343 + libm.so.6 => /lib/libm.so.6 (0xb7f97000) 2.344 + libncurses.so.5 => /lib/libncurses.so.5 (0xb7f55000) 2.345 + libc.so.6 => /lib/libc.so.6 (0xb7e20000) 2.346 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0xb7fc9000) 2.347 +</pre> 2.348 +<a name="dialog"></a> 2.349 +<h3><font color="#6c0023">dialog-1.1-20070409 - Interfaces graphiques aux scripts shell</font></h3> 2.350 +<p> 2.351 +dialog,(<a href="http://invisible-island.net/dialog/dialog.html" 2.352 + >invisible-island.net/dialog/dialog.html</a>), est un utilitaire 2.353 +permettant de construire des interfaces graphiques basées sur la 2.354 +console: 2.355 +</p> 2.356 +<pre> 2.357 + # cd .. 2.358 + # wget ftp://invisible-island.net/dialog/dialog.tar.gz 2.359 + # tar xzf dialog.tar.gz 2.360 + # cd dialog-1.1-20070409 2.361 + # ./configure --enable-nls --with-ncurses --prefix=/usr \ 2.362 + --sysconfdir=/etc --mandir=/usr/share/man 2.363 + # make 2.364 + # make DESTDIR=$PWD/_pkg install 2.365 + # strip -v _pkg/usr/bin/dialog 2.366 +</pre> 2.367 +<p> 2.368 +Copie du binaire dialog dans SliTaz: 2.369 +</p> 2.370 +<pre> 2.371 + # cp _pkg/usr/bin/dialog $fs/usr/bin 2.372 +</pre> 2.373 +<h4>libs</h4> 2.374 +<pre class="script"> 2.375 + libncurses.so.5 => /lib/libncurses.so.5 (0x40027000) 2.376 + libm.so.6 => /lib/libm.so.6 (0x40066000) 2.377 + libc.so.6 => /lib/libc.so.6 (0x40089000) 2.378 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 2.379 +</pre> 2.380 +<h4>locale</h4> 2.381 +<p> 2.382 +Vous pouvez installer les fichiers pour la localisation, si vous le désirez: 2.383 +</p> 2.384 +<pre> 2.385 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 2.386 +</pre> 2.387 +<p> 2.388 +Le fichier de configuration de dialog est /etc/dialogrc, et/ou ~/.dialogrc 2.389 +pour chaque utilisateur. Il y a aussi pleins d'exemples de scripts dans 2.390 +le répertoire /sample des sources de dialog. 2.391 +</p> 2.392 +<a name="ninvaders"></a> 2.393 +<h3><font color="#6c0023">ninvaders-0.1.1 - Clone du jeu Space Invaders</font></h3> 2.394 +<p> 2.395 +nIvaders (<a href="http://ninvaders.sourceforge.net/" 2.396 +>http://ninvaders.sourceforge.net/</a>) est un clone du eu Space Invaders, 2.397 +qui ne fait que 46 ko une fois stripé. Nous commençons par nous placer dans 2.398 +le répertoire /src, téléchargement, détarrage, compilation, nettoyage avec 2.399 +l'utilitaire <code>strip</code> et copie du binaire nInvaders dans 2.400 +/usr/games de SliTaz : 2.401 +</p> 2.402 +<pre> 2.403 + # cd .. 2.404 + # wget http://ovh.dl.sourceforge.net/sourceforge/ninvaders/ninvaders-0.1.1.tar.gz 2.405 + # tar xzf ninvaders-0.1.1.tar.gz 2.406 + # cd ninvaders-0.1.1 2.407 + # make 2.408 + # strip -v nInvaders 2.409 + # cp nInvaders $fs/usr/games 2.410 +</pre> 2.411 +<a name="bastet"></a> 2.412 +<h3><font color="#6c0023">bastet-0.41 - Bastard tetris clone</font></h3> 2.413 +<p> 2.414 +Un petit jeu de tetris (17 Ko strippé) : 2.415 +</p> 2.416 +<pre> 2.417 + # wget http://fph.altervista.org/prog/bastet-0.41.tgz 2.418 + # tar xzf bastet-0.41.tgz 2.419 + # cd bastet-0.41 2.420 + # make 2.421 + # strip bastet 2.422 + # cp bastet $fs/usr/games 2.423 + # mkdir -p $fs/var/games 2.424 + # touch $fs/var/games/bastet.scores 2.425 + # chmod 666 $fs/var/games/bastet.scores 2.426 +</pre> 2.427 +<a name="rhapsody"></a> 2.428 +<h3><font color="#6c0023">rhapsody-0.28b - Client de chat IRC</font></h3> 2.429 +<p> 2.430 +Rhapsody (<a href="http://rhapsody.sourceforge.net/">http://rhapsody.sourceforge.net/</a>) 2.431 +est un client de chat supportant le protocole IRC, rapide et légé. Rhapsody 2.432 +fournit un menu pour une gestion des serveurs, des canaux, et sa propre 2.433 +configuration. Il est donc facile d'utilisation: 2.434 +</p> 2.435 +<pre> 2.436 + # cd .. 2.437 + # wget http://switch.dl.sourceforge.net/sourceforge/rhapsody/rhapsody_0.28b.tgz 2.438 + # tar xzf rhapsody_0.28b.tgz 2.439 + # cd rhapsody-0.28b 2.440 + # ./configure -i /usr/bin -d /usr/share/doc/rhapsody 2.441 + # make 2.442 + # strip -v rhapsody 2.443 +</pre> 2.444 +<p> 2.445 +Installation du binaire dans Slitaz, et des fichiers d'aide. Il faut 2.446 +aussi ajuster les permissions sur ces fichiers afin que tout le monde 2.447 +puisse les lire: 2.448 +</p> 2.449 +<pre> 2.450 + # cp rhapsody $fs/usr/bin 2.451 + # mkdir $fs/usr/share/doc/rhapsody 2.452 + # cp -a help $fs/usr/share/doc/rhapsody/help 2.453 + # chmod 644 $fs/usr/share/doc/rhapsody/help/* 2.454 +</pre> 2.455 +<h4>libs</h4> 2.456 +<p> 2.457 +Rhapsody utilise les librairies suivantes : 2.458 +</p> 2.459 +<pre class="script"> 2.460 + libncurses.so.5 => /lib/libncurses.so.5 (0x40026000) 2.461 + libc.so.6 => /lib/libc.so.6 (0x40066000) 2.462 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)) 2.463 +</pre> 2.464 +<h4>Personnaliser rhapsody</h4> 2.465 +<p> 2.466 +Vous pouvez personnaliser rhapsody via le fichier ~/.rhapsodyrc, ou 2.467 +utiliser <Ctrl+T> pour afficher les options. 2.468 +</p> 2.469 +<a name="initramfs-iso"></a> 2.470 +<h3><font color="#6c0023">Génération de l'initramfs, et d'une image ISO</font></h3> 2.471 +<p> 2.472 +Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' 2.473 +contenu dans SliTaz tools. Ou vous pouvez créer un nouvelle 2.474 +image initramfs, et la copier dans /boot de la racine de cd-rom 2.475 +(rootcd), et pour finir créer un image ISO avec genisoimage: 2.476 +</p> 2.477 +<pre> 2.478 + # cd $fs 2.479 + # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz 2.480 + # cd .. 2.481 + # cp rootfs.gz rootcd/boot 2.482 + # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \ 2.483 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 2.484 + -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd 2.485 +</pre> 2.486 +<h4>Suite</h4> 2.487 +<p> 2.488 +Le prochain chapitre du Cookbook déccript l'installation des 2.489 +<a href="locale.html">locale pour le français</a> (Locale & i18n). 2.490 +</p> 2.491 + 2.492 + 2.493 +<!-- End of content --> 2.494 +</div> 2.495 + 2.496 +<!-- Footer. --> 2.497 +<div id="footer"> 2.498 + <div class="footer-right"></div> 2.499 + <a href="#top">Haut de la page</a> | 2.500 + <a href="index.html">Table des matières</a> 2.501 +</div> 2.502 + 2.503 +<div id="copy"> 2.504 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 2.505 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 2.506 + Documentation publiées sous 2.507 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 2.508 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 2.509 +</div> 2.510 + 2.511 +</body> 2.512 +</html>
3.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 3.2 +++ b/doc/cookbook/base-system.html Sat Mar 29 12:01:05 2008 +0100 3.3 @@ -0,0 +1,807 @@ 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 Cookbook - Base system - Créer la base du LiveCD</title> 3.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 3.10 + <meta name="description" content="SliTaz BusyBox création system gnu linux fonctionnant en RAM howto Documentation du projet SliTaz GNU/Linux création system gnu linux fonctionnant en RAM" /> 3.11 + <meta name="expires" content="never" /> 3.12 + <meta name="modified" content="2007-12-24 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="index.html#intro">Introduction</a> | 3.25 + <a href="index.html">Table des matières</a> | 3.26 + <a href="base-apps.html">Base apps</a> 3.27 +</div> 3.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 3.29 +</div> 3.30 + 3.31 +<!-- Content. --> 3.32 +<div id="content"> 3.33 +<div class="content-right"></div> 3.34 + 3.35 + 3.36 +<h2><font color="#DF8F06">Système de base</font></h2> 3.37 +<p> 3.38 +Construire une distro SliTaz GNU/Linux utilisant Busybox et fonctionnant en RAM. 3.39 +</p> 3.40 +<ul> 3.41 + <li><a href="#about">A propos de ce document.</a></li> 3.42 + <li><a href="#src">Wget src.</a></li> 3.43 + <li><a href="#prepa">Désarchiver et préparer le noyau Linux.</a></li> 3.44 + <li><a href="#rootfs">Création de la racine du système</a>, the root 3.45 + file System (rootfs).</li> 3.46 + <li><a href="#config">Configurer sa box.</a></li> 3.47 + <li><a href="#initramfs">Génération de l'initramfs</a>, archive cpio compressée.</li> 3.48 + <li><a href="#rootcd">Construction de la racine du cdrom</a> (rootcd), et 3.49 + des fichiers de config de Syslinux.</li> 3.50 + <li><a href="#mkiso">Créer un image ISO avec genisoimage ou mkisofs.</a></li> 3.51 + <li><a href="#testiso">Craver ou tester l'ISO avec Qemu.</a></li> 3.52 +</ul> 3.53 +<a name="about"></a> 3.54 +<h3><font color="#6c0023">A propos</font></h3> 3.55 +<p> 3.56 +Ce document décrit la construction de la base de SliTaz, pour cela nous 3.57 +utilisons: un noyau Linux, BusyBox, et Syslinux pour booter le système. 3.58 +Slitaz utilise une archive initramfs décompressée en RAM par le 3.59 +kernel au démarrage du système. Nous allons créer la box, pour qu'elle tienne 3.60 +dans un système de fichier racine de 3 à 4 Mb, en utilisant 'strip' sur 3.61 +les bibliothèques et les binaires, pour gagner de la place. 3.62 +</p> 3.63 +<p> 3.64 +Les scripts et les fichiers de configuration sont crées avec GNU nano, il faut 3.65 +utiliser la combinaison de touches <Ctrl+X> pour enregistrer et quitter. 3.66 +Mais vous pouvez biensûr, utiliser votre éditeur de texte préféré à la place. 3.67 +</p> 3.68 +<p> 3.69 +Ce document est inspiré d'un howto trouvé dans l'archive de BusyBox. 3.70 +Qui est lui-même basé sur un papier présenté par Erik Andersen 3.71 +à la conférence Embedded Systems en 2001. 3.72 +</p> 3.73 +<a name="src"></a> 3.74 +<h3><font color="#6c0023">Wget src</font></h3> 3.75 +<p> 3.76 +Création d'un répertoire src pour le téléchargement et 3.77 +la compilation: 3.78 +</p> 3.79 +<pre> 3.80 + # mkdir -p src 3.81 + # cd src 3.82 +</pre> 3.83 +<ul> 3.84 + <li>Linux Kernel 2.6.20 3.85 + (<a href="http://www.kernel.org/">http://www.kernel.org/</a>). 3.86 + <pre># wget ftp://ftp.kernel.org/pub/linux/kernel/v2.6/linux-2.6.20.tar.bz2</pre> 3.87 + </li> 3.88 + <li>Busybox 1.2.2 3.89 + (<a href="http://www.busybox.net/">http://www.busybox.net/</a>). 3.90 + <pre># wget http://www.busybox.net/downloads/busybox-1.2.2.tar.bz2</pre> 3.91 + </li> 3.92 + <li>Syslinux 3.35 3.93 + (<a href="http://syslinux.zytor.com/">http://syslinux.zytor.com/</a>). 3.94 + <pre># wget ftp://ftp.kernel.org/pub/linux/boot/syslinux/syslinux-3.35.tar.gz</pre> 3.95 + </li> 3.96 + <li>SliTaz tools 1.1 3.97 + Télécharger SliTaz tools, détarrer, sauver l'archive dans src/, et c'est tout : 3.98 + <pre> 3.99 + # wget http://download.tuxfamily.org/slitaz/sources/tools/slitaz-tools-1.1.tar.gz 3.100 + # tar xzf slitaz-tools-1.1.tar.gz</pre> 3.101 + </li> 3.102 +</ul> 3.103 +<a name="prepa"></a> 3.104 +<h3><font color="#6c0023">Désarchiver et préparer le noyau Linux</font></h3> 3.105 +<p> 3.106 +Nous allons commencer par compiler un noyau Linux, ce qui peut prendre un 3.107 +peu de temps. 3.108 +</p> 3.109 +<h4>Noyau Linux</h4> 3.110 +<p> 3.111 +Votre kernel doit supporter le système de fichier intramfs, sinon le 3.112 +cd-rom ne pourra démarrer. Vous pouvez aussi installer les modules dans 3.113 +un répertoire donné afin de ne pas toucher au système hôte. La configuration 3.114 +des sources du noyau Linux se fait avec <code>make menuconfig</code>, en 3.115 +ncurser ou graphiquement avec <code>make gconfig</code> ou, 3.116 +<code>make xconfig</code>. Pour cela il faut que les paquets de développements 3.117 +GTK et/ou QT soient installés. Vous trouverez dans 3.118 +<a href="http://www.slitaz.org/get/tools.html">SliTaz tools</a> les 3.119 +Makefiles de divers noyau 2.6.xx. 3.120 +</p> 3.121 +<p> 3.122 +Une fonctionnalité des noyaux 2.6 est que si nous lançons make menuconfig, 3.123 +xconfig, ou config, pour la première fois, le menu de configuration affiché 3.124 +est basé sur la configuration de notre noyau actuel. 3.125 +</p> 3.126 +<p> 3.127 +Les options choisies dépendent de vos besoins, sachez que vous pouvez installer 3.128 +module-init-tools pour prendre en charge les modules compressés. Pour un système 3.129 +minimum vous pouvez ne choisir que les options vitales. 3.130 +</p> 3.131 +<p> 3.132 +Nous commençons par un <code>cd</code> dans les sources, <code>mrproper</code> 3.133 +pour mettre un peu d'ordre, puis on lance une interface de configuration, 3.134 +<code>gconfig</code>, <code>xconfig</code>, <code>menuconfig</code>, ou 3.135 +<code>oldconfig</code>: 3.136 +</p> 3.137 +<pre> 3.138 + # tar xjf linux-2.6.20.tar.bz2 3.139 + # cd linux-2.6.20 3.140 + # make mrproper 3.141 + # cp ../slitaz-tools-1.1/Makefiles/linux-2.6.20-slitaz.config .config 3.142 + # make oldconfig 3.143 + (# make menuconfig) 3.144 + # make bzImage 3.145 + # make modules 3.146 + # make INSTALL_MOD_PATH=$PWD/_pkg modules_install 3.147 + # cd .. 3.148 +</pre> 3.149 +<p> 3.150 +Si vous désirez plus d'info sur la compilation du noyau, référez-vous aux 3.151 +pages de manuels. A noter que vous pouvez installer ce noyau et 3.152 +redémarrer dessus, vous compilerez la suite avec votre propre noyau. 3.153 +</p> 3.154 +<a name="rootfs"></a> 3.155 +<h3><font color="#6c0023">Création de la racine du sytème (rootfs)</font></h3> 3.156 +<p> 3.157 +La prochaine étape créera un système de fichier racine nommé 'rootfs', 3.158 +pour Root File System, dans l'espace de travail SliTaz. 3.159 +</p> 3.160 +<pre> 3.161 + # mkdir ../rootfs 3.162 +</pre> 3.163 +<h4>Install BusyBox</h4> 3.164 +<p> 3.165 +BusyBox (<a href="http://www.busybox.net/">www.busybox.net</a>) est un 3.166 +exécutable unique qui propose des versions allégées des principaux outils 3.167 +indispensables pour utiliser un noyau Linux. Il est principalement destiné 3.168 +à l'embarqué et permet de presque tout faire. C'est un shell proposant les 3.169 +commandes de coreutils et des démons système. Il y a même un serveur web, et 3.170 +un client/serveur DHCP (udhcpc). 3.171 +</p> 3.172 +<pre> 3.173 + # tar xjf busybox-1.2.2.tar.bz2 3.174 +</pre> 3.175 +<p> 3.176 +Pour configurer et compiler. N'oubliez pas les options dumpkmap, init, etc, 3.177 +pour vous aider, vous trouverez le Makefile de BusyBox dans SliTaz tools. Le 3.178 +make install créera un répertoire _install dans le répertoire courant: 3.179 +</p> 3.180 +<pre> 3.181 + # cd busybox-1.2.2 3.182 + # cp ../slitaz-tools-1.1/Makefiles/busybox-1.2.2.config .config 3.183 + # make oldconfig 3.184 + (# make menuconfig) 3.185 + # make 3.186 + # make install 3.187 + # chmod 4755 _install/bin/busybox 3.188 +</pre> 3.189 +<p> 3.190 +Copier les fichiers de la compilation de Busybox, se trouvant dans le 3.191 +répertoire _install, dans le système de fichiers racine (rootfs): 3.192 +</p> 3.193 +<pre> 3.194 + # cp -a _install/* ../../rootfs 3.195 +</pre> 3.196 +<p> 3.197 +Le lien linuxrc pointant vers bin/busybox, les dossiers /bin, /lib, et /sbin, 3.198 +on été ajoué au répertoire /rootfs. On peut le vérifier avec ls. Il se peut que 3.199 +le lien linuxrc ne soit pas présent si vous n'avez pas séléctionner l'option du 3.200 +support initrd dans BusyBox. Nous effaçons le lien linuxrc, et créons un lien 3.201 +pour init qui pointe sur bin/busybox: 3.202 +</p> 3.203 +<pre> 3.204 + # cd ../../rootfs 3.205 + # ls -CF 3.206 + bin/ linuxrc@ sbin/ usr/ 3.207 + 3.208 + # rm linuxrc 3.209 + # ln -s bin/busybox init 3.210 +</pre> 3.211 +<h4>ldd sur BusyBox</h4> 3.212 +<p> 3.213 +La commande <code>ldd</code> permet de connaître les bibliothèques utilisées par 3.214 +un programme. Les bibliothèques utilisées par Busybox peuvent différer sen fonction 3.215 +du système hôte utilisé, sur Debian par exemple vous devrez copier les bibliothèques 3.216 +situées dans /lib/tls. Les commandes ci-dessous sont donnée avec l'option '-v' pour 3.217 +verbose ou volubile. Pour éliminer les symboles des binaires exécutable et des 3.218 +bibliothèques partagées qui servent au débuggage nous utilison strip. A noter 3.219 +que vous pourriez aussi utiliser les bibliothèques uClibc ou mklibs : 3.220 +</p> 3.221 +<pre> 3.222 + # mkdir lib 3.223 +</pre> 3.224 +<p> 3.225 +Exemple sur SliTaz ou autres: 3.226 +</p> 3.227 +<pre> 3.228 + # cp /lib/{libcrypt.so.1,libm.so.6,libc.so.6} lib 3.229 + # cp /lib/ld-linux.so.2 lib 3.230 +</pre> 3.231 +<p> 3.232 +Exemple sur Debian Etch: 3.233 +</p> 3.234 +<pre> 3.235 + # cp /lib/tls/{libcrypt.so.1,libm.so.6,libc.so.6} lib 3.236 + # cp /lib/ld-linux.so.2 lib 3.237 +</pre> 3.238 +<p> 3.239 +Nettoyage de bibliothèques avec <code>strip</code>: 3.240 +</p> 3.241 +<pre> 3.242 + # strip -v lib/* 3.243 +</pre> 3.244 +<h4>Linux tree et config</h4> 3.245 +<p> 3.246 +Création de quelques répertoires pour créer une arborrescence Linux classique pour 3.247 +SliTaz. /dev pour les devices, /etc, /home, /usr, /proc, /root, et compagnie. 3.248 +Pour en savoir plus sur la hierarchie d'un système de fichiers, et son contenu, il 3.249 +existe le Filesystem Hierarchy Standard, disponible en plusieurs formats sur 3.250 +<a href="http://www.pathname.com/fhs/">www.pathname.com/fhs/</a>. 3.251 +</p> 3.252 +<p> 3.253 +Vous êtes libre de créer votre propre arbre. Dans les systèmes unix traditionnels, 3.254 +/usr contient généralement des fichiers provenant de la distribution, /dev contient 3.255 +les périphériques (devices), /etc contient les fichiers de configuration, /lib des 3.256 +bibliothèques, /home pour la maison des utilisateurs, et /var des données variables. 3.257 +A noter que nous ne créons pas /lib, /bin, /sbin, ils seront crée lors de 3.258 +l'installation de BusyBox: 3.259 +</p> 3.260 +<pre> 3.261 + # mkdir -p dev etc root home proc media mnt sys tmp var 3.262 + # mkdir -p usr/{lib,local,games,share} \ 3.263 + var/{cache,lib,lock,log,games,run,spool} \ 3.264 + media/{cdrom,flash,usbdisk} 3.265 +</pre> 3.266 +<p> 3.267 +Changement des permissions sur le répertoire /tmp: 3.268 +</p> 3.269 +<pre> 3.270 + # chmod 1777 tmp 3.271 +</pre> 3.272 +<p> 3.273 +Configuration de base de la glibc, /etc/ld.so.conf et /etc/rpc ne sont pas 3.274 +indispensable pour un micro système: 3.275 +</p> 3.276 +<pre> 3.277 + # touch etc/ld.so.conf 3.278 + # cp /etc/rpc etc 3.279 +</pre> 3.280 +<h4>Créer le devices dans /dev</h4> 3.281 +<p> 3.282 +Ceci peut se faire avec le script 'mkdevs.sh' trouvé dans busybox. 3.283 +ou avec notre script 'mktazdevs.sh' contenu dans SliTaz tools. Si vous 3.284 +voulez des détails, lisez les scripts. Si vous utilisé la version BusyBox, 3.285 +il faut encore créer le réperoire pts: 3.286 +</p> 3.287 +<pre> 3.288 + # cp ../src/slitaz-tools-1.1/utils/mktazdevs.sh bin 3.289 + # ./bin/mktazdevs.sh dev 3.290 +ou: 3.291 + # cp ../src/busybox-1.2.2/examples/bootfloppy/mkdevs.sh bin 3.292 + # ./bin/mkdevs.sh dev 3.293 + # mkdir -p dev/{pts,input,shm,net,usb} 3.294 +</pre> 3.295 +<p> 3.296 +A noter que nous démarrons mdev -s avec le script rcS, pour créer 3.297 +les devices dynamiquement lors du boot. 3.298 +</p> 3.299 +<h4>Support de la résolution des noms d'hôtes (DNS)</h4> 3.300 +<p> 3.301 +Copie des bibliothèques libnss_* du système hôte, dans notre 3.302 +système SliTaz, ces bibliothèques sont utilisées pour la résolution 3.303 +des noms et nettoyage avec strip: 3.304 +</p> 3.305 +<pre> 3.306 + # cp /lib/{libnss_dns.so.2,libnss_files.so.2} lib 3.307 + # cp /lib/libresolv.so.2 lib 3.308 + # strip -v lib/*.so* 3.309 +</pre> 3.310 +<a name="config"></a> 3.311 +<h3><font color="#6c0023">Configuration de votre Box</font></h3> 3.312 +<p> 3.313 +Créer les fichiers nécessaires dans /etc. Pour plus d'infos, il faut 3.314 +simplement regarder le contenu des fichiers. Nous commençons par créer 3.315 +quelques fichiers utiles au fonctionnement de base du sytème: 3.316 +</p> 3.317 +<h4>Réseau</h4> 3.318 +<p> 3.319 +Création des fichiers de base utilisés pour configurer le réseau: 3.320 +</p> 3.321 +<pre> 3.322 + # echo "127.0.0.1 localhost" > etc/hosts 3.323 + # echo "localnet 127.0.0.1" > etc/networks 3.324 + # echo "slitaz" > etc/hostname 3.325 + # echo "order hosts,bind" > etc/host.conf 3.326 + # echo "multi on" >> etc/host.conf 3.327 +</pre> 3.328 +<h4>/etc/nsswitch.conf</h4> 3.329 +<p> 3.330 +Fichier de configuration utilisé pour la résolution des noms: 3.331 +</p> 3.332 +<pre> 3.333 + # nano etc/nsswitch.conf 3.334 +</pre> 3.335 +<pre class="script"> 3.336 +# /etc/nsswitch.conf: GNU Name Service Switch config. 3.337 +# 3.338 + 3.339 +passwd: files 3.340 +group: files 3.341 +shadow: files 3.342 + 3.343 +hosts: files dns 3.344 +networks: files 3.345 + 3.346 +</pre> 3.347 +<h4>/etc/securetty</h4> 3.348 +<p> 3.349 +Le fichier /etc/securetty, liste les terminaux sur lesquels root peut se 3.350 +connecter: 3.351 +</p> 3.352 +<pre> 3.353 + # nano etc/securetty 3.354 +</pre> 3.355 +<pre class="script"> 3.356 +# /etc/securetty: List of terminals on which root is allowed to login. 3.357 +# 3.358 +console 3.359 + 3.360 +# For people with serial port consoles 3.361 +ttyS0 3.362 + 3.363 +# Standard consoles 3.364 +tty1 3.365 +tty2 3.366 +tty3 3.367 +tty4 3.368 +tty5 3.369 +tty6 3.370 +tty7 3.371 + 3.372 +</pre> 3.373 +<h4>/etc/shells</h4> 3.374 +<p> 3.375 +Le fichier /etc/shells, liste les shells de connection valides. Ce fichier est 3.376 +entre autre utilisé par le serveur SSH dropbear: 3.377 +</p> 3.378 +<pre> 3.379 + # nano etc/shells 3.380 +</pre> 3.381 +<pre class="script"> 3.382 +# /etc/shells: valid login shells. 3.383 +/bin/sh 3.384 +/bin/ash 3.385 +/bin/hush 3.386 + 3.387 +</pre> 3.388 +<h4>/etc/issue et /etc/motd</h4> 3.389 +<p> 3.390 +Création des fichiers /etc/issue affiché à la fin du boot, et du message du 3.391 +jour affiché après le login: 3.392 +</p> 3.393 +<pre> 3.394 + # echo "SliTaz GNU/Linux 1.0 Kernel \r \l" > etc/issue 3.395 + # echo "" >> etc/issue 3.396 + # nano etc/motd 3.397 +</pre> 3.398 +<pre class="script"> 3.399 + 3.400 + (°- { Get documentation in: /usr/share/doc. 3.401 + //\ Use: 'less' or 'more' to read files, 'su' to be root. } 3.402 + v_/_ 3.403 + 3.404 +SliTaz is distributed in the hope that it will be useful, but 3.405 +with ABSOLUTELY NO WARRANTY. 3.406 + 3.407 +</pre> 3.408 +<h4>/etc/busybox.conf</h4> 3.409 +<p> 3.410 +Ce fichier est le fichiers de configuration de BusyBox, il permet 3.411 +de configurer, entre autre des droits sur les applications Busybox. 3.412 +Pour plus d'informations vous pouvez lire le document texte: 3.413 +<a href="http://www.slitaz.org/doc/handbook/security.html">sécurité du système</a> 3.414 +du Handbook. Fichier busybox.conf : 3.415 +</p> 3.416 +<pre> 3.417 + # nano etc/busybox.conf 3.418 +</pre> 3.419 +<pre class="script"> 3.420 +# /etc/busybox.conf: SliTaz GNU/linux Busybox configuration. 3.421 +# 3.422 + 3.423 +[SUID] 3.424 +# Allow command to be run by anyone. 3.425 +su = ssx root.root 3.426 +passwd = ssx root.root 3.427 +loadkmap = ssx root.root 3.428 +mount = ssx root.root 3.429 +reboot = ssx root.root 3.430 +halt = ssx root.root 3.431 + 3.432 +</pre> 3.433 +<p> 3.434 +Pour plus de sécurité, on change les permission sur ce fichier: 3.435 +</p> 3.436 +<pre> 3.437 + # chmod 600 etc/busybox.conf 3.438 +</pre> 3.439 +<h4>/etc/inittab</h4> 3.440 +<p> 3.441 +Fichier de configuration d'init minimal. Il permet d'avoir d'avoir une 3.442 +console root sans passer par le login, et une console activable sur tty2. 3.443 +</p> 3.444 +<pre> 3.445 + # nano etc/inittab 3.446 +</pre> 3.447 +<pre class="script"> 3.448 +# /etc/inittab: init configuration for SliTaz GNU/Linux. 3.449 + 3.450 +::sysinit:/etc/init.d/rcS 3.451 +::respawn:-/bin/sh 3.452 +tty2::askfirst:-/bin/sh 3.453 +::ctrlaltdel:/bin/umount -a -r 3.454 +::ctrlaltdel:/sbin/reboot 3.455 + 3.456 +</pre> 3.457 +<p> 3.458 +Vous trouverez aussi un large exemple d'un fichier inittab dans 3.459 +l'archive de BusyBox. 3.460 +</p> 3.461 +<h4>/etc/profile</h4> 3.462 +<p> 3.463 +Ce fichier est lu lors de chaque login, et affecte tous les utilisateurs. 3.464 +Il faut utiliser le fichier ~/.profile pour la config propre à chaque user. 3.465 +</p> 3.466 +<pre> 3.467 + # nano etc/profile 3.468 +</pre> 3.469 +<pre class="script"> 3.470 +# /etc/profile: system-wide .profile file for the Bourne shells 3.471 + 3.472 +PATH="/usr/sbin:/usr/bin:/sbin:/bin:/usr/games" 3.473 +LD_LIBRARY_PATH="/usr/lib:/lib" 3.474 + 3.475 +if [ "`id -u`" -eq 0 ]; then 3.476 + PS1='\e[1m\u@\h:\w\#\e[m ' 3.477 +else 3.478 + PS1='\e[1m\u@\h:\w\$\e[m ' 3.479 +fi 3.480 + 3.481 +DISPLAY=:0.0 3.482 + 3.483 +export PATH LD_LIBRARY_PATH PS1 DISPLAY ignoreeof 3.484 +umask 022 3.485 + 3.486 +</pre> 3.487 +<h4>Utilisateurs, groupes, et mots de passes</h4> 3.488 +<p> 3.489 +Création des fichiers de configuration des utilisateurs, des groupes, 3.490 +des mots de passes situé dans: etc/{passwd,shadow,group,gshadow}, 3.491 +et ajustage des permissions: 3.492 +</p> 3.493 +<pre> 3.494 + # echo "root:x:0:0:root:/root:/bin/sh" > etc/passwd 3.495 + # echo "root::13525:0:99999:7:::" > etc/shadow 3.496 + # echo "root:x:0:" > etc/group 3.497 + # echo "root:*::" > etc/gshadow 3.498 + # chmod 640 etc/shadow 3.499 + # chmod 640 etc/gshadow 3.500 +</pre> 3.501 +<p> 3.502 +Vous pouvez ajouter d'autres utilisateurs, tel que <a href="hacker.txt">hacker</a> 3.503 +utilisé par le mode liveCD de SliTaz. Vous pouvez aussi configuer un mot de passe pour 3.504 +le super-utilisateur root, avec la commande passwd. Pour ajouter un utilisateur existant 3.505 +dans un groupe existant, vous devez éditer les fichiers /etc/group et /etc/gshadow, car 3.506 +l'applet adduser fourni avec busybox n'offre pas toutes les options fournies par le 3.507 +programme original. 3.508 +</p> 3.509 +<h4>/etc/fstab et /etc/mtab</h4> 3.510 +<p> 3.511 +Liste les systèmes de fchiers à monter: 3.512 +</p> 3.513 +<pre> 3.514 + # nano etc/fstab 3.515 +</pre> 3.516 +<pre class="script"> 3.517 +# /etc/fstab: informations on static file system. 3.518 +# 3.519 +proc /proc proc defaults 0 0 3.520 +sysfs /sys sysfs defaults 0 0 3.521 +devpts /dev/pts devpts defaults 0 0 3.522 +tmpfs /dev/shm tmpfs defaults 0 0 3.523 + 3.524 +</pre> 3.525 +<p> 3.526 +Le fichier /etc/mtab est utilisé entre autre par mkfs*, il liste les partitions montées. 3.527 +Il a besoin de /proc, car c'est un lien sur /proc/mounts: 3.528 +</p> 3.529 +<pre> 3.530 + # chroot . /bin/ash 3.531 + /# ln -s /proc/mounts /etc/mtab 3.532 +</pre> 3.533 +<h4>Clavier</h4> 3.534 +<p> 3.535 +Vous pouvez créer un fichier .kmap spécifique à votre clavier grâce à la 3.536 +commande dumpkmap fournie avec BusyBox. Vous trouverez quelques fichiers kmap 3.537 +dans l'archive <a href="http://www.slitaz.org/get/tools.html">SliTaz tools</a> 3.538 +tel que fr_CH. Pour créer un fichier .kmap (changez fr_CH à votre 3.539 +configuration): 3.540 +</p> 3.541 +<pre> 3.542 + /# mkdir /usr/share/kmap 3.543 + /# /bin/busybox dumpkmap > /usr/share/kmap/fr_CH.kmap 3.544 + /# exit 3.545 +</pre> 3.546 +<p> 3.547 +Une fois ceci fait vous pouvez charger automatiquement votre clavier 3.548 +avec loadkmap dans un script tel que etc/ini.d/rcS, par exemple. 3.549 +</p> 3.550 +<h4>/usr/share/doc</h4> 3.551 +<p> 3.552 +Vous pouvez aussi ajouter divers documents, comme le manuel d'utilisateur 3.553 +de SliTaz, que vous pouvez télécharger sous forme d'archive tar.gz, depuis le 3.554 +site web de SliTaz. 3.555 +</p> 3.556 +<pre> 3.557 + # mkdir -p usr/share/doc 3.558 +</pre> 3.559 +<h4>Installation du script udhcpc</h4> 3.560 +<p> 3.561 +Udhcpc est un client DHCP stable et rapide, fourni avec Busybox, mais 3.562 +ayant un développemnt indépandent. Site web: <a href="http://udhcp.busybox.net/" 3.563 + >http://udhcp.busybox.net/</a>. Vous pouvez utiliser default.script 3.564 +de l'archive BusyBox. Ce script se met dans /usr/share/udhcpc/default.script, 3.565 +mais cela peut être modifié en ligne de commande. Sur SliTaz le client est lancé au boot 3.566 +par le script /etc/init.d/network.sh via le fichier de configuration /etc/network.conf: 3.567 +</p> 3.568 +<pre> 3.569 + # mkdir usr/share/udhcpc 3.570 + # cp ../src/busybox-1.2.2/examples/udhcp/simple.script \ 3.571 + usr/share/udhcpc/default.script 3.572 + # chmod +x usr/share/udhcpc/default.script 3.573 +</pre> 3.574 +<h4>/etc/init.d/rcS</h4> 3.575 +<p> 3.576 +Pour finir cette première mouture il faut encore créer le script d'initialisation 3.577 +/etc/init.d/rcS pour monter les systèmes de fichiers, et lancer quelques commandes. 3.578 +Pour plus d'information vous pouvez jeter un coup d'oeil au chapitre sur 3.579 +<a href="boot-scripts.html">les scripts de démarrage et d'arrêt</a>. Vous pouvez 3.580 +changer la valeur de la variable KMAP= pour que le bon clavier soit chargé: 3.581 +</p> 3.582 +<pre> 3.583 + # mkdir etc/init.d 3.584 + # nano etc/init.d/rcS 3.585 +</pre> 3.586 +<pre class="script"> 3.587 +#! /bin/sh 3.588 +# /etc/init.d/rcS: rcS initial script. 3.589 +# 3.590 + 3.591 +KMAP=fr_CH 3.592 + 3.593 +echo "Processing /etc/init.d/rcS... " 3.594 + 3.595 +/bin/mount proc 3.596 +/bin/mount -a 3.597 +/bin/hostname -F /etc/hostname 3.598 +/sbin/ifconfig lo 127.0.0.1 up 3.599 +/sbin/loadkmap < /usr/share/kmap/$KMAP.kmap 3.600 + 3.601 + 3.602 +</pre> 3.603 +<pre> 3.604 + # chmod +x etc/init.d/rcS 3.605 +</pre> 3.606 +<h4>Note</h4> 3.607 +<p> 3.608 +A noter que vous pouvez encore installer 3.609 +<a href="http://www.slitaz.org/get/tazpkg.html">tazpkg</a> (10 Ko). 3.610 +C'est un gestionnaire de paquets que nous avons créé, vous touverez toutes les 3.611 +infos d'install dans l'archive source. Vous pouvez aussi installer divers 3.612 +fichiers depuis SliTaz tools, tel les lisences. 3.613 +</p> 3.614 +<a name="initramfs"></a> 3.615 +<h3><font color="#6c0023">Build a initramfs cpio archive</font></h3> 3.616 +<p> 3.617 +L'initramfs est une archive <code>cpio</code> du système générée depuis la racine, 3.618 +elle est décompressée en RAM par le noyau Linux lors du démarrage (boot), pour créer 3.619 +le système de fichiers en mémoire vive. Pour générer une archive initramfs, nous 3.620 +nous plaçons dans le répertoire racine du système de fichiers (rootfs), nous fesons 3.621 +une recherche avec <code>find</code>, et nous utilisons des pipes <code>|</code>. 3.622 +Ensuite nous créons une archive<code>cpio</code> gzipée avec <code>gzip</code>, 3.623 +que nous plaçons dans le répertoire de travail. 3.624 +</p> 3.625 +<p> 3.626 +L'initramfs de SliTaz se nomme <strong>rootfs.gz</strong>, c'est le nom du 3.627 +système racine, mais avec l'extension <code>.gz</code>. Si vous changé 3.628 +le nom, il faudrat le spécifier dans le fichier isolinux.cfg pour isolinux, 3.629 +ou menu.lst pour GRUB. 3.630 +</p> 3.631 +<p> 3.632 +Génération de l'initramfs: 3.633 +</p> 3.634 +<pre> 3.635 + # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz 3.636 +</pre> 3.637 +<p> 3.638 +Vous devriez avoir un fichier rootfs.gz d'environ 1 à 2 Mb dans le 3.639 +répertoire de travail de SliTaz. 3.640 +</p> 3.641 +<p> 3.642 +Pour une nouvelle image, lors de modif dans rootfs, il suffit de copier 3.643 +la nouvelle archive rootfs.gz dans rootcd/boot, et de créer une nouvelle 3.644 +image ISO avec <code>genisoimage</code> ou <code>mkisofs</code>. Pour cela vous 3.645 +pouvez utiliser <strong>mktaziso</strong> se trouvant dans SliTaz tools. Ce script 3.646 +se chargera de vérifier si les répertoires sont bien présents, de générer une 3.647 +nouvelle archive cpio compressée et de créer une nouvelle image ISO bootable. 3.648 +</p> 3.649 +<a name="rootcd"></a> 3.650 +<h3><font color="#6c0023">Make rootcd files</font></h3> 3.651 +<p> 3.652 +Les étapes suivantes vont vous permettre de créer la racine du cd-rom 3.653 +bootable. Nous commençons par créer le répertoire rootcd, boot, et isolinux 3.654 +pour les fichiers déstinés au cd-rom: 3.655 +</p> 3.656 +<pre> 3.657 + # cd .. 3.658 + # mkdir -p rootcd/boot/isolinux 3.659 +</pre> 3.660 +<p> 3.661 +En option vous pouvez créer d'autres repértoires pour y mettre divers données, 3.662 +tel que des documents html ou des paquets. 3.663 +</p> 3.664 +<a name="linux"></a> 3.665 +<h4>Copier le kernel</h4> 3.666 +<p> 3.667 +Il suffit de copier le noyau préalablement compilé, dans rootcd/boot: 3.668 +</p> 3.669 +<pre> 3.670 + # cp src/linux-2.6.20/arch/i386/boot/bzImage rootcd/boot 3.671 +</pre> 3.672 +<h4>Copie de l'initramfs dans rootcd/boot</h4> 3.673 +<p> 3.674 +Il ne faut pas oublier de générer une nouvelle archive initramfs 3.675 +lors de modification dans le rootfs (root file system). 3.676 +</p> 3.677 +<pre> 3.678 + # cp rootfs.gz rootcd/boot 3.679 +</pre> 3.680 +<h4>Install du bootloader isolinux</h4> 3.681 +<p> 3.682 +Le bootloader isolinux, il suffit de copier isolinux.bin depuis l'archive 3.683 +des source de Syslinux: 3.684 +</p> 3.685 +<pre> 3.686 + # cd src 3.687 + # tar xzf syslinux-3.35.tar.gz 3.688 + # cp syslinux-3.35/isolinux.bin ../rootcd/boot/isolinux 3.689 + # cd .. 3.690 +</pre> 3.691 +<h4>isolinux.cfg - Configuration d'isolinux</h4> 3.692 +<p> 3.693 +Voici un exemple du fichier isolinux.cfg qui devrait bien fonctionner. Vous 3.694 +pouvez le modifier à volonté: 3.695 +</p> 3.696 +<pre> 3.697 + # nano rootcd/boot/isolinux/isolinux.cfg 3.698 +</pre> 3.699 +<pre class="script"> 3.700 +display display.txt 3.701 +default slitaz 3.702 +label slitaz 3.703 + kernel /boot/bzImage 3.704 + append initrd=/boot/rootfs.gz rw root=/dev/null vga=788 3.705 +implicit 0 3.706 +prompt 1 3.707 +timeout 80 3.708 + 3.709 +</pre> 3.710 +<p> 3.711 +Voici quelques changements que vous pourriez faire dans isolinux.cfg: 3.712 +</p> 3.713 +<ul> 3.714 + <li>La valeur timeout correspond au nombre de secondes à attendre 3.715 + avantde booter. Vous pouvez la mettre à 0, ou hôter la ligne pour 3.716 + démarrer instantanément, ou choisir un temps d'attente plus long tel 3.717 + que 10 s.</li> 3.718 + <li>prompt peut être mis à 0 pour désactiver le 'boot:' prompt.</li> 3.719 + <li>Vous pouvez encore ajouter plus de lignes pour afficher le contenu 3.720 + de plusieurs fichiers textes lorsque l'utilisateur appuie sur F1, F2, 3.721 + F3, etc.</li> 3.722 +</ul> 3.723 +<h4>display.txt</h4> 3.724 +<p> 3.725 +Un petit message de bienvenue, propulsé par isolinux, à vous de modifier 3.726 +ce fichier comme bon vous semble: 3.727 +</p> 3.728 +<pre> 3.729 + # nano rootcd/boot/isolinux/display.txt 3.730 +</pre> 3.731 +<pre class="script"> 3.732 +/* _\|/_ 3.733 + (o o) 3.734 + +----oOO-{_}-OOo---------------------------------------------------+ 3.735 + ____ _ _ _____ 3.736 + / ___|| (_)_ _|_ _ ____ 3.737 + \___ \| | | | |/ _` |_ / 3.738 + ___) | | | | | (_| |/ / 3.739 + |____/|_|_| |_|\__,_/___| 3.740 + 3.741 + SliTaz GNU/Linux - Temporary Autonomous Zone 3.742 + 3.743 + <ENTER> to boot. 3.744 + 3.745 + */ 3.746 +</pre> 3.747 +<a name="mkiso"></a> 3.748 +<h3><font color="#6c0023">Créer un image ISO avec genisoimage ou mkisofs</font></h3> 3.749 +<pre> 3.750 + # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \ 3.751 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 3.752 + -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd 3.753 +</pre> 3.754 +<p> 3.755 +Pour chaque nouvelle modification dans le système de fichier racine 3.756 +de la box, vous devez créer une nouvelle image ISO. 3.757 +</p> 3.758 +<p> 3.759 +Vous pouvez créer un petit script qui se chargera de générer une nouvelle 3.760 +archive cpio compressée et une nouvelle image ISO, ou utiliser mktaziso se 3.761 +trouvant dans SliTaz tools. A noter que vous pouvez aussi utiliser GRUB pour 3.762 +booter la box. 3.763 +</p> 3.764 +<a name="testiso"></a> 3.765 +<h3><font color="#6c0023">Craver ou tester l'ISO avec Qemu</font></h3> 3.766 +<p> 3.767 +Vous pouvez graver l'image ISO avec Graveman, k3b, ou wodim, et booter 3.768 +dessus. Voisi un exemple de commande de gravure avec wodim (valable aussi pour 3.769 +cdrecord), avec un kernel 2.6.*: 3.770 +</p> 3.771 +<pre> 3.772 +# wodim -v -speed=24 -data slitaz-cooking.iso 3.773 +</pre> 3.774 +<h4>Qemu</h4> 3.775 +<p> 3.776 +A noter que vous pouvez tester l'image ISO avec le logiciel d'émulation Qemu 3.777 +(Sur Debian # aptitude install qemu). Pour émuler l'image ISO fraîchement crée, 3.778 +il suffit de taper : 3.779 +</p> 3.780 +<pre> 3.781 +# qemu -cdrom slitaz-cooking.iso 3.782 +</pre> 3.783 +<h4>Suite</h4> 3.784 +<p> 3.785 +La suite logique du Cookbook est le chapitre <a href="base-apps.html" 3.786 +>Base apps</a> fournissant toutes les instructions pour installer et 3.787 +configurer les applications de base distribuée par SliTaz. 3.788 +</p> 3.789 + 3.790 + 3.791 +<!-- End of content --> 3.792 +</div> 3.793 + 3.794 +<!-- Footer. --> 3.795 +<div id="footer"> 3.796 + <div class="footer-right"></div> 3.797 + <a href="#top">Haut de la page</a> | 3.798 + <a href="index.html">Table des matières</a> 3.799 +</div> 3.800 + 3.801 +<div id="copy"> 3.802 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 3.803 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 3.804 + Documentation publiées sous 3.805 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 3.806 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 3.807 +</div> 3.808 + 3.809 +</body> 3.810 +</html>
4.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 4.2 +++ b/doc/cookbook/book.css Sat Mar 29 12:01:05 2008 +0100 4.3 @@ -0,0 +1,170 @@ 4.4 +/* 4.5 + CSS style for SliTaz GNU/Linux *book. 4.6 + Pankso 2007 - www.slitaz.org 4.7 +*/ 4.8 + 4.9 +body { 4.10 + font: 13px sans-serif, vernada, arial; 4.11 + background: #222222; 4.12 + margin: 0; 4.13 + padding-bottom: 100%; 4.14 +} 4.15 + 4.16 +#header { 4.17 + background: #BFB06B url(images/css/header.png) repeat-x top; 4.18 + color: black; 4.19 + height: 50px; 4.20 + border-top: 1px solid black; 4.21 + border-bottom: 1px solid black; 4.22 +} 4.23 +#quicknav { 4.24 + margin-right: 6px; 4.25 + text-align: right; 4.26 + font-size: 12px; 4.27 + } 4.28 +#quicknav { 4.29 + margin-right: 6px; 4.30 +} 4.31 + 4.32 +#quicknav a { 4.33 + background: inherit; 4.34 + color: #222222; 4.35 +} 4.36 + 4.37 +#quicknav a:hover { 4.38 + background: inherit; 4.39 + color: #EDEDED; 4.40 +} 4.41 + 4.42 +/* content. */ 4.43 + 4.44 +#content { 4.45 + background: white url(images/css/content-tl.png) no-repeat top left; 4.46 + color: black; 4.47 + padding: 20px; 4.48 + margin: 30px 50px 0px 50px; 4.49 + width: auto; 4.50 + text-align: justify; 4.51 +} 4.52 + 4.53 +#content li { 4.54 + line-height: 1.5em; 4.55 + text-align: left; 4.56 +} 4.57 + 4.58 +/* Footer. */ 4.59 + 4.60 +#footer { 4.61 + font-size: 11px; 4.62 + font-weight: bold; 4.63 + background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left; 4.64 + color: black; 4.65 + height: 20px; 4.66 + padding: 6px 0px 0px 10px; 4.67 + margin: 0px 50px 0px 50px; 4.68 + width: auto; 4.69 + text-align: center ; 4.70 +} 4.71 + 4.72 +#footer a { 4.73 + text-decoration: none; 4.74 + background: #eaeaea; 4.75 + color: #3E1220; 4.76 +} 4.77 + 4.78 +#footer a:hover { 4.79 + background: #eaeaea; 4.80 + color: #DF8F06; 4.81 +} 4.82 + 4.83 +/* Legal informations */ 4.84 + 4.85 +#copy { 4.86 + font-size: 11px ; 4.87 + text-align: center ; 4.88 + background: transparent; 4.89 + color: #a8a8a8; 4.90 + padding-top: 20px; 4.91 +} 4.92 + 4.93 +#copy a { 4.94 + background: inherit; 4.95 + color: #a8a8a8; 4.96 +} 4.97 + 4.98 +#copy a:hover { 4.99 + background: inherit; 4.100 + color: #EDEDED; 4.101 +} 4.102 + 4.103 +/* Div for round corners. */ 4.104 + 4.105 +.content-right, .footer-right { 4.106 + width: 16px; 4.107 + color: white; 4.108 + background-color: #333333; 4.109 +} 4.110 +.content-right { 4.111 + background: url(images/css/content-tr.png) no-repeat top right; 4.112 + height: 16px; 4.113 + right: 50px; 4.114 + top: 82px; 4.115 + position: absolute; 4.116 +} 4.117 + 4.118 +.footer-right { 4.119 + background: url(images/css/footer-br.png) no-repeat bottom right; 4.120 + height: 20px; 4.121 + float: right; 4.122 +} 4.123 + 4.124 +/* General HTML entities for content. */ 4.125 + 4.126 +h1 { 4.127 + margin: 0px 0px 0px 16px; 4.128 +} 4.129 + 4.130 +h2 { 4.131 + margin: 12px 0; 4.132 + color: #484B7C; 4.133 + background: white; 4.134 +} 4.135 + 4.136 +h3 { 4.137 + font-weight: bold; 4.138 + color: #6c0023; 4.139 + background: white; 4.140 +} 4.141 + 4.142 +a { 4.143 + text-decoration: underline; 4.144 +} 4.145 +a:hover { 4.146 + text-decoration: none; 4.147 +} 4.148 + 4.149 +pre { 4.150 + padding: 5px; 4.151 + color: black; 4.152 + background: #e1e0b0; 4.153 +} 4.154 +pre.script { 4.155 + padding: 10px; 4.156 + color: black; 4.157 + background: #e8e8e8; 4.158 + border: 1px inset #333333; 4.159 +} 4.160 + 4.161 +code { 4.162 + font-size: 12px; 4.163 + color: #669900; 4.164 + background: transparent; 4.165 +} 4.166 + 4.167 +li { 4.168 + line-height: 1.4em; 4.169 +} 4.170 + 4.171 +hr { 4.172 + border: 0pt none; 4.173 +}
5.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 5.2 +++ b/doc/cookbook/boot-scripts.html Sat Mar 29 12:01:05 2008 +0100 5.3 @@ -0,0 +1,220 @@ 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 Cookbook - Boot scripts</title> 5.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 5.10 + <meta name="description" content="liTaz GNU/Linux boot scripts démarrage du système initialisation linux kernel services" /> 5.11 + <meta name="expires" content="never" /> 5.12 + <meta name="modified" content="2007-12-24 12: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="locale.html">Locale & i18n</a> | 5.25 + <a href="index.html">Table des matières</a> | 5.26 + <a href="x-window-system.html">X window system</a> 5.27 +</div> 5.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 5.29 +</div> 5.30 + 5.31 +<!-- Content. --> 5.32 +<div id="content"> 5.33 +<div class="content-right"></div> 5.34 + 5.35 + 5.36 +<h2><font color="#DF8F06">Boot scripts</font></h2> 5.37 +<p> 5.38 +Les scripts de démarrage et d'arrêt avec leurs fichiers de configuration. 5.39 +</p> 5.40 + 5.41 +<ul> 5.42 + <li><a href="#intro">SliTaz et son démarrage.</a></li> 5.43 + <li><a href="#init.d">/etc/init.d/*</a> - Répertoire des scripts et démons.</li> 5.44 + <li><a href="#rcS">/etc/init.d/rcS</a> - Script d'initialisation principale.</li> 5.45 + <li><a href="#rc-scripts">Scripts et démons spécifiques</a> - Les scripts 5.46 + et démons ayant une tâche bien particulière.</li> 5.47 + <li><a href="#inittab">/etc/inittab</a> - Fichier de configuration d'init.</li> 5.48 +</ul> 5.49 + 5.50 +<a name="intro"></a> 5.51 +<h3><font color="#6c0023">SliTaz et son démarrage</font></h3> 5.52 +<p> 5.53 +Dans les premières version du livre, les scripts étaient créer à la main avec 5.54 +la commande <code>cat</code>. Avec le temps, les scripts de démarrage et le 5.55 +fichier de configuration principale sont devenu trop gros et sont trop souvent 5.56 +modifiés pour être inclus dans le Cookbook. Tous les scripts et configuration 5.57 +se trouve dans l'archive des outils SliTaz ou le paquet 5.58 +<a href="http://www.slitaz.org/get/tools.html">slitaz-tools</a>. Vous pouvez 5.59 +ouvrir avec un éditeur de texte et les étudier. 5.60 +</p> 5.61 +<p> 5.62 +SliTaz n'utilise pas de niveau d'execution, tout le système est initialisé via 5.63 +un script principale et son fichier de configuration. Ce script lance lui-même 5.64 +quelque petits scripts qui s'occupe de l'internationalisation ou des options 5.65 +passé en ligne de commande au démarrage. 5.66 +</p> 5.67 + 5.68 +<a name="init.d"></a> 5.69 +<h3><font color="#6c0023">/etc/init.d/* - Répertoire des scripts et démons</font></h3> 5.70 +<p> 5.71 +Le réperoire /etc/init.d contient tous les vrais scripts rc, les scripts 5.72 +finnissant par '.sh' sont de simples scripts shell, et les démons, tel 5.73 +que 'dropbear' ou 'lighttpd', sont aussi de scripts mais qui lance un service. 5.74 +Les scripts des démons permettent de démarrer, arrêter, ou redémarrer un démon 5.75 +via la commande : 5.76 +</p> 5.77 +<pre> 5.78 + # /etc/init.d/demon [start|stop|restart] 5.79 +</pre> 5.80 +<p> 5.81 +Le répertoire /etc/init.d devrait déjà exister, si vous avez suivi le cookbook 5.82 +depuis le début. Si ce n'est pas le cas: <code>mkdir -p /etc/init.d</code>. 5.83 +Sur SliTaz vous trouverez un fichier /etc/init.d/README décrivant le 5.84 +fonctionnemnt de base des scripts rc. A noter aussi que tous les scripts de 5.85 +démarrage et démons peuvent faire appel au fichier 5.86 +<code>/etc/init.d/rc.functions</code>. Ce fichier permet d'inclure divers 5.87 +fonctions dans les scripts rc. SliTaz utilise une fonction <code>status</code> 5.88 +vérifiant si la commande précédante a réussi (0) ou pas. 5.89 +</p> 5.90 + 5.91 +<a name="rcS"></a> 5.92 +<h3><font color="#6c0023">/etc/init.d/rcS - Script d'initialisation principale</font></h3> 5.93 +<p> 5.94 +Le script <code>/etc/init.d/rcS</code> configure tous les services de base 5.95 +et initialise le système de base. Il commence par monter les systèmes de 5.96 +fichiers, démarrer syslogd et klogd, lancer mdev, nettoyer le système, etc. 5.97 +Il utilise le fichier de configuration <code>/etc/rcS.conf</code> pour 5.98 +connaître les démons et scripts à lancer au démarrage. Vous pouvez parcourir 5.99 +le script pour connaître en détail les commandes exécutées : 5.100 +</p> 5.101 +<pre> 5.102 + # nano rootfs/etc/init.d/rcS 5.103 +</pre> 5.104 + 5.105 + 5.106 +<a name="rc-scripts"></a> 5.107 +<h3><font color="#6c0023">Scripts et démons spécifiques</font></h3> 5.108 + 5.109 +<h4>bootopts.sh - Les options du mode LiveCD</h4> 5.110 +<p> 5.111 +Ce script est utilisé pour configurer les options du mode LiveCD, passées en 5.112 +ligne de commande au boot, et lisible via le fichier /proc/cmdline. C'est 5.113 +le script qui permet d'utiliser une clé USB ou un disque dure externe comme 5.114 +partition /home avec l'option home=usb ou home=sda[1-9], ou encore de spécifier 5.115 +directement la langue et le clavier à utiliser. 5.116 +</p> 5.117 + 5.118 +<h4>network.sh - Initialisation du réseau</h4> 5.119 +<p> 5.120 +Le script network.sh utilise le fichier de configuration /etc/netwok.conf pour 5.121 +connaître l'interface à utiliser, si l'on veut lancer le client DHCP ou pas, 5.122 +un IP fixe ou pas. Sur SliTaz le script /etc/init.d/network.sh configure les 5.123 +interfaces réseau au boot, en ce servant des infornations contenues dans 5.124 +/etc/network.conf. Si la variable $DHCP est égale à yes, alors le script 5.125 +/etc/init.d/network.sh lancera le client DHCP sur l'interface $INTERFACE. 5.126 +</p> 5.127 + 5.128 +<h4>i18n.sh - Internationalisation</h4> 5.129 +<p> 5.130 +SliTaz sauvegarde la configuration de la locale par défaut dans le fichier 5.131 +/etc/locale.conf qui est lu par /etc/profile, à chaque login. Le fichier 5.132 +/etc/locale.conf est généré lors du boot grâce au script /etc/init.d/i18n.sh. 5.133 +Ce script lance l'application 'tazlocale' que vous trouverez dans 5.134 +<a href="http://www.slitaz.org/get/tools">SliTaz tools</a>, si le fichier 5.135 +de configuration /etc/locale.conf n'existe pas. Nous utilisons le même processus 5.136 +pour la configuration du clavier en utilisant 'tazkmap' et le fichier de 5.137 +configuration /etc/kmap.conf. Ces deux applications s'intallent dans 5.138 +/sbin sur SliTaz, et utilise <a href="base-ncurses.html">les bibliothèques ncurses</a>, 5.139 +ainsi que <a href="base-ncurses.html#dialog">dialog</a>. Ce script vérifie 5.140 +aussi si le fichier de configuration du fuseau horaire /etc/TZ existe, 5.141 +sinon il le crée en se basant sur la configuration du clavier. 5.142 +</p> 5.143 + 5.144 +<h4>local.sh - Commande local</h4> 5.145 +<p> 5.146 +Création d'un script /etc/init.d/local.sh pour permettant à l'administrateur 5.147 +système d'ajouter facilement des commandes local exécutées au boot: 5.148 +</p> 5.149 +<pre class="script"> 5.150 +#!/bin/sh 5.151 +# /etc/init.d/local.sh: Local startup commands. 5.152 +# All commands here will be executed at boot time. 5.153 +# 5.154 +. /etc/init.d/rc.functions 5.155 + 5.156 +echo "Starting local startup commands... " 5.157 + 5.158 +</pre> 5.159 + 5.160 +<h4>rc.shutdown</h4> 5.161 +<p> 5.162 +Ce script est invoqué par /etc/inittab lors de l'arrêt du système. Il stop 5.163 +aussi tous les démons via la variable RUN_DAEMONS du fichier de configuration 5.164 +pricipale <code>/etc/rcS.conf</code>. 5.165 +</p> 5.166 + 5.167 +<a name="inittab"></a> 5.168 +<h3><font color="#6c0023">/etc/inittab - Fichier de configuration d'init</font></h3> 5.169 +<p> 5.170 +Le premier fichier lu par le noyau au boot. Il définit le script d'initialisation 5.171 +(/etc/init.d/rcS), les shells, et les actions en cas d'arrêt ou de reboot. Vous 5.172 +trouverez une exemple complet et commenté dans l'archive de Busybox et un petit 5.173 +sur cette page : 5.174 +</p> 5.175 +<pre class="script"> 5.176 +# /etc/inittab: init configuration for SliTaz GNU/Linux. 5.177 +# Boot-time system configuration/initialization script. 5.178 +# 5.179 +::sysinit:/etc/init.d/rcS 5.180 + 5.181 +# /sbin/getty respawn shell invocations for selected ttys. 5.182 +tty1::respawn:/sbin/getty 38400 tty1 5.183 +tty2::respawn:/sbin/getty 38400 tty2 5.184 +tty3::respawn:/sbin/getty 38400 tty3 5.185 +tty4::respawn:/sbin/getty 38400 tty4 5.186 +tty5::respawn:/sbin/getty 38400 tty5 5.187 +tty6::respawn:/sbin/getty 38400 tty6 5.188 + 5.189 +# Stuff to do when restarting the init 5.190 +# process, or before rebooting. 5.191 +::restart:/etc/init.d/rc.shutdown 5.192 +::restart:/sbin/init 5.193 +::ctrlaltdel:/sbin/reboot 5.194 +::shutdown:/etc/init.d/rc.shutdown 5.195 + 5.196 +</pre> 5.197 + 5.198 +<h4>Suite</h4> 5.199 +<p> 5.200 +Le Cookbook continue via le chapitre : <a href="x-window-system.html">X window system</a>. 5.201 +</p> 5.202 + 5.203 + 5.204 +<!-- End of content --> 5.205 +</div> 5.206 + 5.207 +<!-- Footer. --> 5.208 +<div id="footer"> 5.209 + <div class="footer-right"></div> 5.210 + <a href="#top">Haut de la page</a> | 5.211 + <a href="index.html">Table des matières</a> 5.212 +</div> 5.213 + 5.214 +<div id="copy"> 5.215 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 5.216 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 5.217 + Documentation publiées sous 5.218 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 5.219 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 5.220 +</div> 5.221 + 5.222 +</body> 5.223 +</html>
6.1 Binary file doc/cookbook/favicon.ico has changed
7.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 7.2 +++ b/doc/cookbook/gtk-apps.html Sat Mar 29 12:01:05 2008 +0100 7.3 @@ -0,0 +1,343 @@ 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 Cookbook - GTK+ apps</title> 7.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 7.10 + <meta name="description" content="slitaz cookbook GTK+ applications leafpad mtpaint transmissin gftp geany IDE compilation" /> 7.11 + <meta name="expires" content="never" /> 7.12 + <meta name="modified" content="2007-12-24 12: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="gtk-libs.html">gtk-libs</a> | 7.25 + <a href="index.html">Table des matières</a> | 7.26 + <a href="rootcd.html">Rootcd</a> 7.27 +</div> 7.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 7.29 +</div> 7.30 + 7.31 +<!-- Content. --> 7.32 +<div id="content"> 7.33 +<div class="content-right"></div> 7.34 + 7.35 + 7.36 +<h2><font color="#DF8F06">Applications GTK+</font></h2> 7.37 +<p> 7.38 +Compilation et installation d'applications graphique utilisant GTK+. 7.39 +</p> 7.40 +<ul> 7.41 + <li><a href="#about">A propos de ce chapitre.</a> - Description et variable 7.42 + d'environnement ($fs)</li> 7.43 + <li><a href="#leafpad">leafpad-0.8.10</a> - Editeur de texte tout simple.</li> 7.44 + <li><a href="#gitmail">gitmail-0.4</a> - Ghost In The Mail, client de mail.</li> 7.45 + <li><a href="#gqview">gqview-2.0.4</a> - Gestionnaire d'images.</li> 7.46 + <li><a href="#mtpaint">mtpaint-3.11</a> - Création et traitement d'images.</li> 7.47 + <li><a href="#transmission">Transmission-0.72</a> - Client BitTorrent léger.</li> 7.48 + <li><a href="#emelfm2">emelfm2-0.3.5</a> - Gestionnaire de fichiers.</li> 7.49 + <li><a href="#geany">geany-0.11</a> - Environnement de Développement Intégré.</li> 7.50 + <li><a href="#gftp">gftp-2.0.18</a> - Client FTP simple et rapide.</li> 7.51 + <li><a href="#xpad">xpad-2.12</a> - Mini application de prise de notes.</li> 7.52 +</ul> 7.53 +<a name="about"></a> 7.54 +<h3><font color="#6c0023">A propos</font></h3> 7.55 +<p> 7.56 +Ce chapitre décrit les commandes passés pour la compilation et 7.57 +l'installation des applications GTK+ distribuées par défaut sur le 7.58 +LiveCD de <a href="http://www.slitaz.org/">SliTaz</a>. L'installation 7.59 +des bibliothèques GTK+ est décrite dans le chapitre : 7.60 +<a href="gtk-libs.html">GTK+ libs</a>. 7.61 +</p> 7.62 +<h4>Variable d'environnement ($fs)</h4> 7.63 +<p> 7.64 +Pour ne pas spécifier tout le chemin vers le répertoire rootfs, export 7.65 +de la variable d'environnement : 7.66 +</p> 7.67 +<pre> 7.68 + # export fs=$PWD/rootfs 7.69 +</pre> 7.70 +<p> 7.71 +Pour vérifier : 7.72 +</p> 7.73 +<pre> 7.74 + # echo $fs 7.75 +</pre> 7.76 +<a name="leafpad"></a> 7.77 +<h3><font color="#6c0023">leafpad-0.8.10 - Editeur de texte tout simple</font></h3> 7.78 +<p> 7.79 +Site web : <a href="http://tarot.freeshell.org/leafpad/">http://tarot.freeshell.org/leafpad/</a> 7.80 +</p> 7.81 +<pre> 7.82 + # wget http://savannah.nongnu.org/download/leafpad/leafpad-0.8.10.tar.gz 7.83 + # tar xzf leafpad-0.8.10.tar.gz 7.84 + # cd leafpad-0.8.10 7.85 + # ./configure --prefix=/usr 7.86 + # make 7.87 + # make DESTDIR=$PWD/_pkg install 7.88 + # strip _pkg/usr/bin/* 7.89 +</pre> 7.90 +<h4>Install in rootfs</h4> 7.91 +<pre> 7.92 + # cp _pkg/usr/bin/* $fs/usr/bin 7.93 + # cp _pkg/usr/share/pixmaps/leafpad.png $fs/usr/share/pixmaps 7.94 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 7.95 +</pre> 7.96 +<a name="gitmail"></a> 7.97 +<h3><font color="#6c0023">gitmail-0.4 - Ghost In The Mail, client de mail</font></h3> 7.98 +<p> 7.99 +Ghost In The Mail permet d'envoyer rapidement, et facilement des 7.100 +mails via le protocole SMTP. 7.101 +</p> 7.102 +<p> 7.103 +Site web : <a href="http://gitmail.sourceforge.net/">http://gitmail.sourceforge.net/</a> 7.104 +</p> 7.105 +<pre> 7.106 + # wget http://switch.dl.sourceforge.net/sourceforge/gitmail/gitmail-0.4.tar.gz 7.107 + # tar xzf gitmail-0.4.tar.gz 7.108 + # cd GhostInTheMail-0.4 7.109 + # ./configure --prefix=/usr 7.110 + # make 7.111 + # make DESTDIR=$PWD/_pkg \ 7.112 + gitmaildocdir=/usr/share/doc/GhostInTheMail \ 7.113 + install 7.114 + # strip _pkg/usr/bin/* 7.115 +</pre> 7.116 +<h4>Install in rootfs</h4> 7.117 +<pre> 7.118 + # cp _pkg/usr/bin/* $fs/usr/bin 7.119 +</pre> 7.120 +<a name="gqview"></a> 7.121 +<h3><font color="#6c0023">gqview-2.0.4 - Gestionnaire d'images</font></h3> 7.122 +<p> 7.123 +Site web : <a href="http://gqview.sourceforge.net/">http://gqview.sourceforge.net/</a> 7.124 +</p> 7.125 +<pre> 7.126 + # wget http://belnet.dl.sourceforge.net/sourceforge/gqview/gqview-2.0.4.tar.gz 7.127 + # tar xzf gqview-2.0.4.tar.gz 7.128 + # cd gqview-2.0.4 7.129 + # ./configure --prefix=/usr --mandir=/usr/share/man 7.130 + # make 7.131 + # make DESTDIR=$PWD/_pkg install 7.132 + # strip _pkg/usr/bin/* 7.133 +</pre> 7.134 +<h4>Install in rootfs</h4> 7.135 +<pre> 7.136 + # cp _pkg/usr/bin/* $fs/usr/bin 7.137 + # cp _pkg/usr/share/pixmaps/* $fs/usr/share/pixmaps 7.138 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 7.139 +</pre> 7.140 +<a name="mtpaint"></a> 7.141 +<h3><font color="#6c0023">mtpaint-3.11 - Création et traitement d'images</font></h3> 7.142 +<p> 7.143 +Site web : <a href="http://mtpaint.sourceforge.net/">http://mtpaint.sourceforge.net/</a> 7.144 +</p> 7.145 +<pre> 7.146 + # wget http://switch.dl.sourceforge.net/sourceforge/mtpaint/mtpaint-3.11.tar.bz2 7.147 + # tar xjf mtpaint-3.11.tar.bz2 7.148 + # cd mtpaint-3.11 7.149 + # ./configure --cpu=i486 --prefix=/usr intl 7.150 + # make 7.151 + # strip src/mtpaint 7.152 +</pre> 7.153 +<h4>Install in rootfs</h4> 7.154 +<pre> 7.155 + # cp src/mtpaint $fs/usr/bin 7.156 + # cp po/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/mtpaint.mo 7.157 + # cp src/icons1/icon.xpm $fs/usr/share/pixmaps/mtpaint.xpm 7.158 +</pre> 7.159 +<a name="transmission"></a> 7.160 +<h3><font color="#6c0023">Transmission-0.72 - Client BitTorrent léger</font></h3> 7.161 +<p> 7.162 +Transmission est un client BitTorrent, rapide, léger, et simple d'utilisation. 7.163 +La complitation du paquet fourni un client en ligne de commande 7.164 +(transmissioncli) et un client GTK+ (transmission-gtk). Nous installons que 7.165 +le client GTK+, le client en ligne de commande est distribué sous forme de 7.166 +paquet SliTaz (*.tazpkg). 7.167 +</p> 7.168 +<p> 7.169 +Site web : <a href="http://transmission.m0k.org/">http://transmission.m0k.org/</a> 7.170 +</p> 7.171 +<pre> 7.172 + # wget http://download.m0k.org/transmission/files/Transmission-0.72.tar.gz 7.173 + # tar xzf Transmission-0.72.tar.gz 7.174 + 7.175 + La version 0.72 est mal archivée: 7.176 + # mv "Transmission .72" Transmission-0.72 7.177 + 7.178 + # cd Transmission-0.72 7.179 + # ./configure --prefix=/usr --disable-openssl 7.180 + # make 7.181 + # strip gtk/transmission-gtk 7.182 + # strip cli/transmissioncli 7.183 +</pre> 7.184 +<h4>Install in rootfs</h4> 7.185 +<pre> 7.186 + # cp gtk/transmission-gtk $fs/usr/bin 7.187 + # cp gtk/transmission.png $fs/usr/share/pixmaps 7.188 + # cp gtk/po/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/transmission-gtk.mo 7.189 +</pre> 7.190 +<a name="emelfm2"></a> 7.191 +<h3><font color="#6c0023">emelfm2-0.3.5 - Gestionnaire de fichiers</font></h3> 7.192 +<p> 7.193 +L'application emelFM2, est un gestionnaire de fichiers, fournissant 7.194 +pleins de fonctions utiles, tel que le montage de périphériques, un 7.195 +visualisateur de texte, l'ouverture d'un terminal dans le répertoire 7.196 +courant, etc. 7.197 +</p> 7.198 +<p> 7.199 +Site web : <a href="http://emelfm2.net/">http://emelfm2.net/</a> 7.200 +</p> 7.201 +<pre> 7.202 + # cd .. 7.203 + # wget http://emelfm2.net/rel/emelfm2-0.3.5.tar.gz 7.204 + # tar xzf emelfm2-0.3.5.tar.gz 7.205 + # cd emelfm2-0.3.5 7.206 + # make PREFIX=/usr 7.207 + # make i18n PREFIX=/usr 7.208 + # make install PREFIX=$PWD/_pkg/usr 7.209 + # make install_i18n PREFIX=$PWD/_pkg/usr 7.210 + # strip -v _pkg/usr/bin/* 7.211 + # strip -v _pkg/usr/lib/emelfm2/plugins/* 7.212 +</pre> 7.213 +<h4>Install in rootfs</h4> 7.214 +<pre> 7.215 + # cp _pkg/usr/bin/* $fs/usr/bin 7.216 + # cp -a _pkg/usr/lib/* $fs/usr/lib 7.217 + # cp -a _pkg/usr/share/pixmaps $fs/usr/share 7.218 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 7.219 +</pre> 7.220 +<a name="geany"></a> 7.221 +<h3><font color="#6c0023">geany-0.11 - Environnement de Développement Intégré</font></h3> 7.222 +<p> 7.223 +Geany et un IDE, il est simple, léger, et rapide, proposant la 7.224 +coloration syntaxique, les onglets, pliage/dépliage du code, la 7.225 +complétion automatique, de l'aide à l'écriture, une liste des symboles, 7.226 +et bien plus. 7.227 +</p> 7.228 +<p> 7.229 +Site web: <a href="http://geany.uvena.de/">http://geany.uvena.de/</a> 7.230 +</p> 7.231 +<p> 7.232 +Pour compiler et faire fonctionner geany sur SliTaz, il faut les 7.233 +bibliothèques libstdc++ et libgcc1, toutes deux fournies par gcc (nous 7.234 +utilisons gcc-4.1.1 que nous avons recompilé, mais vous pouvez copier 7.235 +les bibliothèques depuis votre système hôte). 7.236 +</p> 7.237 +<p> 7.238 +Note: Si la force est avec vous, vous pouvez l'activer via l'option: 7.239 +--enable-the-force 7.240 +</p> 7.241 +<pre> 7.242 + # wget http://mesh.dl.sourceforge.net/sourceforge/geany/geany-0.11.tar.gz 7.243 + # tar xzf geany-0.11.tar.gz 7.244 + # cd geany-0.11 7.245 + # ./configure --prefix=/usr --mandir=/usr/share/man \ 7.246 + --disable-vte --enable-the-force 7.247 + # make 7.248 + # make DESTDIR=$PWD/_pkg install 7.249 + # strip -v _pkg/usr/bin/* 7.250 +</pre> 7.251 +<h4>Install in rootfs</h4> 7.252 +<pre> 7.253 + # cp _pkg/usr/bin/* $fs/usr/bin 7.254 + # cp -a _pkg/usr/share/geany $fs/usr/share 7.255 + # cp _pkg/usr/share/pixmaps/geany.png $fs/usr/share/pixmaps 7.256 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 7.257 +</pre> 7.258 +<a name="gftp"></a> 7.259 +<h3><font color="#6c0023">gftp-2.0.18 - Client FTP simple et rapide</font></h3> 7.260 +<p> 7.261 +L'application gFTP est un client FTP proposant une interface graphique 7.262 +en GTK+. Simple, rapide, efficace et facile à prendre en main. A noter 7.263 +que nous compilons sans le support ssl et l'interface texte. Get, 7.264 +untar, configure, compile and install. 7.265 +</p> 7.266 +<p> 7.267 +Site web : <a href="http://www.gftp.org/">http://www.gftp.org/</a> 7.268 +</p> 7.269 +<pre> 7.270 + # wget http://www.gftp.org/gftp-2.0.18.tar.gz 7.271 + # tar xzf gftp-2.0.18.tar.gz 7.272 + # cd gftp-2.0.18 7.273 + # ./configure --prefix=/usr --mandir=/usr/share/man \ 7.274 + --disable-ssl --disable-textport \ 7.275 + --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu 7.276 + # make 7.277 + # make DESTDIR=$PWD/_pkg install 7.278 + # strip _pkg/usr/bin/* 7.279 +</pre> 7.280 +<h4>Install in rootfs</h4> 7.281 +<p> 7.282 +Slitaz ne fournit que le client GTK+ sur le LiveCD. A noter que 7.283 +<code>gftp</code> est simplement un petit script détectant 7.284 +l'environnement (console ou X) et lançant la bonne interface, de 7.285 +plus ça fait qu'u nom à se souvenir pour l'utilisateur : 7.286 +</p> 7.287 +<pre> 7.288 + # cp _pkg/usr/bin/gftp $fs/usr/bin 7.289 + # cp _pkg/usr/bin/gftp-gtk $fs/usr/bin 7.290 + # cp -a _pkg/usr/share/gftp $fs/usr/share 7.291 + # cp -a _pkg/usr/share/pixmaps $fs/usr/share 7.292 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 7.293 +</pre> 7.294 +<p> 7.295 +Pour gagner un peu de place et éviter les doublons, vous pouvez 7.296 +supprimer le COPIYING (17 Ko) inclut dans /usr/share/gftp. La licence 7.297 +GNU étant déjà présente dans /usr/share/license, si vous le voulez 7.298 +vous pouvez créer un lien symbolique, à vous de voir. 7.299 +</p> 7.300 +<a name="xpad"></a> 7.301 +<h3><font color="#6c0023">xpad-2.12 - Mini application de prise de notes.</font></h3> 7.302 +<p> 7.303 +L'application xpad permet de prendre rapidement divers notes via des 7.304 +fenêtres GTK personnalisables. 7.305 +</p> 7.306 +<p> 7.307 +Site web : <a href="http://xpad.sourceforge.net/">http://xpad.sourceforge.net/</a> 7.308 +</p> 7.309 +<pre> 7.310 + # wget http://surfnet.dl.sourceforge.net/sourceforge/xpad/xpad-2.12.tar.bz2 7.311 + # tar xjf xpad-2.12.tar.bz2 7.312 + # cd xpad-2.12 7.313 + # ./configure --prefix=/usr --mandir=/usr/share/man \ 7.314 + --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu 7.315 + # make 7.316 + # make DESTDIR=$PWD/_pkg install 7.317 + # strip _pkg/usr/bin/* 7.318 +</pre> 7.319 +<h4>Install in rootfs</h4> 7.320 +<pre> 7.321 + # cp _pkg/usr/bin/xpad $fs/usr/bin 7.322 + # cp -a _pkg/usr/share/pixmaps $fs/usr/share 7.323 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 7.324 +</pre> 7.325 + 7.326 + 7.327 +<!-- End of content --> 7.328 +</div> 7.329 + 7.330 +<!-- Footer. --> 7.331 +<div id="footer"> 7.332 + <div class="footer-right"></div> 7.333 + <a href="#top">Haut de la page</a> | 7.334 + <a href="index.html">Table des matières</a> 7.335 +</div> 7.336 + 7.337 +<div id="copy"> 7.338 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 7.339 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 7.340 + Documentation publiées sous 7.341 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 7.342 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 7.343 +</div> 7.344 + 7.345 +</body> 7.346 +</html>
8.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 8.2 +++ b/doc/cookbook/gtk-libs.html Sat Mar 29 12:01:05 2008 +0100 8.3 @@ -0,0 +1,276 @@ 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 Cookbook - GTK+ libs</title> 8.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 8.10 + <meta name="description" content="SliTaz GNU/Linux GTK+ installation compilation pango atk cairo glib" /> 8.11 + <meta name="expires" content="never" /> 8.12 + <meta name="modified" content="2007-12-24 17:00: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="x-window-system.html">X window system</a> | 8.25 + <a href="index.html">Table des matières</a> | 8.26 + <a href="gtk-apps.html">GTK+ apps</a> 8.27 +</div> 8.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 8.29 +</div> 8.30 + 8.31 +<!-- Content. --> 8.32 +<div id="content"> 8.33 +<div class="content-right"></div> 8.34 + 8.35 + 8.36 +<h2><font color="#DF8F06">Bibliothèques GTK+</font></h2> 8.37 +<p> 8.38 +Compilation et installation des bibliothèques GTK+ et compagnie. 8.39 +</p> 8.40 +<ul> 8.41 + <li><a href="#about">A propos de ce chapitre.</a> - Description et variable 8.42 + d'environnement ($fs)</li> 8.43 + <li><a href="#cairo">cairo-1.2.6</a> - 2D graphics library.</li> 8.44 + <li><a href="#glib">glib-2.12.4</a> - C routines.</li> 8.45 + <li><a href="#pango">pango-1.14.8</a> - Library for layout and rendering of text.</li> 8.46 + <li><a href="#atk">atk-1.12.4</a> - Accessibility toolkit.</li> 8.47 + <li><a href="#gtk">gtk-2.8.20</a> - The GIMP Toolkit.</li> 8.48 + <li><a href="#initramfs-iso">Génération de l'initramfs, et d'une image ISO.</a></li> 8.49 +</ul> 8.50 +<a name="about"></a> 8.51 +<h3><font color="#6c0023">A propos</font></h3> 8.52 +<p> 8.53 +Ce chapitre décrit l'installation et la configuration sur SliTaz, des 8.54 +bibliothèques GTK permettant d'insataller des miliers de logiciels. 8.55 +A noter que vous pouvez simplement compiler, et créer un paquet 8.56 +SliTaz que vous installé ensuite à la demande avec tazpkg. 8.57 +</p> 8.58 +<p> 8.59 +La compilation de GTK demandes pas mal de temp, et il faut satisfaire 8.60 +beaucoup de dépendances. Vous trouverez (en anglais) le guide de 8.61 +compilation de GTK: <a href="http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html" 8.62 + >gtk-building.html sur developer.gnome.org</a>. Ce document 8.63 +précise qu'il faut compiler dans l'ordre: GLib, Pango, ATK, puis GTK+. 8.64 +Avant de commancer il faur vérifier que les dépendances soient bien installées 8.65 +sur votre système hôte. Les paquets GLib, Pango, ATK, et GTK+ vont ensemles, 8.66 +et sont distribués par l'équipe des développeurs GTK. Nous ne les décrivons pas, 8.67 +seulement les commandes à lancer. 8.68 +</p> 8.69 +<h4>Variable d'environnement ($fs)</h4> 8.70 +<p> 8.71 +Pour ne pas spécifier tout le chemin vers le répertoire rootfs, export 8.72 +de la variable d'environnement: 8.73 +</p> 8.74 +<pre> 8.75 + # export fs=$PWD/rootfs 8.76 +</pre> 8.77 +<p> 8.78 +Pour vérifier: 8.79 +</p> 8.80 +<pre> 8.81 + # echo $fs 8.82 +</pre> 8.83 +<a name="cairo"></a> 8.84 +<h3><font color="#6c0023">cairo-1.2.6 - 2D graphics library</font></h3> 8.85 +<p> 8.86 +Nous commençons par libcairo 8.87 +(<a href="http://www.cairographics.org/">http://www.cairographics.org/</a>) 8.88 +utilisé pour compiler pango: 8.89 +</p> 8.90 +<pre> 8.91 + # cd src 8.92 + # wget http://cairographics.org/releases/cairo-1.2.6.tar.gz 8.93 + # tar xzf cairo-1.2.6.tar.gz 8.94 + # cd cairo-1.2.6 8.95 + # ./configure --prefix=/usr --mandir=/usr/share/man \ 8.96 + --with-html-dir=/usr/share/doc 8.97 + # make 8.98 + # make DESTDIR=$PWD/_pkg install 8.99 + # strip -v _pkg/usr/lib/*.so* 8.100 +</pre> 8.101 +<h4>Install in rootfs</h4> 8.102 +<pre> 8.103 + # cp -av _pkg/usr/lib/*.so* $fs/usr/lib 8.104 +</pre> 8.105 +<a name="glib"></a> 8.106 +<h3><font color="#6c0023">glib-2.12.4 - C routines</font></h3> 8.107 +<pre> 8.108 + # cd .. 8.109 + # wget ftp://ftp.gtk.org/pub/glib/2.12/glib-2.12.4.tar.bz2 8.110 + # tar xjf glib-2.12.4.tar.bz2 8.111 + # cd glib-2.12.4 8.112 + # ./configure --prefix=/usr --sysconfdir=/etc \ 8.113 + --mandir=/usr/share/man --with-html-dir=/usr/share/doc 8.114 + # make 8.115 + # make DESTDIR=$PWD/_pkg install 8.116 + # strip -v _pkg/usr/bin/* 8.117 + # strip -v _pkg/usr/lib/*.so* 8.118 +</pre> 8.119 +<h4>Install in rootfs</h4> 8.120 +<p> 8.121 +Option, les utilitaires glib-genmarshal et gobject-query on besoin de 8.122 +/lib/tls/librt.so.1: 8.123 +</p> 8.124 +<pre> 8.125 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 8.126 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 8.127 + 8.128 + Les binaires en option: 8.129 + # cp -a _pkg/usr/bin/* $fs/usr/bin 8.130 +</pre> 8.131 +<a name="pango"></a> 8.132 +<h3><font color="#6c0023">pango-1.14.8 - Library for layout and rendering of text</font></h3> 8.133 +<pre> 8.134 + # cd .. 8.135 + # wget ftp://ftp.gtk.org/pub/pango/1.14/pango-1.14.8.tar.bz2 8.136 + # tar xjf pango-1.14.8.tar.bz2 8.137 + # cd pango-1.14.8 8.138 + # ./configure --prefix=/usr --sysconfdir=/etc \ 8.139 + --mandir=/usr/share/man --with-html-dir=/usr/share/doc 8.140 + # make 8.141 + # make DESTDIR=$PWD/_pkg install 8.142 + # strip -v _pkg/usr/bin/* 8.143 + # strip -v _pkg/usr/lib/*.so* 8.144 + # strip -v _pkg/usr/lib/pango/1.5.0/modules/* 8.145 +</pre> 8.146 +<h4>Install in rootfs</h4> 8.147 +<pre> 8.148 + # cp -a _pkg/usr/bin/* $fs/usr/bin 8.149 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 8.150 + # cp -a _pkg/usr/lib/pango $fs/usr/lib 8.151 + # rm -rf $fs/usr/lib/pango/1.5.0/modules/*.la 8.152 + # cp -a _pkg/etc $fs 8.153 +</pre> 8.154 +<p> 8.155 +Création du fichier /etc/pango/pango.modules via un chroot dans 8.156 +le rootfs (pango-querymodules utilise librt.so.1): 8.157 +</p> 8.158 +<pre> 8.159 + # chroot $fs /bin/ash 8.160 + /# pango-querymodules > /etc/pango/pango.modules 8.161 + # exit 8.162 +</pre> 8.163 +<a name="atk"></a> 8.164 +<h3><font color="#6c0023">atk-1.12.4 - Accessibility toolkit</font></h3> 8.165 +<pre> 8.166 + # cd .. 8.167 + # wget http://ftp.gnome.org/pub/gnome/sources/atk/1.12/atk-1.12.4.tar.bz2 8.168 + # tar xjf atk-1.12.4.tar.bz2 8.169 + # cd atk-1.12.4 8.170 + # ./configure --prefix=/usr --mandir=/usr/share/man \ 8.171 + --with-html-dir=/usr/share/doc 8.172 + # make 8.173 + # make DESTDIR=$PWD/_pkg install 8.174 + # strip -v _pkg/usr/lib/*.so* 8.175 +</pre> 8.176 +<h4>Install in rootfs</h4> 8.177 +<pre> 8.178 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 8.179 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 8.180 +</pre> 8.181 +<a name="gtk"></a> 8.182 +<h3><font color="#6c0023">gtk+-2.8.20 - The GIMP Toolkit</font></h3> 8.183 +<pre> 8.184 + # cd .. 8.185 + # wget ftp://ftp.gtk.org/pub/gtk/v2.8/gtk+-2.8.20.tar.bz2 8.186 + # tar xjf gtk+-2.8.20.tar.bz2 8.187 + # cd gtk+-2.8.20 8.188 + # ./configure --prefix=/usr --sysconfdir=/etc \ 8.189 + --mandir=/usr/share/man --with-html-dir=/usr/share/doc 8.190 + # make 8.191 + # make DESTDIR=$PWD/_pkg install 8.192 + # strip -v _pkg/usr/bin/* 8.193 + # strip -v _pkg/usr/lib/*.so* 8.194 + # strip -v --strip-unneeded \ 8.195 + _pkg/usr/lib/gtk-2.0/2.4.0/*/* 8.196 +</pre> 8.197 +<h4>Install in rootfs</h4> 8.198 +<pre> 8.199 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 8.200 + # mkdir $fs/usr/lib/gtk-2.0 8.201 + # cp -a _pkg/usr/lib/gtk-2.0/2.4.0 $fs/usr/lib/gtk-2.0 8.202 + # rm -rf $fs/usr/lib/gtk-2.0/2.4.0/*/*.la 8.203 + 8.204 + Locale et themes: 8.205 + # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale 8.206 + # cp -a _pkg/usr/share/themes $fs/usr/share 8.207 + 8.208 + Les applications: 8.209 + # cp _pkg/usr/bin/gtk-query-immodules-2.0 $fs/usr/bin 8.210 + # cp _pkg/usr/bin/gtk-update-icon-cache $fs/usr/bin 8.211 + # cp _pkg/usr/bin/gdk-pixbuf-csource $fs/usr/bin 8.212 + # cp _pkg/usr/bin/gdk-pixbuf-query-loaders $fs/usr/bin 8.213 + ... 8.214 + 8.215 + Pour l'application gtk-demo: 8.216 + # cp -a _pkg/usr/bin/gtk-demo $fs/usr/bin 8.217 + # cp -a _pkg/usr/share/gtk-2.0 $fs/usr/share 8.218 +</pre> 8.219 +<p> 8.220 +Création des fichiers /etc/gtk-2.0/gtk.immodules et gdk-pixbuf.loaders 8.221 +via un chroot dans le rootfs: 8.222 +</p> 8.223 +<pre> 8.224 + # chroot $fs /bin/ash 8.225 + /# mkdir /etc/gtk-2.0 8.226 + /# gtk-query-immodules-2.0 > /etc/gtk-2.0/gtk.immodules 8.227 + /# gdk-pixbuf-query-loaders > /etc/gtk-2.0/gdk-pixbuf.loaders 8.228 + # exit 8.229 +</pre> 8.230 +<p> 8.231 +A ce stade vous pouvez tester GTK+ avec l'application 'gtk-demo' en 8.232 +créant une ISO, et en utilisant 'qemu'. Vous pouvez aussi compiler 8.233 +une petite application GTK+ tel que LeafPad, et tester! La compilation et 8.234 +l'installation des application GTK+ distribuées par défaut avec SliTaz, est 8.235 +décrite dans le chapitre <a href="gtk-apps.html">gtk-apps</a>. 8.236 +</p> 8.237 +<a name="initramfs-iso"></a> 8.238 +<h3><font color="#6c0023">Génération de l'initramfs, et d'une image ISO</font></h3> 8.239 +<p> 8.240 +Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' 8.241 +contenu dans <a href="/get/tools">SliTaz tools</a>. Vous pouvez aussi créer 8.242 +un nouvelle image initramfs, et la copier dans /boot de la racine de cdrom 8.243 +(rootcd), et pour finir créer un image ISO avec genisoimage: 8.244 +</p> 8.245 +<pre> 8.246 + # cd $fs 8.247 + # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz 8.248 + # cd .. 8.249 + # cp rootfs.gz rootcd/boot 8.250 + # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \ 8.251 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 8.252 + -V "SliTaz" -boot-info-table rootcd 8.253 +</pre> 8.254 +<h4>Suite</h4> 8.255 +<p> 8.256 +Après les bibliothèques, <a href="gtk-apps.html">les applications GTK+</a>. 8.257 +</p> 8.258 + 8.259 + 8.260 +<!-- End of content --> 8.261 +</div> 8.262 + 8.263 +<!-- Footer. --> 8.264 +<div id="footer"> 8.265 + <div class="footer-right"></div> 8.266 + <a href="#top">Haut de la page</a> | 8.267 + <a href="index.html">Table des matières</a> 8.268 +</div> 8.269 + 8.270 +<div id="copy"> 8.271 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 8.272 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 8.273 + Documentation publiées sous 8.274 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 8.275 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 8.276 +</div> 8.277 + 8.278 +</body> 8.279 +</html>
9.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 9.2 +++ b/doc/cookbook/hacker.txt Sat Mar 29 12:01:05 2008 +0100 9.3 @@ -0,0 +1,58 @@ 9.4 +SliTaz cookbook - SliTaz User /home/hacker 9.5 +================================================================================ 9.6 +SliTaz et l'utilisateur hacker. 9.7 + 9.8 + 9.9 +L'utilisateur hacker, est l'utilisateur par défaut en mode LiveCD, il n'a pas 9.10 +de mot de passe. Son répertoire personnel est: /home/hacker. Il y a divers 9.11 +répertoires est fichiers préinstallés que l'on peut trouver dans /home, des 9.12 +SliTaz tools. Si l'option home=usb est spécifiée au boot, le script 9.13 +d'initialisation slitaz-bootopts.sh vérifie que le répertoire /home/hacker, 9.14 +si ce n'est pas le cas, les fichiers par défaut sont copier sur la clé USB. 9.15 + 9.16 + 9.17 +Adduser hacker 9.18 +-------------- 9.19 +Ajout de l'utilisateur hacker avec le shell ash, en se chrootant dans le rootfs: 9.20 + 9.21 + # chroot rootfs /bin/ash 9.22 + # adduser hacker -s /bin/ash 9.23 + Enter new password: 9.24 + ... 9.25 + # exit 9.26 + 9.27 + 9.28 +/home/hacker/* 9.29 +-------------- 9.30 +Le contenu du répertoire /home/hacker sur SliTaz: 9.31 + 9.32 + * Documents/ - Répertoire déstiné aux documents personnel. 9.33 + * bookmarks.html - Fichier de marques pages utilisé par retawq. 9.34 + * Images/ - Répertoire d'images: Art ASCII, Logos, Icons, etc. 9.35 + * Templates/ - Répertoire des modèles, html, shell script, etc. 9.36 + * Public/ - Répertoire public du serveur web. 9.37 + * . - Les fichiers cachés (commence par un point). Ce 9.38 + sont les fichiers de configuration des divers 9.39 + applications. 9.40 + 9.41 +A vous de copier depuis SliTaz tools, les fichiers qui vous semblent utiles, 9.42 +et ou de les modifier à votre convenance. 9.43 + 9.44 + 9.45 +Les permissions 9.46 +--------------- 9.47 +Si vous copié les fichiers d'hacker avec un utilisateur qui n'a pas la même id, 9.48 +les fichiers ne seront pas modifiables par hacker. Pour cela il faut modifier 9.49 +les permissions en ce chrootant: 9.50 + 9.51 + # chroot rootfs /bin/ash 9.52 + # chown -R hacker.hacker /home/hacker 9.53 + Si besoin est: 9.54 + # chmod 755 /home/hacker 9.55 + # chmod 755 /home/hacker/Art 9.56 + etc... 9.57 + # exit 9.58 + 9.59 + 9.60 +================================================================================ 9.61 + http://www.slitaz.org/
10.1 Binary file doc/cookbook/images/css/content-tl.png has changed
11.1 Binary file doc/cookbook/images/css/content-tr.png has changed
12.1 Binary file doc/cookbook/images/css/footer-bl.png has changed
13.1 Binary file doc/cookbook/images/css/footer-br.png has changed
14.1 Binary file doc/cookbook/images/css/header.png has changed
15.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 15.2 +++ b/doc/cookbook/index.html Sat Mar 29 12:01:05 2008 +0100 15.3 @@ -0,0 +1,212 @@ 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 Cookbook</title> 15.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 15.10 + <meta name="description" content="SliTaz BusyBox création system gnu linux fonctionnant en RAM howto Documentation du projet SliTaz GNU/Linux création system gnu linux fonctionnant en RAM wok tools" /> 15.11 + <meta name="expires" content="never" /> 15.12 + <meta name="modified" content="2007-12-24 17:00: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="#intro">Introduction</a> | 15.25 + <a href="http://www.slitaz.org/doc/">SliTaz doc</a> 15.26 +</div> 15.27 +<h1><font color="#3E1220">SliTaz Cookbook</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 + 15.35 +<h2><font color="#DF8F06">Livre de cuisine de SliTaz</font></h2> 15.36 +<p> 15.37 +Index des documents du cookbook de SliTaz, construction pas à pas d'un système 15.38 +mini GNU/Linux Live et installable. 15.39 +</p> 15.40 +<h3><font color="#6c0023">Table des matières</font></h3> 15.41 +<h4>LiveCD</h4> 15.42 +<ul> 15.43 + <li><a href="#intro">Introduction.</a></li> 15.44 + <li><a href="#org">Organisation du répertoire de travail</a></li> 15.45 + <li><a href="base-system.html">Construction du système de base SliTaz</a> 15.46 + - Configuration et installation de BusyBox, du noyau Linux, des 15.47 + bibliothèques associées, et création des fichiers de configuration 15.48 + minimal, création d'une image initramfs et d'une image ISO bootable.</li> 15.49 + <li><a 15.50 + href="base-apps.html">Bibliothèques, applications de base de SliTaz</a> 15.51 + - Install de la calculette bc, module-init-tools. Install et config de 15.52 + Dropbear, fournissant un client, et un serveur SSH ultra légé. Et aussi: 15.53 + LightTPD, e2fsprogs, pcre, zlib.</li> 15.54 + <li><a href="base-ncurses.html">Bibliothèques et applications ncurses</a> 15.55 + - Compilation et install des bibliothèques ncurses, et installation de 15.56 + programmes tel que: l'éditeur de texte Nano, le navigateur web Retawq, 15.57 + Dialog, et Htop.</li> 15.58 + <li><a href="locale.html">Install et config des locales pour le 15.59 + français</a></li> 15.60 + <li><a href="boot-scripts.html">Les scripts de démarrage et d'arrêt</a> 15.61 + - Déscription des fichiers de configuration rc.</li> 15.62 + <li><a href="x-window-system.html">Installation et config du système X</a> 15.63 + - Serveur Xvesa d'XFree86, XTerm, configuration des polices, et 15.64 + installation du gestionnaire de fenêtres épuré Blackbox. (WM pour Window 15.65 + Manager). Installation du navigateur web Links.</li> 15.66 + <li><a href="gtk-libs.html">Les bibliothèques GTK+ et compagnie</a> - 15.67 + Installation de cairo, glib, atk, pango, et GTK+.</li> 15.68 + <li><a href="gtk-apps.html">Compilation et installation d'applications 15.69 + GTK+.</a></li> 15.70 + <li><a href="rootcd.html">Racine du cdrom (rootcd)</a> - Déscriptions et 15.71 + améliorations des fichiers contenus sur le cdrom, utililisation de GRUB 15.72 + pour booter le CD, install de Memtest86.</li> 15.73 +</ul> 15.74 +<h4>Paquets, recette, wok et système</h4> 15.75 +<ul> 15.76 + <li><a href="wok-tools.html">Wok & Tools</a> - Le wok avec Tazwok, 15.77 + les outils du projet SliTaz et la création de paquets.</li> 15.78 + <li><a href="receipts.html">Packages receipts</a> - Description des 15.79 + recettes utilisées pour compiler et créer un paquet automatiquement.</li> 15.80 + <li><a href="hacker.txt">hacker.txt</a> - SliTaz et l'utilisateur 15.81 + hacker.</li> 15.82 + <li><a href="release-tasks.txt">release-tasks.txt</a> - Liste des choses 15.83 + à faire avant de publier une nouvelle version (Cooking ou stable).</li> 15.84 + <li><a href="xorg.html">Xorg</a> - Reconstruire tous les paquets d'Xorg.</li> 15.85 + <li><a href="misc.txt">misc.txt</a> - Divers, tout ce qui ne va pas bien 15.86 + ailleur.</li> 15.87 +</ul> 15.88 + 15.89 +<a name="intro"></a> 15.90 +<h3><font color="#6c0023">Introduction</font></h3> 15.91 +<p> 15.92 +Le cookbook vous permet de suivre la création du LiveCD de SliTaz et de faire 15.93 +un voyage au coeur d'un système GNU/linux. Vous serez ensuite capable de 15.94 +personnaliser votre nouveau système ou de créer votre propre distro autonome 15.95 +fonctionnant en mémoire vive (RAM), et pleinement installable, sur disque dure 15.96 +ou clé USB. Une fois démarré, vous pouvez enlever le cd-rom et SliTaz 15.97 +fonctionne encore. SliTaz peut aussi être utilisé comme environnement dans 15.98 +lequel on se chroot, ou comme cd-rom multitâches. Le seul prérequis est une 15.99 +distribution hôte dans laquel nous allons piquer des bibliothèques, utiliser 15.100 +le compilateur, et les outils de développement. Ce système hôte peut-être: un 15.101 +environnement de développement chrooté, un distro minimal, SliTaz installé 15.102 +sur un disque dur ,ou une distro "généraliste" tel que Debian, Slackware, 15.103 +Fedora, Mandriva, Gentoo, Arch, etc. A noter que nous n'installons rien dans 15.104 +le système hôte lors de nos commandes. 15.105 +</p> 15.106 +<p> 15.107 +SliTaz utilise <a href="http://www.busybox.net/">BusyBox</a>, comme base du 15.108 +système et le noyau Linux. BusyBox c'est le couteaux Suisse de l'embarqué, 15.109 +utilisant une faible empreinte mémoire, et fournissant beaucoup de fichiers 15.110 +d'exemples. Busybox est donc notre principale source d'informations, c'est 15.111 +un utilitaire issu du projet Debian. Nous utilisons et chérissons cette 15.112 +fabuleuse ditribution, nous ne pouvons donc, que vous conseiller d'utiliser 15.113 +<a href="http://www.debian.org/">Debian GNU/Linux</a>. 15.114 +</p> 15.115 +<p> 15.116 +SliTaz utilise le bootloader Syslinux et une archive initramfs du système, 15.117 +compresée avec <code>cpio</code>. Cette archive est ensuite 15.118 +décompréssée en mémoire vive lors du boot par le noyau, dans un système 15.119 +sans taille fixe, en gardant le contrôle sur <code>init</code>. Lors des 15.120 +copies ou compilation d'applications on utilisera <code>strip</code> pour 15.121 +nettoyer les réperoires. Les logiciels genisoimage et mkisofs peuvent être 15.122 +utilisés à choix pour la création des images iso. Pour finir vous pouvez 15.123 +tester l'image <code>.iso</code> avec Qemu ou en gravant l'image sur un 15.124 +cdrom réinscriptible. 15.125 +</p> 15.126 +<a name="org"></a> 15.127 +<h3><font color="#6c0023">Organisation du répertoire de travail</font></h3> 15.128 +<p> 15.129 +Pour créer SliTaz, nous utilisons un répertoire de travail et plusieurs 15.130 +sous-répertoires. Que vous ayez un environnement chrooté pour développer, 15.131 +ou un système hôte, nous proposons d'utiliser un répertoire nommé distro/, 15.132 +pour travailler. Le répertoire distro/ peut être un simple dossier, ou une 15.133 +partition, mais vous êtes évidemment libre, de mettre tous cela ailleur. 15.134 +</p> 15.135 +<h4>distro/</h4> 15.136 +<p>Contenu du répertoire de travail:</p> 15.137 +<ul> 15.138 + <li>rootfs/ --> Pour root file system - C'est la racine 15.139 + du système, destiné à fonctionner en RAM, il est utilisé pour 15.140 + générer l'initramfs du système.</li> 15.141 + <li>rootfs.gz --> l'image initramfs de notre système, qui est une 15.142 + archive <code>cpio</code> compressée avec <code>gzip</code></li> 15.143 + <li>rootcd/ --> Pour root cd. C'est la racine des fichiers du cdrom.</li> 15.144 + <li>src/ --> Les sources, Kernel, Syslinux, Busybox, Dropbear, etc 15.145 + (ça peut aussi être un lien symbolique).</li> 15.146 +</ul> 15.147 +<p> 15.148 +Par la suite, l'initramfs et l'image ISO bootable (slitaz-cooking.iso) 15.149 +seront crées à la racine du répertoire de travail SliTaz/. 15.150 +</p> 15.151 +<h4>Option: rootfs.ext2 - Utilisation d'un disque dure virtuel</h4> 15.152 +<p> 15.153 +Option: rootfs.ext2 (<em>root file system in ext2</em>). C'est un disque dur 15.154 +virtuel, formaté en ext2 et monté en boucle sur rootfs/. Un périphérique de 15.155 +boucle, permet d'utiliser un fichier comme s'il s'agissait d'un périphérique 15.156 +normal (disque dur, disquette, etc), pour construire un système de fichiers 15.157 +dedans. Ce fichier peut être du nombre de méga-octets que vous désirez, nous 15.158 +vous proposons 20480 kb, ce qui correspond à un 20 Mb: 15.159 +</p> 15.160 +<pre> 15.161 + # dd if=/dev/zero of=rootfs.ext2 bs=1k count=20480 15.162 +</pre> 15.163 +<p> 15.164 +Création d'un système de fichier ext2 sur le fichier rootfs.ext2, l'option 15.165 +<code>-F</code> force le formatage du fichier. A noter que que l'utilisation 15.166 +de l'option <code>-m 0</code>, n'alloue aucune place à l'utilisateur root, 15.167 +par défaut elle occupe environ 5%, et l'option <code>-t</code> défini le type 15.168 +du système de fichier à utiliser, tel que ext2, ou ext3: 15.169 +</p> 15.170 +<pre> 15.171 + # mkfs -t ext2 -F -m 0 rootfs.ext2 15.172 +</pre> 15.173 +<p> 15.174 +Nous pouvons maintenant monter rootfs.ext2 en boucle, grâce à l'option 15.175 +<code>-o loop</code> fournie par l'utilitaire <code>mount</code>, et cela 15.176 +dans le répertoire rootfs/. Vous pouvez vérifier si le montage c'est bien 15.177 +effectué avec la commande <code>df -h</code>: 15.178 +</p> 15.179 +<pre> 15.180 + # mkdir rootfs 15.181 + # mount -o loop rootfs.ext2 rootfs 15.182 + # df -h 15.183 +</pre> 15.184 +<p> 15.185 +A la fin de la session de travail, vous pouvez démonter le volume avec umount: 15.186 +</p> 15.187 +<pre> 15.188 + # umount rootfs 15.189 +</pre> 15.190 +<p> 15.191 +Vous serez maintenant, sûrement intéressé par 15.192 +<a href="base-system.html">la construction du système de base SliTaz.</a> 15.193 +</p> 15.194 + 15.195 + 15.196 +<!-- End of content --> 15.197 +</div> 15.198 + 15.199 +<!-- Footer. --> 15.200 +<div id="footer"> 15.201 + <div class="footer-right"></div> 15.202 + <a href="#top">Haut de la page</a> | 15.203 + <a href="index.html">Table des matières</a> 15.204 +</div> 15.205 + 15.206 +<div id="copy"> 15.207 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 15.208 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 15.209 + Documentation publiées sous 15.210 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 15.211 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 15.212 +</div> 15.213 + 15.214 +</body> 15.215 +</html>
16.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 16.2 +++ b/doc/cookbook/locale.html Sat Mar 29 12:01:05 2008 +0100 16.3 @@ -0,0 +1,182 @@ 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 Cookbook - Locale & i18n</title> 16.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 16.10 + <meta name="description" content="SliTaz documentation install locales fr_CH fr _FR" /> 16.11 + <meta name="expires" content="never" /> 16.12 + <meta name="modified" content="2007-12-24 17:00: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="base-ncurses.html">Base ncurses</a> | 16.25 + <a href="index.html">Table des matières</a> | 16.26 + <a href="boot-scripts.html">Boot scripts</a> 16.27 +</div> 16.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 16.29 +</div> 16.30 + 16.31 +<!-- Content. --> 16.32 +<div id="content"> 16.33 +<div class="content-right"></div> 16.34 + 16.35 + 16.36 +<h2><font color="#DF8F06">Locale & i18n</font></h2> 16.37 +<p> 16.38 +Installation et configuration de la locale pour le français. 16.39 +</p> 16.40 +<ul> 16.41 + <li><a href="#install">Installation des locales.</a></li> 16.42 + <li><a href="#config">Config de la locale par défaut sur SliTaz.</a></li> 16.43 +</ul> 16.44 +<a name="install"></a> 16.45 +<h3><font color="#6c0023">Installation des locales</font></h3> 16.46 +<p> 16.47 +Ce chapitre décrit l'installation des locales sur SliTaz GNU/Linux, depuis 16.48 +un système hôte SliTaz GNU/Linux. L'install des locales pour le serveur X est 16.49 +décrite dans le chapitre <a href="x-window-system.html">X window system</a>. 16.50 +Les divers fichiers copier dans ce chapitre proviennent de la compilation 16.51 +du paquet glibc-2.3.6 fesant partie de la <em>toolchain</em>. 16.52 +</p> 16.53 +<h4>Répertoires des divers fichiers</h4> 16.54 +<p> 16.55 +Nous commençons par créer les répertoires qui contiendront les bibliothèques 16.56 +et les fichiers utiles aux différentes locales. Le répertoire LC_MESSAGES 16.57 +contient les fichiers .mo pour les messages traduits s'y ils existent: 16.58 +</p> 16.59 +<pre> 16.60 + # mkdir -p rootfs/usr/share/{i18n,locale} 16.61 + # mkdir -p rootfs/usr/lib/{locale,gconv} 16.62 + # mkdir -p rootfs/usr/share/i18n/{charmaps,locales} 16.63 + # mkdir -p rootfs/usr/share/locale/fr/LC_MESSAGES 16.64 +</pre> 16.65 +<p> 16.66 +Copie des fichiers de localisation pour le Français, le Suisse romand, 16.67 +et le Suisse allemand, dans /usr/share/i18n/locales: 16.68 +</p> 16.69 +<pre> 16.70 + # cp -a /usr/share/i18n/locales/{de_CH,fr_CH,fr_FR,i18n,iso14651_t1} \ 16.71 + rootfs/usr/share/i18n/locales 16.72 +</pre> 16.73 +<p> 16.74 +Copie des fichier translit_* dans /usr/share/i18n/locales: 16.75 +</p> 16.76 +<pre> 16.77 + # cp -a /usr/share/i18n/locales/{translit_circle,translit_cjk_compat} \ 16.78 + rootfs/usr/share/i18n/locales 16.79 + # cp -a /usr/share/i18n/locales/{translit_combining,translit_compat} \ 16.80 + rootfs/usr/share/i18n/locales 16.81 + # cp -a /usr/share/i18n/locales/{translit_font,translit_fraction} \ 16.82 + rootfs/usr/share/i18n/locales 16.83 + # cp -a /usr/share/i18n/locales/{translit_narrow,translit_neutral} \ 16.84 + rootfs/usr/share/i18n/locales 16.85 + # cp -a /usr/share/i18n/locales/{translit_small,translit_wide} \ 16.86 + rootfs/usr/share/i18n/locales 16.87 +</pre> 16.88 +<p> 16.89 +Copie des fichier charmaps dans /usr/share/i18n/charmaps 16.90 +</p> 16.91 +<pre> 16.92 + # cp -a /usr/share/i18n/charmaps/ANSI_X3.* rootfs/usr/share/i18n/charmaps 16.93 + # cp -a /usr/share/i18n/charmaps/{ISO-8859-1.gz,ISO-8859-2.gz,ISO-8859-15.gz} \ 16.94 + rootfs/usr/share/i18n/charmaps 16.95 +</pre> 16.96 +<p> 16.97 +Copie des bibliothèques gconv dans /usr/lib/gconv du rootfs de SliTaz: 16.98 +</p> 16.99 +<pre> 16.100 + # cp /usr/lib/gconv/{ANSI_X3.110.so,gconv-modules,UNICODE.so} \ 16.101 + rootfs/usr/lib/gconv 16.102 + # cp /usr/lib/gconv/{ISO8859-1.so,ISO8859-2.so,ISO8859-15.so} \ 16.103 + rootfs/usr/lib/gconv 16.104 + # strip -v rootfs/usr/lib/gconv/*.so 16.105 +</pre> 16.106 +<p> 16.107 +Copie de l'utilitaire locale: 16.108 +</p> 16.109 +<pre> 16.110 + # cp /usr/bin/locale rootfs/usr/bin 16.111 +</pre> 16.112 +<p> 16.113 +Il faut encore que le fichier /usr/lib/locale/locale-archive soit généré, 16.114 +pour cela nous utilisons l'utilitaire localedef, en se chrootant dans SliTaz: 16.115 +</p> 16.116 +<pre> 16.117 + # cp /usr/bin/localedef rootfs/usr/bin 16.118 + # chroot rootfs /bin/ash 16.119 +</pre> 16.120 +<p> 16.121 +Utilisation de <code>localedef</code> pour la Suisse romand et la France: 16.122 +</p> 16.123 +<pre> 16.124 + /# localedef -i fr_CH -f ISO-8859-1 fr_CH 16.125 + /# localedef -i fr_FR -f ISO-8859-1 fr_FR 16.126 + /# exit 16.127 +</pre> 16.128 +<p> 16.129 +Vous pouvez supprimer le binaire <code>localedef</code> pour gagner 16.130 +un peu de place. 16.131 +</p> 16.132 +<pre> 16.133 + # rm rootfs/usr/bin/localedef 16.134 +</pre> 16.135 +<a name="config"></a> 16.136 +<h3><font color="#6c0023">Config et utilisation d'une locale</font></h3> 16.137 +<p> 16.138 +Pour utiliser la langue lors d'une session, vous pouvez créer un script 16.139 +lancé au boot, ou ajouter 2 lignes au fichier ~/.profile, propre à chaque 16.140 +utilisateurs, avec pour contenu: 16.141 +</p> 16.142 +<pre class="script"> 16.143 + 16.144 +export LANG=fr_CH 16.145 +export LC_ALL=fr_CH 16.146 + 16.147 +</pre> 16.148 +<p> 16.149 +Voilà la langue Française devrait fonctionner, si vous installez retawq ou 16.150 +nano vous pouvez vérifier le bon fonctionnement des locales en copiant 16.151 +le fichier .mo des sources de Retawq, ou Nano, dans: 16.152 +/usr/share/locale/fr/LC_MESSAGES. 16.153 +</p> 16.154 +<h4>Suite</h4> 16.155 +<p> 16.156 +SliTaz utilise le script /etc/init.d/i18n.sh et le fichier de configuration 16.157 +/etc/locale.conf pour gérer la locale du système. Ce script est détaillé dans 16.158 +le chapitre <a href="boot-scripts.html">scripts de démarrage et arrêt</a>. 16.159 +Sur un système SliTaz, il suffit donc de modifier le fichier /etc/locale.conf 16.160 +avec un éditeur de texte, ou de lancer 'tazlocale' pour changer la locale par 16.161 +défaut du système, ou de spécifier la langue au boot via l'option 16.162 +<code>lang=xx</code>. 16.163 +</p> 16.164 + 16.165 + 16.166 +<!-- End of content --> 16.167 +</div> 16.168 + 16.169 +<!-- Footer. --> 16.170 +<div id="footer"> 16.171 + <div class="footer-right"></div> 16.172 + <a href="#top">Haut de la page</a> | 16.173 + <a href="index.html">Table des matières</a> 16.174 +</div> 16.175 + 16.176 +<div id="copy"> 16.177 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 16.178 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 16.179 + Documentation publiées sous 16.180 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 16.181 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 16.182 +</div> 16.183 + 16.184 +</body> 16.185 +</html>
17.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 17.2 +++ b/doc/cookbook/misc.txt Sat Mar 29 12:01:05 2008 +0100 17.3 @@ -0,0 +1,28 @@ 17.4 +SliTaz Cookbook - misc 17.5 +=============================================================================== 17.6 +Divers, tout ce qui ne va pas bien ailleur. 17.7 + 17.8 + 17.9 + * HicolorTheme - Thème par défaut des icons. 17.10 + 17.11 + 17.12 +HicolorTheme 17.13 +------------ 17.14 +Thème par défaut des icons, en soit il n'est pas indispensable, mais 17.15 +son installation évite des messages d'erreurs sur la console. 17.16 + 17.17 + # wget http://icon-theme.freedesktop.org/releases/hicolor-icon-theme-0.10.tar.gz 17.18 + # tar xzf hicolor-icon-theme-0.10.tar.gz 17.19 + # cd hicolor-icon-theme-0.10 17.20 + # ./configure --prefix 17.21 + # make DESTDIR=$PWD/_pkg install 17.22 + 17.23 + Install dans le $fs de SliTaz: 17.24 + 17.25 + # cp -a _pkg/usr $fs 17.26 + 17.27 +Vous pouvez ensuite copier les icons que vous désirez, tel que 17.28 +gnome-fs-home.png. 17.29 + 17.30 +=============================================================================== 17.31 + http://www.slitaz.org/
18.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 18.2 +++ b/doc/cookbook/packaging.html Sat Mar 29 12:01:05 2008 +0100 18.3 @@ -0,0 +1,59 @@ 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 Cookbook - Packaging</title> 18.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 18.10 + <meta name="description" content="packages receipts format categorie cook build options compilation" /> 18.11 + <meta name="expires" content="never" /> 18.12 + <meta name="modified" content="2008-01-30 13:00: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="wok-tools.html">Wok & tools</a> | 18.25 + <a href="index.html">Table des matières</a> 18.26 +</div> 18.27 +<h1><font color="#3E1220">SliTaz Cookbook</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 + 18.35 +<h2><font color="#DF8F06">Packaging</font></h2> 18.36 + 18.37 + 18.38 + 18.39 + 18.40 + 18.41 + 18.42 + 18.43 +<!-- End of content --> 18.44 +</div> 18.45 + 18.46 +<!-- Footer. --> 18.47 +<div id="footer"> 18.48 + <div class="footer-right"></div> 18.49 + <a href="#top">Haut de la page</a> | 18.50 + <a href="index.html">Table des matières</a> 18.51 +</div> 18.52 + 18.53 +<div id="copy"> 18.54 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 18.55 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 18.56 + Documentation publiées sous 18.57 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 18.58 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 18.59 +</div> 18.60 + 18.61 +</body> 18.62 +</html>
19.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 19.2 +++ b/doc/cookbook/receipts.html Sat Mar 29 12:01:05 2008 +0100 19.3 @@ -0,0 +1,244 @@ 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 Cookbook - Receipts (Recettes des paquets)</title> 19.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 19.10 + <meta name="description" content="SliTaz packages receipt la recette de construction d'un paquet slitaz tazpkg tazwok" /> 19.11 + <meta name="expires" content="never" /> 19.12 + <meta name="modified" content="2007-12-24 17:00: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="wok-tools.html">Wok & tools</a> | 19.25 + <a href="index.html">Table des matières</a> 19.26 +</div> 19.27 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 19.28 +</div> 19.29 + 19.30 +<!-- Content. --> 19.31 +<div id="content"> 19.32 +<div class="content-right"></div> 19.33 + 19.34 + 19.35 +<h2><font color="#DF8F06">Receipts (Recettes des paquets)</font></h2> 19.36 +<p> 19.37 +Ce document décrit les possibilités offertes par les recettes utilisées par 19.38 +Tazwok pour compiler et générer des paquets pour SliTaz et tazpkg, via 19.39 +(<a href="wok-tools.html">le wok et les outils</a>). La recette d'un paquet 19.40 +est aussi utilisée par Tazpkg pour installer/désinstaller et donner des 19.41 +informations au sujet d'un paquet.tazpkg (package). Chaque recette commence 19.42 +par un commentaire en English : 19.43 +</p> 19.44 +<pre class="script"> 19.45 + # SliTaz package receipt. 19.46 +</pre> 19.47 + 19.48 +<h3>Variables de base</h3> 19.49 +<p> 19.50 +Les 5 premières variables devraient toujours être présentes et configurées. 19.51 +Elles configure respectivement le non du paquet ($PACKAGE), sa version, sa 19.52 +catégorie, une courte description et le nom du mainteneur. Exemple pour le 19.53 +paquet du gestionnaire de fichiers Clex : 19.54 +</p> 19.55 +<pre class="script"> 19.56 + PACKAGE="clex" 19.57 + VERSION="3.16" 19.58 + CATEGORY="base-apps" 19.59 + SHORT_DESC="Text mode file manager." 19.60 + MAINTAINER="pankso@slitaz.org" 19.61 +</pre> 19.62 + 19.63 +<h3>Variables optionnelles</h3> 19.64 +<p> 19.65 +Tazwok sait aussi utiliser divers variables optionnelles si elles existent, il 19.66 +peut par exemple, utiliser un autre nom pour le paquet source. Il y a aussi des 19.67 +variables qui sont utilisées par Tazpkg pour gérer les dépendances ou donner 19.68 +des informations sur le paquet. 19.69 +</p> 19.70 +<p> 19.71 +<code>$DEPENDS</code>: Specifie les dépendances, il peut y avoir plusieurs 19.72 +paquets séparés par un espace ou sur plusieurs lignes. Cette variable est 19.73 +principalement utilisée par Tazpkg lors de l'installation du paquet et Tazwok 19.74 +pour construire de gros paquets comme Xorg. Exemple pour Clex qui dépend du 19.75 +paquet ncurses : 19.76 +</p> 19.77 +<pre class="script"> 19.78 + DEPENDS="ncurses" 19.79 +</pre> 19.80 +<code>$BUILD_DEPENDS</code>: Specifie les dépendances de compilation, séparées 19.81 +par un espace ou sur plusieurs lignes. Cette variable est utilisée par Tazwok 19.82 +lors de la cuisson d'un paquet et Tazwok. Exemple : 19.83 +</p> 19.84 +<pre class="script"> 19.85 + BUILD_DEPENDS="ncurses-dev" 19.86 +</pre> 19.87 +<p> 19.88 +<code>$TARBALL</code> : L'archive source avec sont extension (tar.gz, tgz ou 19.89 +tar.bz2). En générale, les variables $PACAKAGE et $VERSION sont utilisées et 19.90 +il suffit de modifier l'extension, cela permet de mettre à jour le paquet en 19.91 +ne modifiant que la variable de la version. Exemple générique (voir aussi 19.92 +la variable $SOURCE) : 19.93 +</p> 19.94 +<pre class="script"> 19.95 + TARBALL="$PACKAGE-$VERSION.tar.gz" 19.96 +</pre> 19.97 +<p> 19.98 +<code>$WEB_SITE</code> : Le site web officiel du paquet. Il se peut que 19.99 +certaines bibliothèques n'aient pas de site Web, dans ce cas il n'y a pas 19.100 +besoin de spécifier d'URL. Tazwok et Tazpkg s'attendent a trouver l'URL 19.101 +complet avec le http : 19.102 +</p> 19.103 +<pre class="script"> 19.104 + WEB_SITE="http://www.clex.sk/" 19.105 +</pre> 19.106 +<p> 19.107 +<code>$WGET_URL</code> : L'url de téléchargement des l'archive source. En 19.108 +générale la variable $TARBALL devraient être utilisée pour faciliter la mise 19.109 +à jour du paquet en ne modifiant que $VERSION. Le fichier de configuration de 19.110 +Tazwok configure aussi, par défaut, 3 variable de miroir souvent utilisés. 19.111 +$GNU_MIRROR pour les miroir GNU, $SF_MIRROR pour SourceForge et XORG_MIRROR 19.112 +pour le mirroir du serveur graphique Xorg. Exemple pour Clex : 19.113 +</p> 19.114 +<pre class="script"> 19.115 + WGET_URL="http://www.clex.sk/download/$TARBALL" 19.116 +</pre> 19.117 +<p> 19.118 +<code>$WANTED</code> : Il y a des paquets SliTaz qui sont dépendants de la 19.119 +compilation d'un paquet source. La recette de ces paquets ne nécessite pas de 19.120 +règles de compilation, une variable $WANTED peut être utilisée pour copier des 19.121 +fichiers depuis les sources du paquet voulu en utilisant la variable $src. 19.122 +</p> 19.123 +<p> 19.124 +<code>$SOURCE</code> : Il se peut que le nom du paquet Tazpkg diffère du nom 19.125 +du paquet source. C'est le cas par exemple pour les paquets d'Xorg, le nom 19.126 +Tazpkg des bibliothèque X11 est 'xorg-libX11' et le nom du paquet source est 19.127 +libX11. Cette astuces permet aussi de continuer à utiliser les varibables 19.128 +$src et $_pkg lors la cuisson d'un paquet. A noter que dans le cas libX11, 19.129 +le nom de l'archive source devient $SOURCE-$VERSION.tar.gz. 19.130 +</p> 19.131 + 19.132 +<h3>Variables utilisables dans les fonctions</h3> 19.133 +<p> 19.134 +Tazwok configure plusieurs variables permettant de faciliter la compilation et 19.135 +la construction de paquets Tazpkg. Ces variables sont gérées automatiquement 19.136 +par Tazwok en utilisant les informations contenues dans les recettes, elles 19.137 +peuvent être utilisées par la fonction compile_rules et genpkg_rules décrites 19.138 +toutes deux dans le chapitre : Fonctions. 19.139 +</p> 19.140 +<p> 19.141 +<code>$src</code> : Définit le chemin vers le répertoire des sources désarchivée. 19.142 +</p> 19.143 +<p> 19.144 +<code>$_pkg</code> : Définit le chemin vers les binaires compliés et installés 19.145 +via la commande 'make DESTDIR=$PWD/_pkg install'. Cette variable est utilisée 19.146 +pour copier les fichiers générés et créer des paquets tazpkg. 19.147 +</p> 19.148 +<p> 19.149 +<code>$fs</code> : Définit le chemin vers le pseudo système de fichier (fs) 19.150 +propre à chaque paquet. Le 'fs' d'un paquet correspond à la racine du système 19.151 +cible, un binaire tel que Clex sera par exemple dans $fs/usr/bin/clex, à noter 19.152 +qu'il faut créer les répertoires nécessaires via la fonction genpkg_rules() 19.153 +avant de copier des fichiers. 19.154 +</p> 19.155 +<p> 19.156 +<code>$CONFIGURE_ARGS</code> : Cette variables est définie dans le fichier de 19.157 +configuration de Tazwok (tazwok.conf), elle permet de spécifier des 19.158 +arguments d'optimisation générique lors de la configuration d'un paquet. 19.159 +Par défaut l'architecture est i486. 19.160 +</p> 19.161 + 19.162 +<h3>Fonctions</h3> 19.163 +<p> 19.164 +Une recette peut contenir 4 fonctions. Tazwok sait traiter les fonctions 19.165 +contenant les règles de compliation (compile_rules) et les règles servant à 19.166 +générer un paquet Tazpkg (genpkg_rules). Ces fonctions peuvent contenir toutes 19.167 +sortes de commandes GNU/Linux standards tels que sed ou patch et les variables 19.168 +configurées automatiquements. A noter que ces deux fonctions utilisent les 19.169 +commandes du Cookbook de SliTaz : http://www.slitaz.org/doc/cookbook/ 19.170 +</p> 19.171 +<h4>compile_rules()</h4> 19.172 +<p> 19.173 +Pour compiler un paquet vous pouvez utiliser la variable $src pour vous 19.174 +déplacer (cd) dans le répertoire des sources et utiliser $CONFIGURE_ARGS 19.175 +pour inclure les arguments depuis le fichiers de configuration de Tazwok. 19.176 +Pour construire le paquet il suffit généralement de lancer 'make' sans 19.177 +arguments et pour installer le paquet dans un répertoire _pkg/ il faut 19.178 +utiliser la commande 'make DESTDIR=$PWD/_pkg install'. Exemple générique : 19.179 +</p> 19.180 +<pre class="script"> 19.181 +# Rules to configure and make the package. 19.182 +compile_rules() 19.183 +{ 19.184 + cd $src 19.185 + ./configure --prefix=/usr --infodir=/usr/share/info \ 19.186 + --mandir=/usr/share/man $CONFIGURE_ARGS 19.187 + make 19.188 + make DESTDIR=$PWD/_pkg install 19.189 +} 19.190 +</pre> 19.191 +<h4>genpkg_rules()</h4> 19.192 +<p> 19.193 +Pour générer un paquet Tazpkg il faut mettre les commandes à lancer dans la 19.194 +fonction <code>genpkg_rules</code>. Dans cet exemple on créer le répertoire 19.195 +<code>usr/</code> dans le pseudo système de fichiers du paquet, on copie tout 19.196 +le(s) binaires(s) et on finit par un strip pour nettoyer les fichiers : 19.197 +</p> 19.198 +<pre class="script"> 19.199 +# Rules to gen a SliTaz package suitable for Tazpkg. 19.200 +genpkg_rules() 19.201 +{ 19.202 + mkdir -p $fs/usr 19.203 + cp -a $_pkg/usr/bin $fs/usr 19.204 + strip -s $fs/usr/bin/* 19.205 +} 19.206 +</pre> 19.207 +<h4>pre_install() et post_install()</h4> 19.208 +<p> 19.209 +Ces deux fonctions sont lancées par Tazpkg lors de l'installation du paquet. 19.210 +Il faut les définir avant de générer le paquet.tazpkg avec Tazwok. Si aucune 19.211 +commandes n'est nécessaires ces deux fonction n'ont aucune raison d'être et 19.212 +peuvent être supprimées. Exemple avec echo pour afficher un peu de texte 19.213 +(aucune fonction ne doit être vide) : 19.214 +</p> 19.215 +<pre class="script"> 19.216 +# Pre and post install commands for Tazpkg. 19.217 +pre_install() 19.218 +{ 19.219 + echo "Processing pre-install commands..." 19.220 +} 19.221 +post_install() 19.222 +{ 19.223 + echo "Processing post-install commands..." 19.224 +} 19.225 +</pre> 19.226 + 19.227 + 19.228 +<!-- End of content --> 19.229 +</div> 19.230 + 19.231 +<!-- Footer. --> 19.232 +<div id="footer"> 19.233 + <div class="footer-right"></div> 19.234 + <a href="#top">Haut de la page</a> | 19.235 + <a href="index.html">Table des matières</a> 19.236 +</div> 19.237 + 19.238 +<div id="copy"> 19.239 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 19.240 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 19.241 + Documentation publiées sous 19.242 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 19.243 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 19.244 +</div> 19.245 + 19.246 +</body> 19.247 +</html>
20.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 20.2 +++ b/doc/cookbook/release-tasks.txt Sat Mar 29 12:01:05 2008 +0100 20.3 @@ -0,0 +1,44 @@ 20.4 +SliTaz Cookbook - LiveCD release tasks 20.5 +=============================================================================== 20.6 +Les choses à faire avant de publier un nouvelles version. 20.7 + 20.8 + 20.9 + * Préparer l'arbre de la distribution et la liste des paquets, générer un 20.10 + fichier de configuration et le configurer avec les commandes de Tazlito 20.11 + (tazlito gen-config && tazlito configure). 20.12 + 20.13 + * Vérifier le menu de JWM pour que toutes les applications soient disponibles 20.14 + et que le fond d'écran configuré soit bien présent (/usr/share/images). A 20.15 + noter que le menu/thème de JWM est installé par les SliTaz tools. 20.16 + 20.17 + * Ajouter l'utilisateur hacker avec le script addhacker, les fichiers copier 20.18 + son placés dans addfiles et proviennent des exemples fournits par les 20.19 + outils (slitaz-tools). Les permissions devraient être vérifiée. Le Cookbook 20.20 + en parle : http://www.slitaz.org/doc/cookbook/hacker.txt 20.21 + 20.22 + * Checker la version de Slitaz spécifiée dans le message : /etc/issue 20.23 + Il faut que se soit la même que dans le fichier isolinux.msg affiché en 20.24 + premier au démarrage et dans le fichiers de configuration du miroir pour 20.25 + Tazpkg : /var/lib/tazpkg/mirror. 20.26 + 20.27 + * Editer le fichier isolinux.msg pour y mettre la date de publication/version 20.28 + en accord avec /etc/issue. 20.29 + 20.30 + * En cas de chroot et modifications dans le rootfs, on peut reconstruire 20.31 + le système avec 'tazlito gen-initiso' (ne pas oublier de fichiers cachés 20.32 + dans /root). 20.33 + 20.34 + * Ajouter et vérifier les documents et images qui sont à la racine du cdrom, 20.35 + le fichier README, index.html, style.css et le répertoire des images. Tous 20.36 + les fichiers sont dans l'archive des slitaz-tools et il suffit de les 20.37 + copier dans addfiles/ avant de regénérer l'ISO. 20.38 + 20.39 + * Tester, tester, encore tester... 20.40 + 20.41 + * Préparer l'annonce pour le site Web et le flux RSS, mettre à jour le 20.42 + Handbook si ce n'est pas déjà fait et modifier la TODO list de la partie 20.43 + développement du site (http://www.slitaz.org/devel/). 20.44 + 20.45 + 20.46 +=============================================================================== 20.47 + http://www.slitaz.org/
21.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 21.2 +++ b/doc/cookbook/rootcd.html Sat Mar 29 12:01:05 2008 +0100 21.3 @@ -0,0 +1,215 @@ 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 Cookbook - Rootcd</title> 21.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 21.10 + <meta name="description" content="" /> 21.11 + <meta name="expires" content="never" /> 21.12 + <meta name="modified" content="2007-12-24 17:00: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="http://www.slitaz.org/">www.slitaz.org</a> 21.25 +</div> 21.26 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 21.27 +</div> 21.28 + 21.29 +<!-- Content. --> 21.30 +<div id="content"> 21.31 +<div class="content-right"></div> 21.32 + 21.33 +<h2><font color="#DF8F06">Rootcd</font></h2> 21.34 +<p> 21.35 +Déscriptions et améliorations des fichiers contenus sur le cdrom. 21.36 +</p> 21.37 + 21.38 +<ul> 21.39 + <li><a href="#syslinux">Syslinux/isolinux.</a></li> 21.40 + <li><a href="#splash">Splash image au boot d'isolinux.</a></li> 21.41 + <li><a href="#isolinux-iso">ISO bootable avec isolinux.</a></li> 21.42 + <li><a href="#grub">GRUB.</a></li> 21.43 + <li><a href="#grub-iso">ISO bootable avec GRUB.</a></li> 21.44 + <li><a href="#memtest86">Memtest86.</a></li> 21.45 +</ul> 21.46 + 21.47 +<a name="syslinux"></a> 21.48 +<h3><font color="#6c0023">Syslinux/isolinux</font></h3> 21.49 +<p> 21.50 +Syslinux et le bootloader principale de SliTaz, nous utilisons la version 21.51 +isolinux pour faire démarrer le système contenu sur le cd-rom. Il est simple, 21.52 +efficace, et largement configurable. Isolinux a été installé lors de la 21.53 +création du système de base : <a href="base-system.html">Base system</a>. 21.54 +Le binaire est isolinux.bin, et le fichier de configuration est: isolinux.cfg. 21.55 +Voici un exemple d'isolinux.cfg, utilisant isolinux.msg pour afficher l'image 21.56 +splash, et utilisant des fichiers d'aides affichables via F1, F2, F3, etc. Vous 21.57 +trouverez un fichier help.txt, options.txt, etc, dans SliTaz tools : 21.58 +</p> 21.59 +<pre class="script"> 21.60 +display isolinux.msg 21.61 +default slitaz 21.62 +label slitaz 21.63 + kernel /boot/bzImage 21.64 + append initrd=/boot/rootfs.gz rw root=/dev/null vga=788 21.65 +implicit 0 21.66 +prompt 1 21.67 +timeout 80 21.68 +F1 help.txt 21.69 +F2 options.txt 21.70 +F3 isolinux.msg 21.71 +F4 display.txt 21.72 +</pre> 21.73 + 21.74 +<a name="splash"></a> 21.75 +<h3><font color="#6c0023">Splash image au boot d'isolinux</font></h3> 21.76 +<p> 21.77 +Nous pouvons configurer isolinux pour avoir une jolie image au boot de SliTaz, 21.78 +ou tout autres système utilisant isolinux. Cette image à un format particulier 21.79 +.lss, propre à Syslinux, et elle doit être au mode indexé de 16 couleurs. Vous 21.80 +pouvez utiliser le logo officiel, ppmforge, imagemagic, Gimp, ou autre pour 21.81 +créer votre image. 21.82 +</p> 21.83 +<p> 21.84 +L'archive de Syslinux fourni un logo officiel (sample/syslogo.lss) que vous 21.85 +pouvez directement utiliser en le copiant dans la racine du cd-rom. SliTaz 21.86 +fourni un logo (rootcd/boot/isolinux/splash.lss) que vous trouverez dans 21.87 +l'archive des SliTaz tools. Pour afficher l'image au boot, il faut que l'option 21.88 +'display' appelle le fichier isolinux.msg, qui lui charge l'image au format 21.89 +*.lss. A noter que le fichier isolinux.msg, utilise des caractères ASCII 24. 21.90 +Exemple de création avec 'echo', d'un fichier isolinux.msg utilisant une image 21.91 +splash.lss : 21.92 +</p> 21.93 +<pre> 21.94 + # echo -e "\24isplash.lss\n" > isolinux.msg 21.95 +</pre> 21.96 +<p> 21.97 +Vous pouvez aussi ajouter un message texte afficher sous l'image splash en 21.98 +modifiant ce fichier avec un éditeur de texte, echo, ou cat. 21.99 +</p> 21.100 + 21.101 +<a name="isolinux-iso"></a> 21.102 +<h3><font color="#6c0023">ISO bootable avec isolinux</font></h3> 21.103 +<p> 21.104 +Pour créer un image ISO bootable, en utilisant isolinux, et genisoimage : 21.105 +</p> 21.106 +<pre> 21.107 + # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \ 21.108 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 21.109 + -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd 21.110 +</pre> 21.111 + 21.112 +<a name="grub"></a> 21.113 +<h3><font color="#6c0023">GRUB</font></h3> 21.114 +<p> 21.115 +GRUB (GRand Unified Bootloader), est un bootloader distribué par le projet GNU. 21.116 +C'est lui que nous utilisons lors d'une installation sur disque dure, il peut 21.117 +booter Linux, BSD, Hurd, et Window$. GRUB fournit l'image stage2_eltorito pour 21.118 +faire démarrer les images ISO. Pour trouver stage2_eltorito sur votre système, 21.119 +il faut que le paquet GRUB soit installé. Pour finir vous devez copier 21.120 +stage2_eltorito dans le racine du cdrom. A noter que SliTaz fournit un paquet 21.121 +(.tazpkg) de grub-0.97, que vous trouverez sur les miroirs et vous pouvez 21.122 +aussi recompiler grub-0.97 depuis les sources. Exemple de copie de l'image 21.123 +<code>stage2_eltorito</code> depuis un système Debian ou SliTaz : 21.124 +</p> 21.125 +<pre> 21.126 + # mkdir -p rootcd/boot/grub 21.127 + # cp /usr/lib/grub/i386-pc/stage2_eltorito \ 21.128 + rootcd/boot/grub 21.129 +</pre> 21.130 +<p> 21.131 +Le fichier de configuration de grub se nomme menu.lst, c'est un fichier texte 21.132 +éditable avec votre éditeur de texte préféré. En voici un exemple : 21.133 +</p> 21.134 +<pre class="script"> 21.135 +# By default, boot the first entry. 21.136 +default 0 21.137 + 21.138 +# Boot automatically after 20 secs. 21.139 +timeout 20 21.140 + 21.141 +# Change the colors. 21.142 +color yellow/brown white/black 21.143 + 21.144 +title SliTaz GNU/Linux 1.0 (vga 800x600) (Kernel 2.6.20) 21.145 + kernel /boot/bzImage root=/dev/null vga=788 21.146 + initrd /boot/rootfs.gz 21.147 + 21.148 +title SliTaz GNU/Linux 1.0 (vga 1024x768) (Kernel 2.6.20) 21.149 + kernel /boot/bzImage root=/dev/null vga=771 21.150 + initrd /boot/rootfs.gz 21.151 +</pre> 21.152 + 21.153 +<a name="grub-iso"></a> 21.154 +<h3><font color="#6c0023">ISO bootable avec GRUB</font></h3> 21.155 +<p> 21.156 +Pour créer un image ISO bootable, en utilisant GRUB, et genisiimage ou mkisofs : 21.157 +</p> 21.158 +<pre> 21.159 + # genisoimage -R -o slitaz-test.iso -b boot/grub/stage2_eltorito \ 21.160 + -no-emul-boot -V "SliTaz" -boot-load-size 4 -input-charset iso8859-1 \ 21.161 + -boot-info-table rootcd 21.162 +</pre> 21.163 +<a name="Memtest86"></a> 21.164 +<h3><font color="#6c0023">Memtest86</font></h3> 21.165 +<p> 21.166 +L'application memtest86 (92 ko), est un outil autonome de test de mémoire vive 21.167 +(RAM). Nous téléchargeons l'utilitaire dans le répertoire src, décompression de 21.168 +l'archive, et copie du binaire précompilé : 21.169 +</p> 21.170 +<pre> 21.171 + # mkdir -v -p src 21.172 + # cd src 21.173 + # wget http://www.memtest86.com/memtest86-3.2.tar.gz 21.174 + # tar xzfv memtest86-3.2.tar.gz 21.175 + # cd memtest86-3.2 21.176 + (# more README) 21.177 + # cp precomp.bin ../../rootcd/boot/memtest 21.178 + # cd ../.. 21.179 +</pre> 21.180 +<p> 21.181 +Une fois installé, vous pouvez ajouter un label pour memtest86 au fichier: 21.182 +isolinux.cfg en spécifiant le chemin vers l'utilitaire : 21.183 +</p> 21.184 +<pre class="script"> 21.185 +label memtest 21.186 + kernel /boot/memtest 21.187 +</pre> 21.188 +<p> 21.189 +Ou si vous voulez utiliser GRUB, les lignes pour lancer memtest86 sont: 21.190 +</p> 21.191 +<pre class="script"> 21.192 +title Memtest86 (Test system memory) 21.193 +kernel /boot/memtest 21.194 +</pre> 21.195 +<p> 21.196 +Une fois les lignes ajoutées, vous pouvez créer un nouvelle ISO, et la tester. 21.197 +</p> 21.198 + 21.199 +<!-- End of content --> 21.200 +</div> 21.201 + 21.202 +<!-- Footer. --> 21.203 +<div id="footer"> 21.204 + <div class="footer-right"></div> 21.205 + <a href="#top">Haut de la page</a> | 21.206 + <a href="index.html">Table des matières</a> 21.207 +</div> 21.208 + 21.209 +<div id="copy"> 21.210 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 21.211 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 21.212 + Documentation publiées sous 21.213 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 21.214 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 21.215 +</div> 21.216 + 21.217 +</body> 21.218 +</html>
22.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 22.2 +++ b/doc/cookbook/template.html Sat Mar 29 12:01:05 2008 +0100 22.3 @@ -0,0 +1,55 @@ 22.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 22.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 22.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 22.7 +<head> 22.8 + <title>SliTaz Cookbook - Template</title> 22.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 22.10 + <meta name="description" content="" /> 22.11 + <meta name="expires" content="never" /> 22.12 + <meta name="modified" content="2007-12-24 17:00:00" /> 22.13 + <meta name="publisher" content="www.slitaz.org" /> 22.14 + <meta name="author" content="Christophe Lincoln"/> 22.15 + <link rel="shortcut icon" href="favicon.ico" /> 22.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 22.17 +</head> 22.18 +<body bgcolor="#ffffff"> 22.19 + 22.20 +<!-- Header and quick navigation --> 22.21 +<div id="header"> 22.22 +<div align="right" id="quicknav"> 22.23 + <a name="top"></a> 22.24 + <a href="http://www.slitaz.org/">www.slitaz.org</a> 22.25 +</div> 22.26 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 22.27 +</div> 22.28 + 22.29 +<!-- Content. --> 22.30 +<div id="content"> 22.31 +<div class="content-right"></div> 22.32 + 22.33 + 22.34 +<p> 22.35 +CONTENT 22.36 +</p> 22.37 + 22.38 + 22.39 +<!-- End of content --> 22.40 +</div> 22.41 + 22.42 +<!-- Footer. --> 22.43 +<div id="footer"> 22.44 + <div class="footer-right"></div> 22.45 + <a href="#top">Haut de la page</a> | 22.46 + <a href="index.html">Table des matières</a> 22.47 +</div> 22.48 + 22.49 +<div id="copy"> 22.50 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 22.51 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 22.52 + Documentation publiées sous 22.53 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 22.54 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 22.55 +</div> 22.56 + 22.57 +</body> 22.58 +</html>
23.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 23.2 +++ b/doc/cookbook/wok-tools.html Sat Mar 29 12:01:05 2008 +0100 23.3 @@ -0,0 +1,260 @@ 23.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 23.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 23.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 23.7 +<head> 23.8 + <title>SliTaz Cookbook - Wok & Tools</title> 23.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 23.10 + <meta name="description" content="" /> 23.11 + <meta name="expires" content="never" /> 23.12 + <meta name="modified" content="2007-12-24 17:00:00" /> 23.13 + <meta name="publisher" content="www.slitaz.org" /> 23.14 + <meta name="author" content="Christophe Lincoln"/> 23.15 + <link rel="shortcut icon" href="favicon.ico" /> 23.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 23.17 +</head> 23.18 +<body bgcolor="#ffffff"> 23.19 + 23.20 +<!-- Header and quick navigation --> 23.21 +<div id="header"> 23.22 +<div align="right" id="quicknav"> 23.23 + <a name="top"></a> 23.24 + <a href="index.html">Table des matières</a> | 23.25 + <a href="receipts.html">Receipts</a> 23.26 +</div> 23.27 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 23.28 +</div> 23.29 + 23.30 +<!-- Content. --> 23.31 +<div id="content"> 23.32 +<div class="content-right"></div> 23.33 + 23.34 + 23.35 +<h2><font color="#DF8F06">Wok & Tools</font></h2> 23.36 +<ul> 23.37 + <li><a href="#utils">Les utilitaires du projet.</a></li> 23.38 + <li><a href="#wok">Woking</a> - Utiliser le wok.</li> 23.39 + <li><a href="#cook">Compiler et générer des paquets.</a></li> 23.40 + <li><a href="#opts">Options de compilations des paquets.</a></li> 23.41 + <li><a href="#files">Fichiers inclus ou exclus des paquets.</a></li> 23.42 + <li><a href="#categories">Catégories des paquets.</a></li> 23.43 + <li><a href="#woktree">Structure d'un paquet dans le wok.</a></li> 23.44 + <li><a href="#pkgtree">Structure d'un paquet tazpkg.</a></li> 23.45 + <li><a href="receipts.html">Recettes des paquets.</a></li> 23.46 +</ul> 23.47 + 23.48 +<a name="utils"></a> 23.49 +<h3>Les utilitaires du projet</h3> 23.50 +<p> 23.51 +Au file du temps le projet SliTaz à créer divers petits utilitaires permettant 23.52 +de reconstruire le système depuis les sources et de façon automatique. 23.53 +<a href="http://www.slitaz.org/get/tazwok.html">Tazwok</a> est utilisé pour 23.54 +compiler et générer des paquets (<em>cook</em> pour cuire) via 23.55 +les intructions trouvées dans <a href="receipts.html">les recettes</a>. Le 23.56 +projet propose aussi une archive d'outils contenant divers petits utilitaires, 23.57 +des exemples et des fichiers de configuration. Le générateur de distribution 23.58 +<em>Live</em> Tazlito (SliTaz Live Tool), déstiné aux utilisateurs 23.59 +et développeurs. Tazlito permet d'extraire et reconstruire une image ISO 23.60 +de LiveCD et de générer des distributions à saveure depuis une liste de 23.61 +paquets, un fichier de configuration et une description. Les utilitaires sont 23.62 +tous distribués sous forme d'archive source et sont installés par défaut sur 23.63 +SliTaz. Les développeurs ou futur contributeurs peuvent se référencer à la page 23.64 +<a href="http://www.slitaz.org/devel/forge.html">forge</a> donnant des 23.65 +informations sur la gestion du projet SliTaz. 23.66 +</p> 23.67 +<h4>Tazwok et le wok</h4> 23.68 +<p> 23.69 +L'idée est d'utiliser un répertoire (wok) contenant tous les paquets 23.70 +disponibles, chaque paquet contient au minimum une recette (receipt) servant 23.71 +à télécharger, désarchiver, compiler et générer le paquet binaire. Pour 23.72 +fonctionner, Tazwok a aussi besoin d'un répertoire pour stocker les sources 23.73 +téléchargées ($SOURCES_REPOSITORY) et d'un répertoire pour les paquets générés 23.74 +($PACKAGES_REPOSITORY), ces valeurs peuvent être configurées via le fichier : 23.75 +/etc/tazwok.conf. 23.76 +</p> 23.77 + 23.78 +<a name="wok"></a> 23.79 +<h3><font color="#6c0023">Woking - Utiliser le wok</font></h3> 23.80 +<p> 23.81 +Woking ou comment utiliser le wok pour construire des paquets. Pour commencer 23.82 +il faut que <a href="http://www.slitaz.org/get/tazwok.html">Tazwok</a> soit 23.83 +installé sur votre système et que les principaux outils de développement le 23.84 +soit aussi (binutils, compilateur, librairies-dev, make), sur Slitaz il suffit 23.85 +d'installer le meta-paquet <code>slitaz-toolchain</code> : 23.86 +</p> 23.87 +<pre> 23.88 + # tazpkg recharge 23.89 + # tazpkg get-install slitaz-toolchain 23.90 +</pre> 23.91 +<h4>Récupérer le wok</h4> 23.92 +<p> 23.93 +Pour travailler il faut récupérer le wok depuis le dépôt Mercurial ou depuis 23.94 +une archive sur le miroir principale (TuxFamily) de Slitaz. En supposant que 23.95 +SliTaz se construit dans <code>/home/slitaz</code> : 23.96 +</p> 23.97 +<pre> 23.98 + $ hg clone http://hg.slitaz.org/wok/ /home/slitaz/wok 23.99 +</pre> 23.100 +<p> 23.101 +Les archives sont aussi récupérable depuis l'URL : 23.102 +<a href="ftp://download.tuxfamily.org/slitaz/wok/">ftp://download.tuxfamily.org/slitaz/wok/</a>. 23.103 +Il suffit de prendre la dernière version et de la désarchiver où bon vous 23.104 +semble. Avant de compiler son premier paquet il faut configurer Tazwok pour 23.105 +qu'il trouve le wok préalablement téléchargé. Par défaut le chemin est 23.106 +<code>/home/slitaz/wok</code>, vous pouvez le changer ou renommer le wok 23.107 +téléchargé. Pour afficher/vérifier les chemins que Tazwok va utiliser et 23.108 +le nombres de paquet disponibles dans le wok, vous pouvez utiliser la 23.109 +commande <code>stats</code> de Tazwok : 23.110 +</p> 23.111 +<pre> 23.112 + # tazwok stats 23.113 +</pre> 23.114 + 23.115 +<a name="cook"></a> 23.116 +<h3>Compiler et générer des paquets</h3> 23.117 +<p> 23.118 +Configuer, compiler, striper, générer le paquet SliTaz et le compresser peut 23.119 +se faire en une seule commandes. Pour éviter toute frustration... il est 23.120 +conseillé de commencer par construire un paquet, sans modifier sa recette, et 23.121 +ne demandant pas de dépendances. M4 est idéal pour se lancer et cuire (cook) : 23.122 +</p> 23.123 +<pre> 23.124 + # tazwok cook m4 23.125 +</pre> 23.126 +<p> 23.127 +Une fois le travail fini, le paquet SliTaz se trouvent dans le repositoire 23.128 +spécifié dans la configuration (Par défaut <code>/home/slitaz/packages</code>). 23.129 +Si tout c'est bien passé, vous pouvez installer le paquet sur le système hôte 23.130 +ou l'utiliser pour générer votre distribution LiveCD via 23.131 +<a href="http://www.slitaz.org/doc/manuals/tazlito.html">Tazlito</a>. Pour 23.132 +créer un nouveau paquet vous pouvez utiliser la commande <code>new-tree</code> 23.133 +avec l'option <code>--interactive</code> et lire la document au sujet des 23.134 +possibilités proposée par <a href="receipts.html">les recettes</a> des paquets. 23.135 +Toutes les commandes disponibles avec Tazwok sont décrite dans : 23.136 +<a href="http://www.slitaz.org/doc/manuals/tazwok.html">Tazwok manual</a> 23.137 +</p> 23.138 +<h4>Cooklists - Liste de cuisson</h4> 23.139 +<p> 23.140 +Pour compiler plusieurs paquets en une seule commande, on peut utiliser des 23.141 +listes de cuisson. Il y a des listes exemples dans le répertoire 23.142 +/usr/share/examples/tazwok/cooklists sur SliTaz, c'est juste un fichier texte 23.143 +avec un paquet par ligne. Exemple avec mypkgs.cooklist : 23.144 +</p> 23.145 +<pre> 23.146 + # tazwok cook-list mypkgs.cooklist 23.147 +</pre> 23.148 + 23.149 +<a name="opts"></a> 23.150 +<h3>Options de compilations des paquets</h3> 23.151 +<p> 23.152 +Vous êtes libre d'utiliser les options de compilation que vous désirez, il faut 23.153 +juste respecter le FSH, la doc dans /usr/share/doc par exemple et suivre les 23.154 +standards de Freedesktop (.desktop en autre). Ensuite c'est une questions de 23.155 +choix, on peut par exemple désactiver le support XML pour avoir un binaire PHP 23.156 +plus petit et se débarasser de libxml2, mais dans le cas de PHP le gain de 23.157 +place ne vaut pas le coup par rapport aux pertes de fonctionnailtés. Si vous 23.158 +avez des doutes, regardez des recettes existantes et leure options de 23.159 +compilation dans <code>compile_rules</code>. 23.160 +</p> 23.161 +<h4>Optimisation</h4> 23.162 +<p> 23.163 +Les paquets SliTaz officiels sont optimisés pour i486, les options 23.164 +d'optimisation passées en arguments à configure sont spécifiées dans le 23.165 +fichier de configuration de Tazwok (<code>/etc/tazwok.conf</code>) et peuvent 23.166 +être appelées via la variable <code>$CONFIGURE_ARGS</code>. Si vous voulez 23.167 +compiler un paquet avec des arguments différents, vous pouvez modifier le 23.168 +fichier de configuration de Tazwok : 23.169 +</p> 23.170 +<pre class="script"> 23.171 +CONFIGURE_ARGS="--build=i486-pc-linux-gnu --host=i486-pc-linux-gnu" 23.172 +</pre> 23.173 + 23.174 +<a name="files"></a> 23.175 +<h3>Fichiers inclus ou exclus des paquets</h3> 23.176 +<p> 23.177 +Au sujet des fichiers à inclures ou exclures du paquet, l'idée et de mettre le 23.178 +minimum dans le paquet de base et de créer des paquets séparés pour les 23.179 +fichiers optionnels ou de développement. En général, les paquets de base ne 23.180 +contiennent pas de man, info, doc ou librairies statique, il faut créer un 23.181 +paquet-doc ou paquet-dev. A noter que SliTaz ne propose pas la commande man ou 23.182 +info, donc pas de manuel ou fichier GNU info et que la création de paquets 23.183 +contenant la doc est vraiment en option, surtout si la documentation est en 23.184 +English. Par contre, un bout de texte au sujet du paquet dans le Handbook est 23.185 +plus qu'apprécié. 23.186 +</p> 23.187 +<p> 23.188 +Au niveau des fichiers de configuration, quand c'est possible, le but est de 23.189 +proposer des fichiers de configurations de base permettant de faire fonctionner 23.190 +directement le paquet. Dans le cas du serveur Web LightTPD, le paquet SliTaz 23.191 +fourni des fichiers de configuration fait maison et le script de démarrage du 23.192 +démon situé dans /etc/init.d, le tout documenté dans le Handbook. Pour un 23.193 +nouveau paquet, vous êtes libre de choisir sa configuration par défaut en 23.194 +fonction de ce qui vous semble le plus simple pour l'utilisateur final. Sur 23.195 +SliTaz vous disposez aussi d'un répertoire /usr/share/examples destiné à des 23.196 +exemples de configuration ou autres types d'exemples utiles. 23.197 +</p> 23.198 + 23.199 +<a name="categories"></a> 23.200 +<h3>Catégories des paquets</h3> 23.201 +<p> 23.202 +Les catégories des paquets existent à titre d'information et ne sont pas encore 23.203 +vraiment figée. L'idée est de classer les paquets pour une futur interface web 23.204 +dont les pages seraient générée chaque nuit depuis le wok en récupérant les 23.205 +données dans les recettes des paquets. Dans l'immédiat, les paquets de 23.206 +développement dans 'devel', Xorg et compagnie dans 'x-window' et la plus part 23.207 +des nouveautés dans 'extra'. 23.208 +</p> 23.209 + 23.210 +<a name="woktree"></a> 23.211 +<h3>Structure d'un paquet dans le wok</h3> 23.212 +<p> 23.213 +La structure des paquets dans le wok devraient être respectée si l'on veut que 23.214 +Tazwok trouve les bons fichiers et répertoires. Contenu possible d'un paquet 23.215 +(le répertoire taz/ est créé lors le la cuission) : 23.216 +</p> 23.217 +<ul> 23.218 + <li><code>stuff/</code> : Le matériel utilisé pour configurer, compiler et 23.219 + générer le paquet (patche(s), Makefile, pseudo fs, etc).</li> 23.220 + <li><code>taz/</code> : Répertoire contenant l'arbre du paquet Tazpkg 23.221 + généré, le paquet compressé est stocké dans le répertoire spécifié par 23.222 + $PACKAGES_REPOSITORY du fichier de configuration de Tazwok.</li> 23.223 + <li><code>receipt</code> : La recette de cuisine (voir 23.224 + <a href="receipts.html">receipts</a>).</li> 23.225 + <li><code>description.txt</code> : La description du paquet (en option) est copiée 23.226 + à la racine du paquet Tazpkg. Une fois installé, 'tazpkg' sait 23.227 + traiter ce fichier via la commande 'tazpkg desc pkgname'.</li> 23.228 +</ul> 23.229 + 23.230 +<a name="pkgtree"></a> 23.231 +<h3>Structure d'un paquet tazpkg</h3> 23.232 +<p> 23.233 +Les paquets SliTaz sont des archives cpio contenant un système de fichiers 23.234 +compressé avec gzip et des fichiers : 23.235 +</p> 23.236 +<ul> 23.237 + <li><code>fs/</code> : Pseudo système de fichiers contenant tous les 23.238 + fichiers à installer.</li> 23.239 + <li><code>receipt</code> : La recette de cuisine (voir receipt.txt).</li> 23.240 + <li><code>files.list</code> : Liste des fichiers contenus dans le paquet.</li> 23.241 + <li><code>description.txt</code> : La description du paquet (en option).</li> 23.242 +</ul> 23.243 + 23.244 +<!-- End of content --> 23.245 +</div> 23.246 + 23.247 +<!-- Footer. --> 23.248 +<div id="footer"> 23.249 + <div class="footer-right"></div> 23.250 + <a href="#top">Haut de la page</a> | 23.251 + <a href="index.html">Table des matières</a> 23.252 +</div> 23.253 + 23.254 +<div id="copy"> 23.255 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 23.256 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 23.257 + Documentation publiées sous 23.258 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 23.259 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 23.260 +</div> 23.261 + 23.262 +</body> 23.263 +</html>
24.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 24.2 +++ b/doc/cookbook/x-window-system.html Sat Mar 29 12:01:05 2008 +0100 24.3 @@ -0,0 +1,536 @@ 24.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 24.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 24.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 24.7 +<head> 24.8 + <title>SliTaz Cookbook - Template</title> 24.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 24.10 + <meta name="description" content="SliTaz GNU/Linux install XFree86 Xvesa Links fontconfig JWM expat" /> 24.11 + <meta name="expires" content="never" /> 24.12 + <meta name="modified" content="2007-12-24 17:00:00" /> 24.13 + <meta name="publisher" content="www.slitaz.org" /> 24.14 + <meta name="author" content="Christophe Lincoln"/> 24.15 + <link rel="shortcut icon" href="favicon.ico" /> 24.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 24.17 +</head> 24.18 +<body bgcolor="#ffffff"> 24.19 + 24.20 +<!-- Header and quick navigation --> 24.21 +<div id="header"> 24.22 +<div align="right" id="quicknav"> 24.23 + <a name="top"></a> 24.24 + <a href="boot-scripts.html">Boot scripts</a> | 24.25 + <a href="index.html">Table des matières</a> | 24.26 + <a href="gtk-libs.html">GTK+ libs</a> 24.27 +</div> 24.28 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 24.29 +</div> 24.30 + 24.31 +<!-- Content. --> 24.32 +<div id="content"> 24.33 +<div class="content-right"></div> 24.34 + 24.35 + 24.36 +<h2><font color="#DF8F06">X window system</font></h2> 24.37 +<p> 24.38 +Installation et configuration de base du système de fenêtres X. 24.39 +</p> 24.40 +<ul> 24.41 + <li><a href="#about">A propos de ce chapitre</a> - Description et variable 24.42 + d'environnement ($fs)</li> 24.43 + <li><a href="#expat">expat-2.0.0</a> - XML parser library.</li> 24.44 + <li><a href="#freetype">freetype-2.3.1</a> - Bibliothèques de police sytème.</li> 24.45 + <li><a href="#fontconfig">fontconfig 2.4.2</a> - Outils de gestion des polices.</li> 24.46 + <li><a href="#xserver">Xserver</a> - Serveur graphique Xvesa d'Xfree86 24.47 + 4.6.0 et les bibliothèques d'Xorg.</li> 24.48 + <li><a href="#xterm">xterm-223</a> - Emulateur de terminal.</li> 24.49 + <li><a href="#libpng">libpng-1.2.18</a> - Les bibliothèques de manip des images PNG.</li> 24.50 + <li><a href="#jwm">jwm-2.0</a> - Gestionnaire de fenêtres.</li> 24.51 + <li><a href="#jpeg">jpeg-6b</a> - Les bibliothèques de manip des images JPEG.</li> 24.52 + <li><a href="#tiff">tiff-3.8.2</a> - Bibliothèques et utilitaires TIFF.</li> 24.53 + <li><a href="#links">links-2.1pre29</a> - Navigateur web graphique et texte.</li> 24.54 + <li><a href="#initramfs-iso">Génération de l'initramfs, et d'une image ISO.</a></li> 24.55 +</ul> 24.56 +<a name="about"></a> 24.57 +<h3><font color="#6c0023">A propos</font></h3> 24.58 +<p> 24.59 +Ce chapitre décrit l'installation et la configuration du système X 24.60 +window sur SliTaz. Nous allons installer, les bibliothèques pour les 24.61 +polices, expat, XML, un server graphique (Xvesa), un émulateur de 24.62 +terminal (XTerm), divers petits outils, et un gestionnaire de 24.63 +fenêtres (JWM). Nous vous proposons aussi d'installer les 24.64 +bibliothèques JPEG et le navigateur web Links (en français). 24.65 +</p> 24.66 +<h4>Variable d'environnement ($fs)</h4> 24.67 +<p> 24.68 +Pour ne pas spécifier tout le chemin vers le répertoire rootfs, export 24.69 +de la variable d'environnement: 24.70 +</p> 24.71 +<pre> 24.72 + # export fs=$PWD/rootfs 24.73 +</pre> 24.74 +<p> 24.75 +Pour vérifier: 24.76 +</p> 24.77 +<pre> 24.78 + # echo $fs 24.79 +</pre> 24.80 +<a name="expat"></a> 24.81 +<h3><font color="#6c0023">expat-2.0.0 - XML parser library</font></h3> 24.82 +<p> 24.83 +Expat (<a href="http://expat.sourceforge.net/">http://expat.sourceforge.net/</a>) 24.84 +contient des bibliothèques d'analyse XML: 24.85 +</p> 24.86 +<pre> 24.87 + # cd .. 24.88 + # wget http://switch.dl.sourceforge.net/sourceforge/expat/expat-2.0.0.tar.gz 24.89 + # tar xzf expat-2.0.0.tar.gz 24.90 + # cd expat-2.0.0 24.91 + # ./configure --sysconfdir=/etc --prefix=/usr \ 24.92 + --mandir=/usr/share/man 24.93 + # make 24.94 + # make DESTDIR=$PWD/_pkg install 24.95 + # strip -v _pkg/usr/lib/* 24.96 + # strip -v _pkg/usr/bin/* 24.97 +</pre> 24.98 +<p> 24.99 +Par la suite nous allons installer 'xterm' qui a besoin de libexpat.so.0, 24.100 +il suffit de créer un lien symbolique sur libexpat.so.1.5.0, et le tour est 24.101 +joué. Ensuite vous pouvez installerles bibliothèques, et l'application 'xmlwf' 24.102 +dans le rootfs: 24.103 +</p> 24.104 +<pre> 24.105 + # cd _pkg/usr/lib 24.106 + # ln -s libexpat.so.1.5.0 libexpat.so.0 24.107 + # cp -a *.so* $fs/usr/lib 24.108 + # cd .. 24.109 + # cp -a bin/* $fs/usr/bin 24.110 + # cd ../.. 24.111 +</pre> 24.112 +<h4>libs</h4> 24.113 +Bibliothèques uitilisées par xmlwf: 24.114 +<pre class="script"> 24.115 + libexpat.so.1 => /usr/lib/libexpat.so.1 (0x40021000) 24.116 + libc.so.6 => /lib/tls/libc.so.6 (0x40041000) 24.117 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) 24.118 +</pre> 24.119 +<a name="freetype"></a> 24.120 +<h3><font color="#6c0023">freetype-2.3.1 - Bibliothèques de police sytème</font></h3> 24.121 +<p> 24.122 +Le paquet freetype (<a href="http://www.freetype.org/">http://www.freetype.org/</a>) 24.123 +contient des bibliothèques utilisées par X pour la configuration des polices 24.124 +du système: 24.125 +</p> 24.126 +<pre> 24.127 + # cd .. 24.128 + # wget http://download.savannah.gnu.org/releases/freetype/freetype-2.3.1.tar.bz2 24.129 + # tar xjf freetype-2.3.1.tar.bz2 24.130 + # cd freetype-2.3.1 24.131 + # ./configure --sysconfdir=/etc --prefix=/usr \ 24.132 + --mandir=/usr/share/man 24.133 + # make 24.134 + # make DESTDIR=$PWD/_pkg install 24.135 + # strip -vs _pkg/usr/lib/* 24.136 + # cp -a _pkg/usr/bin/* $fs/usr/bin 24.137 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 24.138 +</pre> 24.139 +<a name="fontconfig"></a> 24.140 +<h3><font color="#6c0023">fontconfig 2.4.2 - Outils de gestion des polices</font></h3> 24.141 +<p> 24.142 +Le paquet fontconfig (<a href="http://www.fontconfig.org/wiki/">www.fontconfig.org/wiki/</a>) 24.143 +fourni la bibliothèque libfontconfig, utilisée par de nombreux 24.144 +programme sous X. Note: XFree86 fournit aussi ces bibliothèques, et 24.145 +les utilitaires. Nous avons choisi d'utiliser le paquet original, car 24.146 +il fonctionne mieux avec JWM: 24.147 +</p> 24.148 +<pre> 24.149 + # cd .. 24.150 + # wget http://fontconfig.org/release/fontconfig-2.4.2.tar.gz 24.151 + # tar xzf fontconfig-2.4.2.tar.gz 24.152 + # cd fontconfig-2.4.2 24.153 + # ./configure --sysconfdir=/etc --prefix=/usr \ 24.154 + --mandir=/usr/share/man --localstatedir=/var 24.155 + # make 24.156 + # make DESTDIR=$PWD/_pkg install 24.157 + # strip -v _pkg/usr/bin/* 24.158 + # strip -v _pkg/usr/lib/* 24.159 + # cp -a _pkg/usr/bin/* $fs/usr/bin 24.160 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 24.161 + # cp -a _pkg/etc $fs 24.162 + # cp -a _pkg/var $fs 24.163 +</pre> 24.164 +<h4>libs</h4> 24.165 +<p> 24.166 +Un 'ldd' sur fc-cache donne, le bibliothèques ci-dessous. Vous pouvez utiliser 24.167 +libfreetype d'Xfree86: 24.168 +</p> 24.169 +<pre class="script"> 24.170 + libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb7f12000) 24.171 + libz.so.1 => /usr/lib/libz.so.1 (0xb7eff000) 24.172 + libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb7edf000) 24.173 + libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb7eb0000) 24.174 + libc.so.6 => /lib/tls/libc.so.6 (0xb7d7b000) 24.175 + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0xb7f8c000) 24.176 +</pre> 24.177 +<a name="xserver"></a> 24.178 +<h3><font color="#6c0023">Xserver - Serveur graphique Xvesa d'Xfree86</font></h3> 24.179 +<p> 24.180 +Nous allons utiliser la versions binaires du serveur Xvesa et les polices 24.181 +distribuée par Xfree86.org 24.182 +(<a href="http://www.free86.org/">www.free86.org/</a>). Nous allons par contre, 24.183 +copier les bibliothèques d'Xorg depuis le système hôte, car elle seront 24.184 +utilisées par la compilation des applications X, Xvesa fonctionne très bien 24.185 +comme ça et cela simplifie les choses. Vous pouvez aussi 24.186 +<a href="xorg.html">recompiler les paquets d'Xorg</a> sur votre système de 24.187 +développement. 24.188 +</p> 24.189 +<h4>Xtinyx server - Xvesa</h4> 24.190 +<p> 24.191 +Le serveur Xvesa est très léger, et utilise peut de bibliothèques, il 24.192 +se trouve dans l'archive Xtinyx.tgz. Téléchargement et install dans 24.193 +/usr/bin du rootfs de SliTaz: 24.194 +</p> 24.195 +<pre> 24.196 + # cd .. 24.197 + # mkdir -p XFree86-4.6.0 && cd XFree86-4.6.0 24.198 + # wget http://ftp.xfree86.org/pub/XFree86/4.6.0/binaries/Linux-ix86-glibc23/Xtinyx.tgz 24.199 + # tar xzf Xtinyx.tgz 24.200 + # cp bin/Xvesa $fs/usr/bin 24.201 + # strip $fs/usr/bin/Xvesa 24.202 + # chmod 4711 $fs/usr/bin/Xvesa 24.203 +</pre> 24.204 +<h4>libs pour Xvesa</h4> 24.205 +<pre class="script"> 24.206 + libz.so.1 => /usr/lib/libz.so.1 (0xb7ed6000) 24.207 + libm.so.6 => /lib/tls/libm.so.6 (0xb7eb1000) 24.208 + libc.so.6 => /lib/tls/libc.so.6 (0xb7d7e000) 24.209 + /lib/ld-linux.so.2 (0xb7ef8000) 24.210 +</pre> 24.211 +<h4>rgb.txt - Les couleurs RGB sous X</h4> 24.212 +<p> 24.213 +Le fichier de configuration des couleurs utilisée par le serveur X 24.214 +se nomme <code>rgb.txt</code>, nous vous proposons de copier celui 24.215 +du système hôte. La bibliothèque libX11.so d'Xorg va chercher les 24.216 +fichiers de configuration dans /usr/share/X11, et le serveur Xvesa 24.217 +dans /usr/X11R6/lib/X11, nous allons créer un lien dans /usr/share/X11 24.218 +afin de satisfaire cela: 24.219 +</p> 24.220 +<pre> 24.221 + # mkdir -p $fs/usr/share/X11 24.222 + # cp /usr/share/X11/rgb.txt $fs/usr/share/X11 24.223 + # chroot $fs /bin/ash 24.224 + /# mkdir -p /usr/X11R6/lib/X11/ 24.225 + /# ln -s /usr/share/X11/rgb.txt /usr/X11R6/lib/X11/rgb.txt 24.226 + /# exit 24.227 +</pre> 24.228 +<h4>Xfnts - Les polices</h4> 24.229 +<p> 24.230 +Pour que le serveur fonctionnent il nous faut les polices de base, que vous 24.231 +pouvez télécharger depuis xfree86.org, les compiler depuis les paquets d'Xorg, 24.232 +ou les copier depuis votre système hôte. Les polices du système peuvent se 24.233 +mettre dans différents dossiers, et une fois installées pour devez lancer 24.234 +<code>lc-cache</code> pour mettre à jour le cache. Attention les fonts 24.235 +prennent de la place, vous pouvez ne copier que le minimum. Le répertoire 24.236 +/usr/share/fonts contient les polices truetype tels que biststream-vera: 24.237 +</p> 24.238 +<pre> 24.239 + # wget http://ftp.xfree86.org/pub/XFree86/4.6.0/binaries/Linux-ix86-glibc23/Xfnts.tgz 24.240 + # tar xzf Xfnts.tgz 24.241 + # mkdir -p $fs/usr/X11R6/lib/X11/fonts 24.242 + # mkdir -p $fs/usr/share/fonts/truetype 24.243 + 24.244 + Copie des polices... 24.245 + (# cp -a lib/X11/fonts/* $fs/usr/X11R6/lib/X11/fonts) 24.246 + (# cp -a /usr/share/fonts/truetype/* $fs/usr/share/fonts/truetype 24.247 +</pre> 24.248 +<p> 24.249 +Pour regénérer le fichier fonts.dir, il vous faut lancer mkfontdir sur le réperoire 24.250 +en question: 24.251 +</p> 24.252 +<pre> 24.253 + # mkfontdir $fs/usr/X11R6/lib/X11/fonts/75dpi 24.254 +</pre> 24.255 +<p> 24.256 +Les fichiers de configuration de fontconfig, se trouvent dans /etc/fonts, fourni 24.257 +par le paquet fontconfig. Vous pouvez maintenant lancer 'fc-cache', et pour 24.258 +connaître la liste des polices vous pouvez utiliser 'fc-list'. Vous pouvez faire 24.259 +cela avec un chroot dans le rootfs: 24.260 +</p> 24.261 +<pre> 24.262 + # chroot $fs /bin/ash 24.263 + # fc-cache -v 24.264 + # fc-list 24.265 + # exit 24.266 +</pre> 24.267 +<h4>Xlib locale - Les fichiers de localisation</h4> 24.268 +<p> 24.269 +Sur SliTaz nous avons installé que 4 locales, C, iso8859-1, iso8859-15, et 24.270 +iso8859-2 provenant de la <a href="xorg.html">compilation d'Xorg</a>. 24.271 +Vous pouvez copier les fichiers depuis le système hôte ou utiliser les fichiers 24.272 +distribuées par XFree86. Exemple de copie de toutes les locales depuis le 24.273 +système hôte: 24.274 +</p> 24.275 +<pre> 24.276 + # mkdir -p $fs/usr/share/X11/locale 24.277 + # cp -a /usr/share/X11/locale/* $fs/usr/share/X11/locale 24.278 +</pre> 24.279 +<h4>Utilisation de X</h4> 24.280 +<p> 24.281 +A noter que vous pouvez déjà utiliser Xvesa comme terminal X, si vous 24.282 +avez une machine sur le réseau acceptant les connexions Xdmcp. Pour 24.283 +cela vous pouvez lancer le server avec l'option <code>-query</code>, 24.284 +exemple: 24.285 +</p> 24.286 +<pre> 24.287 + # Xvesa -ac -shadow -screen 1024x768x24 -query 192.168.0.2 24.288 +</pre> 24.289 +<a name="xterm"></a> 24.290 +<h3><font color="#6c0023">xterm - Emulateur de terminal</font></h3> 24.291 +<p> 24.292 +Le paquet Xterm (<a href="http://invisible-island.net/xterm/" 24.293 + >invisible-island.net/xterm/</a>)fournit un émulateur de terminal pour X: 24.294 +</p> 24.295 +<pre> 24.296 + # wget ftp://invisible-island.net/xterm/xterm-223.tgz 24.297 + # tar xzf xterm-223.tgz 24.298 + # cd xterm-223 24.299 + # ./configure --prefix=/usr --sysconfdir=/etc \ 24.300 + --mandir=/usr/share/man --localstatedir=/var \ 24.301 + --with-app-defaults=/usr/share/X11/app-defaults \ 24.302 + --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu 24.303 + # make 24.304 + # make DESTDIR=$PWD/_pkg install 24.305 + # strip _pkg/usr/bin/* 24.306 + # cp _pkg/usr/bin/* $fs/usr/bin 24.307 + # cp -a _pkg/usr/share/X11/* $fs/usr/share/X11 24.308 +</pre> 24.309 +<h4>libs</h4> 24.310 +<p> 24.311 +Un ldd sur XTerm, nous fait copier les bibliothèques manquantes depuis 24.312 +le système hôte et n'oubliez pas de stripper le tout à la fin: 24.313 +</p> 24.314 +<pre class="script"> 24.315 + libXft.so.2 => /usr/lib/libXft.so.2 (0xb7f09000) 24.316 + libXrender.so.1 => /usr/lib/libXrender.so.1 (0xb7f00000) 24.317 + libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb7ed5000) 24.318 + libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb7e68000) 24.319 + libz.so.1 => /usr/lib/libz.so.1 (0xb7e54000) 24.320 + libX11.so.6 => /usr/lib/libX11.so.6 (0xb7d68000) 24.321 + libXaw.so.7 => /usr/lib/libXaw.so.7 (0xb7d0f000) 24.322 + libXmu.so.6 => /usr/lib/libXmu.so.6 (0xb7cfa000) 24.323 + libXext.so.6 => /usr/lib/libXext.so.6 (0xb7cec000) 24.324 + libXt.so.6 => /usr/lib/libXt.so.6 (0xb7c9e000) 24.325 + libSM.so.6 => /usr/lib/libSM.so.6 (0xb7c96000) 24.326 + libICE.so.6 => /usr/lib/libICE.so.6 (0xb7c7f000) 24.327 + libncurses.so.5 => /lib/libncurses.so.5 (0xb7c3c000) 24.328 + libc.so.6 => /lib/libc.so.6 (0xb7b2c000) 24.329 + libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb7b0b000) 24.330 + libXau.so.6 => /usr/lib/libXau.so.6 (0xb7b08000) 24.331 + libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0xb7b03000) 24.332 + libdl.so.2 => /lib/libdl.so.2 (0xb7aff000) 24.333 + libXpm.so.4 => /usr/lib/libXpm.so.4 (0xb7aee000) 24.334 +</pre> 24.335 +<a name="libpng"></a> 24.336 +<h3><font color="#6c0023">libpng-1.2.18 - Bibliothèques PNG</font></h3> 24.337 +<p> 24.338 +Les bibliothèques PNG (<a href="http://libpng.org/pub/png/libpng.html" 24.339 + >http://libpng.org/pub/png/libpng.html</a>)permettent de manipuler 24.340 +et d'utiliser les images au format .png: 24.341 +</p> 24.342 +<pre> 24.343 + # wget http://puzzle.dl.sourceforge.net/sourceforge/libpng/libpng-1.2.18.tar.bz2 24.344 + # tar xjf libpng-1.2.18.tar.bz2 24.345 + # cd libpng-1.2.18 24.346 + # ./configure --enable-shared --prefix=/usr \ 24.347 + --mandir=/usr/share/man 24.348 + # make 24.349 + # make DESTDIR=$PWD/_pkg install 24.350 + # strip _pkg/usr/lib/*.so* 24.351 + # cp -a _pkg/usr/lib/libpng12.so* $fs/usr/lib 24.352 + # cp -a _pkg/usr/bin/libpng12* $fs/usr/bin 24.353 +</pre> 24.354 +<a name="jwm"></a> 24.355 +<h3><font color="#6c0023">jwm-2.0 - Gestionnaire de fenêtres</font></h3> 24.356 +<p> 24.357 +Joe's Window Manager (<a href="http://www.joewing.net/programs/jwm/" 24.358 + >http://www.joewing.net/programs/jwm/</a>) est un gestionnaire de fenêtres 24.359 +ultra léger, et convivial. C'est le window manager par défaut de SliTaz. Le 24.360 +fichier de configuration principal est dans /etc/jwm/system.jwmrc, comprenant 24.361 +la config du menu et du style: 24.362 +</p> 24.363 +<pre> 24.364 + # cd .. 24.365 + # wget http://www.joewing.net/programs/jwm/releases/jwm-2.0.tar.bz2 24.366 + # tar xjf jwm-2.0.tar.bz2 24.367 + # cd jwm-2.0 24.368 + # ./configure --prefix=/usr --mandir=/usr/share/man \ 24.369 + --sysconfdir=/etc/jwm --disable-xinerama 24.370 + # make 24.371 + # strip src/jwm 24.372 + # cp src/jwm $fs/usr/bin 24.373 + # mkdir $fs/etc/jwm 24.374 + # cp example.jwmrc $fs/etc/jwm/system.jwmrc 24.375 +</pre> 24.376 +<h4>libs</h4> 24.377 +<p> 24.378 +Les bibliothèques que ldd nous aura fourni: 24.379 +</p> 24.380 +<pre class="script"> 24.381 + libX11.so.6 => /usr/lib/libX11.so.6 (0xb7e35000) 24.382 + libpng12.so.0 => /usr/lib/libpng12.so.0 (0xb7e12000) 24.383 + libXft.so.2 => /usr/lib/libXft.so.2 (0xb7e00000) 24.384 + libXrender.so.1 => /usr/lib/libXrender.so.1 (0xb7df7000) 24.385 + libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb7dcc000) 24.386 + libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb7d5f000) 24.387 + libz.so.1 => /usr/lib/libz.so.1 (0xb7d4a000) 24.388 + libXpm.so.4 => /usr/lib/libXpm.so.4 (0xb7d3a000) 24.389 + libXext.so.6 => /usr/lib/libXext.so.6 (0xb7d2c000) 24.390 + libc.so.6 => /lib/libc.so.6 (0xb7c1c000) 24.391 + libXau.so.6 => /usr/lib/libXau.so.6 (0xb7c19000) 24.392 + libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0xb7c14000) 24.393 + libdl.so.2 => /lib/libdl.so.2 (0xb7c0f000) 24.394 + libm.so.6 => /lib/libm.so.6 (0xb7bea000) 24.395 + libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb7bc9000) 24.396 +</pre> 24.397 +<p> 24.398 +Vous pouvez démarrer le server X et JWM avec la commande ci-dessous, ou en 24.399 +créant un script, tel que /usr/bin/startx avec pour contenu: 24.400 +</p> 24.401 +<pre> 24.402 +Xvesa -ac -shadow -screen 1024x768x24 & exec jwm 24.403 +</pre> 24.404 +<h4>Sur SliTaz</h4> 24.405 +<p> 24.406 +SliTaz utilise le fichier ~/.xsession pour lancer un session grahique. 24.407 +La commande 'startx' vérifie si il existe, si oui il le lance, sinon il lance 24.408 +le script 'tazx' pour configurer le système X. La page du guide de l'utilisateur 24.409 +au sujet d'X window est dans: /usr/share/doc/slitaz/user-guide/x-window.html, 24.410 +et sur le site web. 24.411 +</p> 24.412 +<p> 24.413 +Nous avons choisi d'utiliser les icons du thème Tango: 24.414 +<a href="http://tango.freedesktop.org/">http://tango.freedesktop.org/</a>, 24.415 +que nous n'avons pas compilé. Nous utilison seulement le minimum, et 24.416 +des images au format 16x16 que nous mettons dans /usr/share/icons. 24.417 +</p> 24.418 +<p> 24.419 +Pour tester JWM, avec une ISO en cuisson: 24.420 +</p> 24.421 +<pre> 24.422 + # Xvesa -ac -shadow -screen 800x600x24 & exec jwm 24.423 +</pre> 24.424 +<a name="jpeg"></a> 24.425 +<h3><font color="#6c0023">jpeg-6b - Bibliothèques JPEG</font></h3> 24.426 +<p> 24.427 +Les bibliothèques de manipulation des images JPEG, et quelques 24.428 +petits utilitaires: 24.429 +</p> 24.430 +<pre> 24.431 + # wget http://www.ijg.org/files/jpegsrc.v6b.tar.gz 24.432 + # tar xzf jpegsrc.v6b.tar.gz 24.433 + # cd jpeg-6b 24.434 + # ./configure --enable-shared --prefix=/usr \ 24.435 + --mandir=/usr/share/man 24.436 + # make 24.437 + # strip .libs/* 24.438 + # cp -a .libs/*.so* $fs/usr/lib 24.439 + # cp .libs/{cjpeg,djpeg,jpegtran} $fs/usr/bin 24.440 +</pre> 24.441 +<a name="tiff"></a> 24.442 +<h3><font color="#6c0023">tiff-3.8.2 - Bibliothèques et utilitaires TIFF</font></h3> 24.443 +<p> 24.444 +Les bibliothèques de manipulation des images TIFF, et quelques 24.445 +petits utilitaires en option: 24.446 +</p> 24.447 +<pre> 24.448 + # wget ftp://ftp.remotesensing.org/pub/libtiff/tiff-3.8.2.tar.gz 24.449 + # tar xzf tiff-3.8.2.tar.gz 24.450 + # cd tiff-3.8.2 24.451 + # ./configure --prefix=/usr --mandir=/usr/share/man 24.452 + # make 24.453 + # make DESTDIR=$PWD/_pkg install 24.454 + # strip _pkg/usr/bin/* 24.455 + # strip _pkg/usr/lib/*.so* 24.456 + # cp -a _pkg/usr/lib/*.so* $fs/usr/lib 24.457 +</pre> 24.458 +<p> 24.459 +A vous d'installer les utilitaires que vous voulez. 24.460 +</p> 24.461 +<a name="links"></a> 24.462 +<h3><font color="#6c0023">links-2.1pre29 - Navigateur web graphique et texte</font></h3> 24.463 +<p> 24.464 +Links (<a href="http://links.twibright.com/">links.twibright.com</a>) est 24.465 +un navigateur web proposant un mode texte et un mode graphique, il est 24.466 +traduit dans de multiples langues, dont le français: 24.467 +</p> 24.468 +<pre> 24.469 + # cd .. 24.470 + # wget http://links.twibright.com/download/links-2.1pre28.tar.gz 24.471 + # tar xzf links-2.1pre28.tar.gz 24.472 + # cd links-2.1pre28 24.473 + # ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man \ 24.474 + --without-directfb --without-ssl --enable-graphics --enable-javascript 24.475 + # make 24.476 + # make DESTDIR=$PWD/_pkg install 24.477 + # strip -v _pkg/usr/bin/* 24.478 + # cp -v _pkg/usr/bin/* $fs/usr/bin 24.479 +</pre> 24.480 +<h4>libs</h4> 24.481 +<pre class="script"> 24.482 + libtiff.so.3 => /usr/lib/libtiff.so.3 24.483 + libjpeg.so.62 => /usr/lib/libjpeg.so.62 (0xb7ede000) 24.484 + libpng12.so.0 => /usr/lib/libpng12.so.0 (0xb7eba000) 24.485 + libz.so.1 => /usr/lib/libz.so.1 (0xb7ea7000) 24.486 + libX11.so.6 => /usr/lib/libX11.so.6 (0xb7dbb000) 24.487 + libdl.so.2 => /lib/tls/libdl.so.2 (0xb7db7000) 24.488 + libpcre.so.0 => /usr/lib/libpcre.so.0 (0xb7d96000) 24.489 + libm.so.6 => /lib/tls/libm.so.6 (0xb7d70000) 24.490 + libc.so.6 => /lib/tls/libc.so.6 (0xb7c3e000) 24.491 + libXau.so.6 => /usr/lib/libXau.so.6 (0xb7c3b000) 24.492 + libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0xb7c36000) 24.493 + /lib/ld-linux.so.2 (0xb7f5d000) 24.494 +</pre> 24.495 +<a name="initramfs-iso"></a> 24.496 +<h3><font color="#6c0023">Génération de l'initramfs, et d'une image ISO</font></h3> 24.497 +<p> 24.498 +Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' 24.499 +contenu dans <a href="http://www.slitaz.org/get/tools.html">SliTaz tools</a>. 24.500 +Ou vous pouvez créer un nouvelle image initramfs, et la copier dans 24.501 +/boot de la racine de cd-rom (rootcd), et pour finir créer un image 24.502 +ISO avec genisoimage: 24.503 +</p> 24.504 +<pre> 24.505 + # cd $fs 24.506 + # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz 24.507 + # cd .. 24.508 + # cp rootfs.gz rootcd/boot 24.509 + # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \ 24.510 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 24.511 + -V "SliTaz" -boot-info-table rootcd 24.512 +</pre> 24.513 +<h4>Suite</h4> 24.514 +<p> 24.515 +La suite logique du cookbook passe par l'installation des bibliothèques 24.516 +GTK décrite dans le chapitre : <a href="gtk-libs.html">GTK+ libs</a>. 24.517 +</p> 24.518 + 24.519 + 24.520 +<!-- End of content --> 24.521 +</div> 24.522 + 24.523 +<!-- Footer. --> 24.524 +<div id="footer"> 24.525 + <div class="footer-right"></div> 24.526 + <a href="#top">Haut de la page</a> | 24.527 + <a href="index.html">Table des matières</a> 24.528 +</div> 24.529 + 24.530 +<div id="copy"> 24.531 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 24.532 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 24.533 + Documentation publiées sous 24.534 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 24.535 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 24.536 +</div> 24.537 + 24.538 +</body> 24.539 +</html>
25.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 25.2 +++ b/doc/cookbook/xorg.html Sat Mar 29 12:01:05 2008 +0100 25.3 @@ -0,0 +1,160 @@ 25.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 25.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 25.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 25.7 +<head> 25.8 + <title>SliTaz Cookbook - Xorg</title> 25.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 25.10 + <meta name="description" content="xorg proto libs apps compilation du serveur X Xorg" /> 25.11 + <meta name="expires" content="never" /> 25.12 + <meta name="modified" content="2007-12-24 17:00:00" /> 25.13 + <meta name="publisher" content="www.slitaz.org" /> 25.14 + <meta name="author" content="Christophe Lincoln"/> 25.15 + <link rel="shortcut icon" href="favicon.ico" /> 25.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 25.17 +</head> 25.18 +<body bgcolor="#ffffff"> 25.19 + 25.20 +<!-- Header and quick navigation --> 25.21 +<div id="header"> 25.22 +<div align="right" id="quicknav"> 25.23 + <a name="top"></a> 25.24 + <a href="index.html">Table des matières</a> 25.25 +</div> 25.26 +<h1><font color="#3E1220">SliTaz Cookbook</font></h1> 25.27 +</div> 25.28 + 25.29 +<!-- Content. --> 25.30 +<div id="content"> 25.31 +<div class="content-right"></div> 25.32 + 25.33 + 25.34 +<h2><font color="#DF8F06">Howto Xorg - Serveur graphique modulaire</font></h2> 25.35 +<ul> 25.36 + <li><a href="#woking">Construire Xorg automatiquement avec Tazwok.</a></li> 25.37 + <li><a href="#get">Obtenir Xorg avec wget.</a></li> 25.38 + <li><a href="#make">Compiler Xorg à la main.</a></li> 25.39 +</ul> 25.40 +<p> 25.41 +Note : SliTaz utilise le serveur Xvesa fournit par XFree86 et les bibliothèques 25.42 +d'Xorg, cette page décrit la compilation des bibliothèques d'Xorg utilisées 25.43 +sur SliTaz. Ce document est principalement destiné aux développeurs et 25.44 +contributeurs du projet, mais il peut être utile à toutes personnes cherchant 25.45 +à recompiler Xorg et les bibliothèques Xlib depuis les sources en générant 25.46 +un minimum de dépendances. 25.47 +</p> 25.48 + 25.49 +<a name="woking"></a> 25.50 +<h3>Construire Xorg automatiquement avec Tazwok</h3> 25.51 +<p> 25.52 +Sur SliTaz, ou si vous avez installé Tazwok, vous pouvez recompiler Xorg en 25.53 +quelques commandes. Le wok contient un meta-paquet nommé <code>xorg</code> et 25.54 +un autre nommé <code>xorg-dev</code>, ils permettent de compiler/cuire tous 25.55 +les paquets Xorg utilisé par SliTaz. Pour compiler vous devez avoir installé 25.56 +la plus part des paquets de développement, si ce n'est pas le cas : 25.57 +</p> 25.58 +<pre> 25.59 + # tazpkg get-install slitaz-dev-pkgs 25.60 +</pre> 25.61 +<p> 25.62 +Ensuite vous pouvez lancer la cuisson (si tout est prêt, wok et paquets de 25.63 +developpement), en commençant par les proto's (xproto, etc) : 25.64 +</p> 25.65 +<pre> 25.66 + # tazwok cook xorg-dev-proto 25.67 + # tazwok cook xorg 25.68 + # tazwok cook xorg-dev 25.69 +</pre> 25.70 + 25.71 +<a name="get"></a> 25.72 +<h3>Obtenir Xorg (7.2) avec wget</h3> 25.73 +<p> 25.74 +Xorg est distribuée sous forme de modules, ce qui est bien pratique, car 25.75 +l'on peut installer uniquement ce que l'on veut, mais cela demande beaucoup 25.76 +de téléchargements. Pour vous aidez nous avons créer un petit script qui 25.77 +télécharge le minimum pour SliTaz, vous trouverez le script 25.78 +<code>getXorg.sh</code> dans <a href="../../get/tools.html">SliTaz tools (1.1)</a>. 25.79 +A noter que ce script n'est plus mis à jour, les développeurs utilisent 25.80 +<a href="wok-tools.html">les outils et le wok</a>. Pour utiliser le script de 25.81 +téléchargemnt, il faut ce placer dans le répertoire dans lequel vous désirez 25.82 +télécharger Xorg, puis lancer le script préalablement copié : 25.83 +</p> 25.84 +<pre> 25.85 + # cd .. 25.86 + # mkdir Xorg && cd Xorg 25.87 + # cp slitaz-tools-1.1/utils/getXorg-7.2.sh . 25.88 + # ./getXorg-7.2.sh 25.89 +</pre> 25.90 +<a name="make"></a> 25.91 +<h3>Compiler Xorg à la main</h3> 25.92 +<p> 25.93 +La compilation d'Xorg est assez longue, il y a beaucoup de paquets. 25.94 +Pour commnencer il faut complier tous les paquets proto téléchargés, 25.95 +vous pouvez utiliser la commande <code>make DESTDIR=$PWD/_pkg install</code> 25.96 +pour installer le paquet dans un répertoire donné. Exemple avec xproto: 25.97 +</p> 25.98 +<pre> 25.99 + # cd proto 25.100 + # tar xzf xproto-X11R7.2-7.0.10.tar.gz 25.101 + # cd xproto-X11R7.2-7.0.10 25.102 + # ./configure --prefix=/usr --sysconfdir=/etc \ 25.103 + --mandir=/usr/share/man --localstatedir=/var \ 25.104 + --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu 25.105 + # make 25.106 + # make install 25.107 +</pre> 25.108 +<p> 25.109 +Compilation des bibliothèques en reprenant les options utilisées 25.110 +pour les proto. Exemple avec le premier paquet à compiler xtrans, 25.111 +n'oubliez pas de lancer <code>ldconfig</code> si vous installer le 25.112 +paquet sur la machine de développement: 25.113 +</p> 25.114 +<pre> 25.115 + # cd .. && cd lib 25.116 + # tar xzf xtrans-X11R7.2-1.0.3.tar.gz 25.117 + # cd xtrans-X11R7.2-1.0.3 25.118 + # ./configure --prefix=/usr --sysconfdir=/etc \ 25.119 + --mandir=/usr/share/man --localstatedir=/var \ 25.120 + --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu 25.121 + # make 25.122 + # make install 25.123 + # ldconfig 25.124 +</pre> 25.125 +<p> 25.126 +Une fois que tous les paquets des bibliothèques sont compilés, vous pouvez 25.127 +commencer à compiler des applications pour X tels que le terminal graphique 25.128 +Xterm. SliTaz utilise encore le paquet 'rgb' contenant le fichier 25.129 +/usr/share/X11/rgb.txt définissant les couleurs. Exemple de compilation pour 25.130 +<code>xsetroot</code>, application permettant de changer la couleur du fond 25.131 +d'écran (modifiez $VERSION par la version que vous avez téléchargé : 25.132 +</p> 25.133 +<pre> 25.134 + # cd .. && cd app 25.135 + # tar xzf xsetroot-$VERSION.tar.gz 25.136 + # cd xsetroot-$VERSION 25.137 + # ./configure --prefix=/usr --sysconfdir=/etc \ 25.138 + --mandir=/usr/share/man --localstatedir=/var \ 25.139 + --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu 25.140 + # make && make install 25.141 +</pre> 25.142 + 25.143 + 25.144 +<!-- End of content --> 25.145 +</div> 25.146 + 25.147 +<!-- Footer. --> 25.148 +<div id="footer"> 25.149 + <div class="footer-right"></div> 25.150 + <a href="#top">Haut de la page</a> | 25.151 + <a href="index.html">Table des matières</a> 25.152 +</div> 25.153 + 25.154 +<div id="copy"> 25.155 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 25.156 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 25.157 + Documentation publiées sous 25.158 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 25.159 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 25.160 +</div> 25.161 + 25.162 +</body> 25.163 +</html>
26.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 26.2 +++ b/doc/handbook/book.css Sat Mar 29 12:01:05 2008 +0100 26.3 @@ -0,0 +1,170 @@ 26.4 +/* 26.5 + CSS style for SliTaz GNU/Linux *book. 26.6 + Pankso 2007 - www.slitaz.org 26.7 +*/ 26.8 + 26.9 +body { 26.10 + font: 13px sans-serif, vernada, arial; 26.11 + background: #222222; 26.12 + margin: 0; 26.13 + padding-bottom: 100%; 26.14 +} 26.15 + 26.16 +#header { 26.17 + background: #BFB06B url(images/css/header.png) repeat-x top; 26.18 + color: black; 26.19 + height: 50px; 26.20 + border-top: 1px solid black; 26.21 + border-bottom: 1px solid black; 26.22 +} 26.23 +#quicknav { 26.24 + margin-right: 6px; 26.25 + text-align: right; 26.26 + font-size: 12px; 26.27 + } 26.28 +#quicknav { 26.29 + margin-right: 6px; 26.30 +} 26.31 + 26.32 +#quicknav a { 26.33 + background: inherit; 26.34 + color: #222222; 26.35 +} 26.36 + 26.37 +#quicknav a:hover { 26.38 + background: inherit; 26.39 + color: #EDEDED; 26.40 +} 26.41 + 26.42 +/* content. */ 26.43 + 26.44 +#content { 26.45 + background: white url(images/css/content-tl.png) no-repeat top left; 26.46 + color: black; 26.47 + padding: 20px; 26.48 + margin: 30px 50px 0px 50px; 26.49 + width: auto; 26.50 + text-align: justify; 26.51 +} 26.52 + 26.53 +#content li { 26.54 + line-height: 1.5em; 26.55 + text-align: left; 26.56 +} 26.57 + 26.58 +/* Footer. */ 26.59 + 26.60 +#footer { 26.61 + font-size: 11px; 26.62 + font-weight: bold; 26.63 + background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left; 26.64 + color: black; 26.65 + height: 20px; 26.66 + padding: 6px 0px 0px 10px; 26.67 + margin: 0px 50px 0px 50px; 26.68 + width: auto; 26.69 + text-align: center ; 26.70 +} 26.71 + 26.72 +#footer a { 26.73 + text-decoration: none; 26.74 + background: #eaeaea; 26.75 + color: #3E1220; 26.76 +} 26.77 + 26.78 +#footer a:hover { 26.79 + background: #eaeaea; 26.80 + color: #DF8F06; 26.81 +} 26.82 + 26.83 +/* Legal informations */ 26.84 + 26.85 +#copy { 26.86 + font-size: 11px ; 26.87 + text-align: center ; 26.88 + background: transparent; 26.89 + color: #a8a8a8; 26.90 + padding-top: 20px; 26.91 +} 26.92 + 26.93 +#copy a { 26.94 + background: inherit; 26.95 + color: #a8a8a8; 26.96 +} 26.97 + 26.98 +#copy a:hover { 26.99 + background: inherit; 26.100 + color: #EDEDED; 26.101 +} 26.102 + 26.103 +/* Div for round corners. */ 26.104 + 26.105 +.content-right, .footer-right { 26.106 + width: 16px; 26.107 + color: white; 26.108 + background-color: #333333; 26.109 +} 26.110 +.content-right { 26.111 + background: url(images/css/content-tr.png) no-repeat top right; 26.112 + height: 16px; 26.113 + right: 50px; 26.114 + top: 82px; 26.115 + position: absolute; 26.116 +} 26.117 + 26.118 +.footer-right { 26.119 + background: url(images/css/footer-br.png) no-repeat bottom right; 26.120 + height: 20px; 26.121 + float: right; 26.122 +} 26.123 + 26.124 +/* General HTML entities for content. */ 26.125 + 26.126 +h1 { 26.127 + margin: 0px 0px 0px 16px; 26.128 +} 26.129 + 26.130 +h2 { 26.131 + margin: 12px 0; 26.132 + color: #484B7C; 26.133 + background: white; 26.134 +} 26.135 + 26.136 +h3 { 26.137 + font-weight: bold; 26.138 + color: #6c0023; 26.139 + background: white; 26.140 +} 26.141 + 26.142 +a { 26.143 + text-decoration: underline; 26.144 +} 26.145 +a:hover { 26.146 + text-decoration: none; 26.147 +} 26.148 + 26.149 +pre { 26.150 + padding: 5px; 26.151 + color: black; 26.152 + background: #e1e0b0; 26.153 +} 26.154 +pre.script { 26.155 + padding: 10px; 26.156 + color: black; 26.157 + background: #e8e8e8; 26.158 + border: 1px inset #333333; 26.159 +} 26.160 + 26.161 +code { 26.162 + font-size: 12px; 26.163 + color: #669900; 26.164 + background: transparent; 26.165 +} 26.166 + 26.167 +li { 26.168 + line-height: 1.4em; 26.169 +} 26.170 + 26.171 +hr { 26.172 + border: 0pt none; 26.173 +}
27.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 27.2 +++ b/doc/handbook/chroot-env.html Sat Mar 29 12:01:05 2008 +0100 27.3 @@ -0,0 +1,196 @@ 27.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 27.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 27.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 27.7 +<head> 27.8 + <title>SliTaz Handbook - Chroot env</title> 27.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 27.10 + <meta name="description" content="SliTaz chroot environnement chrooté développer tester" /> 27.11 + <meta name="expires" content="never" /> 27.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 27.13 + <meta name="publisher" content="www.slitaz.org" /> 27.14 + <meta name="author" content="Christophe Lincoln"/> 27.15 + <link rel="shortcut icon" href="favicon.ico" /> 27.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 27.17 +</head> 27.18 +<body bgcolor="#ffffff"> 27.19 + 27.20 +<!-- Header and quick navigation --> 27.21 +<div id="header"> 27.22 +<div align="right" id="quicknav"> 27.23 + <a name="top"></a> 27.24 + <a href="hacking-livecd.html">Hacking LiveCD</a> | 27.25 + <a href="index.html">Table des matières</a> 27.26 +</div> 27.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 27.28 +</div> 27.29 + 27.30 +<!-- Content. --> 27.31 +<div id="content"> 27.32 +<div class="content-right"></div> 27.33 + 27.34 +<h2><font color="#DF8F06">Chroot environment</font></h2> 27.35 + 27.36 +<p> 27.37 +Ce document décrit les étapes à réaliser pour créer un environnement chrooté, 27.38 +afin de changer la racine du système pour travailler. Cela permet de compiler, 27.39 +tester et développer SliTaz sans risques pour le système hôte depuis lequel 27.40 +on travaille. Ce système hôte peut être SliTaz installée en dur ou tout autre 27.41 +système GNU/Linux tel que Debian, Fedora, PCLinuxOS, etc. On peut aussi créer 27.42 +un environnement chrooté en mode LiveCD associé à un media USB. Les seuls 27.43 +prérequis sont d'avoir une image ISO de SliTaz à disposition et un peu de 27.44 +temps. A noter que toutes les opérations sont réalisées en tant 27.45 +qu'administrateur (<em>root</em>). 27.46 +</p> 27.47 +<h3><font color="#6c0023">Préparer l'environnement</font></h3> 27.48 +<p> 27.49 +Pour commencer, il faut extraire le contenu de l'image ISO dans le répertoire 27.50 +qui va servir au chroot. Le répertoire de chroot peut se créer à l'endroit que 27.51 +l'on veut, nous utilisons un répertoire <code>/home/slitaz/chroot-env</code>. 27.52 +Pour extraire le contenu d'une image ISO, il faut la monter en <em>loop</em> 27.53 +sur un répertoire, pour ensuite copier le système de fichiers racine 27.54 +compressé (<code>rootfs.gz</code>) dans le répertoire de chroot. En 27.55 +supposant que l'ISO est dans le répertoire courant : 27.56 +</p> 27.57 +<pre> 27.58 + # mkdir /tmp/loop 27.59 + # mount -o loop slitaz-cooking.iso /tmp/loop 27.60 + # mkdir -p /home/slitaz/chroot-env 27.61 + # cp /tmp/loop/boot/rootfs.gz \ 27.62 + /home/slitaz/chroot-env 27.63 + # umount /tmp/loop 27.64 +</pre> 27.65 +<p> 27.66 +Maintenant qu'on a une copie du système de fichiers compressé, il faut le 27.67 +décompresser et le désarchiver (c'est une archive <code>cpio</code> compressée 27.68 +avec lzma ou gzip). Pour finir cette étape de préparation et continuer, on 27.69 +peut retirer le <code>rootfs</code> qui n'est plus utilisé : 27.70 +</p> 27.71 +<pre> 27.72 + # cd /home/slitaz/chroot-env 27.73 + # (zcat rootfs.gz 2>/dev/null || lzma d rootfs.gz -so) | cpio -id 27.74 + # rm rootfs rootfs.gz 27.75 +</pre> 27.76 +<p> 27.77 +Si le désarchivage du rootfs compressé avec LZMA échoue en utilisant la 27.78 +première méthode vous pouvez utiliser: 27.79 +</p> 27.80 +<pre> 27.81 + # unlzma rootfs.gz -S .gz 27.82 + # cat rootfs | cpio -id 27.83 +</pre> 27.84 + 27.85 +<h3><font color="#6c0023">Utiliser l'environnement</font></h3> 27.86 +<p> 27.87 +Pour utiliser l'environnemnt chrooté, il suffit de monter quelques systèmes 27.88 +de fichier virtuels et d'utiliser la commande <code>chroot</code>. Pour se 27.89 +simplifier la vie on peut rapidement créer un petit script automatisant 27.90 +le chroot. Exemple en utilisant le répertoire de chroot 27.91 +<code>/home/slitaz/chroot-env</code> et en créant un script nommé 27.92 +<code>chroot_in_env.sh</code> dans <code>/home/slitaz</code>. A noter que 27.93 +le contenu du script n'a pas besoin d'être tapé mais simplement copié/coller 27.94 +dans le terminal et que sur un autre système que SliTaz vous pouvez 27.95 +décommenter les lignes montant/démontant <code>/dev</code> et 27.96 +<code>/tmp</code> : 27.97 +</p> 27.98 +<pre> 27.99 + # cat > /home/slitaz/chroot_in_env.sh << "EOF" 27.100 +</pre> 27.101 +<pre class="script"> 27.102 +#!/bin/sh 27.103 +# Chroot in SliTaz to hack. 27.104 +# 27.105 +ROOTFS="/home/slitaz/chroot-env" 27.106 + 27.107 +# Mount virtual Kernel file systems and chroot. 27.108 +# 27.109 +#mount --bind /dev $ROOTFS/dev 27.110 +#mount --bind /tmp $ROOTFS/tmp 27.111 +mount -t proc proc $ROOTFS/proc 27.112 +mount -t sysfs sysfs $ROOTFS/sys 27.113 +mount -t devpts devpts $ROOTFS/dev/pts 27.114 +mount -t tmpfs shm $ROOTFS/dev/shm 27.115 + 27.116 +echo "Chrooting in $ROOTFS... " 27.117 +chroot $ROOTFS /bin/sh --login 27.118 + 27.119 +# Unmount virtual Kernel file systems on exit. 27.120 +# 27.121 +umount $ROOTFS/dev/shm 27.122 +umount $ROOTFS/dev/pts 27.123 +umount $ROOTFS/sys 27.124 +umount $ROOTFS/proc 27.125 +#umount $ROOTFS/tmp 27.126 +#umount $ROOTFS/dev 27.127 + 27.128 +echo "Exiting of $ROOTFS chroot environment... " 27.129 + 27.130 +EOF 27.131 +</pre> 27.132 +<p> 27.133 +Pour finir et tester l'environnement, il suffit de rendre le script exécutable 27.134 +et le lancer : 27.135 +</p> 27.136 +<pre> 27.137 + # chmod +x /home/slitaz/chroot_in_env.sh 27.138 + # sh /home/slitaz/chroot_in_env.sh 27.139 +</pre> 27.140 +<h4>Activer le réseau</h4> 27.141 +<p> 27.142 +Pour avoir le réseau afin de télécharger, naviguer en mode texte et installer 27.143 +des paquets de développement, il suffit de lancer le client DHCP sur la bonne 27.144 +interface, exemple avec <code>eth1</code> : 27.145 +</p> 27.146 +<pre> 27.147 + /# udhcpc -i eth1 27.148 +</pre> 27.149 +<h4>Installer des paquets</h4> 27.150 +<p> 27.151 +Si le réseau est fonctionnel, il suffit de recharger la liste des paquets et 27.152 +utiliser <code>tazpkg get-install</code> pour installer de nouveaux paquets. 27.153 +Si la connexion n'est pas possible, on peut télécharger les paquets du miroir 27.154 +depuis un autre système, les copier dans l'environnement chrooté et les 27.155 +installer via la commande <code>tazpkg install</code>. Pour installer la base 27.156 +des outils de compilation : 27.157 +</p> 27.158 +<pre> 27.159 + /# tazpkg recharge 27.160 + /# tazpkg get-install slitaz-toolchain 27.161 +</pre> 27.162 +<p> 27.163 +Une fois l'environnement configuré, on peut complier des applications 27.164 +depuis les sources pour en créer des paquets, tester des scripts et autre. 27.165 +Le chapitre <a href="development.html">développement</a> du Handbook et le 27.166 +<a href="http://www.slitaz.org/doc/cookbook/">Cookbook</a> devraient aider à 27.167 +aller plus loin. 27.168 +</p> 27.169 +<h4>Sortir de l'environnement</h4> 27.170 +<p> 27.171 +Pour sortir de l'environnement chrooté il suffit de taper <code>exit</code>, 27.172 +le script <code>chroot_in_env.sh</code> va finir son rôle en démontant 27.173 +le systèmes de fichiers virtuels propre au Kernel Linux : 27.174 +</p> 27.175 +<pre> 27.176 + /# exit 27.177 + # 27.178 +</pre> 27.179 + 27.180 +<!-- End of content --> 27.181 +</div> 27.182 + 27.183 +<!-- Footer. --> 27.184 +<div id="footer"> 27.185 + <div class="footer-right"></div> 27.186 + <a href="#top">Haut de la page</a> | 27.187 + <a href="index.html">Table des matières</a> 27.188 +</div> 27.189 + 27.190 +<div id="copy"> 27.191 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 27.192 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 27.193 + Documentation publiées sous 27.194 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 27.195 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 27.196 +</div> 27.197 + 27.198 +</body> 27.199 +</html>
28.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 28.2 +++ b/doc/handbook/cmdline.html Sat Mar 29 12:01:05 2008 +0100 28.3 @@ -0,0 +1,363 @@ 28.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 28.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 28.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 28.7 +<head> 28.8 + <title>SliTaz Handbook - Ligne de commandes</title> 28.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 28.10 + <meta name="description" content="commande de base linux SliTaz help ls cd wget ligne de commandes console terminal xterm" /> 28.11 + <meta name="expires" content="never" /> 28.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 28.13 + <meta name="publisher" content="www.slitaz.org" /> 28.14 + <meta name="author" content="Christophe Lincoln"/> 28.15 + <link rel="shortcut icon" href="favicon.ico" /> 28.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 28.17 +</head> 28.18 +<body bgcolor="#ffffff"> 28.19 + 28.20 +<!-- Header and quick navigation --> 28.21 +<div id="header"> 28.22 +<div align="right" id="quicknav"> 28.23 + <a name="top"></a> 28.24 + <a href="jwm.html">JWM</a> | 28.25 + <a href="index.html">Table des matières</a> 28.26 +</div> 28.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 28.28 +</div> 28.29 + 28.30 +<!-- Content. --> 28.31 +<div id="content"> 28.32 +<div class="content-right"></div> 28.33 + 28.34 +<h2><font color="#DF8F06">Références en ligne de commandes (<em>cmdline</em>)</font></h2> 28.35 + 28.36 +<ul> 28.37 + <li><a href="#intro">Introduction aux commandes.</a></li> 28.38 + <li><a href="#help">Aide et liste des commandes disponibles.</a></li> 28.39 + <li><a href="#ls">Lister les fichiers contenus dans un répertoire.</a></li> 28.40 + <li><a href="#cd">Se déplacer dans les répertoires.</a></li> 28.41 + <li><a href="#cp">Copier des fichiers.</a></li> 28.42 + <li><a href="#mkdir">Créer de nouveaux répertoires.</a></li> 28.43 + <li><a href="#rm">Supprimer des fichiers ou des répertoires.</a></li> 28.44 + <li><a href="#read">Lire des fichiers.</a></li> 28.45 + <li><a href="#edit">Editer des fichiers en mode ncurses.</a></li> 28.46 + <li><a href="#cat">Cat</a> - Éditer en ligne de commandes.</li> 28.47 + <li><a href="#web-nav">Naviguer sur le web.</a></li> 28.48 + <li><a href="#irc-chat">Discuter sur les canaux IRC.</a></li> 28.49 + <li><a href="#wget">Télécharger des fichiers.</a></li> 28.50 + <li><a href="#partitions">Lister les partitions disponibles.</a></li> 28.51 + <li><a href="#mount">Monter une partition, un cdrom ou une clé USB.</a></li> 28.52 + <li><a href="#halt">Eteindre le système, ou redémarrer.</a></li> 28.53 +</ul> 28.54 + 28.55 +<a name="intro"></a> 28.56 +<h3><font color="#6c0023">Introduction aux commandes</font></h3> 28.57 +<p> 28.58 +Ce document se veut être un rapide référentiel pour utiliser SliTaz en ligne 28.59 +commandes via un terminal Linux ou un terminal graphique (XTerm). 28.60 +Vous disposez de nombreuses commandes GNU/Linux de manipulation des fichiers, 28.61 +de maintenance système ou de gestion du réseau. Vous pouvez aussi naviguer sur 28.62 +le web, chatter sur l'IRC, télécharger, éditer des scripts et même jouer en 28.63 +mode texte. Note : il faut être <em>root</em> pour les opérations de montage 28.64 +de disques durs ou de cdrom. Vous pouvez utiliser la commande <code>su</code> 28.65 +pour devenir administrateur système. 28.66 +</p> 28.67 +<a name="help"></a> 28.68 +<h3><font color="#6c0023">Aide et liste des commandes disponibles</font></h3> 28.69 +<p> 28.70 +La plupart des commandes des systèmes GNU/Linux ont une option d'aide pour des 28.71 +infos sur leur utilisation. Pour avoir de l'aide et connaître des informations 28.72 +sur l'utilisation d'une commande il faut taper le nom de la commande suivie 28.73 +de l'option <code>--help</code>. Exemple avec la commande de copie de fichiers 28.74 +<code>cp</code> : 28.75 +</p> 28.76 +<pre> 28.77 + $ cp --help 28.78 +</pre> 28.79 +<p> 28.80 +Pour lister les commandes disponibles sur le système, vous pouvez simplement 28.81 +taper 2 fois sur la touche de tabulation qui se trouve à gauche du clavier 28.82 +et comporte 2 flèches horizontales et opposées. Pour connaître les commandes 28.83 +fournient par Busybox, vous pouvez taper <code>help</code>. 28.84 +</p> 28.85 +<a name="ls"></a> 28.86 +<h3><font color="#6c0023">Lister les fichiers contenus dans un répertoire</font></h3> 28.87 +<p> 28.88 +Pour lister les fichiers et les dossiers contenus dans un répertoire, vous 28.89 +pouvez utiliser la commande <code>ls</code>. Pour connaître toutes les 28.90 +possibilités, n'oubliez pas d'utiliser l'option <code>--help</code>. Pour 28.91 +simplement lister les fichiers du répertoire courant : 28.92 +</p> 28.93 +<pre> 28.94 + $ ls 28.95 +</pre> 28.96 +<p> 28.97 +Lister tous les fichiers en utilisant l'option <code>-al</code> : 28.98 +</p> 28.99 +<pre> 28.100 + $ ls -al 28.101 +</pre> 28.102 +<p> 28.103 +Lister un répertoire donné: 28.104 +</p> 28.105 +<pre> 28.106 + $ ls /home/slitaz 28.107 +</pre> 28.108 +<a name="cd"></a> 28.109 +<h3><font color="#6c0023">Se déplacer dans les répertoires</font></h3> 28.110 +<p> 28.111 +Pour naviguer dans les fichiers vous pouvez utiliser la commande 28.112 +<code>cd</code> : 28.113 +</p> 28.114 +<pre> 28.115 + $ cd /usr/share/doc 28.116 + Revenir au réperoire parent : 28.117 + $ cd .. 28.118 +</pre> 28.119 +<p> 28.120 +Pour aller dans le répertoire de l'utilisateur (root = /root) : 28.121 +</p> 28.122 +<pre> 28.123 + $ cd 28.124 + Ou : 28.125 + $ cd ~ 28.126 + Ou encore : 28.127 + $ cd $HOME 28.128 +</pre> 28.129 + 28.130 +<a name="cp"></a> 28.131 +<h3><font color="#6c0023">Copier des fichiers</font></h3> 28.132 +<p> 28.133 +La commande <code>cp</code> copier des fichiers ou des dossiers. L'exemple 28.134 +copie le fichier info.txt se trouve dans le répertoire courant, vers le 28.135 +répertoire Documents/ : 28.136 +</p> 28.137 +<pre> 28.138 + $ cp info.txt Documents/ 28.139 +</pre> 28.140 +<p> 28.141 +Copier un répertoire entier. Ici la commande copie le répertoire Templates/ 28.142 +dans /home/hacker : 28.143 +</p> 28.144 +<pre> 28.145 + $ cp -a Templates /home/hacker 28.146 +</pre> 28.147 + 28.148 +<a name="mkdir"></a> 28.149 +<h3><font color="#6c0023">Créer de nouveaux répertoires</font></h3> 28.150 +<p> 28.151 +mkdir de l'Anglais make a directory. Cette commande permet de créer un nouveau 28.152 +répertoire. La commande ci-dessous crée un répertoire qui se nomme Projects. 28.153 +Il se créera dans le répértoite /home de l'utilisateur courant ou dans le 28.154 +répertoire dans lequel on se trouve : 28.155 +</p> 28.156 +<pre> 28.157 + $ mkdir Projects 28.158 +</pre> 28.159 +<p> 28.160 +Création d'un répertoire qui se nomme script-1.0 dans le dossier Projects/ : 28.161 +</p> 28.162 +<pre> 28.163 + $ mkdir Projects/script-1.0 28.164 +</pre> 28.165 + 28.166 +<a name="rm"></a> 28.167 +<h3><font color="#6c0023">Supprimer des fichiers ou des répertoires</font></h3> 28.168 +<p> 28.169 +La commande <code>rm</code> permet de supprimer un fichier. Imaginons que 28.170 +nous allons supprimer le fichier fichier.txt et qui se trouve dans le 28.171 +répertoire courant : 28.172 +</p> 28.173 +<pre> 28.174 + $ rm fichier.txt 28.175 +</pre> 28.176 +<p> 28.177 +La commande <code>rm</code> a plusieurs options. Pour supprimer tout un 28.178 +répertoire avec son contenu, il faut utiliser l'option <code>-rf</code>. 28.179 +Exemple : 28.180 +</p> 28.181 +<pre> 28.182 + $ rm -rf /home/hacker/Templates 28.183 +</pre> 28.184 + 28.185 +<a name="read"></a> 28.186 +<h3><font color="#6c0023">Lire des fichiers</font></h3> 28.187 +<p> 28.188 +Pour lire le contenu d'un fichier ou d'un script, vous pouvez utiliser les 28.189 +commandes <code>less</code>, <code>more</code>, <code>cat</code>, ou encore 28.190 +le navigateur web Retawq. Exemples avec un fichier README, essential.txt, et 28.191 +script.sh : 28.192 +</p> 28.193 +<pre> 28.194 + $ less -EM essential.txt 28.195 + ou: 28.196 + $ more README 28.197 + ou encore: 28.198 + $ cat /chemin/script.sh 28.199 +</pre> 28.200 +<p> 28.201 +Afficher un fichier texte ou html avec le navigateur web Retawq : 28.202 +</p> 28.203 +<pre> 28.204 + $ retawq /usr/share/doc/index.html 28.205 +</pre> 28.206 + 28.207 +<a name="edit"></a> 28.208 +<h3><font color="#6c0023">Editer des fichiers</font></h3> 28.209 +<p> 28.210 +L'édition de fichiers texte, scripts, fichier de configurations, etc, peut se 28.211 +faire facilement avec l'éditeur GNU Nano dans une console ou un terminal 28.212 +graphique. Exemple avec un fichier bookmarks.html (<Ctrl+X> pour quitter 28.213 +et enregistrer) : 28.214 +</p> 28.215 +<pre> 28.216 + $ nano Public/bookmarks.html 28.217 +</pre> 28.218 + 28.219 +<a name="cat"></a> 28.220 +<h3><font color="#6c0023">Cat</font></h3> 28.221 +<p> 28.222 +Vous pouvez utiliser la commande <code>cat</code> pour créer divers 28.223 +fichiers texte. EOF signifie End Of File, c'est là que le fichier se termine. 28.224 +Exemple avec un fichier packages.list, cette commande supprime le contenu 28.225 +actuel du fichier : 28.226 +</p> 28.227 +<pre> 28.228 + $ cat > packages.list << "EOF" 28.229 + Du texte... 28.230 + et encore texte 28.231 + 28.232 + EOF 28.233 +</pre> 28.234 +<p> 28.235 +Pour ajouter du texte à la suite du fichier, mettez 2 fois: plus grand que 28.236 +(>>) après <code>cat</code>, exemple : 28.237 +</p> 28.238 +<pre> 28.239 + $ cat >> packages.list << "EOF" 28.240 + Du texte... 28.241 + 28.242 + EOF 28.243 +</pre> 28.244 + 28.245 +<a name="web-nav"></a> 28.246 +<h3><font color="#6c0023">Naviguer sur le web</font></h3> 28.247 +<p> 28.248 +Surfer sur la toile avec SliTaz simplement et rapidement avec 'retawq', 28.249 +navigateur web en mode texte. A noter que vous pouvez aussi utiliser 28.250 +le navigateur en local. Vous naviguerez ensuite facilement avec les flèches 28.251 +de votre clavier, les liens sont en bleu et il faut taper <ENTER> pour 28.252 +les suivre : 28.253 +</p> 28.254 +<pre> 28.255 + $ retawq http://slitaz.libordux.org/ 28.256 + ou: 28.257 + $ retawq http://localhost/ 28.258 +</pre> 28.259 +<a name="irc-chat"></a> 28.260 +<h3><font color="#6c0023">Discuter sur les canaux IRC</font></h3> 28.261 +<p> 28.262 +Pour discuter et transférer des fichiers via les multiples serveurs IRC 28.263 +de la planète, SliTaz fournit Rhapsody. Ce client IRC est simple, rapide, 28.264 +léger, fournissant un menu de configuration ncurses très agréable et facile à 28.265 +prendre en main. Pour lancer l'application depuis un terminal, se connecter 28.266 +à un serveur (irc.tuxfamily.org) et joindre le canal #tuxfamily : 28.267 +</p> 28.268 +<pre> 28.269 + $ rhapsody 28.270 + /connect irc.tuxfamily.org 28.271 + /join #tuxfamily 28.272 +</pre> 28.273 +<a name="wget"></a> 28.274 +<h3><font color="#6c0023">Télécharger des fichiers</font></h3> 28.275 +<p> 28.276 +Pour télécharger divers formats de fichiers sur internet, vous disposez de la 28.277 +commande <code>wget</code>. Vous pouvez rapatrier une simple page html, 28.278 +le contenu de tout un répertoire ou tout un site web : 28.279 +</p> 28.280 +<pre> 28.281 + $ wget http://www.slitaz.org/doc/handbook/ 28.282 +</pre> 28.283 +<a name="partitions"></a> 28.284 +<h3><font color="#6c0023">Lister les partitions disponibles</font></h3> 28.285 +<p> 28.286 +Pour lister les partitions d'un disque dur interne ou externe, vous pouvez 28.287 +utiliser la commande cat pour afficher le contenu du fichier 28.288 +<code>/proc/partitions</code> ou utiliser l'utilitaire <code>fdisk</code> 28.289 +avec l'option <code>-l</code> signifiant <em>list</em>. Vous pouvez ensuite 28.290 +monter la (les) partitions que vous désirez utiliser : 28.291 +</p> 28.292 +<pre> 28.293 + $ cat /proc/partitions 28.294 + ou 28.295 + # fdisk -l 28.296 +</pre> 28.297 +<a name="mount"></a> 28.298 +<h3><font color="#6c0023">Monter une partition, un cdrom ou une clé USB</font></h3> 28.299 +<p> 28.300 +Pour monter une partition locale, dans le système de fichier SliTaz, nous vous 28.301 +conseillons d'utiliser le répertoire /mnt. Dans l'exemple nous créons les 28.302 +répertoires nécessaires, et nous montons la partition <code>hda6</code> du 28.303 +premier disque dur local sur /mnt/hda6 : 28.304 +</p> 28.305 +<pre> 28.306 + # mkdir -p /mnt/hda6 28.307 + # mount -t ext3 /dev/hda6 /mnt/hda6 28.308 +</pre> 28.309 +<p> 28.310 +SliTaz fonctionne en RAM, vous pouvez monter ce même cdrom ou le retirer 28.311 +pour en monter un autre (/dev/cdrom est un lien sur le premier lecteur de 28.312 +cdrom). A noter qu'un cdrom est un média amovible, il devrait donc se 28.313 +monter sur /media : 28.314 +</p> 28.315 +<pre> 28.316 + # mount -t iso9660 /dev/cdrom /media/cdrom 28.317 +</pre> 28.318 +<p> 28.319 +Pour monter une clé USB ou flash disk il faut spécifier le bon système de 28.320 +fichiers. Normalement une clé USB achetée dans le marché est formatée en 28.321 +FAT32 ce qui permet de la lire depuis GNU/Linux et Windows. Sur un système 28.322 +GNU/Linux elle est reconnue généralement comme le disque sda1, nous avons 28.323 +donc préparer un lien <code>sda1</code> sur <code>flash</code>, pour se 28.324 +faciliter la tâche. C'est aussi un média amovible et devrait se monter sur 28.325 +/media : 28.326 +</p> 28.327 +<pre> 28.328 + # mount -t vfat /dev/flash /media/flash 28.329 +</pre> 28.330 +<a name="halt"></a> 28.331 +<h3><font color="#6c0023">Eteindre le système, ou redémarrer</font></h3> 28.332 +<p> 28.333 +Pour arrêter SliTaz ou redémarrer, vous pouvez utiliser la commande 28.334 +<code>halt</code>, <code>reboot</code> ou utiliser la combinaison des touches 28.335 +<Ctrl+Alt+Delete>, ce qui correspond à un redémarrage système. En cas de 28.336 +problèmes, essayez d'utiliser l'option <code>-f</code>, signifiant 28.337 +<em>forced</em> : 28.338 +</p> 28.339 +<pre> 28.340 + # halt 28.341 + Pour redémarrer : 28.342 + # reboot 28.343 + Ou : 28.344 + # reboot -f 28.345 +</pre> 28.346 + 28.347 +<!-- End of content --> 28.348 +</div> 28.349 + 28.350 +<!-- Footer. --> 28.351 +<div id="footer"> 28.352 + <div class="footer-right"></div> 28.353 + <a href="#top">Haut de la page</a> | 28.354 + <a href="index.html">Table des matières</a> 28.355 +</div> 28.356 + 28.357 +<div id="copy"> 28.358 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 28.359 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 28.360 + Documentation publiées sous 28.361 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 28.362 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 28.363 +</div> 28.364 + 28.365 +</body> 28.366 +</html>
29.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 29.2 +++ b/doc/handbook/development.html Sat Mar 29 12:01:05 2008 +0100 29.3 @@ -0,0 +1,332 @@ 29.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 29.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 29.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 29.7 +<head> 29.8 + <title>SliTaz Handbook - Developpement</title> 29.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 29.10 + <meta name="description" content="developpement sur Slitaz Geany scripts dialog toolchain gcc make" /> 29.11 + <meta name="expires" content="never" /> 29.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 29.13 + <meta name="publisher" content="www.slitaz.org" /> 29.14 + <meta name="author" content="Christophe Lincoln"/> 29.15 + <link rel="shortcut icon" href="favicon.ico" /> 29.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 29.17 +</head> 29.18 +<body bgcolor="#ffffff"> 29.19 + 29.20 +<!-- Header and quick navigation --> 29.21 +<div id="header"> 29.22 +<div align="right" id="quicknav"> 29.23 + <a name="top"></a> 29.24 + <a href="secure-shell.html">SHell sécurisé</a> | 29.25 + <a href="index.html">Table des matières</a> 29.26 +</div> 29.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 29.28 +</div> 29.29 + 29.30 +<!-- Content. --> 29.31 +<div id="content"> 29.32 +<div class="content-right"></div> 29.33 + 29.34 +<h2><font color="#DF8F06">Développement</font></h2> 29.35 + 29.36 +<ul> 29.37 + <li><a href="#about">À propos du développement</a> - Sur SliTaz 29.38 + et de SliTaz.</li> 29.39 + <li><a href="#shell-scripts">Scripts SHell</a> - #!/bin/sh</li> 29.40 + <li><a href="#dialog">Dialog</a> - Création d'interface graphique 29.41 + basée sur la console.</li> 29.42 + <li><a href="#geany">Geany</a> - IDE ou Environnement de Développement 29.43 + Intégré.</li> 29.44 + <li><a href="#perl">Perl ou Microperl</a> - Coder et utiliser des scripts 29.45 + Perl et/ou CGI propulsés par microperl.</li> 29.46 + <li><a href="#python">Python</a> - Le langage Python</li> 29.47 + <li><a href="#toolchain">Toolchain</a> - Bibliothèques, compilateur C 29.48 + et outils associés.</li> 29.49 +</ul> 29.50 + 29.51 +<a name="about"></a> 29.52 +<h3><font color="#6c0023">À propos du dévelopement</font></h3> 29.53 +<p> 29.54 +SliTaz fournit quelques outils de développement, conception de sites web, 29.55 +édition avancée de scripts, et de code source avec l'IDE 'geany'. Création 29.56 +d'interface graphique à vos scripts SHell avec 'dialog'. 29.57 +</p> 29.58 +<p> 29.59 +Si vous cherchez des informations sur le développement de SliTaz, 29.60 +le <a href="http://www.slitaz.org/doc/cookbook/">cookbook</a> (livre de 29.61 +cuisine) vous décrira toutes les étapes de construction du système. Sur le 29.62 +site web de SliTaz, la partie <a href="http://www.slitaz.org/devel/">devel</a> 29.63 +vous donnera des informations générales au sujet des développeurs et des 29.64 +possibilités de participation. 29.65 +</p> 29.66 +<a name="shell-scripts"></a> 29.67 +<h3><font color="#6c0023">Scripts SHell</font></h3> 29.68 +<p> 29.69 +L'écriture de scripts SHell est la manière la plus simple pour commencer à 29.70 +coder, ils permettent d'avoir rapidement un résultat et les seuls prérequis 29.71 +sont de savoir ouvrir un terminal et utiliser un éditeur de texte tels 29.72 +que Nano, LeafPad ou Geany. Les scripts SHell permettent de faire énomérement 29.73 +de choses sur un système GNU/Linux, initialiser le système, faire des 29.74 +sauvegardes, exécuter des tâches répétitives, afficher des informations sur 29.75 +l'état du système, créer ou modifier des fichier, etc. Dans un script SHell, 29.76 +vous pouvez aussi utiliser des variables, des fonctions ou encore des appels 29.77 +pour inclure un fichier. A noter que vous pouvez nommer vos scripts comme bon 29.78 +vous semble et que l'utilisation de l'extension <code>.sh</code> est largement 29.79 +utilisée. 29.80 +</p> 29.81 +<h4>Créer un script SHell</h4> 29.82 +<p> 29.83 +Avant de commencer un nouveau script SHell, vous devez faire attention 29.84 +à l'interprétateur utilisé. La plus part du temps les scripts SHell 29.85 +utilisent <code>/bin/sh</code>, cela permet d'être plus portable. 29.86 +Il y a aussi des scripts qui appelent <code>/bin/bash</code>, mais cela 29.87 +implique que Bash soit installé sur le système. Pour qu'un script SHell 29.88 +fonctionne il doit être exécutable par l'utilisateur courant, le changement 29.89 +des permissions sur un fichier peut se faire en ligne de commande via 29.90 +l'outils <code>chmod</code>. Pour créer un <code>script.sh</code> et le 29.91 +rendre exécutable : 29.92 +</p> 29.93 +<pre> 29.94 + $ touch script.sh 29.95 + $ chmod +x script.sh 29.96 +</pre> 29.97 +<p> 29.98 +Maintenant que vous avez un nouveau fichier exécutable, vous allez pouvoir 29.99 +l'éditer. Vous pouvez continuer en restant dans le terminal et en utilisant 29.100 +l'éditeur Nano (Ctrl+X pour enregistrer) ou en ouvrant l'IDE Geany sur le 29.101 +fichier : 29.102 +</p> 29.103 +<pre> 29.104 + $ nano script.sh 29.105 + Ou : 29.106 + $ geany script.sh & 29.107 +</pre> 29.108 +<p> 29.109 +Voici un µscript qui contient une variable <code>NAME</code> et qui en 29.110 +affiche la valeur avec la commande <code>echo</code> : 29.111 +</p> 29.112 +<pre class="script"> 29.113 +#!/bin/sh 29.114 + 29.115 +NAME="kayam" 29.116 + 29.117 +echo "$NAME est sympa." 29.118 + 29.119 +</pre> 29.120 +<p> 29.121 +Une fois que vous avez créé/modifié votre <code>script.sh</code>, il suffit 29.122 +d'enregistrer et d'exécuter le script pour voir le résultat : 29.123 +</p> 29.124 +<pre> 29.125 + $ ./script.sh 29.126 +</pre> 29.127 +<p> 29.128 +Voilà pour cette brève introduction au scripts SHell. Pour aller plus loin, le 29.129 +web regorge d'informations à ce sujet et regarder ce qu'on fait les autres 29.130 +peut aussi aider. 29.131 +</p> 29.132 +<a name="dialog"></a> 29.133 +<h3><font color="#6c0023">Dialog</font></h3> 29.134 +<p> 29.135 +Dialog permet de créer des interfaces graphique basées sur la console, telles 29.136 +que 'tazkmap'. Le fichier de configuration de dialog est /etc/dialogrc, et/ou 29.137 + ~/.dialogrc pour chaque utilisateur. Voici un simple exemple d'utilisation de 29.138 + dialog via une console ou un terminal : 29.139 +</p> 29.140 +<pre> 29.141 + $ dialog --title "Hello $USER" \ 29.142 + --msgbox "Message propulsé par dialog." 5 54 29.143 +</pre> 29.144 +<p> 29.145 +Vous trouverez pleins d'exemples de scripts dans le répertoire /sample des 29.146 +sources de dialog, que vous pouvez télécharger depuis: 29.147 +<a href="http://invisible-island.net/dialog/dialog.html" 29.148 + >invisible-island.net/dialog/dialog.html</a>. Download des sources avec 29.149 +'wget' et décompression : 29.150 +</p> 29.151 +<pre> 29.152 + $ wget ftp://invisible-island.net/dialog/dialog.tar.gz 29.153 + $ tar xzf dialog.tar.gz 29.154 +</pre> 29.155 +<a name="geany"></a> 29.156 +<h3><font color="#6c0023">Geany IDE</font></h3> 29.157 +<p> 29.158 +Geany est un IDE ou Environnement de Dévelopement Intégré, il est simple, 29.159 +léger, et rapide, proposant la coloration syntaxique, les onglets, 29.160 +pliage/dépliage du code, la complétion automatique, de l'aide à l'écriture. 29.161 +Vous avez une liste des symboles, fonctions, méthodes, variables très utiles, 29.162 +avec une petite flèche de signalisation. Et encore, sélecteur de couleurs 29.163 +intégré, fenêtre de messages, lancement du script courant via le bouton 29.164 +Exécuter, etc. C'est avec lui que nous avons créé cette page, 29.165 +la documentation, et presque tout le site web (un peu avec Nano aussi). 29.166 +</p> 29.167 +<h4>Lancer Geany</h4> 29.168 +<p> 29.169 +Vous trouverez Geany dans le menu de JWM --> Development --> Geany. 29.170 +Un fois lancé pour la première fois, vous pouvez ajuster vos préférences 29.171 +via --> Editer --> Préférences. Vous pouvez aussi lancer Geany via un 29.172 +terminal X et la commande : 29.173 +</p> 29.174 +<pre> 29.175 + $ geany & 29.176 +</pre> 29.177 +<p> 29.178 +Note : Lors de la compilation des sources, le scripts <code>./configure</code> 29.179 +propose l'option : <code>--enable-the-force</code>... Que l'on peut utiliser 29.180 +si l'on penser avoir la force et être Luc Skywalker! 29.181 +</p> 29.182 +<a name="perl"></a> 29.183 +<h3><font color="#6c0023">Perl ou Microperl - Coder/utiliser des scripts Perl</font></h3> 29.184 +<p> 29.185 +Sur SliTaz vous pouvez coder et utiliser le puissant langage de scripts Perl 29.186 +via le binaire <code>perl</code> ou <code>microperl</code>. Microperl est une 29.187 +version très allégée de Perl compilée à partir des sources officielles de Perl, 29.188 +les scripts fonctionnant avec microperl sont complètement compatible avec la 29.189 +version complète de Perl. C'est justement une des forces de Perl, il est portable 29.190 +et fonctionne sur toutes les systèmes d'exploitations. Perl est un langage 29.191 +interprété cela veut dire que le code n'a pas besoin d'être compilé et qu'il 29.192 +peut être utilisé directement. A noter que sur SliTaz, <code>perl</code> 29.193 +et/ou <code>microperl</code> se sont pas installé par défaut sur le LiveCD, vous 29.194 +pouvez soit reconstruire votre propore ISO en incluant Perl ou installer via 29.195 +le gestionnaire de paquets. A noter que le paquet Microperl fait mois d'1 Mb 29.196 +et ne fournit aucun modules, juste le minimum : 29.197 +</p> 29.198 +<pre> 29.199 + # tazpkg install perl 29.200 + Ou : 29.201 + # tazpkg install microperl 29.202 +</pre> 29.203 + 29.204 +<h4>Hello world!</h4> 29.205 +<p> 29.206 +Le but de ce µscript est d'afficher <em>Hello World</em>. Vous pouvez 29.207 +commencer par créer le fichier et le rendre exécutable depuis la ligne de 29.208 +commandes et l'éditer ensuite graphiquement avec l'IDE Geany. A noter que nous 29.209 +nommons le scripts <code>hello.pl</code> mais que vous pouvez nommer un 29.210 +script Perl comme bon vous semble, avec ou sans l'extension <code>.pl</code> : 29.211 +</p> 29.212 +<pre> 29.213 + $ touch hello.pl 29.214 + $ chmod +x hello.pl 29.215 + $ geany hello.pl & 29.216 +</pre> 29.217 +<p> 29.218 +La première ligne d'un scripts Perl commence par définir le chemin vers 29.219 +l'interprétateur Perl, généralement <code>/usr/bin/perl</code> et pour 29.220 +afficher du texte il suffit d'utiliser la commande <code>print</code>. 29.221 +Code à copier/coller. A noter que le langage Perl est sensible à la casse et 29.222 +qu'une instruction devrait toujours se terminer par un point-virgule : 29.223 +</p> 29.224 +<pre class="script"> 29.225 +#!/usr/bin/perl 29.226 +# 29.227 + 29.228 +print "Hello World!\n"; 29.229 + 29.230 +</pre> 29.231 +<p> 29.232 +Pour exécuter et tester le script : 29.233 +</p> 29.234 +<pre> 29.235 + $ ./hello.pl 29.236 +</pre> 29.237 + 29.238 +<h4>Scripts CGI et Perl</h4> 29.239 +<p> 29.240 +Les scripts CGI ont pour but d'afficher des pages web générées dynamiquement. 29.241 +Le langage Perl assoicié au serveur web LightTPD vous permet d'utiliser 29.242 +des scripts CGI via votre espace public ou via des hôtes virtuels. Perl est 29.243 +tout à fait adapté au web 2.0 et permet de générer rapidement des pages xHTML. 29.244 +Sur Slitaz, vous devez avoir installé Perl ou Microperl et 29.245 +<a href="web-server.html#cgi-perl">configuré le serveur Web LightTPD</a> avant 29.246 +de pouvoir utiliser des scripts CGI codé en Perl. A noter que par défaut vous 29.247 +pouvez utiliser des scripts SHell (.sh) et les placer dans /cgi-bin/). 29.248 +</p> 29.249 +<p> 29.250 +Une fois le server bien configuré, vous pouvez directement placer des scripts 29.251 +CGI dans votre répertoire <code>$HOME/Public/cgi-bin</code> en utilisant 29.252 +l'extension <code>.pl</code> ou <code>.cgi</code> et les visualiser en local 29.253 +ou à distance. Exemple de script CGI utilisant Perl : 29.254 +</p> 29.255 +<pre class="script"> 29.256 +#!/usr/bin/perl 29.257 +# 29.258 +print "content-type : text/html\n\n"; 29.259 + 29.260 +print "Hello World!\n"; 29.261 + 29.262 +</pre> 29.263 + 29.264 +<a name="python"></a> 29.265 +<h3><font color="#6c0023">Python</font></h3> 29.266 +<p> 29.267 +Le langage de programmation Python est disponible sous forme de paquet 29.268 +facilement installable. Un fois Python installé vous pouvez créer vos propre 29.269 +scripts/programmes et utiliser des applications CGI via le serveur Web LightTPD 29.270 +en prenant soin de <a href="web-server.html#cgi-python">configurer le serveur</a> 29.271 +correctement. A noter que le dépôt Mercurial officiel de SliTaz fourni une 29.272 +interface Web CGI/Python, c'est une solution adaptée à la production, robuste 29.273 +et fiable. Pour installer le paquet <code>python</code> avec Tazpkg : 29.274 +</p> 29.275 +<pre> 29.276 + # tazpkg get-install python 29.277 +</pre> 29.278 + 29.279 +<a name="toolchain"></a> 29.280 +<h3><font color="#6c0023">Toolchain - Bibliothèques, compilateur C et outils associés</font></h3> 29.281 +<p> 29.282 +Pour compiler des logiciels depuis les sources ou son propre code, vous avez 29.283 +au minimum, besoin de la chaîne d'outils de base (<em>toolchain</em>), 29.284 +composée des outils Binutils, de la bibliothèque Glibc , du compilateur 29.285 +GCC, des <em>headers</em> du noyau et de l'utilitaire Make. Cette chaîne 29.286 +d'outils peut être installée via le gestionnaire de paquets Tazpkg et une 29.287 +seule commande. A noter que cette <em>toolchain</em> est utilisée par les 29.288 +développeurs de SliTaz pour compiler le système entier depuis les sources. 29.289 +Pour installer les paquets via l'installation d'un meta paquet créant les 29.290 +dépendances qu'il faut : 29.291 +</p> 29.292 +<pre> 29.293 + # tazpkg get-install slitaz-toolchain 29.294 +</pre> 29.295 +<p> 29.296 +L'installation de la toolchain permet de compiler beaucoup d'applications 29.297 +de base et en mode texte. A noter que beaucoup de paquets compileront sans 29.298 +problème en utilisant le SHell Ash de Busybox, mais d'autres paquets ne 29.299 +compileront pas sans Bash. GNU bash est disponnible sous forme de paquet 29.300 +ainsi que divers outils de développement de base tels que Flex, M4, Bison, 29.301 +ou encore Pkg-config. Si vous cherchez pkg-config par exemple : 29.302 +</p> 29.303 +<pre> 29.304 + $ tazpkg search pkg-config 29.305 +</pre> 29.306 +<p> 29.307 +Si vous désirez compiler des applications utilsant les bibliothèques Ncurses, 29.308 +vous devez installer le paquet <code>ncurses-dev</code> complet (par défaut 29.309 +il n'y a que le paquet minimum installé). A noter que le paquet ncurses fournit 29.310 +aussi divers petits programmes tels que <code>tic</code> ou <code>tack</code> : 29.311 +</p> 29.312 +<pre> 29.313 + $ tazpkg search ncurses 29.314 +</pre> 29.315 + 29.316 +<!-- End of content --> 29.317 +</div> 29.318 + 29.319 +<!-- Footer. --> 29.320 +<div id="footer"> 29.321 + <div class="footer-right"></div> 29.322 + <a href="#top">Haut de la page</a> | 29.323 + <a href="index.html">Table des matières</a> 29.324 +</div> 29.325 + 29.326 +<div id="copy"> 29.327 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 29.328 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 29.329 + Documentation publiées sous 29.330 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 29.331 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 29.332 +</div> 29.333 + 29.334 +</body> 29.335 +</html>
30.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 30.2 +++ b/doc/handbook/enlightenment.html Sat Mar 29 12:01:05 2008 +0100 30.3 @@ -0,0 +1,190 @@ 30.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 30.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 30.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 30.7 +<head> 30.8 + <title>SliTaz Handbook - Enlightenment</title> 30.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 30.10 + <meta name="description" content="" /> 30.11 + <meta name="expires" content="never" /> 30.12 + <meta name="modified" content="2000-02-03 19:30:00" /> 30.13 + <meta name="publisher" content="www.slitaz.org" /> 30.14 + <meta name="author" content="Christophe Lincoln"/> 30.15 + <link rel="shortcut icon" href="favicon.ico" /> 30.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 30.17 +</head> 30.18 +<body bgcolor="#ffffff"> 30.19 + 30.20 +<!-- Header and quick navigation --> 30.21 +<div id="header"> 30.22 +<div align="right" id="quicknav"> 30.23 + <a name="top"></a> 30.24 + <a href="utilities.html">Utilitaires</a> | 30.25 + <a href="index.html">Table des matières</a> 30.26 +</div> 30.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 30.28 +</div> 30.29 + 30.30 +<!-- Content. --> 30.31 +<div id="content"> 30.32 +<div class="content-right"></div> 30.33 + 30.34 +<h2><font color="#DF8F06">Enlightenment (e17)</font></h2> 30.35 + 30.36 +<ul> 30.37 + <li><a href="#intro">Introduction et présentation.</a></li> 30.38 + <li><a href="#install">Installation et lancement.</a></li> 30.39 + <li><a href="#menu-icons">Menu et icônes de bureau.</a></li> 30.40 + <li><a href="#themes">Thèmes graphiques.</a></li> 30.41 +</ul> 30.42 + 30.43 +<a name="intro"></a> 30.44 +<h3><font color="#6c0023">Introduction et présentation de e17</font></h3> 30.45 +<p> 30.46 +Enlightenment est un environnement de bureau complet, entièrement configurable 30.47 +à la souris et proposant de nombreux thèmes. La version fournie par le projet 30.48 +SliTaz est une version encore en développement connue sous le nom de e17, 30.49 +cette version est considérée suffisament stable pour être intégrée dans la 30.50 +distribution et travailler en production. Cela dit, SliTaz ne propose pas des 30.51 +outils tels que Rage ou Entrance, mais ce qu'il faut pour disposer d'un 30.52 +d'environnement de bureau complet, simple d'utilisation, stable, réactif et 30.53 +efficace. Tous les réglages peuvent se faire graphiquement via le panneau de 30.54 +configuration intégrés au bureau, le menu s'affiche via un clique de gauche 30.55 +sur l'écran ou depuis une gondole. Il est entre autres possible d'utiliser le 30.56 +glisser/déposer depuis un gestionnaire de fichiers et le bureau ou d'afficher 30.57 +des icônes pour lancer ses applications préférées. 30.58 +</p> 30.59 +<p> 30.60 +Enlightenment a été conçu pour être déployable sur des systèmes avec peu de 30.61 +ressources comme sur les systèmes plus puissants. IL permet d'avoir des fonds 30.62 +d'écran, des éléments du menus et des gadgets animés et interactifs, sait 30.63 +gérer les bureaux virtuels (Alt + roulette de la souris). D'autres 30.64 +fonctionnalités très pratiques permettent de gagner du temps sur des tâches 30.65 +simples, comme par exemple le fait de déplacer une fenêtre d'un bureau à un 30.66 +autre via le pager ou le fait d'enrouler une fenêtre avec la molette sur sa 30.67 +bordure. 30.68 +</p> 30.69 +<p> 30.70 +Site Web : <a href="http://www.enlightenment.org/">www.enlightenment.org</a> 30.71 +</p> 30.72 + 30.73 +<a name="install"></a> 30.74 +<h3><font color="#6c0023">Installation et lancement</font></h3> 30.75 +<p> 30.76 +Installer et lancer Enlightenment sur SliTaz se résume à exécuter une commande 30.77 +et éditer un fichier. Si vous n'avez pas rechargé votre liste de paquets depuis 30.78 +quelques temps, pensez à la mettre à jour. Pour installer Enlightenment et ses 30.79 +dépendances : 30.80 +</p> 30.81 +<pre> 30.82 + # tazpkg get-install enlightenment 30.83 +</pre> 30.84 +<p> 30.85 +Une fois tous les paquets installés, vous pouvez reconfigurer votre session X 30.86 +avec <code>tazx</code> en spécifiant e17 en argument : 30.87 +</p> 30.88 +<pre> 30.89 + $ tazx e17 30.90 +</pre> 30.91 +<p> 30.92 +Pour commencer à utiliser Enlightenment il faut sauver le fichier, sortir de 30.93 +sa session X courante et redémarrer une session graphique avec : 30.94 +</p> 30.95 +<pre> 30.96 + $ startx 30.97 +</pre> 30.98 +<h4>Éditer ~/.xsession</h4> 30.99 +<p> 30.100 +Pour configurer manuellement votre session X via le fichier de configuration 30.101 +de votre session X (<code>~/.xsession</code>). Il faut modifier la ligne 30.102 +lançant le serveur Xvesa, commenter ou supprimer la ligne exécutant 30.103 +JWM et ajouter <code>exec enlightenment_start</code> à la fin du fichier. 30.104 +~/.Xsession peut être édité depuis le menu de JWM et la catégorie 30.105 +<em>Preferences</em> ou avec Nano dans un terminal. N'oubliez pas d'ajouter 30.106 +<code>-terminate</code> à la ligne lançant Xvesa. Simple exemple : 30.107 +</p> 30.108 +<pre class="script"> 30.109 +# ~/.xsession: Start X window session on your system. 30.110 +# 30.111 +Xvesa -ac -shadow -terminate -screen 1280x800x24 -mouse /dev/input/mice,5 & 30.112 +#exec jwm 30.113 +exec enlightenment_start 30.114 +</pre> 30.115 +<p> 30.116 +Sortez de votre session est relancez <code>startx</code>. 30.117 +</p> 30.118 + 30.119 +<a name="menu-icons"></a> 30.120 +<h3><font color="#6c0023">Menu et icônes de bureau</font></h3> 30.121 +<p> 30.122 +Enlightenment respect les standards de Freedesktop, les applications sont 30.123 +classées par catégorie et apparaîssent automatiquement lors de leur 30.124 +installation si un un fichier de bureau est fournit. Les fichiers de bureau 30.125 +(<code>.desktop</code>) du système sont contenu dans le répertoire 30.126 +<code>/usr/share/applications</code> ou le repértoire personnel 30.127 +<code>~/.local/share/applications</code>. Ces fichiers de bureau ont une 30.128 +syntaxe simple, sont éditables depuis le panneau de configuration ou avec 30.129 +un simple éditeur de texte. Les fichiers des menus affichant les catégories 30.130 +dans le menu d'Enlightenment sont contenus dans le paquet 30.131 +<code>slitaz-menus</code> : 30.132 +</p> 30.133 +<pre> 30.134 + # tazpkg get-install slitaz-menus 30.135 +</pre> 30.136 +<h4>Un icône sur le bureau</h4> 30.137 +<p> 30.138 +Pour avoir un icône sur le bureau lançant une application vous pouvez créer 30.139 +à la main un fichier <code>.desktop</code> dans votre répertoire personnel 30.140 +<code>~/Desktop</code>, les fichiers de bureau placés dans ce réperoire sont 30.141 +automatiquement reconnus par Enlightenment. Un simple fichier de bureau peut 30.142 +tenir sur huit lignes avec respectivement le nom (<code>Name</code>), le nom 30.143 +généric, un commentaire, la commande à exécuter (<code>Exec</code>), l'icône, 30.144 +le type et les catégories Freedesktop. Exemple d'un fichier de bureau pour 30.145 +Xterm : 30.146 +</p> 30.147 +<pre class="script"> 30.148 +[Desktop Entry] 30.149 +Name=XTerm (sb) 30.150 +GenericName=Terminal 30.151 +Comment=Run commands in a shell 30.152 +Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar 30.153 +Icon=xterm.png 30.154 +Type=Application 30.155 +Categories=Utility;Terminal; 30.156 +</pre> 30.157 + 30.158 +<a name="themes"></a> 30.159 +<h3><font color="#6c0023">Thèmes graphiques</font></h3> 30.160 +<p> 30.161 +Enlightenment est conçu de manière à pouvoir tout configurer en fonctions de 30.162 +ses préférences. Vous pouvez facilement modifier l'apparence des fenêtres, 30.163 +de l'image de démarrage, du fond d'écran, les mouvements des fenêtres, les 30.164 +gondoles et autres gadjgets. Vous trouverez plusieurs thèmes complet ou 30.165 +fonds décran sur le site Web dédié aux outils et graphisme du bureau get-e.org. 30.166 +Les thèmes s'installent graphiquement via le menu et l'interface de 30.167 +configuration des thèmes, vous pouvez aussi les mettre manuellement dans vos 30.168 +répertoires de configuration personnel de Enlightenment : <code>~/.e/e</code>. 30.169 +</p> 30.170 +<p> 30.171 +Enlightenment users art : <a href="http://www1.get-e.org/">www1.get-e.org</a> 30.172 +</p> 30.173 + 30.174 +<!-- End of content --> 30.175 +</div> 30.176 + 30.177 +<!-- Footer. --> 30.178 +<div id="footer"> 30.179 + <div class="footer-right"></div> 30.180 + <a href="#top">Haut de la page</a> | 30.181 + <a href="index.html">Table des matières</a> 30.182 +</div> 30.183 + 30.184 +<div id="copy"> 30.185 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 30.186 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 30.187 + Documentation publiées sous 30.188 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 30.189 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 30.190 +</div> 30.191 + 30.192 +</body> 30.193 +</html>
31.1 Binary file doc/handbook/favicon.ico has changed
32.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 32.2 +++ b/doc/handbook/gen-livecd.html Sat Mar 29 12:01:05 2008 +0100 32.3 @@ -0,0 +1,294 @@ 32.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 32.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 32.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 32.7 +<head> 32.8 + <title>SliTaz Handbook - Générer son propre LiveCD à saveur</title> 32.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 32.10 + <meta name="description" content="créer son propre livecd de slitaz gnu linux tazlito" /> 32.11 + <meta name="expires" content="never" /> 32.12 + <meta name="modified" content="2008-01-30 13:30:00" /> 32.13 + <meta name="publisher" content="www.slitaz.org" /> 32.14 + <meta name="author" content="Christophe Lincoln"/> 32.15 + <link rel="shortcut icon" href="favicon.ico" /> 32.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 32.17 +</head> 32.18 +<body bgcolor="#ffffff"> 32.19 + 32.20 +<!-- Header and quick navigation --> 32.21 +<div id="header"> 32.22 +<div align="right" id="quicknav"> 32.23 + <a name="top"></a> 32.24 + <a href="liveusb.html">LiveUSB</a> | 32.25 + <a href="index.html">Table des matières</a> 32.26 +</div> 32.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 32.28 +</div> 32.29 + 32.30 +<!-- Content. --> 32.31 +<div id="content"> 32.32 +<div class="content-right"></div> 32.33 + 32.34 +<h2><font color="#DF8F06">Générer un LiveCD à saveur</font></h2> 32.35 +<p> 32.36 +Comment créer son propre LiveCD facilement est rapidement avec Tazlito. 32.37 +</p> 32.38 + 32.39 +<ul> 32.40 + <li><a href="#intro">Pour commencer.</a></li> 32.41 + <li><a href="#2cmds">Un LiveCD en 2 commandes.</a></li> 32.42 + <li><a href="#get-flavor">Récupérer une saveur.</a></li> 32.43 + <li><a href="#gen-distro">Générer la distribution.</a></li> 32.44 + <li><a href="#gen-flavor">Créer une saveur.</a></li> 32.45 + <li><a href="#addfiles">Fichiers additionnels.</a></li> 32.46 + <li><a href="#pkgs">Paquets utilisés.</a></li> 32.47 + <li><a href="#configure">Fichier de configuration.</a></li> 32.48 +</ul> 32.49 + 32.50 +<a name="intro"></a> 32.51 +<h3><font color="#6c0023">Pour commencer</font></h3> 32.52 +<p> 32.53 +Créer sa propre version du LiveCD de SliTaz avec Tazlito (<em>SliTaz Live 32.54 +Tool</em>) prend peu de temps et permet de choisir précisément les paquets 32.55 +logiciels que l'on veut retrouver dans le système. Le support des saveurs 32.56 +vous pemet de générer un LiveCD personnalisé en modifiant une liste de paquets 32.57 +ou en utilisant des saveurs crées et envoyées sur slitaz.org par des 32.58 +utilisateurs ou contributeurs. Tazlito est un outil en ligne de commande, il 32.59 +ne faut pas que cela vous repousse, vous aurez votre propre image ISO en 2 32.60 +commandes et la graverez en 1 commande. 32.61 +</p> 32.62 +<p> 32.63 +La génération du LiveCD demande un minimum de 256 Mb de RAM et la compression 32.64 +du système avec LZMA peut prendre un certain temps. Il est possible de créer 32.65 +une distribution depuis le mode LiveCD ou depuis un système installé. En mode 32.66 +LiveCD, il est conseillé d'utiliser un media USB ou un disque dur pour stocker 32.67 +les fichiers générés, conserver le travail et gagner de la place en RAM. 32.68 +</p> 32.69 +<p> 32.70 +Tazlito est aussi utilsé par les développeurs SliTaz pour générer le LiveCD 32.71 +officiel. Les seuls prérequis sont d'avoir Tazlito d'installé, c'est le cas 32.72 +par défaut sur SliTaz, mais vous pouvez générer le LiveCD depuis une autre 32.73 +distribution à condition d'avoir les paquets voulus sous la main ou de le 32.74 +télécharger. 32.75 +</p> 32.76 +<h4>Installer Tazlito sur une autre distribution</h4> 32.77 +<p> 32.78 +Tazlito n'a aucune dépendance particulière pour générer le LiveCD, mais il 32.79 +dépend de Cdrkit pour graver l'image et de Tazpkg pour regénérer des paquets 32.80 +SliTaz depuis ceux qui sont installés. Pour récupérer Tazlito et l'installer 32.81 +en suivant les instructions du fichier README contenu dans <a 32.82 + href="http://download.tuxfamily.org/slitaz/sources/tazlito/" 32.83 + >les sources de Tazlito</a>. 32.84 +</p> 32.85 + 32.86 +<a name="2cmds"></a> 32.87 +<h3><font color="#6c0023">Un LiveCD en 2 commandes</font></h3> 32.88 +<ul> 32.89 + <li>Récupérer une saveur : <code>tazlito get-flavor core</code></li> 32.90 + <li>En option : Modifier la liste des paquets ou ajouter Fichiers 32.91 + additionnels.</li> 32.92 + <li>Générer la distribution : <code>tazlito gen-distro</code></li> 32.93 +</ul> 32.94 +<p> 32.95 +Une fois le travail fini, vous trouvez l'image ISO du LiveCD dans le répertoire 32.96 +<code>/home/slitaz/distro</code>. 32.97 +</p> 32.98 + 32.99 + 32.100 +<a name="get-flavor"></a> 32.101 +<h3><font color="#6c0023">Récupérer une saveur</font></h3> 32.102 +<p> 32.103 +Une saveur est un fichier <code>.flavor</code> contenant toutes les informations 32.104 +nécessaires à la création du LiveCD. La saveur fournit une liste des paquets 32.105 +(<code>distro-packages.list</code>), une description et des fichiers 32.106 +additionnels propres à la saveur choisie. La liste des saveurs peut être 32.107 +téléchargées et mise à jour avec Tazlito : 32.108 +</p> 32.109 +<pre> 32.110 + # tazlito list-flavors 32.111 + Ou : 32.112 + # tazlito list-flavors --recharge 32.113 +</pre> 32.114 +<p> 32.115 +La liste des saveurs va automatiquement s'afficher, donnant la taille du 32.116 +LiveCD et une brève description. Pour la suite, la commande 32.117 +<code>get-flavor</code> va télécharger le fichier de saveur <code>.flavor</code> 32.118 +extraire automatiquement la liste des paquets et la description dans le 32.119 +répertoire courant et mettre les fichiers additionnels dans le répertoire 32.120 +<code>/home/slitaz/distro/addfiles</code>. Pour stocker les saveurs nous vous 32.121 +proposons d'utiliser un répertoire spécifique tel que 32.122 +<code>/home/slitaz/flavors</code>, vous pouvez créer ce répertoire et vous y 32.123 +placer avec les commandes : 32.124 +</p> 32.125 +<pre> 32.126 + # mkdir -p /home/slitaz/flavors 32.127 + # cd /home/slitaz/flavors 32.128 +</pre> 32.129 +<p> 32.130 +Pour télécharger et/ou extraire les fichiers d'une saveur particulière : 32.131 +</p> 32.132 +<pre> 32.133 + # tazlito get-flavor saveur-particuliere 32.134 +</pre> 32.135 +<p> 32.136 +La description d'une saveur peut être affichée avec la commande 32.137 +<code>show-flavor</code> de Tazlito. Une fois la saveur choisie téléchargée 32.138 +et/ou extraite, vous pouvez générer la distribution. 32.139 +</p> 32.140 + 32.141 +<a name="gen-distro"></a> 32.142 +<h3><font color="#6c0023">Générer la distribution</font></h3> 32.143 +<p> 32.144 +Pour une première ISO nous vous conseillons de tester sans modifier la liste, 32.145 +ensuite vous pourrez supprimer ou ajouter des paquets à volonté. Mais attention, 32.146 +les paquets du système de base sont indispensables. La commande 32.147 +<code>gen-distro</code> génère une image ISO avec tous les paquets de la 32.148 +liste, il faut être root et être dans le même répertoire que liste et le 32.149 +fichier de configuration. Pour générer un LiveCD : 32.150 +</p> 32.151 +<pre> 32.152 + # tazlito gen-distro 32.153 +</pre> 32.154 +<p> 32.155 +Voilà, votre première image ISO du LiveCD est générée dans 32.156 +<code>/home/slitaz/distro</code>, sans compte pour l'utilisateur hacker. 32.157 +<p> 32.158 +<h4>L'utilisateur hacker</h4> 32.159 +</p> 32.160 +Si vous désirez avoir un compte utilisateur avec hacker, il faut l'ajouter 32.161 +et recréer le système de fichier racine compressé : 32.162 +</p> 32.163 +<pre> 32.164 + # tazlito addhacker 32.165 + # tazlito gen-initiso 32.166 +</pre> 32.167 +<h4>Nettoyer, regénérer et aller plus loins</h4> 32.168 +<p> 32.169 +Pour continuer et aller plus loin, 32.170 +vous pouvez simplement ajouter un ou deux paquets à la liste, nettoyer la distro 32.171 +et regénérer le système de fichier racine avec une nouvelle image ISO : 32.172 +</p> 32.173 +<pre> 32.174 + # tazlito clean-distro 32.175 + # tazlito gen-distro 32.176 +</pre> 32.177 +<p> 32.178 +Tazlito fournit encore plusieurs possibilités, telles que la gravure de l'ISO 32.179 +ou la copie de fichiers additionnels dans le système ou directement sur le cdrom. 32.180 +Pour connaître toutes les commandes disponibles, vous pouvez vous référer au 32.181 +<a href="http://www.slitaz.org/doc/manuals/tazlito.html">manuel de Tazlito</a> 32.182 +installé par défaut sur tous les systèmes SliTaz et accessible depuis le menu 32.183 +de JWM 32.184 +</p> 32.185 + 32.186 +<a name="gen-flavor"></a> 32.187 +<h3><font color="#6c0023">Créer une saveur</font></h3> 32.188 +<p> 32.189 +Tazlito permet de facilement créer une saveur particulière à partir des 32.190 +résultats de fabrication de la distribution (<code>gen-distro</code>). Le 32.191 +fichier de saveur produit contiendra tous les fichiers additionnels, la 32.192 +decription et la liste de paquets et réutilisé ultérieurement et mis à jour 32.193 +en fonction des versions des paquets. Pour générer une saveur en répondant à 32.194 +une ou deux questions : 32.195 +</p> 32.196 +<pre> 32.197 + # tazlito gen-flavor nouvelle-saveur 32.198 +</pre> 32.199 +<p> 32.200 +Une fois que votre saveur est fonctionnel et bien testées, vous avez la 32.201 +possibilité de l'envoyer sur slitaz.org afin qu'elle soit mise à disposition 32.202 +de tous, listée via <code>list-flavor</code> et utilisable via 32.203 +<code>get-flavor</code>. Pour envoyer une saveur vous avez plusieurs moyens, 32.204 +passer par la liste de discussion, mettre le fichier en ligne et le signaler 32.205 +sur le forum ou directement l'envoyer par mail à un contributeur du projet. 32.206 +</p> 32.207 + 32.208 + 32.209 +<a name="addfiles"></a> 32.210 +<h3><font color="#6c0023">Fichiers additionnels</font></h3> 32.211 +<p> 32.212 +Les fichiers de saveurs contiennent généralement des fichiers additionnels 32.213 +copiés directement dans le système de fichier racine ou dans la racine du 32.214 +cdrom. Le chemin vers les fichiers à utiliser est spécifié dans le fichier 32.215 +de configuration <code>tazlito.conf</code>, logiquement et par défaut, les 32.216 +fichiers sont situé dans <code>/home/slitaz/distro/addfiles</code>. Les 32.217 +fichiers additionnels de la saveur <code>core</code> fournissent par exemple 32.218 +le menu du gestionnaire de fenêtres <a href="jwm.html">JWM</a> et les fonds 32.219 +d'écrans. Il suffit de modifier, ajouter ou supprimer des fichiers dans le 32.220 +pseudo système racine (<code>rootfs</code>) ou la racine du CD 32.221 +(<code>rootcd</code>) et de regénérer la distribution pour retouver les 32.222 +fichiers dans l'ISO. Pour nettoyer et regénérer la distribution : 32.223 +</p> 32.224 +<pre> 32.225 + # tazlito clean-distro 32.226 + # tazlito gen-distro 32.227 +</pre> 32.228 + 32.229 +<a name="pkgs"></a> 32.230 +<h3><font color="#6c0023">Paquets utilisés</font></h3> 32.231 +<p> 32.232 +Pour créer votre distro il vous faut des paquets SliTaz. Tazlito et Tazpkg 32.233 +permettent de recréer les paquets depuis un système SliTaz en fonctionnement 32.234 +ou de télécharger les paquets directement en fonction de la saveur choisie. 32.235 +Par logique, sur SliTaz, les paquets se mettent dans le répertoire 32.236 +<code>/home/slitaz/packages</code>, mais vous pouvez chager cela via un 32.237 +fichier de configutation de Tazlito (tazlito.conf). 32.238 +</p> 32.239 +<p> 32.240 +Si vous voulez récupérer des paquets à la main, vous pouvez utiliser un 32.241 +logiciel FTP tel que gFTP (installé par défaut sur SliTaz) ou la ligne de 32.242 +commande et <code>wget</code> pour télécharger des paquets officiels. L'URL 32.243 +direct vers les versions des paquets : 32.244 +<a href="ftp://download.tuxfamily.org/slitaz/packages/" 32.245 + >ftp://download.tuxfamily.org/slitaz/packages/</a> 32.246 +</p> 32.247 +<p> 32.248 +Vous pouvez aussi utiliser vos propre paquets en les mettant dans le répertoire 32.249 +des paquets. Si vous cherchez de la documentation au sujet de la création de 32.250 +paquets SliTaz, vous pouvez vous référer au livre de cuisine ou 32.251 +<a href="http://www.slitaz.org/doc/cookbook/">Cookbook</a>. 32.252 +</p> 32.253 + 32.254 +<a name="configure"></a> 32.255 +<h3><font color="#6c0023">Fichier de configuration</font></h3> 32.256 +<p> 32.257 +Par défaut Tazlito utilise le fichier de configuration système 32.258 +<code>/etc/tazlito/tazlito.conf</code> ou un fichier <code>tazlito.conf</code> 32.259 +situé dans le répertoire courant. C'est à dire que vous pouvez utiliser le 32.260 +fichier par défaut ou avoir un fichier de configuration spécifique à chaque 32.261 +distro que vous créez. Ce fichier de configuration permet de changer le nom 32.262 +de l'image ISO, le nom du préparateur et les chemins vers les répertoires de 32.263 +travail. Pour créer et configurer directement un fichier de configuration, il 32.264 +suffit de lancer Tazlito avec la commande <code>configure</code> et cela depuis 32.265 +le répertoire de la distro (vous pouvez le créer ailleur). En supposant que 32.266 +avez l'arbre de la distro dans <code>/home/slitaz/distro</code> et que vous 32.267 +vous y êtes placé avec <code>cd</code> : 32.268 +</p> 32.269 +<pre> 32.270 + $ tazlito configure 32.271 +</pre> 32.272 +<p> 32.273 +Une fois que vous avez répondu aux questions, vous pouvez soit recréer l'image 32.274 +ISO, reconstruire le système racine et l'ISO ou générer une nouvelle distro 32.275 +avec la liste des paquets. 32.276 +</p> 32.277 + 32.278 +<!-- End of content --> 32.279 +</div> 32.280 + 32.281 +<!-- Footer. --> 32.282 +<div id="footer"> 32.283 + <div class="footer-right"></div> 32.284 + <a href="#top">Haut de la page</a> | 32.285 + <a href="index.html">Table des matières</a> 32.286 +</div> 32.287 + 32.288 +<div id="copy"> 32.289 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 32.290 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 32.291 + Documentation publiées sous 32.292 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 32.293 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 32.294 +</div> 32.295 + 32.296 +</body> 32.297 +</html>
33.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 33.2 +++ b/doc/handbook/graphics.html Sat Mar 29 12:01:05 2008 +0100 33.3 @@ -0,0 +1,138 @@ 33.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 33.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 33.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 33.7 +<head> 33.8 + <title>SliTaz Handbook - Graphisme</title> 33.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 33.10 + <meta name="description" content="Graphisme sur SliTaz mtPaint GQview GIMP" /> 33.11 + <meta name="expires" content="never" /> 33.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 33.13 + <meta name="publisher" content="www.slitaz.org" /> 33.14 + <meta name="author" content="Christophe Lincoln"/> 33.15 + <link rel="shortcut icon" href="favicon.ico" /> 33.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 33.17 +</head> 33.18 +<body bgcolor="#ffffff"> 33.19 + 33.20 +<!-- Header and quick navigation --> 33.21 +<div id="header"> 33.22 +<div align="right" id="quicknav"> 33.23 + <a name="top"></a> 33.24 + <a href="multimedia.html">Multimedia</a> | 33.25 + <a href="index.html">Table des matières</a> 33.26 +</div> 33.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 33.28 +</div> 33.29 + 33.30 +<!-- Content. --> 33.31 +<div id="content"> 33.32 +<div class="content-right"></div> 33.33 + 33.34 +<h2><font color="#DF8F06">Graphisme et gestion d'images</font></h2> 33.35 + 33.36 +<ul> 33.37 + <li><a href="#gcolor2">Gcolor2</a> - Selecteur et gestionnaire de colors.</li> 33.38 + <li><a href="#gqview">GQview</a> - Gestionnaire d'images.</li> 33.39 + <li><a href="#gimp">Gimp</a> - Manipulation et création d'images.</li> 33.40 + <li><a href="#jpeg">jpeg</a> - Outils JPEG en ligne de commande.</li> 33.41 + <li><a href="#bluefish">mtPaint</a> - Création et traitement d'images.</li> 33.42 +</ul> 33.43 + 33.44 +<a name="gcolor2"></a> 33.45 +<h3><font color="#6c0023">Gcolor2 - Selecteur et gestionnaire de colors</font></h3> 33.46 +<p> 33.47 +Gcolor2 est un petit outils permettant de séléctionner et conserver des 33.48 +palettes de couleures. C'est très utile lors de la créations de thèmes pour 33.49 +SliTaz par exemple. Vous trouverez l'application dans la catégorie 33.50 +<code>Graphics</code> ou vous pouvez la lancer via la commande : 33.51 +</p> 33.52 +<pre> 33.53 + $ gcolor2 & 33.54 +</pre> 33.55 + 33.56 +<a name="gimp"></a> 33.57 +<h3><font color="#6c0023">Gimp - Manipulation et création d'images</font></h3> 33.58 +<p> 33.59 +The GIMP (GNU Image Manipulation) est un logiciel de manipulation d'images de 33.60 +très haute qualité. Il permet de faire tous ce qu'on peut attendre d'une 33.61 +application de traitement d'images, gestion avançée des calques, filtres, 33.62 +chemin, outils divers, dégradés, ou encore le support des scripts ajoutant des 33.63 +fonctionnalités. Gimp support un très grand nombre de format d'images tel que 33.64 +PNG, JPEG, XPM, PPM, TIFF, PostScript, PSD, il propose aussi son propre format 33.65 +XCF pemettant de conserver par exemple les claques. Pour installer Gimp : 33.66 +</p> 33.67 +<pre> 33.68 + # tazpkg get-install gimp 33.69 +</pre> 33.70 +<p> 33.71 +Gimp est extensible et peut se configurer via l'interface principale, les 33.72 +fichiers de configurations, brosses ou scripts personnels vont dans le 33.73 +répertoire caché <code>~/.gimp-2.2</code>. 33.74 +</p> 33.75 + 33.76 +<a name="gqview"></a> 33.77 +<h3><font color="#6c0023">GQview - Gestionnaire d'images</font></h3> 33.78 +<p> 33.79 +GQview est rapide et léger, il permet une navigation très rapide entre les 33.80 +images, par sélection des dossiers se trouvant dans votre arborescence, et 33.81 +cela se fait en un seul clic de souris. Il intègre la possibilité de faire des 33.82 +diaporamas, des rotations d'images et d'afficher les données EXIF, d'ajouter 33.83 +des mots clés ou tags, de configurer les actions, de glisser-déposer. Il 33.84 +donne aussi la possibilité d'éditer les images dans un logiciel externe de 33.85 +son choix (mtPaint ou Gimp par exemple), l'interface est entièrement traduite 33.86 +en français, et est très simple d'utilisation. 33.87 +</p> 33.88 + 33.89 +<a name="jpeg"></a> 33.90 +<h3><font color="#6c0023">jpeg - Outils JPEG en ligne de commande</font></h3> 33.91 +<p> 33.92 +Pour que les applications utilisant les images JPEG fonctionnent, elles 33.93 +doivent êtres liée aux bibliothèques fournies par le paquet jpeg-6b, ce paquet 33.94 +propose aussi quelques petits utilitaires à utiliser en ligne de commande. 33.95 +Pour modifier des images JPEG en ligne de commande, vous pouvez utiliser 33.96 +<code>jpegtran</code>, installé par défaut sur SliTaz. L'utilitaire 33.97 +<code>jpegtran</code> permet par exemple de faire une rotation de 33.98 +l'image via l'option <code>-rotate</code>. Le paquet jpeg-6b fournit aussi les 33.99 +outils <code>cjpeg</code> et <code>djpeg</code>. Pour connaître les options 33.100 +disponibles avec tous ces outils, vous pouvez utiliser l'option 33.101 +<code>--help</code> propre à chaque application. Exemple avec 33.102 +<code>cjpeg</code> : 33.103 +</p> 33.104 +<pre> 33.105 + $ cjpeg --help 33.106 +</pre> 33.107 + 33.108 +<a name="mtPaint"></a> 33.109 +<h3><font color="#6c0023">mtPaint - Création et traitement d'images</font></h3> 33.110 +<p> 33.111 +mtPaint est une application de création et de retouche d'images, PNG, TIFF, 33.112 +XPM, BMP. Il est presque entièrement traduit en français, offre beaucoup de 33.113 +fonctions, simple, léger, et rapide. L'outil mtPaint fournit une fonction de 33.114 +capture d'écran (screenshot), que vous pouvez utiliser via le menu 33.115 +--> Graphics --> Grab screenshot, ou en tapant la commande ci-dessous 33.116 +dans un terminal: 33.117 +</p> 33.118 +<pre> 33.119 + $ mtpaint -s 33.120 +</pre> 33.121 + 33.122 +<!-- End of content --> 33.123 +</div> 33.124 + 33.125 +<!-- Footer. --> 33.126 +<div id="footer"> 33.127 + <div class="footer-right"></div> 33.128 + <a href="#top">Haut de la page</a> | 33.129 + <a href="index.html">Table des matières</a> 33.130 +</div> 33.131 + 33.132 +<div id="copy"> 33.133 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 33.134 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 33.135 + Documentation publiées sous 33.136 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 33.137 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 33.138 +</div> 33.139 + 33.140 +</body> 33.141 +</html>
34.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 34.2 +++ b/doc/handbook/hacking-livecd.html Sat Mar 29 12:01:05 2008 +0100 34.3 @@ -0,0 +1,444 @@ 34.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 34.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 34.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 34.7 +<head> 34.8 + <title>SliTaz Handbook - Hacking LiveCD</title> 34.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 34.10 + <meta name="description" content="modifier generer le livecd manuellement ligne de commande" /> 34.11 + <meta name="expires" content="never" /> 34.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 34.13 + <meta name="publisher" content="www.slitaz.org" /> 34.14 + <meta name="author" content="Christophe Lincoln"/> 34.15 + <link rel="shortcut icon" href="favicon.ico" /> 34.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 34.17 +</head> 34.18 +<body bgcolor="#ffffff"> 34.19 + 34.20 +<!-- Header and quick navigation --> 34.21 +<div id="header"> 34.22 +<div align="right" id="quicknav"> 34.23 + <a name="top"></a> 34.24 + <a href="gen-livecd.html">Générer un LiveCD</a> | 34.25 + <a href="index.html">Table des matières</a> 34.26 +</div> 34.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 34.28 +</div> 34.29 + 34.30 +<!-- Content. --> 34.31 +<div id="content"> 34.32 +<div class="content-right"></div> 34.33 + 34.34 +<h2><font color="#DF8F06">Hacking SliTaz LiveCD</font></h2> 34.35 + 34.36 +<ul> 34.37 + <li><a href="#intro">Introduction.</a></li> 34.38 + <li><a href="#pre">Organisation et préparation.</a></li> 34.39 + <li><a href="#add-files">Ajouter des fichiers dans l'ISO.</a></li> 34.40 + <li><a href="#isolinux">Modifier la configuration d'isolinux.</a></li> 34.41 + <li><a href="#memtest">Installer et utiliser Memtest86.</a></li> 34.42 + <li><a href="#rootfs">Manipuler la racine du système Live.</a></li> 34.43 + <li><a href="#gen-iso">Générer une image ISO bootable avec isolinux.</a></li> 34.44 +</ul> 34.45 + 34.46 +<a name="intro"></a> 34.47 +<h3><font color="#6c0023">Introduction</font></h3> 34.48 +<p> 34.49 +<em>Hacking SliTaz LiveCD</em> ou comment s'amuser avec l'image ISO du LiveCD, 34.50 +la modifier, la personnaliser et la reconstruire à la main. A noter que vous 34.51 +avez aussi la possibilité de 34.52 +<a href="gen-livecd.html">créer une saveur avec Tazlito</a> et cela de. Créer 34.53 +sa propre image ISO bootable ne demande que peut de temps, les étapes à suivre 34.54 +sont soigneusement décrites dans ce document et sont faciles à réaliser. La 34.55 +manipulation de l'images ISO permet d'ajouter des nouveaux fichiers ou de 34.56 +modifier les fichiers existants sur le cdrom. L'image ISO de SliTaz fait moins 34.57 +de 30 Mb et un CD-R ou CD-RW classique fournit 700 Mb, il reste donc pas mal 34.58 +de place, pour mettre par exemple, vos photos afin de les montrer en 34.59 +<em>live</em> via SliTaz et un diaporama propulsé par le gestionnaire 34.60 +d'images GQview. Le <em>hacking</em> de l'image ISO permet de modifier les 34.61 +fichiers de configuration du chargeur de démarrage (<em>boot loader</em>) et 34.62 +son image <em>splash</em> ou d'en utiliser un autre tel que GRUB. Vous pouvez 34.63 +aussi facilement et directement ajouter des utilitaire tel que Memtest86 (outil 34.64 +servant à tester la RAM d'une machine). En utilisant les mêmes techniques, il 34.65 +est également possible de modifier le contenu du système en soit, cela demande 34.66 +quelques manipulations supplémentaires et un peu plus de temps... libre. 34.67 +</p> 34.68 +<a name="pre"></a> 34.69 +<h3><font color="#6c0023">Organisation et préparation</font></h3> 34.70 +<p> 34.71 +Pour commencer il faut définir l'endroit ou l'on va travailler, créer un 34.72 +répertoire de travail et plusieurs sous-répertoires destinés à accueillir les 34.73 +différents fichiers. Le <em>hacking</em> de l'ISO peut se faire depuis un 34.74 +système SliTaz ou tous autres système GNU/Linux tels que Debian, Fedora, 34.75 +PCLinuxOS, Slackware, etc. Si vous utilisez SliTaz en mode LiveCD (vous pouvez 34.76 +retirer le cdrom une fois SliTaz lancée en RAM et graver votre nouvelle ISO), 34.77 +nous vous conseillons d'utiliser un media USB pour conserver le travail, sinon 34.78 +il sera perdu à l'arrêt du système. Pour travailler nous vous proposons 34.79 +d'utiliser un répertoire <code>hacked/</code> que vous pouvez créer dans 34.80 +un répertoire <code>/home/slitaz</code>, à la racine de votre espace 34.81 +utilisateur, ou ailleurs si vous le désirez. Utiliser un répertoire 34.82 +<code>/home/slitaz</code> vous permet de stocker une image ISO originale et 34.83 +de créer en options un répertoire <code>src/</code> pour télécharger 34.84 +d'éventuelles paquets sources. Toutes les étapes de <em>hacking</em> peuvent 34.85 +se faire en lignes de commandes via un termial X tel que XTerm ou en mode 34.86 +texte et un terminal Linux. A noter que nous vous conseillons de faire les 34.87 +opérations en tant que <em>root</em> afin d'éviter tous problèmes de 34.88 +permissions. Pour devenir administrateur (<em>root</em>), créer le 34.89 +répertoire de travail dans <code>/home/slitaz/hacked</code> et se placer 34.90 +dedans : 34.91 +</p> 34.92 +<pre> 34.93 + $ su 34.94 + # mkdir -p /home/slitaz/hacked 34.95 + (# mkdir -p /home/slitaz/src) 34.96 + # cd /home/slitaz/hacked 34.97 +</pre> 34.98 +<h4>Récupérer les fichiers contenus sur l'ISO</h4> 34.99 +<p> 34.100 +Maintenant que vous êtes dans le répertoire de travail, il faut créer la 34.101 +racine de votre cdrom modifié et récupérer les fichiers contenu dans l'ISO 34.102 +original du LiveCD. C'est à dire le noyau Linux (<code>bzImage</code>), le 34.103 +système de fichiers compressé (<code>rootfs.gz</code>) et les fichiers du 34.104 +chargeur de démarrage Isolinux. Pour récupérer ces fichiers vous avez deux 34.105 +solutions, soit les prendre depuis un cdrom gravé, soit directement depuis 34.106 +une image ISO local. Pour créer la racine de votre CD (<code>rootcd</code>) 34.107 +et copier les fichiers depuis un périphérique cdrom reconnu comme 34.108 +<code>/dev/cdrom</code> et monté sur <code>/media/cdrom</code> : 34.109 +</p> 34.110 +<pre> 34.111 + # mount -t iso9660 /dev/cdrom /media/cdrom 34.112 + # mkdir rootcd 34.113 + # cp -a /media/cdrom/* rootcd 34.114 +</pre> 34.115 +<p> 34.116 +Pour monter une image ISO en <em>loop</em> sur le répertoire temporaire 34.117 +nommé <code>/tmp/loop</code> (avec l'image ISO <code>slitaz-cooking.iso</code> 34.118 +préalablement téléchargée ou copiée), créer la racine du CD, copier les 34.119 +fichiers et démonter l'image ISO : 34.120 +</p> 34.121 +<pre> 34.122 + # mkdir /tmp/loop 34.123 + # mount -o loop slitaz-cooking.iso /tmp/loop 34.124 + # mkdir rootcd 34.125 + # cp -a /tmp/loop/* rootcd 34.126 + # umount /tmp/loop 34.127 +</pre> 34.128 +<p> 34.129 +Voilà, tous les fichiers nécessaires devraient être présents dans le répertoire 34.130 +<code>rootcd/</code>, pour vous en assurer, vous pouvez pouver lister 34.131 +récursivement les fichiers via la commande <code>ls</code> : 34.132 +</p> 34.133 +<pre> 34.134 + # ls -R rootcd 34.135 +</pre> 34.136 +<a name="add-files"></a> 34.137 +<h3><font color="#6c0023">Ajouter des fichiers dans l'ISO</font></h3> 34.138 +<p> 34.139 +L'ajout de divers fichiers et répertoires dans l'image ISO consiste 34.140 +simplement à copier des données à la racine du cdrom (<code>rootcd/</code>) 34.141 +et à générer une nouvelle image. Les données ajoutées peuvent être classées 34.142 +dans un ou des répertoires préalablement créés à la racine du CD. Une fois 34.143 +l'image ISO gravée sur un CD-R/CD-RW vous pourrez utiliser SliTaz comme 34.144 +avant, monter le cdrom sur <code>/media/cdrom</code> et naviguer dans vos 34.145 +données graphiquement avec emelFM2, dans un terminal avec Clex ou en ligne de 34.146 +commandes. Vos données seront aussi lisibles depuis tous les systèmes GNU/Linux, 34.147 +BSD, et même... Windows. 34.148 +</p> 34.149 +<h4>Créer un ou des répertoires et copier des données</h4> 34.150 +<p> 34.151 +Pour créer et copier des fichiers vous pouvez commencer par utiliser la 34.152 +ligne de commande et continuer graphiquement en tant que simple utilisateur. 34.153 +Nous allons créer un répertoires <code>images/</code> en tant que <em>root</em> 34.154 +et changer les permissions pour que tous les utilisateurs puissent écrire 34.155 +dedans : 34.156 +</p> 34.157 +<pre> 34.158 + # mkdir rootcd/images 34.159 + # chmod 777 rootcd/images 34.160 +</pre> 34.161 +<p> 34.162 +Maintenant qu'un nouveau répertoire existe en écriture pour tous, il faut le 34.163 +remplir. Une fois que vous avez fini de copier vos données, il suffit de 34.164 +<a href="#gen-iso">générer une nouvelle image ISO bootable</a>. 34.165 +</p> 34.166 +<a name="isolinux"></a> 34.167 +<h3><font color="#6c0023">Modifier la configuration d'isolinux</font></h3> 34.168 +<p> 34.169 +Modifier la configuration d'isolinux vous permet de créer des entrées 34.170 +personnalisées avec des options de <em>boot</em> prédéfinies, vous pouvez par 34.171 +exemple ajouter un <code>label</code> lançant SliTaz avec les options 34.172 +<code>lang=fr</code> et <code>kmap=fr_CH</code>. Au niveau graphisme, vous 34.173 +pouvez facilement changer l'image <em>splash</em> s'affichant au démarrage. 34.174 +L'application <code>isolinux</code> est le chargeur de démarrage 34.175 +(<em>boot loader</em>) du LiveCD, il est fournit par le paquet Syslinux. 34.176 +L'archive source de Syslinux fournit diverses applications dont le rôle est 34.177 +de démarrer un système GNU/Linux. La version binaire <code>isolinux.bin</code> 34.178 +est déstinée aux image ISO, ce chargeur de démarrage est simple, rapide et 34.179 +facilement configurable via un fichier de configuration principale, éditable 34.180 +graphiquement ou dans un terminal avec votre éditeur de texte préféré. 34.181 +La syntaxe du fichier de configuration <code>isolinux.cfg</code> est facile 34.182 +à comprendre, pour ajouter de nouvelles entrées il suffit de copier/coller 34.183 +en utilisant le fichier original. Pour éditer graphiquement le fichier 34.184 +<code>isolinux.cfg</code> avec Leafpad : 34.185 +</p> 34.186 +<pre> 34.187 + # leafpad rootcd/boot/isolinux/isolinux.cfg & 34.188 +</pre> 34.189 +<h4>Fichier de configuration isolinux.cfg</h4> 34.190 +<p> 34.191 +Le fichier <code>isolinux.cfg</code>, fourni en standard sur le LiveCD de 34.192 +SliTaz, commence par la valeur <code>display</code>, cette valeur permet 34.193 +d'afficher tel quel un fichier texte ou d'afficher un fichier 34.194 +(<code>isolinux.msg</code>) utilisant des caractères ASCII 24 et permettant 34.195 +d'afficher du texte avec une image <em>splash</em>. La valeur 34.196 +<code>default</code> défini le nom du <code>label</code> à démarrer par 34.197 +défaut après le temps d'attente (<code>timeout</code>). <em>Timeout</em> 34.198 +correspond au nombre de secondes à attendre avant de booter, vous pouvez le 34.199 +mettre à 0, hôter la ligne pour démarrer instantanément ou choisir un temps 34.200 +d'attente plus long tel que 80 s. Pour finir, le <code>prompt</code> peut 34.201 +être désactivé via la valeur <code>0</code>, les valeurs F1, F2, F3 34.202 +affichent des fichiers d'aides et F4 est un display au format texte : 34.203 +</p> 34.204 +<pre class="script"> 34.205 +display isolinux.msg 34.206 +default slitaz 34.207 +label slitaz 34.208 + kernel /boot/bzImage 34.209 + append initrd=/boot/rootfs.gz rw root=/dev/null vga=788 34.210 +implicit 0 34.211 +prompt 1 34.212 +timeout 80 34.213 +F1 help.txt 34.214 +F2 options.txt 34.215 +F3 isolinux.msg 34.216 +F4 display.txt 34.217 +</pre> 34.218 +<p> 34.219 +Exemple d'un label <code>slitazfr</code> que vous pouvez ajouter à l'orginal, 34.220 +pour configurer directement la langue du système en français et avoir le 34.221 +clavier Belge : 34.222 +</p> 34.223 +<pre class="script"> 34.224 +label slitazfr 34.225 + kernel /boot/bzImage 34.226 + append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=be 34.227 +</pre> 34.228 +<p> 34.229 +Une fois que vous avez fini de modifier le fichier de configuration, il ne 34.230 +faut pas oublier d'enregistrer vos changements avant de 34.231 +<a href="#gen-iso">générer une nouvelle image ISO bootable</a> avec isolinux. 34.232 +</p> 34.233 +<a name="memtest"></a> 34.234 +<h3><font color="#6c0023">Installer et utiliser Memtest86</font></h3> 34.235 +<p> 34.236 +L'application memtest86 (92 ko) est un outil autonome de test de mémoire vive 34.237 +(RAM). Memetes86 permet de tester en profondeur l'état des barrettes de RAM et 34.238 +de déceler une quelconque défaillance. L'outil s'installe dans le répertoire 34.239 +<code>boot/</code> de la racine du cdrom et se lance directement au démarrage 34.240 +de la machine en tapant simplement <code>memtest</code> au prompt d'isolinux. 34.241 +Direction <code>/home/slitaz/src</code> (si le répertoire n'existe pas : 34.242 +<code>mkdir -p /home/slitaz/src</code>) pour télécharger les sources et les 34.243 +désarchiver : 34.244 +</p> 34.245 +<pre> 34.246 + # cd /home/slitaz/src 34.247 + # wget http://www.memtest86.com/memtest86-3.3.tar.gz 34.248 + # tar xzf memtest86-3.3.tar.gz 34.249 +</pre> 34.250 +<p> 34.251 +Le paquet source de Memtest86 étant désarchivé (vous y trouverez un fichier 34.252 +<code>README</code> en anglais donnant des informations sur l'outil), vous 34.253 +allez pouvoir l'installer dans le <em>root CD</em> de votre ISO hackée. En 34.254 +partant du principe que vous utilisez un répertoire de travail 34.255 +<code>/home/slitaz/hacked</code>, nous allons copier le binaire précompilé 34.256 +dans le répertoire <code>boot/</code> de la racine du CD : 34.257 +</p> 34.258 +<pre> 34.259 + # cp memtest86-3.3/precomp.bin \ 34.260 + /home/slitaz/hacked/rootcd/boot/memtest 34.261 +</pre> 34.262 +<p> 34.263 +Maintenant que le binaire est installé dans le <em>root CD</em>, il suffit 34.264 +d'ajouter une entrée pour Memtest86 dans le fichier de configuration d'isolinux 34.265 +et de <a href="#gen-iso">générer une nouvelle image ISO bootable</a>. 34.266 +Direction <code>/home/slitaz/hacked</code> pour éditer le fichier 34.267 +<code>isolinux.cfg</code> avec LeafPad par exemple : 34.268 +</p> 34.269 +<pre> 34.270 + # cd /home/slitaz/hacked 34.271 + # leafpad rootcd/boot/isolinux/isolinux.cfg & 34.272 +</pre> 34.273 +<pre class="script"> 34.274 +label memtest 34.275 + kernel /boot/memtest 34.276 +</pre> 34.277 +<p> 34.278 +Site web officiel de Memtest86 : 34.279 +<a href="http://www.memtest86.com/">http://www.memtest86.com/</a> 34.280 +</p> 34.281 +<a name="rootfs"></a> 34.282 +<h3><font color="#6c0023">Manipuler la racine du système Live</font></h3> 34.283 +<p> 34.284 +La modification du système Live vous permet par exemple d'ajouter rapidement 34.285 +un nouvel utilisateur avec mot de passe, de personnaliser le graphisme ou 34.286 +d'ajouter des commandes exécutées automatiquement au démarrage du LiveCD. Les 34.287 +opérations nécessaires à la modification du système de fichier racine ( 34.288 +<em>root file system</em>) sont : extraire le système du fichier compresé 34.289 +<code>rootfs.gz</code>, modfier, reconstruire l'image du système compressé 34.290 +et générer une nouvelle ISO. En partant du principe que vous avez déjà 34.291 +<a href="#pre">préparé votre répertoire de travail</a>, il faut commencer 34.292 +par créer un répertoire destiné à contenir les fichiers du système modifiable. 34.293 +Le système racine compressé étant nommé <code>rootfs.gz</code>, nous vous 34.294 +proposons d'utiliser un répertoire <code>rootfs/</code> pour l'extraire. 34.295 +Direction le répertoire de travail <code>hacked/</code>, création du 34.296 +répertoire racine et copie du système compressé depuis le répertoire 34.297 +<code>rootcd/boot/</code> (la racine du cdrom) : 34.298 +</p> 34.299 +<pre> 34.300 + # cd /home/slitaz/hacked 34.301 + # mkdir rootfs 34.302 + # cp rootcd/boot/rootfs.gz rootfs 34.303 +</pre> 34.304 +<p> 34.305 +Maintenant que vous avez une copie du système compressé, il suffit de le 34.306 +décompresser et de le désarchiver avec <code>cpio</code>. Techniquement : Le 34.307 +fichier <code>rootfs.gz</code> est une archive Cpio compressé avec LZMA ou 34.308 +Gzip, elle est reconnue comme une image <code>initramfs</code> par le noyau 34.309 +Linux. Lors du démarrage de la machine, le noyau se charge en mémoire et 34.310 +décompresse l'image du système en mémoire vive pour finir par exécuter les 34.311 +scripts d'initialisation. Pour extraire le système dans le répertoire 34.312 +<code>rootfs/</code> et supprimer la copie désarchivée (Rappel : vous pouvez 34.313 +copier/coller les commandes) : 34.314 +</p> 34.315 +<pre> 34.316 + # cd rootfs 34.317 + # (zcat rootfs.gz 2>/dev/null || lzma d rootfs.gz -so) | cpio -id 34.318 + # rm rootfs rootfs.gz 34.319 +</pre> 34.320 +<p> 34.321 +Le système est prêt à être modifié, vous pouvez lister les fichiers contenus 34.322 +à la racine de votre système hackable en utilisant la commande <code>ls</code>. 34.323 +</p> 34.324 +<h4>Modifier un fichier</h4> 34.325 +<p> 34.326 +Pour faire simple et vous aider comprendre le principe, nous allons modifier 34.327 +un fichier script dans le but d'ajouter deux commandes exécutées 34.328 +automatiquement à chaque démarrage du LiveCD. La cible est : 34.329 +<code>etc/init.d/local.sh</code>, il suffit de l'ouvrir avec votre éditeur de 34.330 +texte préféré tel que Geany : 34.331 +</p> 34.332 +<pre> 34.333 + # geany etc/init.d/local.sh & 34.334 +</pre> 34.335 +<p> 34.336 +Nous allons ajouter une commande affichant un message et faisant dormir le 34.337 +système 4 secondes (c'est juste pour se faire la main). Example de lignes à 34.338 +ajouter au script déstiné aux commandes locales : 34.339 +</p> 34.340 +<pre class="script"> 34.341 +echo "* Hacked SliTaz version booting..." 34.342 +sleep 4 34.343 +</pre> 34.344 +<h4>Reconstruire l'image du système compressée</h4> 34.345 +<p> 34.346 +Une fois les modifications terminées, vous pouvez reconstruire une image 34.347 +compressée de votre système modifié en utilisant <code>find</code> pour 34.348 +trouver les fichiers, <code>cpio</code> pour archiver, <code>lzma</code> ou 34.349 +<code>gzip </code> pour compresser et des pipes <code>|</code> pour connecter 34.350 +le tout. Cette commande doit être lancée depuis le répertoire racine du 34.351 +système (<code>rootfs/</code>) et crée un fichier compressé 34.352 +<code>rootfs.gz</code> dans le répertoire précédant : 34.353 +</p> 34.354 +<pre> 34.355 + # find . -print | cpio -o -H newc | lzma e -si -so > ../rootfs.gz 34.356 + Ou avec gzip : 34.357 + # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz 34.358 +</pre> 34.359 +<p> 34.360 +Pour finir il suffit de copier votre système compressé dans le répertoire 34.361 +<code>boot/</code> de la racine du CD et de <a href="#gen-iso" 34.362 +>générer une nouvelle image ISO bootable</a> avec isolinux. Pour copier le 34.363 +<em>rootfs</em> en écrasant l'actuel, direction le répertoire de travail : 34.364 +</p> 34.365 +<pre> 34.366 + # cd ../ 34.367 + # cp -a rootfs.gz rootcd/boot 34.368 +</pre> 34.369 +<a name="gen-iso"></a> 34.370 +<h3><font color="#6c0023">Générer une image ISO bootable avec isolinux</font></h3> 34.371 +<p> 34.372 +La suite de commandes permettant de créer une image avec le 34.373 +<em>boot loader</em> <code>isolinux</code>, utilise l'application 34.374 +<code>genisoimage</code> suivie de nombreuses options. Le nom de l'ISO est 34.375 +spécifié au début, après l'option <code>-o</code> et le répertoire racine 34.376 +(<code>rootcd/</code>) tout à la fin, après l'option 34.377 +<code>-boot-info-table</code> : 34.378 +</p> 34.379 +<pre> 34.380 + # genisoimage -R -o slitaz-hacked.iso -b boot/isolinux/isolinux.bin \ 34.381 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 34.382 + -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table rootcd 34.383 +</pre> 34.384 +<p> 34.385 +Si vous désirez vérifier le contenu de l'ISO avant gravage, il suffit 34.386 +de monter l'image en <code>loop</code> et de lister les fichiers. Sur SliTaz 34.387 +et la plupart des systèmes GNU/Linux, vous pouvez graver des images au 34.388 +format ISO avec l'utilitaire <code>wodim</code> fournit par <a 34.389 +href="utilities.html#cdrkit">cdrkit</a>. 34.390 +</p> 34.391 +<h4>Générer de nouvelles ISO via un script</h4> 34.392 +<p> 34.393 +Si vous testez plusieurs possibilités et que vous êtes amené à souvent générer 34.394 +des nouvelles images ISO, vous aurez peut être envie de semi-automatiser les 34.395 +opérations via un simple petit script SHell. Ce petit script peut être créé 34.396 +en ligne de commandes ou édité graphiquement, mais il ne faut oublier de le 34.397 +rendre exécutable. Vous pouvez créer le script avec la commande 34.398 +<code>cat</code>, à noter que <code>EOF</code> signifie <em>End Of File</em>, 34.399 +c'est la que le fichier se termine. Nous vous proposons de nommer le script 34.400 +<code>gen_hacked_iso.sh</code> et d'utiliser deux variables permettant de 34.401 +rapidement changer le nom de l'image ISO et le chemin vers le répertoire 34.402 +racine du cdrom : 34.403 +</p> 34.404 +<pre> 34.405 + # cat > gen_hacked_iso.sh << "EOF" 34.406 +</pre> 34.407 +<pre class="script"> 34.408 +#!/bin/sh 34.409 +# Gen a new hacked ISO image. 34.410 +# 34.411 +ISO_NAME="slitaz-hacked.iso" 34.412 +ROOTCD="rootcd" 34.413 + 34.414 +genisoimage -R -o $ISO_NAME -b boot/isolinux/isolinux.bin \ 34.415 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 34.416 + -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table $ROOTCD 34.417 + 34.418 +EOF 34.419 +</pre> 34.420 +<p> 34.421 +Pour utiliser le script, il suffit de le rendre exécutable et de l'exécuter : 34.422 +</p> 34.423 +<pre> 34.424 + # chmod +x gen_hacked_iso.sh 34.425 + # ./gen_hacked_iso.sh 34.426 +</pre> 34.427 + 34.428 +<!-- End of content --> 34.429 +</div> 34.430 + 34.431 +<!-- Footer. --> 34.432 +<div id="footer"> 34.433 + <div class="footer-right"></div> 34.434 + <a href="#top">Haut de la page</a> | 34.435 + <a href="index.html">Table des matières</a> 34.436 +</div> 34.437 + 34.438 +<div id="copy"> 34.439 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 34.440 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 34.441 + Documentation publiées sous 34.442 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 34.443 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 34.444 +</div> 34.445 + 34.446 +</body> 34.447 +</html>
35.1 Binary file doc/handbook/images/css/content-tl.png has changed
36.1 Binary file doc/handbook/images/css/content-tr.png has changed
37.1 Binary file doc/handbook/images/css/footer-bl.png has changed
38.1 Binary file doc/handbook/images/css/footer-br.png has changed
39.1 Binary file doc/handbook/images/css/header.png has changed
40.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 40.2 +++ b/doc/handbook/index.html Sat Mar 29 12:01:05 2008 +0100 40.3 @@ -0,0 +1,176 @@ 40.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 40.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 40.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 40.7 +<head> 40.8 + <title>SliTaz Handbook</title> 40.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 40.10 + <meta name="description" content="" /> 40.11 + <meta name="expires" content="never" /> 40.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 40.13 + <meta name="publisher" content="www.slitaz.org" /> 40.14 + <meta name="author" content="Christophe Lincoln"/> 40.15 + <link rel="shortcut icon" href="favicon.ico" /> 40.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 40.17 +</head> 40.18 +<body bgcolor="#ffffff"> 40.19 + 40.20 +<!-- Header and quick navigation --> 40.21 +<div id="header"> 40.22 +<div align="right" id="quicknav"> 40.23 + <a name="top"></a> 40.24 + <a href="http://www.slitaz.org/doc/">www.slitaz.org/doc/</a> | 40.25 + <a href="http://www.slitaz.org/en/doc/handbook/">English Handbook</a> 40.26 +</div> 40.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 40.28 +</div> 40.29 + 40.30 +<!-- Content. --> 40.31 +<div id="content"> 40.32 +<div class="content-right"></div> 40.33 + 40.34 +<h2><font color="#DF8F06">Livre de main de SliTaz</font></h2> 40.35 + 40.36 +<h3><font color="#6c0023">Table des matières</font></h3> 40.37 +<ul> 40.38 + <li><a href="livecd.html">Utiliser le LiveCD</a> - Comment démarrer ? 40.39 + Conserver ses données en utilisant un media externe (clé USB). Login, 40.40 + des mots de passes et session graphique (X).</li> 40.41 + <li><a href="install.html">Instructions d'installation</a> - Déscription 40.42 + des étapes à réaliser manuellement pour installer Slitaz sur un disque 40.43 + dur.</li> 40.44 + <li><a href="cmdline.html">Références en ligne de commandes</a> - Utiliser 40.45 + SliTaz en ligne commandes via un terminal Linux ou graphique.</li> 40.46 + <li><a href="jwm.html">JWM</a> - Présentation, utilisation et 40.47 + configuration du gestionnaire de fenêtres <em>Joe Window Manager</em>. 40.48 + Ce document fournit les instructions pour créer un thème ou/et modifier 40.49 + le menu en fonction de ses goûts, envies et besoins.</li> 40.50 + <li><a href="enlightenment.html">Enlightenment (e17)</a> - Environnement 40.51 + de bureau complet, léger, rapide, facilement configurable et simplement 40.52 + beau.</li> 40.53 +</ul> 40.54 +<h4>Applications</h4> 40.55 +<ul> 40.56 + <li><a href="utilities.html">Utilitaires</a> - Navigateurs de fichiers, 40.57 + base de données SQL, calculatrice, gravure de CD/DVD et créations ISO.</li> 40.58 + <li><a href="office.html">Bureautique</a> - Traitement de texte, Organiseur 40.59 + personnel, lecteur PDF, Wiki, etc.</li> 40.60 + <li><a href="network.html">Internet</a> - Navigateurs web, 40.61 + client de chat IRC, client mail, client BitTorrent et FTP.</li> 40.62 + <li><a href="graphics.html">Graphisme</a> - Infographie, et gestion 40.63 + d'images.</li> 40.64 + <li><a href="multimedia.html">Multimedia</a> - Son, musique et video</li> 40.65 + <li><a href="development.html">Développement</a> - Créer des interfaces 40.66 + graphiques avec Dialog, IDE ou Environnement de Développement Intégré, 40.67 + scripts SHell et Perl. 40.68 + Installer la <em>toolchain</em> et compiler des sources.</li> 40.69 + <li><a href="secure-shell.html">SHell sécurisé (SSH)</a> - Contrôle et 40.70 + admin à distance avec Dropbear, client/serveur SSH et fournissant aussi 40.71 + l'utilitaire de copie scp.</li> 40.72 + <li><a href="system-tools.html">Outils système</a> - Visionneur de 40.73 + processus système, mountage et gestion d'un disque dur.</li> 40.74 + <li>Jeux - Clone du jeu Space in Vaders : nInvaders. Et un petit tetris : 40.75 + Bastet.</li> 40.76 +</ul> 40.77 +<h4>Système</h4> 40.78 +<ul> 40.79 + <li><a href="x-window.html">Système de fenêtres X</a> - Utilisation du 40.80 + serveur Xvesa ou Xorg, polices (<em>fonts</em>) et configuration d'une 40.81 + session graphique.</li> 40.82 + <li><a href="system-admin.html">Administration du système</a> - Configurer 40.83 + la langue, le clavier, régler l'horloge et le fuseau horaire. Utiliser 40.84 + Crond et Crontab, gestion des utilisateurs et groupes.</li> 40.85 + <li><a href="network-config.html">Configuration du réseau</a> - Connexion au web, 40.86 + réseau local, et pare-feu (firewall).</li> 40.87 + <li><a href="web-server.html">Serveur web</a> - Utiliser et configurer le 40.88 + serveur web LightTPD.</li> 40.89 + <li><a href="packages.html">Gestion des paquets</a> - Liste des paquets 40.90 + logiciels, installation, désinstallation, et infos sur les paquets de 40.91 + SliTaz.</li> 40.92 + <li><a href="security.html">Sécurité du système</a> - SliTaz et la sécurité 40.93 + du système en général.</li> 40.94 + <li><a href="chroot-env.html">Environnement chrooté</a> - Construire un 40.95 + <em>chroot</em> pour protéger le système hôte, tester, compiler et/ou 40.96 + développer SliTaz.</li> 40.97 + <li><a href="hacking-livecd.html">Hacking LiveCD</a> - Manipuler et 40.98 + s'amuser avec l'image ISO du LiveCD de SliTaz.</li> 40.99 + <li><a href="gen-livecd.html">Générer un LiveCD à saveur</a> - Créer 40.100 + votre propre saveur du LiveCD en utilisant les paquets et Tazlito.</li> 40.101 + <li><a href="liveusb.html">LiveUSB</a> - Installer et démarrer SliTaz 40.102 + depuis un media USB.</li> 40.103 +</ul> 40.104 + 40.105 +<a name="about"></a> 40.106 +<h3><font color="#6c0023">À propos de ce Handbook</font></h3> 40.107 +<p> 40.108 +Le Handbook de SliTaz est le livre de référence au sujet de l'utilisation du 40.109 +système au niveau utilisateur, administrateur et développeur en général. Ce 40.110 +Handbook réunit des travaux de référence, des mini manuels et une collection 40.111 +d'instructions destinées à fournir un livre complet, de haute qualité, 40.112 +facilement consultable et fournissant des réponses rapides sur un sujet 40.113 +spécifique. Le Handbook est écrit au format xHTML 1.0 avec l'IDE Geany et 40.114 +l'éditeur de texte GNU Nano. 40.115 +</p> 40.116 +<p> 40.117 +Vous pouvez vous référer à la table des matières de cette page pour un 40.118 +accès aux divers documents à thèmes. Pour commencer en mode LiveCD, nous vous 40.119 +conseillons de jeter un coup d'oeil au chapître : 40.120 +<a href="livecd.html">Utiliser le LiveCD</a>. Vous pouvez lire le Handbook 40.121 +de manière linéaire en utilisant le liens de navigation rapide situés dans le 40.122 +coin droite en haut de chaque pages ou naviguer dans les pages en fonction de 40.123 +vos besoins. 40.124 +</p> 40.125 +<p> 40.126 +La dernière version du <a href="http://www.slitaz.org/doc/handbook/" 40.127 +>Handbook</a> de SliTaz est lisible via la partie 40.128 +<a href="http://www.slitaz.org/doc/">documentation</a> du site web de 40.129 +<a href="http://www.slitaz.org/">www.slitaz.org</a>. Au moment de la 40.130 +publication d'une nouvelle version de SliTaz, le Handbook est archivé et 40.131 +prend le même numéro de version que SliTaz. Il est alors inclus en standard, 40.132 +dans la distribution de base officielle. 40.133 +</p> 40.134 +<h4>Participer/collaborer/réclamer</h4> 40.135 +<p> 40.136 +La documentation du projet se veut une oeuvre collaborative. Vous pouvez 40.137 +facilement participer à l'écriture ou à la relecture de documents, nous faire 40.138 +part de vos suggestions et commentaires. Si vous avez besoin d'une description 40.139 +supplémentaire, d'un texte de référence ou autre, vous pouvez, sans hésiter, 40.140 +nous contacter et nous faire une demande spécifique. 40.141 +</p> 40.142 +<p> 40.143 +Si vous avez remarqué des erreurs dans les textes ou si vous avez fait une 40.144 +relecture complète d'un chapître, vous pouvez envoyer/attacher vos 40.145 +correctifs sous forme de patch ou envoyer toute la page relue ou encore 40.146 +signaler les erreurs directement dans le contenu du mail. 40.147 +</p> 40.148 +<p> 40.149 +Pour écrire un nouveau document ou un bout de texte à rajouter dans un 40.150 +chapître existant, vous pouvez utiliser la page modèle du Handbook 40.151 +(<a href="template.html">template.html</a>) associée à sa feuille de style 40.152 +CSS (<a href="book.css">handbook.css</a>) ou simplement utiliser un 40.153 +fichier texte (une personne de la liste se chargera de la mise en page). Une 40.154 +fois votre texte mis en page, vous pouvez l'envoyer sur la liste afin qu'il 40.155 +soit relu et corrigé. Votre documents sera ensuite intégré au Handbook 40.156 +officiel de SliTaz. Par la suite, vous avez le choix de rester le mainteneur 40.157 +du document ou de passer la main. 40.158 +</p> 40.159 + 40.160 +<!-- End of content --> 40.161 +</div> 40.162 + 40.163 +<!-- Footer. --> 40.164 +<div id="footer"> 40.165 + <div class="footer-right"></div> 40.166 + <a href="#top">Haut de la page</a> | 40.167 + <a href="index.html">Table des matières</a> 40.168 +</div> 40.169 + 40.170 +<div id="copy"> 40.171 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 40.172 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 40.173 + Documentation publiées sous 40.174 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 40.175 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 40.176 +</div> 40.177 + 40.178 +</body> 40.179 +</html>
41.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 41.2 +++ b/doc/handbook/install.html Sat Mar 29 12:01:05 2008 +0100 41.3 @@ -0,0 +1,240 @@ 41.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 41.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 41.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 41.7 +<head> 41.8 + <title>SliTaz Handbook - Installation</title> 41.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 41.10 + <meta name="description" content="installation de SliTaz GNU/Linux sur disque dur hd grub boot" /> 41.11 + <meta name="expires" content="never" /> 41.12 + <meta name="modified" content="2007-12-18 12:30:00" /> 41.13 + <meta name="publisher" content="www.slitaz.org" /> 41.14 + <meta name="author" content="Christophe Lincoln"/> 41.15 + <link rel="shortcut icon" href="favicon.ico" /> 41.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 41.17 +</head> 41.18 +<body bgcolor="#ffffff"> 41.19 + 41.20 +<!-- Header and quick navigation --> 41.21 +<div id="header"> 41.22 +<div align="right" id="quicknav"> 41.23 + <a name="top"></a> 41.24 + <a href="cmdline.html">Ligne de commandes</a> | 41.25 + <a href="index.html">Table des matières</a> 41.26 +</div> 41.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 41.28 +</div> 41.29 + 41.30 +<!-- Content. --> 41.31 +<div id="content"> 41.32 +<div class="content-right"></div> 41.33 + 41.34 +<h2><font color="#DF8F06">Instructions d'installation sur HD</font></h2> 41.35 + 41.36 +<ul> 41.37 + <li><a href="#apropos">A propos de ce document.</a></li> 41.38 + <li><a href="#prerequis">Prérequis.</a></li> 41.39 + <li><a href="#installer">Installateur.</a></li> 41.40 + <li><a href="#byhand">Installation à la main.</a> 41.41 + <ul> 41.42 + <li><a href="#cdrom">Monter le cdrom.</a></li> 41.43 + <li><a href="#install">Installation du système.</a></li> 41.44 + </ul></li> 41.45 + <li><a href="#grub">Installer le bootloader GRUB.</a></li> 41.46 + <li><a href="#reboot">Redémarrer (<em>reboot</em>).</a></li> 41.47 +</ul> 41.48 + 41.49 +<a name="apropos"></a> 41.50 +<h3><font color="#6c0023">A propos de ce document</font></h3> 41.51 +<p> 41.52 +Ce document fournit les instructions pour une installation de SliTaz GNU/Linux 41.53 +sur un disque dur (HD). Il vous faudra passer quelques commandes et éditer 41.54 +quelques fichiers au format texte. Le temps à consacrer pour une 41.55 +installation de base est d'environ 10 min. A noter que vous pouvez toujours 41.56 +utiliser une clé USB ou un disque dur externe en tant que partition 41.57 +<code>/home</code>, comme avec <a href="livecd.html">le mode LiveCD</a>. A noter 41.58 +que vous avez le choix entre un installation semi-automatisée ou une 41.59 +installation à la main, commande par commande. 41.60 +</p> 41.61 + 41.62 +<a name="prerequis"></a> 41.63 +<h3><font color="#6c0023">Prérequis</font></h3> 41.64 +<p> 41.65 +Il vous faut un cdrom ou une image ISO de SliTaz et environ 80 Mb de libre 41.66 +sur un disque dur de votre ordinateur. Si le mode liveCD fonctionne c'est 41.67 +que vous pouvez installer SliTaz facilement et sans aucun problèmes. 41.68 +</p> 41.69 +<p> 41.70 +Pour commencer, vous devez avoir une partition montée pour installer SliTaz 41.71 +et avoir ouvert un terminal avec un SHell administrateur (<em>root</em>). 41.72 +En mode LiveCD, vous pouvez devenir <em>root</em> avec la commande 41.73 +<code>su</code> suivi du mot de passe <code>root</code>. Pour lister les 41.74 +partitions disponibles, vous pouvez utiliser les commandes : 41.75 +<code>cat /proc/partitions</code> ou <code>fdisk -l</code>. Pour créer un 41.76 +système de fichiers sur une partition, vous pouvez utiliser l'utilitaire 41.77 +<code>mkfs</code>. Exemple avec la partition <code>hda1</code> et le système 41.78 +de fichiers journalisé <code>ext3</code>, attention cette commande détruit 41.79 +définitivement toutes les données de la partition spécifiée : 41.80 +</p> 41.81 +<pre> 41.82 + # mkfs.ext3 /dev/hda1 41.83 +</pre> 41.84 + 41.85 +<a name="installer"></a> 41.86 +<h3><font color="#6c0023">Installateur</font></h3> 41.87 +<p> 41.88 +SliTaz fourni un installateur en mode ncurses, simple, intutif et en français. 41.89 +Il fournit les instructions nécessaires, pas à pas, pour que l'installation 41.90 +du système se passe sans soucis et que vous puissiez redémarrer sur votre 41.91 +nouveau système SliTaz GNU/Linux. Les étapes sont toutes automatisées, vous 41.92 +pourrez installer le gestionnaire de démarrage GRUB si besoin est, ou 41.93 +ajouter une ligne au fichier de configuration de votre gestionnaire de 41.94 +démarrage actuel. Pour afficher le premier message et commencer l'installation : 41.95 +</p> 41.96 +<pre> 41.97 + # slitaz-installer 41.98 +</pre> 41.99 + 41.100 +<a name="byhand"></a> 41.101 +<h3><font color="#6c0023">Installation à la main</font></h3> 41.102 +<p> 41.103 +Si vous avez utilisé l'installateur, vous pouvez directement passer au 41.104 +<a href="#grub">bootloader GRUB.</a> 41.105 +</p> 41.106 +<p> 41.107 +A noter que vous pouvez copier/coller les commandes depuis Firefox dans le 41.108 +terminal, en utilisant le bouton du milieu. A noter aussi que ce document ne 41.109 +demande qu'a être amélioré, toute contribution est la bienvenue. 41.110 +</p> 41.111 +<h4>Monter la partition cible</h4> 41.112 +<p> 41.113 +Pour monter la partition cible sur un point de montage tel que le répertoire 41.114 +<code>/mnt/target</code>, vous pouvez utiliser la commande <code>mount</code>. 41.115 +Exemple : 41.116 +</p> 41.117 +<pre> 41.118 + # mkdir /mnt/target 41.119 + # mount -t ext3 /dev/hda1 /mnt/target 41.120 +</pre> 41.121 + 41.122 +<a name="cdrom"></a> 41.123 +<h4>Monter le cdrom</h4> 41.124 +<p> 41.125 +Tous les fichiers utiles se trouvent sur le cdrom de SliTaz. Il faut le noyau 41.126 +Linux, le système de fichiers racine compressé (rootfs.gz), et des packages 41.127 +additionnels si vous le désirez. Pour monter le périphérique de cdrom sur 41.128 +le point de montage <code>/media/cdrom</code> : 41.129 +</p> 41.130 +<pre> 41.131 + # mount -t iso9660 /dev/cdrom /media/cdrom 41.132 + ou 41.133 + # mount -t iso9660 /dev/hdd /media/cdrom 41.134 +</pre> 41.135 + 41.136 +<a name="install"></a> 41.137 +<h4>Installation du système</h4> 41.138 +<p> 41.139 +Création du répertoire /boot et copie du noyau Linux, qui se nomme bzImage 41.140 +sur le cdrom. Nous allons renommer le noyau en vmlinuz suivi de son numéro 41.141 +de version, que l'on peut obtenir avec la commande 41.142 +<code>uname -r</code> en mode live : 41.143 +</p> 41.144 +<pre> 41.145 + # mkdir /mnt/target/boot 41.146 + # cd /media/cdrom/boot 41.147 + # cp bzImage /mnt/target/boot/vmlinuz-2.6.22.9-slitaz 41.148 +</pre> 41.149 +<p> 41.150 +Copie du rootfs: 41.151 +</p> 41.152 +<pre> 41.153 + # cp rootfs.gz /mnt/target 41.154 +</pre> 41.155 +<p> 41.156 +Nous allons maintenant nous déplacer dans la cible, et décompressé l'archive 41.157 +rootfs.lf avec lzma et cpio. Nous supprimons ensuite le fichier rootfs et le 41.158 +lien init, utilisé par le mode liveCD : 41.159 +</p> 41.160 +<pre> 41.161 + # cd /mnt/target 41.162 + # lzma d rootfs.lz -so | cpio -id 41.163 + # rm rootfs.lz init 41.164 +</pre> 41.165 +<p> 41.166 +Voilà SliTaz est installé. Si vous avez déjà GRUB ou Lilo d'installé, vous 41.167 +pouvez ajouter les lignes nécessaires pour faire booter SliTaz, et redémarrer. 41.168 +Sinon il vous faut installer le boot loader GRUB. 41.169 +</p> 41.170 +<a name="grub"></a> 41.171 +<h3><font color="#6c0023">Installer le bootloader GRUB</font></h3> 41.172 +<p> 41.173 +Le paquet GRUB devrait être installé sur le LiveCD de SliTaz. GRUB est un 41.174 +chargeur de démarrage (<em>boot loader</em>) permettant de lancer les systèmes 41.175 +GNU/Linux, BSD et même Windows, via de simple entrée dans un fichier texte. 41.176 +Ce fichier texte se nomme <code>menu.list</code>, il permet de finement 41.177 +configurer le chargeur de démarrage, il peut être modifié manuellement et à 41.178 +tous moments. 41.179 +</p> 41.180 +<p> 41.181 +Installation de GRUB sur le mbr, avec comme racine /mnt/target (la cible), et 41.182 +comme disque <code>hda</code> : 41.183 +</p> 41.184 +<pre> 41.185 + # grub-install --root-directory=/mnt/target /dev/hda 41.186 +</pre> 41.187 +<p> 41.188 +Vous pouvez maintenant ajouter les lignes de configuration ci-dessous pour 41.189 +SliTaz, au fichier menu.lst de la cible. Pour cela vous pouvez utiliser 41.190 +l'éditeur de texte Nano ou LeafPad en mode graphique . A noter que pour 41.191 +connaître la version du noyau Linux sur un système GNU/Linux, vous pouvez 41.192 +utiliser la commande <code>$ uname -a</code>. Pour éditer le fichier de 41.193 +configuration de GRUB (Un exemple est fournit) : 41.194 +</p> 41.195 +<pre> 41.196 + # nano /mnt/target/boot/grub/menu.lst 41.197 + (Ctrl+X pour quitter) 41.198 + ou : 41.199 + # leafpad /mnt/target/boot/grub/menu.lst 41.200 +</pre> 41.201 +<h4>/boot/grub/menu.lst - Exemple</h4> 41.202 +<pre class="script"> 41.203 + 41.204 + title SliTaz GNU/Linux (cooking) (Kernel 2.6.22.9-slitaz) 41.205 + root(hd0,0) 41.206 + kernel /boot/vmlinuz-2.6.22.9-slitaz root=/dev/hda1 vga=788 41.207 + 41.208 +</pre> 41.209 +<a name="reboot"></a> 41.210 +<h3><font color="#6c0023">Redémarrer (<em>reboot</em>)</font></h3> 41.211 +<p> 41.212 +Vous devriez pouvoir redémarrer sur votre nouveau système SliTaz GNU/Linux. 41.213 +Après l'installation de SliTaz sur un disque dur, il est recommandé de 41.214 +commencer par configurer le système, en fonction de ses besoins, du matériel, 41.215 +et des possibilités. Pour configurer votre système après le reboot et 41.216 +apprendre à utiliser SliTaz, vous pouvez vous référer au Handbook. Vous pouvez 41.217 +redémarrer via le menu du gestionnaire de fenêtres JWM ou via la commande : 41.218 +</p> 41.219 +<pre> 41.220 + # reboot 41.221 +</pre> 41.222 + 41.223 + 41.224 +<!-- End of content --> 41.225 +</div> 41.226 + 41.227 +<!-- Footer. --> 41.228 +<div id="footer"> 41.229 + <div class="footer-right"></div> 41.230 + <a href="#top">Haut de la page</a> | 41.231 + <a href="index.html">Table des matières</a> 41.232 +</div> 41.233 + 41.234 +<div id="copy"> 41.235 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 41.236 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 41.237 + Documentation publiées sous 41.238 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 41.239 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 41.240 +</div> 41.241 + 41.242 +</body> 41.243 +</html>
42.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 42.2 +++ b/doc/handbook/jwm.html Sat Mar 29 12:01:05 2008 +0100 42.3 @@ -0,0 +1,215 @@ 42.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 42.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 42.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 42.7 +<head> 42.8 + <title>SliTaz Handbook - JWM</title> 42.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 42.10 + <meta name="description" content="SliTaz desktop bureau graphique JWM light window manager léger rapide simple gestion fenêtres" /> 42.11 + <meta name="expires" content="never" /> 42.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 42.13 + <meta name="publisher" content="www.slitaz.org" /> 42.14 + <meta name="author" content="Christophe Lincoln"/> 42.15 + <link rel="shortcut icon" href="favicon.ico" /> 42.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 42.17 +</head> 42.18 +<body bgcolor="#ffffff"> 42.19 + 42.20 +<!-- Header and quick navigation --> 42.21 +<div id="header"> 42.22 +<div align="right" id="quicknav"> 42.23 + <a name="top"></a> 42.24 + <a href="enlightenment.html">Enlightenment</a> | 42.25 + <a href="index.html">Table des matières</a> 42.26 +</div> 42.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 42.28 +</div> 42.29 + 42.30 +<!-- Content. --> 42.31 +<div id="content"> 42.32 +<div class="content-right"></div> 42.33 + 42.34 +<h2><font color="#DF8F06">JWM le gestionnaire de fenêtres</font></h2> 42.35 + 42.36 +<ul> 42.37 + <li><a href="#intro">Introduction et présentation de JWM.</a></li> 42.38 + <li><a href="#usage-config">Utilisation et configuration de JWM.</a></li> 42.39 + <li><a href="#style">Créer son propre style pour JWM.</a></li> 42.40 + <li><a href="#ontheweb">JWM sur le web.</a></li> 42.41 +</ul> 42.42 + 42.43 +<a name="intro"></a> 42.44 +<h3><font color="#6c0023">Introduction et présentation de JWM</font></h3> 42.45 +<p> 42.46 +Le gestionnaire de fenêtres (en anglais <em>window manager</em> ou <em>WM</em>) 42.47 +fourni de base avec SliTaz, se nomme : JWM (<em>Joe's Window Manager</em>). 42.48 +Un gestionnaire de fenêtres est une application tournant au dessus du serveur 42.49 +X, permetant de contrôler l'apparence des fenêtres, d'ouvrir un terminal X ou 42.50 +d'afficher des applications. Il permet ensuite de placer, de réduire, et de 42.51 +dimensionner les fenêtres à son propre gré. JWM sais aussi gérer plusieurs 42.52 +bureaux virtuels, fournit des raccourcis clavier configurables, et propose un 42.53 +joli menu supportant les icônes. JWM est un gestionnaire de fenêtres très 42.54 +léger, c'est un bureau graphique efficace, ne consommant pas toutes les 42.55 +ressources du système, il est relativement facile d'accès à un débutant dans 42.56 +le monde libre de GNU/Linux. Côté développeur l'utilisation d'un gestionnaire 42.57 +de fenêtres léger est appréciable, l'économie des ressources système 42.58 +signifiant un gain en rapidité, même sur des machines puissantes. 42.59 +</p> 42.60 +<p> 42.61 +<em>Joe's Window Manager</em> est écrit en C, simple, rapide, épuré, stable et 42.62 +efficace. JWM propose une ou plusieurs barre(s) des tâches, un menu avec des 42.63 +icônes et un pager pour la gestion des bureaux virtuels, la barre des tâches 42.64 +peut aussi afficher l'heure en différents formats et un dock par instance de 42.65 +JWM. De plus il est facilement configurable via un seul fichier texte vous 42.66 +permettant de changer le menu, les polices et leurs tailles, et les 42.67 +différentes couleurs. Le projet est en actif développement et les 42.68 +fonctionnalités s'additionnent avec le temps, depuis la version 2.0 vous 42.69 +bénéficiez, par exemple, du support des couleurs dégradées (<em>gradient</em>), 42.70 +de la gestion du fond d'écran ou de la possibilité de déplacer les fenêtres 42.71 +via le pager. 42.72 +</p> 42.73 +<a name="usage-config"></a> 42.74 +<h3><font color="#6c0023">Utilisation et configuration de JWM</font></h3> 42.75 +<p> 42.76 +La prise en main de Joe's Window Manager est très rapide. Pour afficher le 42.77 +menu il suffit de cliquer quelque part sur le bureau ou sur le bouton du menu 42.78 +qui se trouve, par défaut, en bas à gauche de l'écran. Vous pouvez 42.79 +redimensionner une fenêtre via une des bordures ou un des coins, les passer 42.80 +d'un bureau virtuel à l'autre via le pager, les réduire ou encore les 42.81 +maximiser. Vous disposez aussi de raccourcis clavier configurables pour un 42.82 +accès plus rapide aux applications que vous utilisez le plus souvent. Sur 42.83 +SliTaz le fichier de configuration système est : 42.84 +<code>/etc/jwm/system.jwmrc</code>. A part ce fichier de configuration 42.85 +système, chaque utilisateur peut utiliser son propre fichier de configuration 42.86 +caché <code>~/.jwmrc</code>. Ce fichier est un fichier texte utilisant la 42.87 +syntaxe XML, il peut être modifié avec un simple éditeur de texte, les lignes 42.88 +commençant par : <code><!--</code> sont des commentaires qui vous aiderons 42.89 +à savoir quelle balise fait quoi. 42.90 +</p> 42.91 +<p> 42.92 +Pour faciliter la personnalisation de son bureau, SliTaz copie automatiquement, 42.93 +lors du lancement de la première session graphique, un fichier de configuration 42.94 +système à la racine du répertoire personnel de l'utilisateur. Vous pouvez 42.95 +directement modifier ce fichier et faire vos essais sans risques. Pour l'éditer 42.96 +avec votre éditeur de texte préféré : 42.97 +</p> 42.98 +<pre> 42.99 + $ geany $HOME/.jwmrc & 42.100 +</pre> 42.101 +<p> 42.102 +Pour récupérer un fichier de configuration original, il faut copier celui du 42.103 +système dans son répertoire personnel en le renommant par <code>.jwmrc</code>, 42.104 +vous pourez ensuite (re)commencer à l'éditer : 42.105 +</p> 42.106 +<pre> 42.107 + $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc 42.108 +</pre> 42.109 +<p> 42.110 +Maintenant que vous avez un fichier de configuration personnel vous allez 42.111 +pouvoir créer votre propre menu en utilisant les icônes dont vous avez envie. 42.112 +La balise : <code>RootMenu</code> correspond au menu affiché par un clique 42.113 +sur un des trois boutons de la souris. Pour ajouter une catégorie vous devez 42.114 +utiliser la balise : Menu contenant elle même des entrées pour divers 42.115 +programmes. Une entrée dans le menu de JWM peut tenir sur une seule ligne, 42.116 +exemple avec l'application de gestion d'images GQview : 42.117 +</p> 42.118 +<pre class="script"> 42.119 +<Program icon="gqview.png" label="GQview">gqview</Program> 42.120 +</pre> 42.121 +<p> 42.122 +Il existe encore de nombreuses possibilités de configuration comme 42.123 +l'utilisation de plusieurs <code>RootMenu</code> en fonction des boutons de 42.124 +la souris, le choix du mode utilisé pour déplacer les fenêtres, la création 42.125 +de groupes, etc. Le manuel disponible en ligne sur le site web officiel du 42.126 +projet devrait vous aider à aller plus loin, pour afficher une liste des 42.127 +options possibles en ligne de commandes il suffit de taper : 42.128 +<code>jwm -h</code> dans un terminal. 42.129 +</p> 42.130 +<a name="style"></a> 42.131 +<h3><font color="#6c0023">Créer son propre style pour JWM</font></h3> 42.132 +<p> 42.133 +Créer son style graphique avec JWM est relativement facile et se fait 42.134 +rapidement, les balises sont claires et les attributs possibles sont donnés 42.135 +dans les commentaires. Lors de l'élaboration de votre travail, vous pouvez 42.136 +voir vos modification au fur et à mesure en redémarrant le gestionnaire de 42.137 +fenêtres via le menu ou la commande : <code>jwm -restart</code>. Dans le 42.138 +fichier de configuration les balises de styles débutent après la ligne de 42.139 +commentaires : <!-- Visual Styles -->. Pour commencer voici une petite 42.140 +liste des balises de styles principales avec une courte description : 42.141 +</p> 42.142 +<ul> 42.143 + <li><code>Background</code> gére le fond d'écran. Ce tag supporte les 42.144 + attributs : <code>solid, gradient, image</code> ou <code>tile</code>, 42.145 + permettant respectivement d'utiliser une couleur solide, de créer un 42.146 + dégradé, d'afficher une image redimensinnée ou en mode tuile.</li> 42.147 + <li><code>BorderStyle</code> contrôle le style de la bordure des fenêtres</li> 42.148 + <li><code>TrayStyle</code> contrôle une barre des tâches. Vous pouvez en 42.149 + mettre plusieurs (en haut et en bas par exemple). La barre des tâches peut, 42.150 + entre autre, être cachée automatiquement ou ne remplir qu'une partie de 42.151 + l'écran via l'attribut <code>width</code>.</li> 42.152 + <li><code>TaskListStyle</code> contrôle le style de la liste des fenêtres 42.153 + ouvertes sur le bureau courant.</li> 42.154 + <li><code>PagerStyle</code> contrôle le pager affichant les différents 42.155 + bureaux virtuels (quatre par défaut).</li> 42.156 + <li><code>MenuStyle</code> définit le style du menu.</li> 42.157 + <li>Les icônes sont définies par le tag <code>IconPath</code>, vous pouvez 42.158 + facilement utiliser vos icônes personnelles en spécifiant le chemin 42.159 + complet vers le répertoire qui les contient. A noter que vous pouvez 42.160 + spécifier plus d'un chemin, si vous voulez par exemple utiliser vos 42.161 + images et celles du système contenues dans : 42.162 + <code>/usr/share/pixmaps</code> et <code>/usr/share/icons</code>. SliTaz 42.163 + utilise les icons du thème Tango: <a href="http://tango.freedesktop.org/" 42.164 + >tango.freedesktop.org</a> pour le menu. Ils sont de taille 16x16 et se 42.165 + trouvent dans le répertoire : <code>/usr/share/icons/Tango</code>. 42.166 + Vous pouvez en rajouter, les modifier, les supprimer, etc. Si vous désirez 42.167 + installer de nouvelles icônes en espace utilisateur, nous vous conseillons 42.168 + d'utiliser un répertoire personnel <code>~/Images/Icons</code> (configurer 42.169 + par défaut) ou un répertoire caché <code>~/.icons</code>. 42.170 +</li> 42.171 +</ul> 42.172 +<p> 42.173 +Les couleurs peuvent être définies avec leur nom ou leur numéro RGB, tel que : 42.174 +<code>#3A4956</code>. Pour utiliser de belles couleurs en mode dégradé 42.175 +(<em>gradient</em>), vous devez spécifier deux couleurs séparées par 42.176 +deux points, exemple : <code>#6C0023:#3E1220</code>. Vous pouvez aussi changer 42.177 +les polices et leurs tailles en utilisant la balise : <code>Font</code>. Il y 42.178 +a encore quelques petites choses que vous pouvez modifier pour personnaliser 42.179 +votre bureau, telles que le format de l'horloge ou le nom du bouton et son icône. 42.180 +Avant de redémarrer JWM avec votre nouveau fichier de configuration, vous 42.181 +pouvez vérifier sa syntaxe en utilisant la commande : <code>jwm -p</code>. 42.182 +Pour aller plus loin, le manuel officiel décrit tous les tags, les options 42.183 +possibles et les attributs valides. Vous pouvez le consulter en ligne sur le 42.184 +site web de JWM. 42.185 +</p> 42.186 +<a name="ontheweb"></a> 42.187 +<h3><font color="#6c0023">JWM sur le web</font></h3> 42.188 +<ul> 42.189 + <li><a href="http://www.joewing.net/programs/jwm/" 42.190 + >www.joewing.net/programs/jwm/</a> - Le site web officiel de Joe's 42.191 + Window Manager, fournissant des news et le manuel complet.</li> 42.192 + <li><a href="http://joesnet.sytes.net/">joesnet.sytes.net</a> - Site web 42.193 + de JoesBox, proposant des thèmes et divers petits utilitaires à utiliser 42.194 + avec JWM.</li> 42.195 + <li>#jwm sur irc.freenode.net - Le canal de discussions IRC de JWM sur 42.196 + les serveurs de Freenode.</li> 42.197 +</ul> 42.198 + 42.199 +<!-- End of content --> 42.200 +</div> 42.201 + 42.202 +<!-- Footer. --> 42.203 +<div id="footer"> 42.204 + <div class="footer-right"></div> 42.205 + <a href="#top">Haut de la page</a> | 42.206 + <a href="index.html">Table des matières</a> 42.207 +</div> 42.208 + 42.209 +<div id="copy"> 42.210 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 42.211 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 42.212 + Documentation publiées sous 42.213 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 42.214 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 42.215 +</div> 42.216 + 42.217 +</body> 42.218 +</html>
43.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 43.2 +++ b/doc/handbook/livecd.html Sat Mar 29 12:01:05 2008 +0100 43.3 @@ -0,0 +1,347 @@ 43.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 43.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 43.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 43.7 +<head> 43.8 + <title>SliTaz Handbook - LiveCD</title> 43.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 43.10 + <meta name="description" content="utiliser le livecd options login utilisateur session X" /> 43.11 + <meta name="expires" content="never" /> 43.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 43.13 + <meta name="publisher" content="www.slitaz.org" /> 43.14 + <meta name="author" content="Christophe Lincoln"/> 43.15 + <link rel="shortcut icon" href="favicon.ico" /> 43.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 43.17 +</head> 43.18 +<body bgcolor="#ffffff"> 43.19 + 43.20 +<!-- Header and quick navigation --> 43.21 +<div id="header"> 43.22 +<div align="right" id="quicknav"> 43.23 + <a name="top"></a> 43.24 + <a href="install.html">Installation</a> | 43.25 + <a href="index.html">Table des matières</a> 43.26 +</div> 43.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 43.28 +</div> 43.29 + 43.30 +<!-- Content. --> 43.31 +<div id="content"> 43.32 +<div class="content-right"></div> 43.33 + 43.34 +<h2><font color="#DF8F06">Utiliser le LiveCD et ses options</font></h2> 43.35 + 43.36 +<ul> 43.37 + <li><a href="#quick-intro">Rapide introduction au LiveCD.</a></li> 43.38 + <li><a href="#boot">Démarrer sur le CD (<em>boot</em>).</a></li> 43.39 + <li><a href="#options">Options à passer au démarrage.</a></li> 43.40 + <li><a href="#kernel-param">Paramètres du noyau Linux</a> - Matériel 43.41 + et modes VGA.</li> 43.42 + <li><a href="#home">Option : home=usb</a> - Conserver ses donnés sur un 43.43 + media USB.</li> 43.44 + <li><a href="#i18n">Options : lang=XX et kmap=XX</a> - Spécifier la langue 43.45 + et le clavier.</li> 43.46 + <li><a href="#config">Option : config=<device>,<path></a> - 43.47 + Lancer un script au démarrage du LiveCD.</li> 43.48 + <li><a href="#sound">Option : sound=*</a> - Supprimer le support du son ou 43.49 + saute la configuration automatique.</li> 43.50 + <li><a href="#modprobe">Option : modprobe=modules</a> - Charger des modules 43.51 + à la volée.</li> 43.52 + <li><a href="#sessions">Sessions</a> - Login, mots de passes et X.</li> 43.53 +</ul> 43.54 + 43.55 +<a name="quick-intro"></a> 43.56 +<h3><font color="#6c0023">Rapide introduction au LiveCD</font></h3> 43.57 +<p> 43.58 +Le LiveCD de SliTaz GNU/Linux est une distribution libre fonctionnant depuis 43.59 +un cdrom. La distribution vous permet d'emporter avec vous un mini système 43.60 +ultra rapide, léger et sans rien installer. L'utilisation du LiveCD de SliTaz 43.61 +est absolument sans risques pour le système d'exploitation existant sur 43.62 +l'ordinateur hôte et SliTaz ne touche pas aux disques durs. Le LiveCD est 43.63 +disponible sous forme d'image au format ISO contenant le système 43.64 +d'exploitation complet et compressé. Cette image ISO peut être gravée sur 43.65 +un cdrom (CD-RW ou un CD-R), ensuite, il suffit de redémarrer la machine 43.66 +avec le cdrom dans le lecteur de CD ou DVD pour lancer SliTaz en mémoire vive 43.67 +(RAM). Une fois en fonctionnement, SliTaz est autonome, vous pouvez retirer le 43.68 +cdrom et utiliser le système pendant des mois sans redémarrer... 43.69 +</p> 43.70 + 43.71 +<a name="boot"></a> 43.72 +<h3><font color="#6c0023">Démarrer sur le CD (<em>boot</em>)</font></h3> 43.73 +<p> 43.74 +L'utilisation de SliTaz nécessite que votre machine démarre (<em>boot</em>) 43.75 +depuis le périphérique de CD/DVD et non pas depuis le disque dur. Dans la 43.76 +plupart des cas votre ordinateur est déjà configuré pour amorcer sur cdrom, si 43.77 +ce n'est pas le cas, il faut modifier l'ordre de démarrage via l'interface de 43.78 +configuration du BIOS accessible, en général, en pressant une touche 43.79 +(<code>F10</code>, <code>F12</code>, <code>esc</code> ou autre) dans les 43.80 +premières secondes qui suivent l'allumage de la machine. Quand vous êtes dans 43.81 +le BIOS, il faut chercher les paramètres relatifs à la séquence de démarrage 43.82 +tels que <em>Boot Order</em> ou <em>Boot Device</em> et changer l'ordre pour 43.83 +que le cdrom arrive en premier. Pour finir, n'oubliez pas d'enregistrer les 43.84 +modifications avant de quitter l'interface de configuration du BIOS. 43.85 +</p> 43.86 +<p> 43.87 +Quand la machine a réussi à démarrer sur le cdrom, vous vous retrouvez avec 43.88 +une image <em>splash</em> du logo de Slitaz et une invite de commande 43.89 +permettant de passer différentes options au noyau Linux et aux scripts de 43.90 +démarrage (<em>boot scripts</em>) utilisés par SliTaz. Il suffit alors de 43.91 +taper sur la touche <code>ENTER</code> pour lancer le système avec ou sans 43.92 +options, la touche <code>F1</code> affichera un texte d'aide et d'informations. 43.93 +</p> 43.94 + 43.95 +<a name="options"></a> 43.96 +<h3><font color="#6c0023">Options et paramètre à passer au démarrage</font></h3> 43.97 +<p> 43.98 +Le système LiveCD de SliTaz propose diverses options à passer au démarrage 43.99 +(<em>boot</em>), via l'invite de commandes propulsé par Syslinux. Il y deux 43.100 +types d'options : celles de SliTaz et celles du noyau Linux. Les options 43.101 +propres à SliTaz sont utilisées par les scripts de démarrage et les paramètres 43.102 +du noyau Linux (<em>kernel boot parameters</em>), tel que le mode VGA, sont 43.103 +gérés directement par le noyau. Pour passer des options au démarrage vous devez 43.104 +commencer par taper <code>slitaz</code> suivit des options, pour vous simplifier 43.105 +la vie vous pouvez simplement taper par exemple <code>fr</code> et ENTER pour 43.106 +charger un fichier de clavier (en clavier qwerty <code>slitaz</code> 43.107 +correspond à : <code>slitqw</code>). Exemple : 43.108 +</p> 43.109 +<pre> 43.110 + slitaz vga=791 no387 43.111 +</pre> 43.112 +<p> 43.113 +A noter que le noyau Linux conserve les données passées au <em>boot</em> dans 43.114 +le fichier texte <code>/proc/cmdline</code>. Sur un système GNU/Linux en 43.115 +fonctionnement, ce fichier est facilement lisible depuis un terminal et via la 43.116 +commande : 43.117 +</p> 43.118 +<pre> 43.119 + $ cat /proc/cmdline 43.120 +</pre> 43.121 + 43.122 +<a name="kernel-param"></a> 43.123 +<h3><font color="#6c0023">Paramètres du noyau Linux</font></h3> 43.124 +<p> 43.125 +Sur les systèmes GNU/Linux, les paramètres spécifiques au noyau Linux varient 43.126 +en fonction de la configuration utilisée lors de la compilation de celui-ci. 43.127 +Le noyau utilisé par SliTaz est construit avec un minimum de modules et 43.128 +propose peu de paramètres modifiables au démarrage. Cela dit, vous avez 43.129 +la possibilité de désactiver l'émulation d'un coprocesseur mathématique via 43.130 +le code : <code>no387</code> et/ou d'activer <code>irqpoll</code> en cas de 43.131 +problèmes d'interruption avec le matértiel (lecteur CD/DVD par exemple). Le 43.132 +noyau Linux de SliTaz fournit aussi un mode de sortie video vga VESA pour le 43.133 +<em>framebuffer</em>. C'est lui qui affiche le petit logo Tux et gère la 43.134 +taille d'affichage du terminal Linux. A noter qu'une fois le système démarré, 43.135 +vous avez accès à six pseudo terminaux Linux via les combinaisons de touches : 43.136 +<code>Ctrl+alt+F1</code>, <code>Ctrl+alt+F2</code>, etc. 43.137 +</p> 43.138 + 43.139 +<h4>vga=XXX - Modes VGA du noyau</h4> 43.140 +<pre class="script"> 43.141 +Colors | 640x480 800x600 1024x768 1280x1024 1600x1200 43.142 +------------------------------------------------------- 43.143 +256 | 769 771 773 775 796 43.144 +32768 | 784 787 790 793 797 43.145 +65536 | 785 788 791 794 798 43.146 +16,8M | 786 789 792 795 799 43.147 +</pre> 43.148 + 43.149 +<a name="home"></a> 43.150 +<h3><font color="#6c0023">Option : home=usb - Conserver ses donnés</font></h3> 43.151 +<p> 43.152 +L'option <code>home=usb</code> ou <code>home=*</code> active 43.153 +le montage d'une partition d'un périphérique USB externe sur le répertoire 43.154 +<code>/home</code> (maison) destiné aux utilisateurs du système. 43.155 +L'utilisation d'une clé USB, d'un disque dur externe ou d'une carte SD, 43.156 +permet de conserver les informations utilisateur sur un support persistant. 43.157 +Associer le LiveCD de Slitaz à un support de stockage a de gros avantages, 43.158 +tels que de conserver la configuration de vos applications préférées, vos 43.159 +marques pages, vos documents, vos images, etc. Cette technique vous permet 43.160 +aussi de créer votre propre menu et votre propre thème pour le gestionnaire de 43.161 +fenêtres JWM. Vous pouvez par exemple facilement utiliser une image en fond 43.162 +d'écran et la retrouver à chaque fois que vous utiliser le cdrom de SliTaz. 43.163 +Ces informations sont stockées dans des fichiers de configurations cachés 43.164 +propre à chaque compte du système. La plupart des applications destinées aux 43.165 +utilisateurs ont un fichier/répertoire de configuration système généralement 43.166 +situé dans <code>/etc</code> et un fichier/répertoire caché (commençant par 43.167 +un point) appartenant à l'utilisateur. Pour utiliser cette option il faut une 43.168 +partition formatée en <code>ext3</code> et située sur un périphérique USB tel 43.169 +qu'une clé USB <em>flash memory</em>, le format <code>ext3</code> est un 43.170 +système de fichiers journalisé, supportant la gestion des permissions et 43.171 +offrant donc bien plus de sécurité que le format <code>FAT32</code> ou 43.172 +<code>NTFS</code> utilisé par Windows. A noter que la lecture ou l'écriture 43.173 +sur un système de fichiers <code>ext3</code> n'est pas supportée nativement 43.174 +par Windows mais que SliTaz peut lire et écrire sur un système de fichiers 43.175 +<code>FAT32</code> grâce au support natif fourni par le noyau Linux. 43.176 +</p> 43.177 +<p> 43.178 +Si vous avez déjà un media externe formaté en <code>ext3</code>, vide ou 43.179 +contenant des données mais ayant assez d'espace libre, vous pouvez directement 43.180 +l'utiliser. Aucune donnée existante ne sera détruite, il y aura juste un 43.181 +répertoire <code>hacker/</code> créé automatiquement lors de la première 43.182 +utilisation du LiveCD avec le périphérique et la partition en question. 43.183 +</p> 43.184 +<h4>Partitions et formatage d'un media</h4> 43.185 +<p> 43.186 +Dans la plupart des cas les clés USB et les cartes de type SD <em>card</em> 43.187 +n'ont qu'une seule partition, généralement reconnue comme <code>sda1</code> 43.188 +par le noyau Linux. Une fois formatée, vous pouvez utiliser cette première 43.189 +partition en passant l'option <code>home=sda1</code> ou plus simplement 43.190 +<code>home=usb</code> à l'invite de commandes disponible au démarrage du 43.191 +système. Si vous désirez utiliser une partition d'un disque dur externe, 43.192 +composé de multiples partitions, vous pouvez utiliser l'option 43.193 +<code>home=sda[1-9]</code> en spécifiant la bonne partition. A noter que vous 43.194 +pouvez aussi partitionner une clé USB en différentes partitions et utiliser 43.195 +une de ces partitions comme <em>home</em>. Pour savoir si votre media a bien 43.196 +été reconnu et connaître l'emplacement depuis lequel il est accessible, vous 43.197 +pouvez utiliser l'utilitaire <code>fdisk</code> avec l'option <code>-l</code>. 43.198 +Pour utiliser cette commande vous devez avoir les droits d'administrateur 43.199 +système (<em>root</em>), que vous pouvez obtenir via la commande 43.200 +<code>su</code> suivi du mot de passe <em>root</em>. Exemple : 43.201 +</p> 43.202 +<pre> 43.203 + $ su 43.204 + # fdisk -l 43.205 +</pre> 43.206 +<p> 43.207 +Le formatage en <code>ext3</code> va détruire toutes les données contenues sur 43.208 +la partition en question, attention à ne pas vous tromper de disque ou de 43.209 +partition. Une fois que le media sera formaté, il sera prêt à être utilisé 43.210 +pour stocker vos données personnelles. Pour formater la première partition 43.211 +d'un périphérique <code>sda</code>, vous pouvez utiliser la commande 43.212 +<code>mkfs.ext3</code> ou l'utilitaire Tazusb : 43.213 +</p> 43.214 +<pre> 43.215 + # mkfs.ext3 /dev/sda1 43.216 + ou: 43.217 + # tazusb format /dev/sda1 43.218 +</pre> 43.219 +<h4>Utiliser un media</h4> 43.220 +<p> 43.221 +L'utilisation d'un périphérique externe commence lors du démarrage 43.222 +(<em>boot</em>) du système LiveCD, il faut spécifier l'option 43.223 +<code>home=usb</code> ou <code>home=*</code> précédée par 43.224 +<code>slitaz</code>. La partition peut aussi être spécifiée en utilisant 43.225 +l'UUID ou le label de la partition. Exemple : 43.226 +</p> 43.227 +<pre> 43.228 + slitaz home=usb 43.229 + slitaz home=sdb1 43.230 + slitaz home=UUID/LABEL 43.231 +</pre> 43.232 +<p> 43.233 +Lors de l'exécution des scripts de démarrage, SliTaz lit le fichier 43.234 +<code>/proc/cmdline</code> pour savoir si une partition doit être montée sur 43.235 +<code>/home</code>. Si l'option existe, le script va commencer par attendre 43.236 +environ 10 secondes que le media soit bien détecté par le noyau Linux et 43.237 +tenter de monter la partition. Lors de la première utilisation le contenu 43.238 +original du répertoire <code>/home/hacker</code> est copié sur la nouvelle 43.239 +partition préalablement montée. Vous aurez alors un système fonctionnant en 43.240 +mémoire vive et des données personnelles sur votre media de type USB. 43.241 +</p> 43.242 + 43.243 +<a name="i18n"></a> 43.244 +<h3><font color="#6c0023">Options : lang=XX et kmap=XX - Langue et clavier</font></h3> 43.245 +<p> 43.246 +Le LiveCD de Slitaz vous propose de configurer la langue et le clavier 43.247 +directement au <em>boot</em> ou graphiquement pendant l'initialisation du 43.248 +système. Cela veut dire que si vous ne spécifiez pas la langue ou le clavier 43.249 +via l'invite de commandes, le système lancera automatiquement une interface 43.250 +de configuration lors de l'exécution des scripts de démarrage. SliTaz est 43.251 +en français <code>fr</code> et en anglais <code>en</code>, les claviers 43.252 +<code>be ca de en es fr_CH fr it jp us </code>. Exemple d'utilisation de 43.253 +ces options : 43.254 +</p> 43.255 +<pre> 43.256 + slitaz lang=fr kmap=be 43.257 +</pre> 43.258 + 43.259 +<a name="config"></a> 43.260 +<h3><font color="#6c0023">Option : config=<device>,<path></font></h3> 43.261 +<p> 43.262 +L'option <code>config=</code> vous permet de lancer un script au démarrage 43.263 +du LiveCD, ce script peur être situé sur une partition d'un disque dur local 43.264 +ou sur un media de type USB. Cette option permet par exemple, de monter une 43.265 +image ISO sur <code>/usr</code> afin de pouvoir éconnomiser le la mémoire 43.266 +vive et utilisé SliTaz sur de machines ayant 32 Mb RAM. Exemple avec un script 43.267 +nommé <code>slitaz.sh</code> et sutué sur la première partition du premier 43.268 +disque dur local : 43.269 +</p> 43.270 +<pre> 43.271 + slitaz config=/dev/hda1,slitaz.sh 43.272 +</pre> 43.273 + 43.274 +<a name="sound"></a> 43.275 +<h3><font color="#6c0023">Option : sound=*</font></h3> 43.276 +<p> 43.277 +L'option <code>sound=no</code> ou <code>sound=noconf</code> vous permettent 43.278 +respéctivement, de supprimer tous les modules et applications en rapport au 43.279 +support du son pour gagner de la mémoire vive (RAM), ou de sauter la 43.280 +configuration automatique au démarrage si vous ne désirez pas configurer le son 43.281 +mais quand même conserver le nécessaire pour un configuration manuel par 43.282 +la suite. 43.283 +</p> 43.284 +<pre> 43.285 + slitaz sound=no 43.286 +</pre> 43.287 + 43.288 +<a name="modprobe"></a> 43.289 +<h3><font color="#6c0023">Option : modprobe=modules</font></h3> 43.290 +<p> 43.291 +L'option <code>mdprobe=modules</code> vous permettent de charger des modules 43.292 +du noyau à la volée lors du démarrage du système. Cette options est utile par 43.293 +exemple si un driver compilé en modules est nécessaire à la configuration de 43.294 +la carte réseau ou son. A noter que sur un système en fonction, vous pouvez 43.295 +lister les modules disponibles via la commande : <code>modprobe -l</code> et 43.296 +que la commande <code>lspci</code> peut vous aider à connaître votre matériel 43.297 +et le nom du bon driver. Pour charger un ou des modules : 43.298 +</p> 43.299 +<pre> 43.300 + slitaz modprobe=modules1,modules2 43.301 +</pre> 43.302 + 43.303 +<a name="sessions"></a> 43.304 +<h3><font color="#6c0023">Sessions - Login, mots de passes et X</font></h3> 43.305 +<p> 43.306 +Quand le système a finit son initialisation, l'écran est nettoyé et l'invite 43.307 +de <em>login</em> ou le gestionnaire de connexion Slim s'affiche. Sur un 43.308 +système GNU/Linux il y a un administrateur système nommé <em>root</em>, il 43.309 +a tous les droits et ne devrait pas être utilisé pour se loguer directement. 43.310 +SliTaz a donc un compte <em>root</em> et propose un utilisateur <em>hacker</em> 43.311 +sans mot de passe. Pour devenir <em>root</em> au sein d'une session utilisateur, 43.312 +vous pouvez utiliser la commande <code>su</code> suivie du mot de passe root. 43.313 +En mode LiveCD, le mot de passe <em>root</em> est <code>root</code>. 43.314 +</p> 43.315 +<p> 43.316 +Une fois logué dans une session, vous pouvez utiliser les nombreuses commandes 43.317 +disponibles, les outils en mode texte tels que l'éditeur GNU Nano ou le 43.318 +gestionnaire de fichiers Clex. Vous pouvez aussi lancer une session graphique 43.319 +(X) via la commande <code>startx</code> ou encore vous connecter à une machine 43.320 +distante via une session SSH ou X. La commande <code>startx</code> va lancer 43.321 +le serveur graphique (Xvesa) et démarrer le gestionnaire de fenêtres JWM, vous 43.322 +aurez alors la possibilité d'utiliser des applications graphiques via le menu 43.323 +fourni par SliTaz et propulsé par JWM (Joe Window Manager). Pour lancer une 43.324 +session X depuis une console Linux, dans le cas par exemple ou vous avez utilisé 43.325 +l'option <code>screen=text</code> et que Slim n'est pas lançé : 43.326 +</p> 43.327 +<pre> 43.328 + $ startx 43.329 +</pre> 43.330 + 43.331 +<!-- End of content --> 43.332 +</div> 43.333 + 43.334 +<!-- Footer. --> 43.335 +<div id="footer"> 43.336 + <div class="footer-right"></div> 43.337 + <a href="#top">Haut de la page</a> | 43.338 + <a href="index.html">Table des matières</a> 43.339 +</div> 43.340 + 43.341 +<div id="copy"> 43.342 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 43.343 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 43.344 + Documentation publiées sous 43.345 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 43.346 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 43.347 +</div> 43.348 + 43.349 +</body> 43.350 +</html>
44.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 44.2 +++ b/doc/handbook/liveusb.html Sat Mar 29 12:01:05 2008 +0100 44.3 @@ -0,0 +1,492 @@ 44.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 44.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 44.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 44.7 +<head> 44.8 + <title>SliTaz Handbook - LiveUSB</title> 44.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 44.10 + <meta name="description" content="" /> 44.11 + <meta name="expires" content="never" /> 44.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 44.13 + <meta name="publisher" content="www.slitaz.org" /> 44.14 + <meta name="author" content="Christophe Lincoln"/> 44.15 + <link rel="shortcut icon" href="favicon.ico" /> 44.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 44.17 +</head> 44.18 +<body bgcolor="#ffffff"> 44.19 + 44.20 +<!-- Header and quick navigation --> 44.21 +<div id="header"> 44.22 +<div align="right" id="quicknav"> 44.23 + <a name="top"></a> 44.24 + <a href="index.html">Table des matières</a> 44.25 +</div> 44.26 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 44.27 +</div> 44.28 + 44.29 +<!-- Content. --> 44.30 +<div id="content"> 44.31 +<div class="content-right"></div> 44.32 + 44.33 +<h2><font color="#DF8F06">LiveUSB - SliTaz sur un media USB</font></h2> 44.34 + 44.35 +<ul> 44.36 + <li><a href="#method">Methodes, type de media et notes</a> - Introduction, 44.37 + système de fichiers, résumé des étapes.</li> 44.38 + <li><a href="#tazusb">LiveUSB en 2 commandes</a> - Utiliser TazUSB pour 44.39 + créer un LiveUSB facilement.</li> 44.40 + <li><a href="#prepa">Préparer le media USB</a> - Formater si besoin est, 44.41 + copier les fichiers du LiveCD.</li> 44.42 + <li><a href="#grub">Installer et utiliser GRUB</a> - Installer le 44.43 + gestionnaire de démarrage GRUB sur le media USB.</li> 44.44 + <li><a href="#grubiso">GRUB sur cdrom</a> - Utiliser le media via un cdrom 44.45 + bootable contenant GRUB.</li> 44.46 + <li><a href="#extlinux">Installer et utiliser EXTLINUX</a> - Installer le 44.47 + gestionnaire de démarrage EXTLINUX sur le media USB.</li> 44.48 + <li><a href="#windows">Installer SliTaz sur USB depuis Windows</a> - Installer 44.49 + SliTaz sur un media USB en utilisanr Syslinux depuis Windows.</li> 44.50 +</ul> 44.51 + 44.52 +<a name="method"></a> 44.53 +<h3><font color="#6c0023">Methodes, type de media et notes</font></h3> 44.54 +<p> 44.55 +Ce document décrit les étapes à réaliser pour installer les fichiers nécessaires 44.56 +afin de démarrer SliTaz depuis un périphérique de type USB (clé, carte SD, 44.57 +disque dur externe). Ce n'est pas une installation du système à proprement 44.58 +parler, le mode de fonctionnemnt de SliTaz reste le même qu'en mode LiveCD, 44.59 +c'est à dire que le système sera entièrement chargé en mémoire vive (RAM) 44.60 +lors du démarrage. Avoir SliTaz sur un media USB vous permet de vous passer 44.61 +du cdrom sur les machines capables de démarrer depuis un périphérique USB et 44.62 +l'utiliser le même media pour stocker vos données personnelles de manière 44.63 +persistante. Il faut aussi savoir que tous les PC ne sont pas capables de 44.64 +démarrer directement sur USB et que le démarrage du système est plus long 44.65 +que depuis un cdrom. 44.66 +</p> 44.67 +<h4>Disque dur externe, carte SD ou clé USB</h4> 44.68 +<p> 44.69 +Un media de stockage USB peut être un disque dur externe de grande ou petite 44.70 +capacité, une carte de type SD/flash ou une clé USB. Vous pouvez par exemple, 44.71 +utiliser l'ancienne carte d'un appareil de photos numérique ayant au 44.72 +minimum une capacité de 32 Mb. Cela dit, l'utilisation de 44.73 +<a href="#grub">GRUB</a> avec les clés USB ne réussi pas toujours et dépend 44.74 +du type de clé. Si l'utilisation de GRUB échoue, il est conseillé d'utiliser 44.75 +le gestionaire de démarrage <a href="#extlinux">EXTLINUX</a> et d'installer 44.76 +un MBR fonctionnel sur la clé USB. 44.77 +</p> 44.78 +<p> 44.79 +Pour commencer nous vous conseillons d'utiliser une partition formatée en ext3 44.80 +et non au format natif FAT32. Le système de fichiers ext3 est un système de 44.81 +fichiers propre à GNU/Linux, robuste, fiable et illisible nativement depuis 44.82 +Windows, ce qui peut être un point positif ou négatif. A noter que vous pourrez 44.83 +aussi utiliser cette même partition pour stocker vos données de manière 44.84 +persistante via l'option <code>home=usb</code> proposée par SliTaz. Cela dit, 44.85 +vous pouvez aussi installer SliTaz sur une clé USB au format FAT32 comme 44.86 +suggéré sur le forum de SliTaz : 44.87 +<a href="http://forum.slitaz.org/viewtopic.php?pid=28#p28">SliTaz sur clé USB FAT32</a>. 44.88 +</p> 44.89 +<h4>Étapes à réaliser</h4> 44.90 +<p> 44.91 +En gros, il faut récupérer les fichiers contenus sur le LiveCD, les 44.92 +copier sur le media USB et installer un gestionnaire de démarrage. A noter 44.93 +qu'il existe plusieurs gestionnaires de démarrage, Syslinux, GRUB ou encore 44.94 +Lilo. SliTaz fournit GRUB sur la version standard du LiveCD et dans les paquets 44.95 +du miroir, il a l'avantage de pouvoir aussi être utilisé pour démarrer 44.96 +d'autres systèmes d'expoitations et de proposer un SHell permettant par exemple 44.97 +de réinstaller GRUB dans le MBR (Master Boot Record) d'un disque dur. 44.98 +</p> 44.99 + 44.100 +<a name="tazusb"></a> 44.101 +<h3><font color="#6c0023">LiveUSB en 2 commandes</font></h3> 44.102 +<p> 44.103 +Pour créer facilement un système Live tenant sur un media USB, vous pouvez 44.104 +utiliser TazUSB ou installer les fichiers manuellement. TazUSB est un 44.105 +utilitaire simple, efficace et bien testé. Vous pouvez créer un media en une ou 44.106 +deux commandes. Pour cela il vous faut un LiveCD de SliTaz et biensûr un media 44.107 +USB dont vous devez connaître le nom (<code>fdisk -l</code> ou <code>blkid</code>). 44.108 +Formatage optionnel et génération d'un media bootable reconnu comme /dev/sdb1: 44.109 +</p> 44.110 +<pre> 44.111 + # tazusb format /dev/sdb1 44.112 + # tazusb gen-liveusb /dev/sdb1 44.113 +</pre> 44.114 +<p> 44.115 +Une fois le media généré, vous pouvez redémarrer sur votre media USB. Si vous 44.116 +désirez installer des applications, mettre à jour ou configurer le système et 44.117 +retouver vos modifications lors de a prochaine utilisation, il vous faut 44.118 +recréer le système compressé en utilisant la commande <code>writefs</code> de 44.119 +TazUSB. A noter que le menu de JWM propose par défaut des entrées pour écrire 44.120 +le système sur le media en utilisant gzip, lzma ou aucune compression (prend 44.121 +plus de place mais démarre beaucoup plus rapidement). 44.122 +</p> 44.123 + 44.124 +<a name="prepa"></a> 44.125 +<h3><font color="#6c0023">Préparer le media USB</font></h3> 44.126 +<p> 44.127 +Si vous avez déjà une partition au format ext3, vous n'avez pas besoin de 44.128 +reformater, sinon il faut créer un système de fichier avec l'utilitaire 44.129 +<code>mkfs.ext3</code>. Attention le formatage d'une partition détruit toutes 44.130 +les données qui s'y trouvent. Généralement, la première ou unique partition 44.131 +d'un media USB est reconnu par le noyau Linux comme <code>/dev/sda</code>, pour 44.132 +lister les périphériques et partitions disponibles vous pouvez utiliser la 44.133 +commande <code>fdisk -l</code> avant de créer le système de fichiers ext3 : 44.134 +</p> 44.135 +<pre> 44.136 + # mkfs.ext3 /dev/sda1 44.137 + # mount -t ext3 /dev/sda1 /media/flash 44.138 +</pre> 44.139 +<p> 44.140 +Le formatage de la partition va créer un répertoire système nommé 44.141 +<code>lost+found</code> (perdu et trouvé), ce répertoire est utiliser par le 44.142 +système de fichier en cas de problèmes. Maintenant que le media est formaté 44.143 +et monté, vous pouvez copier le contenu du cdrom sur le périphérique, soit 44.144 +depuis un cdrom gravé, soit depuis une image ISO locale : 44.145 +</p> 44.146 +<pre> 44.147 + # mount -t iso9660 /dev/cdrom /media/cdrom 44.148 + Ou : 44.149 + # mount -o loop slitaz-cooking.iso /media/cdrom 44.150 +</pre> 44.151 +<p> 44.152 +Copie de tous les fichiers contenu dans le répertoire <code>boot/</code> 44.153 +du LiveCD, il se peut que le système de fichiers compressé soit nommé 44.154 +<code>rootfs.lz</code>, si c'est le cas, il faut le renommer en 44.155 +<code>rootfs.gz</code> : 44.156 +</p> 44.157 +<pre> 44.158 + # cp -a /media/cdrom/boot /media/flash 44.159 + # mv /media/flash/boot/rootfs.lz /media/flash/boot/rootfs.gz 44.160 +</pre> 44.161 + 44.162 +<a name="grub"></a> 44.163 +<h3><font color="#6c0023">Installer et utiliser GRUB</font></h3> 44.164 +<p> 44.165 +Pour installer GRUB (GRand Unified Bootloader) il faut commencer par copier 44.166 +les fichiers <code>stage1</code> et <code>stage2</code> depuis 44.167 +<code>/usr/lib/grub/i386-pc</code> dans le répertoire <code>boot/grub</code> 44.168 +du media USB. Une fois les fichiers copiés et le media trouvé par GRUB, vous 44.169 +allez pouvoir installer le gestionnaire de démarrage dans le MBR du 44.170 +périphérique. Copie des fichiers, lancement du SHell GRUB et recherche de 44.171 +<code>stage1</code> fraîchement copié : 44.172 +</p> 44.173 +<pre> 44.174 + # cp /usr/lib/grub/i386-pc/stage[1-2] /media/flash/boot/grub 44.175 + # grub 44.176 + grub> find /boot/grub/stage1 44.177 +</pre> 44.178 +<p> 44.179 +Ce qui peut donner (hd0,0), (hd1,0) ou encore (hd2,0), GRUB voit le premier 44.180 +disque <code>hda</code> comme <code>hd0</code>, il faut donc modifier les 44.181 +valeures en fonction de votre configuration. Il se peut aussi que votre media 44.182 +ne soit pas trouvé, dans ce cas vous pouvez utiliser le <em>bootloader</em> 44.183 +<a href="#extlinux">EXTLINUX</a>. Pour installer GRUB vous pouvez 44.184 +utiliser les commandes <code>root</code> et <code>setup</code>. Pour quitter 44.185 +le SHell GRUB c'est la commande <code>quit</code> : 44.186 +</p> 44.187 +<pre> 44.188 + grub> root (hd2,0) 44.189 + grub> setup (hd2) 44.190 + grub> quit 44.191 +</pre> 44.192 +<p> 44.193 +La dernière chose qu'il reste à faire avant de redémarrer, est de créer un 44.194 +fichier de configuration de GRUB permettant de lancer SliTaz avec l'option 44.195 +<code>home=usb</code>, ce qui permet d'utiliser aussi le media comme partition 44.196 +<code>/home</code> pour stocker ses données, installer des applications en 44.197 +espace utilisateur et conserver vos configurations logiciels. Le fichiers 44.198 +de configuration utilisé par GRUB peut être créé avec votre éditeur de texte 44.199 +préféré, exemple avec LeafPad : 44.200 +</p> 44.201 +<pre> 44.202 + # leafpad /media/flash/boot/grub/menu.lst 44.203 +</pre> 44.204 +<pre class="script"> 44.205 +# /boot/grub/menu.lst: GRUB boot loader configuration. 44.206 +# 44.207 + 44.208 +# Change the colors. 44.209 +color yellow/brown light-green/black 44.210 + 44.211 +# For booting SliTaz from a cdrom or USB media (LiveRAM). 44.212 +# 44.213 +title SliTaz GNU/Linux (Cooking) (Kernel 2.6.22.9) 44.214 +kernel /boot/bzImage root=/dev/null vga=771 home=usb 44.215 +initrd /boot/rootfs.gz 44.216 +</pre> 44.217 +<p> 44.218 +Vous pouvez encore ajouter ces quelques lignes, pour avoir une entrée 44.219 +permettant de réinstaller GRUB dans un MBR (utile en cas problèmes) : 44.220 +</p> 44.221 +<pre class="script"> 44.222 +# For installing GRUB into the hard disk 44.223 +# 44.224 +title Install GRUB into the hard disk 44.225 +root (hd0,0) 44.226 +setup (hd0) 44.227 +</pre> 44.228 +<p> 44.229 +Voilà, vous pouvez démonter le cdrom et le media. ET redémarrer sur votre 44.230 +clé USB en prenant soins de configurer correctement le BIOS de votre machine 44.231 +pour qu'elle démarre depuis le media USB et non depuis le disque dur : 44.232 +</p> 44.233 +<pre> 44.234 + # umount /media/cdrom 44.235 + # umount /media/flash 44.236 + # reboot 44.237 +</pre> 44.238 + 44.239 +<a name="grubiso"></a> 44.240 +<h3><font color="#6c0023">GRUB sur cdrom</font></h3> 44.241 +<p> 44.242 +Il est possible de créer rapidement une image ISO contenant GRUB, servant à 44.243 +démarrer SliTaz depuis un media USB et cela sur des machines ne pouvant pas 44.244 +démarrer directement sur USB. Pour ce faire GRUB fourni une image nommée 44.245 +<code>stage2_eltorito</code> permettant de rendre un cdrom bootable. Pour créer 44.246 +une image ISO gravable il faut créer la racine du cdrom, copier le fichier 44.247 +<code>stage2_eltorito</code> et générer une ISO avec <code>genisoimage</code>. 44.248 +Les commandes peuvent être copiées/collées ligne par ligne. Pour créer la 44.249 +racine du cdrom (<code>rootcd</code> et copier l'image eltorito de GRUB : 44.250 +</p> 44.251 +<pre> 44.252 + $ mkdir -p rootcd/boot/grub 44.253 + $ cp /usr/lib/grub/i386-pc/stage2_eltorito \ 44.254 + rootcd/boot/grub 44.255 +</pre> 44.256 +<p> 44.257 +Le fichier de configuration de grub se nomme toujours <code>menu.lst</code>, 44.258 +c'est un fichier texte éditable avec votre éditeur de texte préféré. Vous 44.259 +pouvez mettre le nombre d'entrées que vous désirez, pour démarrer SliTaz il 44.260 +faut spécifier la bonne racine <code>root (hd2,0)</code> pour que GRUB trouve 44.261 +le noyau (<code>bzImage</code>) et le système compressé (<code>roottf.gz</code>). 44.262 +Un petit fichier de configuration minimaliste : 44.263 +</p> 44.264 +<pre class="script"> 44.265 +# /boot/grub/menu.lst: GRUB boot loader configuration. 44.266 +# 44.267 + 44.268 +title SliTaz GNU/Linux (Cooking) 44.269 +root (hd2,0) 44.270 +kernel /boot/bzImage root=/dev/null home=usb 44.271 +initrd /boot/rootfs.gz 44.272 +</pre> 44.273 +<h4>Générer un ISO bootable</h4> 44.274 +<p> 44.275 +Pour générer une image ISO vous pouvez utiliser <code>genisoimage</code> 44.276 +fourni en standard sur le LiveCD de SliTaz. Cette commande est relativement 44.277 +longue, les <em>backslash</em> en fin de ligne permettent de continuer la 44.278 +commande sur la ligne suivante. Dans l'exemple, l'image se nomme 44.279 +<code>grub.iso</code>, le volume Grub et la racine du cdrom 44.280 +<code>rootcd</code> : 44.281 +</p> 44.282 +<pre> 44.283 + $ genisoimage -R -o grub.iso \ 44.284 + -b boot/grub/stage2_eltorito \ 44.285 + -no-emul-boot -V "Grub" -boot-load-size 4 \ 44.286 + -input-charset iso8859-1 -boot-info-table \ 44.287 + rootcd 44.288 +</pre> 44.289 + 44.290 +<a name="extlinux"></a> 44.291 +<h3><font color="#6c0023">Installer et utiliser EXTLINUX</font></h3> 44.292 +<p> 44.293 +Extlinux est un gestionnaire de démarrage provenant du paquet Syslinux, il 44.294 +permet de démarrer un système GNU/Linux depuis un système de fichiers ext2 ou 44.295 +ext3. C'est un gestionnaire de démarrage simple et fiable, il fonctionne bien 44.296 +pour les clés USB. Pour commencer il faut récupérer la dernière version 44.297 +du paquet Syslinux depuis le site du noyau Linux et installer le binaire 44.298 +<code>extlinux</code> dans votre répertoire personnel <code>~/Bin</code> ou 44.299 +dans un répertoire système tel que <code>/usr/bin</code>. Pour télécharger, 44.300 +désarchiver et installer EXTLINUX en espace utilisateur : 44.301 +</p> 44.302 +<pre> 44.303 + $ wget http://www.kernel.org/pub/linux/utils/boot/syslinux/syslinux-3.61.tar.gz 44.304 + $ tar xzf syslinux-3.61.tar.gz 44.305 + $ cp syslinux-3.61/extlinux/extlinux ~/.local/bin 44.306 +</pre> 44.307 +<p> 44.308 +Maintenant que le binaire <code>extlinux</code> est disponible, vous pouvez 44.309 +l'installer dans sur un media monté et cela via un SHell administrateur 44.310 +<em>root</em> obtenu via la commande <code>su</code>. Nous vous conseillons 44.311 +d'installer EXTLINUX dans un répertoire dédié, c'est à dire 44.312 +<code>/boot/extlinux</code> du media USB : 44.313 +</p> 44.314 +<pre> 44.315 + # mkdir -p /media/flash/boot/extlinux 44.316 + # extlinux --install /media/flash/boot/extlinux 44.317 +</pre> 44.318 +<p> 44.319 +Sur les clé USB il faut encore installer un MBR pour s'assurer de rendre le 44.320 +media bootable. Attention à spécifier le bon périphérique, dans la plus part 44.321 +des cas une clé USB est reconnue comme sda : 44.322 +</p> 44.323 +<pre> 44.324 + # cat syslinux-3.61/mbr/mbr.bin > /dev/sda 44.325 +</pre> 44.326 +<p> 44.327 +Le fichier de configuration se nomme <code>extlinux.conf</code> et doit se 44.328 +trouver dans le même répertoire que le binaire <code>extlinux</code>. Les 44.329 +chemins vers les fichiers peuvent être absolus ou relatifs au répertoire 44.330 +d'installation d'extlinux. Ce fichier à la même syntaxe que le fichier 44.331 +<code>isolinux.cfg</code> utilisé pour démarrer le LiveCD de SliTaz. Vous 44.332 +utilisant votre éditeur de texte préféré ou la commande <code>cat</code> 44.333 +(<code>EOT</code> signifie <em>End Of Text</em>, c'est là que le fichier 44.334 +se termine). A noter que vous pouvez copier/coller le contenu du fichier en 44.335 +une seule fois : 44.336 +</p> 44.337 +<pre> 44.338 + # cat > /media/flash/boot/extlinux/extlinux.conf << "EOT" 44.339 +</pre> 44.340 +<pre class="script"> 44.341 +display display.txt 44.342 +default slitaz 44.343 +label slitaz 44.344 + kernel /boot/bzImage 44.345 + append initrd=/boot/rootfs.gz rw root=/dev/null home=usb 44.346 +</pre> 44.347 +<pre> 44.348 + EOT 44.349 +</pre> 44.350 +<h4>Afficher un message boot</h4> 44.351 +<p> 44.352 +La première ligne <code>display display.txt</code> permet d'afficher un fichier 44.353 +text au démarrage de EXTLINUX, vous pouvez utiliser/modifier celui utiliser sur 44.354 +le LiveCD ou en créer un nouveau. Si vous ne voulez pas afficher un 44.355 +<em>display</em>, il suffit de supprimer la ligne. Pour créer un nouveau 44.356 +fichier <code>display.txt</code> avec <code>cat </code>: 44.357 +</p> 44.358 +<pre> 44.359 + # cat > /media/flash/boot/extlinux/display.txt << "EOT" 44.360 +</pre> 44.361 +<pre class="script"> 44.362 +/* _\|/_ 44.363 + (o o) 44.364 + +----oOO-{_}-OOo---------------------------------------------------+ 44.365 + ____ _ _ _____ 44.366 + / ___|| (_)_ _|_ _ ____ 44.367 + \___ \| | | | |/ _` |_ / 44.368 + ___) | | | | | (_| |/ / 44.369 + |____/|_|_| |_|\__,_/___| 44.370 + 44.371 + SliTaz GNU/Linux LiveUSB 44.372 + 44.373 + Simple Light Incredible Temporary Autonomus Zone 44.374 + 44.375 + */ 44.376 +</pre> 44.377 +<pre> 44.378 + EOT 44.379 +</pre> 44.380 +<p> 44.381 +Reste plus qu'a redémarrer sur votre clé USB en prenant soins de configurer 44.382 +correctement le BIOS de votre machine pour qu'elle démarre depuis le media USB 44.383 +et non depuis le disque dur : 44.384 +</p> 44.385 +<pre> 44.386 + # umount /media/flash 44.387 + # reboot 44.388 +</pre> 44.389 + 44.390 +<a name="windows"></a> 44.391 +<h3><font color="#6c0023">Installer SliTaz sur USB depuis Windows</font></h3> 44.392 +<p> 44.393 +Il est possible d'installer SliTaz sur un media USB depuis un système 44.394 +Windows, cette procédure a été testé sur Windows XP et Vista. Avant de 44.395 +commercer, téléchargez la dernière version de SliTaz sur le site : 44.396 +<a href="http://www.slitaz.org/get/">Obtenir SliTaz</a>. Il vous faut aussi 44.397 +récupérer l'utilitaire syslnux <a 44.398 + href="http://www.eu.kernel.org/pub/linux/boot/syslinux/syslinux-3.60.zip" 44.399 + >syslinux-3.60.zip</a>. 44.400 +</p> 44.401 +<p> 44.402 +1. Extraire l'image sur la clé USB. L'image ISO peut être extraite avec des 44.403 +outils comme <a href="http://www.7-zip.org">7-Zip</a> ou Winimage (shareware) 44.404 +par exemple. Normallement vous devriez obtenir l'arborescence suivante : 44.405 +</p> 44.406 +<pre class="script"> 44.407 +\boot 44.408 +\boot\isolinux 44.409 +\boot\grub 44.410 +\boot\syslinux 44.411 +</pre> 44.412 +<p> 44.413 +2. Sur la clé USB, copier les fichiers du gestionnaire de démarrage dans le 44.414 +répertoire <code>\boot\syslinux</code> : 44.415 +</p> 44.416 +<pre class="script"> 44.417 +\boot\isolinux\*.txt 44.418 +\boot\isolinux\*.msg 44.419 +\boot\isolinux\*.cfg 44.420 +\boot\isolinux\*.lss 44.421 +</pre> 44.422 +<p> 44.423 +3. Toujours dans le répertoire <code>\boot\syslinux</code>, renommer 44.424 +<code>isolinux.cfg</code> en <code>syslinux.cfg</code> et 44.425 +<code>isolinux.msg</code> en <code>syslinux.msg</code>. Ce n'est pas 44.426 +indipensable pour isolinux.msg, mais c'est plus cohérent. 44.427 +</p> 44.428 +<p> 44.429 +4. Extraire le fichier syslinux.exe de l'archive téléchargée sur kernel.org et 44.430 +le copier dans <code>\boot\syslinux</code> sur la clé. 44.431 +</p> 44.432 +<p> 44.433 +5. Modifiez le fichier <code>syslinux.cfg</code> pour qu'il corresponde à vos 44.434 +besoin. Exemple: 44.435 +</p> 44.436 +<pre class="script"> 44.437 +display syslinux.msg 44.438 +default slitaz 44.439 +label slitaz 44.440 + kernel /boot/bzImage 44.441 + append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=fr vga=normal 44.442 +implicit 0 44.443 +prompt 1 44.444 +timeout 80 44.445 +F1 help.txt 44.446 +F2 options.txt 44.447 +F3 isolinux.msg 44.448 +F4 display.txt 44.449 +</pre> 44.450 +<p> 44.451 +<strong>Note :</strong> Par rapport au fichier d'origine la ligne 44.452 +<code>display isolinux.msg</code> a été remplaçée par 44.453 +<code>display syslinux.cfg</code>. Et les paramètres 44.454 +<code>lang=fr kmap=fr</code> on été rajouté sur la ligne <code>append</code>. 44.455 +</p> 44.456 +<p> 44.457 +6. Il ne reste plus qu'à exécuter <code>syslinux.exe</code> pour installer le 44.458 +<em>bootloader</em>. Exemple dans le cas où la clé est désignée par la lettre 44.459 +K : 44.460 +</p> 44.461 +<pre> 44.462 +K: 44.463 +cd \boot\syslinux 44.464 +syslinux -ma -d \boot\syslinux K: 44.465 +</pre> 44.466 + 44.467 +<h4>Version rapide</h4> 44.468 +<ol> 44.469 + <li>Télécharchez l'achive <a 44.470 + href="http://files.openomy.com/public/Erjo/syslinux.zip">syslnux.zip</a>.</li> 44.471 + <li>Extrayez le répertoire syslinux et copiez le dans le répertoire 44.472 + boot de la clé USB.</li> 44.473 + <li>Exécutez le script <code>\boot\syslinux\bootusb.bat</code>.</li> 44.474 +</ol> 44.475 + 44.476 +<!-- End of content --> 44.477 +</div> 44.478 + 44.479 +<!-- Footer. --> 44.480 +<div id="footer"> 44.481 + <div class="footer-right"></div> 44.482 + <a href="#top">Haut de la page</a> | 44.483 + <a href="index.html">Table des matières</a> 44.484 +</div> 44.485 + 44.486 +<div id="copy"> 44.487 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 44.488 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 44.489 + Documentation publiées sous 44.490 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 44.491 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 44.492 +</div> 44.493 + 44.494 +</body> 44.495 +</html>
45.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 45.2 +++ b/doc/handbook/multimedia.html Sat Mar 29 12:01:05 2008 +0100 45.3 @@ -0,0 +1,202 @@ 45.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 45.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 45.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 45.7 +<head> 45.8 + <title>SliTaz Handbook - Multimedia</title> 45.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 45.10 + <meta name="description" content="slitaz *book template" /> 45.11 + <meta name="expires" content="never" /> 45.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 45.13 + <meta name="publisher" content="www.slitaz.org" /> 45.14 + <meta name="author" content="Christophe Lincoln"/> 45.15 + <link rel="shortcut icon" href="favicon.ico" /> 45.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 45.17 +</head> 45.18 +<body bgcolor="#ffffff"> 45.19 + 45.20 +<!-- Header and quick navigation --> 45.21 +<div id="header"> 45.22 +<div align="right" id="quicknav"> 45.23 + <a name="top"></a> 45.24 + <a href="development.html">Developpement</a> | 45.25 + <a href="index.html">Table des matières</a> 45.26 +</div> 45.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 45.28 +</div> 45.29 + 45.30 +<!-- Content. --> 45.31 +<div id="content"> 45.32 +<div class="content-right"></div> 45.33 + 45.34 +<h2><font color="#DF8F06">Multimedia</font></h2> 45.35 + 45.36 +<ul> 45.37 + <li><a href="#intro">Slitaz le son et la video.</a></li> 45.38 + <li><a href="#config">Configurer une carte son.</a></li> 45.39 + <li><a href="#alsamixer">Alsamixer</a> - Mixer simple et efficace.</li> 45.40 + <li><a href="#alsaplayer">Alsaplayer</a> - Lecteur de musique.</li> 45.41 + <li><a href="#asunder">Asunder</a> - Audio CD Ripper.</li> 45.42 + <li><a href="#xine">Xine</a> - Lecteur multimedia.</li> 45.43 + <li><a href="#mpg123">mpg123</a> - Lecteur audio et encodeur en ligne de 45.44 + commande.</li> 45.45 +</ul> 45.46 + 45.47 +<a name="intro"></a> 45.48 +<h3><font color="#6c0023">Slitaz le son et la video</font></h3> 45.49 +<p> 45.50 +En mode LiveCD SliTaz fournit le support du son mais pas de lecteur video, 45.51 +cela dit vous pouvez visionner des videos en flash sur Youtube par exemple. 45.52 +Pour regarder des videos vous pouvez utiliser Xine, il supporte la plus part des 45.53 +formats tels que OGG ou AVI, à noter que Xine peut aussi faire office de 45.54 +lecteur de musique. Au niveau du son, vous avez un mixer avec Alsamixer et un 45.55 +lecteur avec Alsaplayer, ils sont tous deux installée par défaut sur la version 45.56 +standard du LiveCD et permettent d'écouter des fichiers OGG, MP3 ou WAV. Pour 45.57 +configurer ou reconfigurer votre carte son, vous avez le choix entre deux 45.58 +petit programmes permettant de configurer le son simplement via des boîtes de 45.59 +dialogue. 45.60 +</p> 45.61 + 45.62 +<a name="conf"></a> 45.63 +<h3><font color="#6c0023">Configurer une carte son</font></h3> 45.64 +<p> 45.65 +En mode LiveCD SliTaz configure automatiquement le son au démarrage en lançant 45.66 +une boîte de dialogue, dans la majeur partie des cas, la carte son est reconnue 45.67 +et il suffit d'appuyer sur ENTER pour continuer, se loguer et avoir le son 45.68 +fonctionnel. Cela dit, il se peut que votre carte son ne soit pas reconnue au 45.69 +démarrage ou simplement pas supportée. Avant de jeter l'éponge, vous pouvez 45.70 +tenter de configurer manuellement votre carte et demander le l'aide sur la liste 45.71 +de discussion ou le forum de support matériel. 45.72 +</p> 45.73 +<h4>Soundconf</h4> 45.74 +<p> 45.75 +Pour configurer ou reconfigurer une carte son, SliTaz fournit le script 45.76 +<code>soundconf</code>, cet utilitaire est utilisé au démarrage, ne pose 45.77 +qu'une question, charge les bons modules automatiquement et configure 45.78 +<code>/etc/rcS.conf</code> pour que le driver soit chargé à chaque démarrage. 45.79 +Soundconf va aussi régler les volumes automatiquement, vous pourrez modifier 45.80 +les réglages par la suite via le mixer et alsactl. Pour lancer l'interface de 45.81 +configuration du son, il faut avoir les droits d'administrateur et taper : 45.82 +</p> 45.83 +<pre> 45.84 + # soundconf 45.85 +</pre> 45.86 +<h4>Alsactl</h4> 45.87 +<p> 45.88 +Alsactl pour <em>Alsa control</em> permet de stocker ou restaurer les réglages 45.89 +du son, utile par exemple pour restaurer ses préférences à chaque démarrage. 45.90 +Lors de la configuration du son avec Soundconf les volumes sont réglés 45.91 +automatiquement, vous pouvez utiliser <code>alsamixer</code> avec <em>root</em> 45.92 +pour modifier les valeurs et ensuite lancer <code>alsactl</code> pour stocker 45.93 +la configuration 45.94 +</p> 45.95 +<pre> 45.96 + # alsactl store 45.97 +</pre> 45.98 +<p> 45.99 +Pour restaurer ensuite la configuration vous pouvez utiliser la commande 45.100 +<code>alsactl restore</code> et pour restaurer vos préférences à chaque 45.101 +démarrage vous pouvez ajouter la commande au script /etc/init.d/local.sh en 45.102 +l'éditant avec un éditeur de texte ou avec : 45.103 +</p> 45.104 +<pre> 45.105 + # echo 'alsactl restore' > /etc/init.d/local.sh 45.106 +</pre> 45.107 + 45.108 +<a name="alsamixer"></a> 45.109 +<h3><font color="#6c0023">Alsamixer</font></h3> 45.110 +<p> 45.111 +Alsamixer et le mixer officiel du projet Alsa, il est simple et efficace. Vous 45.112 +pouvez le lancer via le menu du gestionnaire de fenêtre ou directement depuis 45.113 +un terminal. Les volumes se réglent avec les flèches et le mode muet se met ou 45.114 +s'enlève via la touche <code>m</code>. Pour lancer le mixer depuis un terminal 45.115 +Linux ou un graphique : 45.116 +</p> 45.117 +<pre> 45.118 + $ alsamixer 45.119 +</pre> 45.120 + 45.121 +<a name="alsaplayer"></a> 45.122 +<h3><font color="#6c0023">Alsaplayer</font></h3> 45.123 +<p> 45.124 +Le lecteur de musique Alsaplayer se veut simple, épuré et intuitif. Il est réactif 45.125 +et se prend rapidement en main, l'interface est sobre et adaptable. Alsaplayer 45.126 +sur SliTaz fournit le support des fichiers OGG, MP3 (via libmad) et WAV, des 45.127 +playlists, propose des visualisateurs pour accompager le son, la possibilité 45.128 +de régler la vitesse de lecture ou le volume. Une fois lancé via le menu du 45.129 +gestionnaire de fenêtre, il suffit de cliquer sur le bouton play ou celui de 45.130 +la liste de lecture pour commencer à charger un ou des morceaux. 45.131 +</p> 45.132 + 45.133 +<a name="asunder"></a> 45.134 +<h3><font color="#6c0023">Asunder - Audio CD Ripper</font></h3> 45.135 +<p> 45.136 +Asunder est un logiciel d'extraction et encodage de pistes audio depuis un CD. 45.137 +L'outils est très simple d'utilisation, permet d'encoder les morceaux au format 45.138 +wav, ogg ou mp3 via le paquet <code>lame</code>. Il peut aussi faire une 45.139 +recheche CDDB, créer une liste de lecture et modifier les noms des fichiers. 45.140 +Vous trouverez Asunder dans la catégorie Multimedia, il est très rapidement 45.141 +pris en main et efficace. 45.142 +</p> 45.143 + 45.144 +<a name="xine"></a> 45.145 +<h3><font color="#6c0023">Xine</font></h3> 45.146 +<p> 45.147 +Xine est un projet fournissant des bibliothèques et divers visionneurs de video, 45.148 +SliTaz fournit les blibliothèques et un <em>media player</em> contenu dans 45.149 +le paquet <code>xine-ui</code> (ui pour <em>User Interface</em>). Le lecteur 45.150 +Xine propose un interface Xlib, un pannel de contrôle, une interface de 45.151 +configuration via un clique de droite sur la fenêtre principale et des plugins. 45.152 +Il lit la musique OGG, MP3, etc, et les videos au format OGG, AVI ou MPG. Pour 45.153 +installer Xine et ses dépendances : 45.154 +</p> 45.155 +<pre> 45.156 + # tazpkg get-install xine-ui 45.157 +</pre> 45.158 +<p> 45.159 +Une fois installé vous pouvez lancer <code>xine</code> depuis la ligne de 45.160 +commande ou ajouter un entrée dans la catégorie Multimedia du menu de JWM : 45.161 +</p> 45.162 +<pre class="script"> 45.163 +<Program icon="xine.xpm" label="Xine media player">xine</Program> 45.164 +</pre> 45.165 + 45.166 +<a name="mpg123"></a> 45.167 +<h3><font color="#6c0023">mpg123</font></h3> 45.168 +<p> 45.169 +mpg123 est un lecteur et convertisseur de fichiers audio et s'utilise en ligne 45.170 +de commande. C'est à dire que vous pouvez écouter ou convertir de la musique 45.171 +depuis un terminal, pour afficher l'aide vous pouvez utiliser l'option 45.172 +<code>--help</code>. Pour lire un fichier MP3 par exemple, il suffit de lancer 45.173 +<code>mpg123</code> suivi du nom du fuchier audio : 45.174 +</p> 45.175 +<pre> 45.176 + $ mpg123 sound.mp3 45.177 +</pre> 45.178 +<p> 45.179 +mpg123 permet aussi de convertir et encoder un fichier audio dans un autre 45.180 +format. Vous pouvez par exemple convertir un fichier MP3 en WAV, exemple : 45.181 +</p> 45.182 +<pre> 45.183 + $ mpg123 -w sound.wav sound.mp3 45.184 +</pre> 45.185 + 45.186 +<!-- End of content --> 45.187 +</div> 45.188 + 45.189 +<!-- Footer. --> 45.190 +<div id="footer"> 45.191 + <div class="footer-right"></div> 45.192 + <a href="#top">Haut de la page</a> | 45.193 + <a href="index.html">Table des matières</a> 45.194 +</div> 45.195 + 45.196 +<div id="copy"> 45.197 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 45.198 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 45.199 + Documentation publiée sous 45.200 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 45.201 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 45.202 +</div> 45.203 + 45.204 +</body> 45.205 +</html>
46.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 46.2 +++ b/doc/handbook/network-config.html Sat Mar 29 12:01:05 2008 +0100 46.3 @@ -0,0 +1,420 @@ 46.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 46.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 46.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 46.7 +<head> 46.8 + <title>SliTaz Handbook - Network config</title> 46.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 46.10 + <meta name="description" content="DHCP ifconfig réseau sur SliTaz udhcpc masque passerelle 127.0.0.1 hostname IP fixe PPPOE" /> 46.11 + <meta name="expires" content="never" /> 46.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 46.13 + <meta name="publisher" content="www.slitaz.org" /> 46.14 + <meta name="author" content="Christophe Lincoln"/> 46.15 + <link rel="shortcut icon" href="favicon.ico" /> 46.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 46.17 +</head> 46.18 +<body bgcolor="#ffffff"> 46.19 + 46.20 +<!-- Header and quick navigation --> 46.21 +<div id="header"> 46.22 +<div align="right" id="quicknav"> 46.23 + <a name="top"></a> 46.24 + <a href="web-server.html">Serveur web</a> | 46.25 + <a href="index.html">Table des matières</a> 46.26 +</div> 46.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 46.28 +</div> 46.29 + 46.30 +<!-- Content. --> 46.31 +<div id="content"> 46.32 +<div class="content-right"></div> 46.33 + 46.34 +<h2><font color="#DF8F06">Configuration du réseau</font></h2> 46.35 + 46.36 +<ul> 46.37 + <li><a href="#about">A propos du réseau sur SliTaz.</a></li> 46.38 + <li><a href="#netbox">Netbox</a> - Configuration graphique du réseau.</li> 46.39 + <li><a href="#hostname">/etc/hostname</a> - Le nom de machine.</li> 46.40 + <li><a href="#network.conf">/etc/network.conf</a> - Fichier de 46.41 + configuration du réseau.</li> 46.42 + <li><a href="#dynamicIP">IP dynamique</a> - Client DHCP udhcpc.</li> 46.43 + <li><a href="#staticIP">IP static</a> - Utilisation d'un adresse fixe.</li> 46.44 + <li><a href="#pppoe">Connexion ADSL en pppoe kernel-mode.</a></li> 46.45 + <li><a href="#rp-pppoe">Connexion ADSL avec rp-pppoe.</a></li> 46.46 + <li><a href="#list">Liste des interfaces et des routes.</a></li> 46.47 + <li><a href="#firewall">Gestion du pare-feu</a> - (<em>firewall</em>).</li> 46.48 + <li><a href="web-server.html">Configuration du serveur web.</a></li> 46.49 + <li><a href="secure-shell.html">Gestion du serveur SSH.</a></li> 46.50 +</ul> 46.51 + 46.52 +<a name="about"></a> 46.53 +<h3><font color="#6c0023">A propos du réseau sur SliTaz</font></h3> 46.54 +<p> 46.55 +Par défaut SliTaz lance le client DHCP (udhcpc) sur eth0 lors du boot. Si 46.56 +votre carte réseau a bien été reconnue comme une interface eth0, et que vous 46.57 +utilisez un routeur, votre connexion devrait déjà fonctionner. C'est une 46.58 +configuration dynamique, à chaque démarrage du système le client DHCP obtient 46.59 +une nouvelle adresse IP depuis le serveur DHCP, qui est intégré au 46.60 +router, ou situé sur une autre machine. Pour changer la configuration par 46.61 +défaut vous devez passer par le fichier /etc/network.conf décrit ci-dessous. 46.62 +Pour les personnes utilisant <a href="#pppoe">PPPOE</a>, vous pouvez utiliser 46.63 +les outils fournis par <code>rp-pppoe</code> et installés par défaut sur SliTaz. 46.64 +</p> 46.65 + 46.66 +<a name="netbox"></a> 46.67 +<h3><font color="#6c0023">Netbox - Configuration graphique du réseau</font></h3> 46.68 +<p> 46.69 +Netbox est un petite interface graphique permettant de facilemnt configurer 46.70 +une interface réseau en utilisant le protocole DHCP ou en demandant une adresse 46.71 +IP fixe. Les onglets <em>DHCP</em> et <em>Staic IP</em> permettent de démarrer 46.72 +ou stopper la connexion et change automatiquement les valeurs dans les fichiers 46.73 +système. Netbox fournit aussi un onglet <em>System wide</em> depuis lequel 46.74 +vous pouvez directement éditer les fichiers de configuration système. Vous 46.75 +pouvez lancer Netbox depuis le menu Outils système (<em>System tools</em>) ou 46.76 +depuis un terminal graphique : 46.77 +</p> 46.78 +<pre> 46.79 + $ subox netbox 46.80 +</pre> 46.81 + 46.82 +<a name="hostname"></a> 46.83 +<h3><font color="#6c0023">/etc/hostname - Le nom de machine</font></h3> 46.84 +<p> 46.85 +Le fichier /etc/hostname configure le nom de la machine. Le nom de machine est 46.86 +chargé au démarrage du système avec la commande 'hostname'. Sans argument 46.87 +cette commande retournera le nom de machine actuel : 46.88 +</p> 46.89 +<pre> 46.90 + $ hostame 46.91 +</pre> 46.92 +<p> 46.93 +Pour changer le nom de machine vous pouvez utiliser la commande 46.94 +<code>echo</code> ou utiliser un des éditeurs de texte disponible sur SliTaz 46.95 +(il faut être <em>root</em>). Exemple avec <code>echo</code> et le nom 46.96 +de machine <code>kayam</code> : 46.97 +</p> 46.98 +<pre> 46.99 + # echo "kayam" > /etc/hostname 46.100 +</pre> 46.101 + 46.102 +<a name="network.conf"></a> 46.103 +<h3><font color="#6c0023">/etc/network.conf</font></h3> 46.104 +<p> 46.105 +Le fichier /etc/network.conf est le fichier de configuration du réseau sur 46.106 +votre système SliTaz. Sa syntaxe est simple, vous pouvez modifier son contenu 46.107 +avec un éditeur de texte tel que Nano. Le fichier /etc/network.conf est 46.108 +utilisé par le script /etc/init.d/network.sh pour configurer les interfaces 46.109 +réseau au démarrage du système. 46.110 +</p> 46.111 +<p> 46.112 +Le fichier de configuration du réseau (network.conf) vous permet de lancer ou 46.113 +non le client DHCP au boot. Vous pouvez aussi spécifier une adresse IP fixe 46.114 +avec son masque de sous réseau, la passerelle par défaut, et le serveur DNS à 46.115 +utiliser. 46.116 +</p> 46.117 + 46.118 +<a name="dynamicIP"></a> 46.119 +<h3><font color="#6c0023">IP dynamique - Client DHCP udhcpc</font></h3> 46.120 +<p> 46.121 +Le client DHCP udhcpc fourni avec Busybox utilise le script 46.122 +/usr/share/udhcpc/default.script pour obtenir une adresse IP dynamiquement 46.123 +au boot. Il supporte diverses options que vous pouvez connaître avec l'option 46.124 +<code>--help</code> : 46.125 +</p> 46.126 +<pre> 46.127 + # udhcpc --help 46.128 +</pre> 46.129 +<p> 46.130 +Pour ne pas lancer udhcpc sur eth0, ou modifier l'interface (ex: eth1) vous 46.131 +devez passer par le fichier /etc/network.conf, et spécifier "no" à 46.132 +la variable DHCP= : 46.133 +</p> 46.134 +<pre class="script"> 46.135 + 46.136 +# Dynamic IP address. 46.137 +# Enable/disable DHCP client at boot time. 46.138 +DHCP="no" 46.139 + 46.140 +</pre> 46.141 + 46.142 +<a name="staticIP"></a> 46.143 +<h3><font color="#6c0023">IP fixe - Utilisation d'un adresse spécifique</font></h3> 46.144 +<p> 46.145 +Vous pouvez spécifier une adresse IP fixe à configurer au démarrage du système, 46.146 +en mettant la valeur "yes" à la variable STATIC= : 46.147 +</p> 46.148 +<pre class="script"> 46.149 + 46.150 +# Static IP address. 46.151 +# Enable/disable static IP at boot time. 46.152 +STATIC="yes" 46.153 + 46.154 +</pre> 46.155 +<p> 46.156 +Pour que la configuration fonctionne, vous devez spécifier une adresse IP, 46.157 +son masque de sous réseau, la passerelle par défaut (gateway), et le serveur 46.158 +DNS à utiliser. Exemple : 46.159 +</p> 46.160 +<pre class="script"> 46.161 + 46.162 +# Set IP address, and netmask for a static IP. 46.163 +IP="192.168.0.6" 46.164 +NETMASK="255.255.255.0" 46.165 + 46.166 +# Set route gateway for a static IP. 46.167 +GATEWAY="192.168.0.1" 46.168 + 46.169 +# Set DNS server. for a static IP. 46.170 +DNS_SERVER="192.168.0.1" 46.171 + 46.172 +</pre> 46.173 + 46.174 +<a name="pppoe"></a> 46.175 +<h3><font color="#6c0023">Connexion internet ADSL en pppoe kernel-mode</font></h3> 46.176 +<p> 46.177 +Pré-requis: le support ppp et pppoe doit être activé dans le noyau (dur ou 46.178 +modules) et l'interface ethernet configurée. Vous devez indiquer à ppp 46.179 +d'utiliser le plugin rp-pppoe du noyau dans <code>/etc/ppp/options</code> : 46.180 +</p> 46.181 +<pre class="script"> 46.182 +plugin rp-pppoe.so 46.183 +name <votre identifiant de connexion FAI> 46.184 +noipdefault 46.185 +defaultroute 46.186 +mtu 1492 46.187 +mru 1492 46.188 +lock 46.189 +</pre> 46.190 +<p> 46.191 +Si vous avez compilé le support de votre carte réseau en module dans le noyau, 46.192 +vous devrez activer ce dernier dans /etc/rcS.conf: 46.193 +</p> 46.194 +<pre class="script"> 46.195 +LOAD_MODULES="<votre module>" 46.196 +</pre> 46.197 +<p> 46.198 +Modifier le fichier /etc/ppp/pap-secrets ou /etc/ppp/chap-secrets : 46.199 +</p> 46.200 +<pre class="script"> 46.201 +# client server secret IP addresses 46.202 +"votre_login_fai" * "mot_de_passe" 46.203 +</pre> 46.204 +<p> 46.205 +Les fichiers /etc/host.conf et /etc/resolv.conf devraient être automatiquement renseignés. 46.206 +C'est tout ! Pour vous connecter à internet, il suffit simplement de taper : 46.207 +</p> 46.208 +<pre> 46.209 +pppd eth0 46.210 +</pre> 46.211 + 46.212 +<a name="rp-pppoe"></a> 46.213 +<h3><font color="#6c0023">Connexion pppoe avec rp-pppoe</font></h3> 46.214 +<p> 46.215 +Pour configurer sa connexion internet ADSL via le protocole PPPOE, SliTaz 46.216 +fournit la suite d'utilitaires du paquet <code>rp-pppoe</code>. L'utilisation 46.217 +de <code>pppoe-setup</code> est un jeu d'enfant et vous permet de configurer 46.218 +rapidement le réseau. Si vous utilisez DHCP c'est encore plus facile, puisque 46.219 +c'est le serveur de votre FAI (Fournisseur d'accès internet) qui va s'occuper 46.220 +de tout. Si vous n'avez pas le DHCP vous devez commencer par désactiver son 46.221 +utilisation via la variable <code>DHCP="no"</code> du fichier de configuration 46.222 +<code>/etc/network.conf</code>. A noter que pour modifier des fichiers de 46.223 +configuration système et se connecter, vous devez devenir administrateur via 46.224 +la commande <code>su</code>. Pour installer rp-pppoe et changer la variable 46.225 +DHCP avec Nano (Ctrl + x pour sauver et quitter) : 46.226 +</p> 46.227 +<pre> 46.228 + $ su 46.229 + # tazpkg get-install rp-pppoe 46.230 + # nano /etc/network.conf 46.231 +</pre> 46.232 +<h4>Configurer avec pppoe-setup</h4> 46.233 +<p> 46.234 +Pour commencer à configurer votre connexion PPPOE, vous devez ouvrir un 46.235 +terminal X ou utiliser la console Linux pour lancer <code>pppoe-setup</code> 46.236 +et répondre aux questions : 46.237 +</p> 46.238 +<pre> 46.239 + # pppoe-setup 46.240 +</pre> 46.241 +<ol> 46.242 + <li>Tapez votre nom d'utilisateur. A noter qu'il s'agit du nom 46.243 + d'utilisateur avec lequel vous communiquez avec votre FAI, ils est 46.244 + différent de ceux du système, bien sûr.</li> 46.245 + <li>Interface internet, il s'agit par défaut de eth0 sauf si vous en avez 46.246 + plusieurs, auquel cas vous aurez eth1, eth2, etc.. généralement la touche 46.247 + <strong>entree</strong> suffit.</li> 46.248 + <li>Si vous avez un lien ADSL permanent répondez ici par 46.249 + <strong>oui</strong>, sinon par <strong>non</strong> (valeur par 46.250 + défaut).</li> 46.251 + <li>Spécifiez les DNS primaire et secondaire de votre FAI, il vous 46.252 + les communiquera, n'hésitez pas à les lui demander.</li> 46.253 + <li>Tapez le mot de passe avec lequel vous communiquez avec votre FAI, 46.254 + à noter que vous devrez le tapez deux fois.</li> 46.255 + <li>Choisir le firewall ou pare-feu en fonction de votre matériel, 46.256 + si vous avez un routeur vous pouvez entrer 2 sinon 1. En cas de doute 46.257 + tapez 1.</li> 46.258 +</ol> 46.259 +<h4>Démarrer et arrêter la connexion</h4> 46.260 +<p> 46.261 +Toujours en ligne de commande, il suffit de lancer <code>pppoe-start</code> 46.262 +pour démarrer la connexion. Quelques secondes puis le système vous dit qu'il 46.263 +est connecté. S'il vous donne un message du genre TIMED OUT c'est que vous 46.264 +avez mal configuré ou que les branchements sont défectueux. Revérifiez votre 46.265 +cablage et reprenez l'installation au début. Pour démarrer sa connexion : 46.266 +</p> 46.267 +<pre> 46.268 + # pppoe-start 46.269 +</pre> 46.270 +<p> 46.271 +Pour arrêter la connexion vous pouvez utiliser l'utilitaire 46.272 +<code>pppoe-stop</code>, toujours en ligne de commande. 46.273 +</p> 46.274 + 46.275 +<a name="list"></a> 46.276 +<h3><font color="#6c0023">Liste des interfaces et des routes</font></h3> 46.277 +<p> 46.278 +Vous pouvez lister les interfaces réseau disponibles avec la commande 46.279 +<code>ifconfig</code> suivie de l'option <code>-a</code>, ou afficher 46.280 +l'aide avec l'option <code>--help</code> : 46.281 +</p> 46.282 +<pre> 46.283 + # ifconfig -a 46.284 + # ifconfig --help 46.285 +</pre> 46.286 +<p> 46.287 +Pour afficher la table de routage IP du noyau vous pouvez utiliser la commande 46.288 +<code>route</code> sans arguments : 46.289 +</p> 46.290 +<pre> 46.291 + $ route 46.292 +</pre> 46.293 + 46.294 +<a name="firewall"></a> 46.295 +<h3><font color="#6c0023">Gestion du pare-feu (<em>firewall</em>)</font></h3> 46.296 +<p> 46.297 +SliTaz fourni un pare-feu très basic, les régles de sécurité du noyau sont 46.298 +lancées et les règles d'iptables sont désactivées par défaut. Vous pouvez 46.299 +activer/désactiver son éxécution au démarrage, et créer de nouvelles régles 46.300 +via le fichier de configuration : /etc/firewall.conf 46.301 +</p> 46.302 +<p> 46.303 +Le script du <em>firewall</em> fournit par défaut sur SliTaz, commence par 46.304 +configurer les options propre au noyau: les redirections ICMP, les sources de 46.305 +routage, log des adresses impossibles et les filtres contre le spoofing. Le 46.306 +script lance ensuite les règles d'Iptables définies dans la fonction 46.307 +<code>iptables_rules()</code> du fichier de configuration : /etc/firewall.conf 46.308 +</p> 46.309 +<p> 46.310 +Le <em>firewall</em> utilise l'application Iptables, il se compose de deux 46.311 +fichiers : Le fichier de configuration /etc/firewall.conf et le script 46.312 +/etc/init.d/firewall, que vous ne devriez pas avoir besoin de modifier. A 46.313 +noter qu'il y de nombreuses options avec Iptables, pour de plus amples 46.314 +informations, référez-vous à la documentation officielle de Netfilter/iptables 46.315 +disponible en ligne sur : 46.316 +<a href="http://www.netfilter.org/documentation/">www.netfilter.org/documentation/</a> 46.317 +</p> 46.318 +<h4>Démarrer, arrêter, redémarrer le firewall</h4> 46.319 +<p> 46.320 +Le script /etc/init.d/firewall vous permet de démarrer/redémarrer, d'arrêter 46.321 +et d'afficher le status du firewall. L'option redémarrer est souvent utilisée 46.322 +pour tester de nouvelles règles, après modification du fichier de 46.323 +configuration. Exemple : 46.324 +</p> 46.325 +<pre> 46.326 + # /etc/init.d/firewall restart 46.327 +</pre> 46.328 +<h4>Activer/désactiver le firewall au boot</h4> 46.329 +<p> 46.330 +Pour activer/désactiver les options de sécurité propre au noyau, mettez "yes" 46.331 +ou "no" à la variable KERNEL_SECURITY= : 46.332 +</p> 46.333 +<pre class="script"> 46.334 + 46.335 +# Enable/disable kernel security at boot time. 46.336 +KERNEL_SECURITY="yes" 46.337 + 46.338 +</pre> 46.339 +<p> 46.340 +Et pour activer/désactiver les règles d'iptables, il faut modifier la variable 46.341 +IPTABLES_RULES= : 46.342 +</p> 46.343 +<pre class="script"> 46.344 + 46.345 +# Enable/disable iptables rules. 46.346 +IPTABLES_RULES="yes" 46.347 + 46.348 +</pre> 46.349 +<h4>Ajouter, supprimer, ou modifier les règles d'iptables</h4> 46.350 +<p> 46.351 +fichier de configuration: /etc/firewall.conf. En bas du fichier vous trouverez 46.352 +fichier de configuration: /etc/firewall.conf. En bas du fichier vous touverez 46.353 +une fonction : <code>iptables_rules()</code> contenant toutes les commandes 46.354 +d'iptables à lancer lors du démarrage du firewall. Pour supprimer une règle, 46.355 +nous vous conseillons de commenter les lignes correspondantes avec : 46.356 +<code>#</code>. A noter qu'il ne faut pas laisser cette fonction vide, si 46.357 +vous voulez désactiver les règles d'iptables, il est préférable de mettre 46.358 +"no" à la variable IPTABLES_RULES= du fichier de configuration. 46.359 +</p> 46.360 +<p> 46.361 +Exemple de règles iptables. On refuse toutes les connexions entrantes, et 46.362 +sortantes, puis on accepte les connexions sur l'hôte local, le réseau local, 46.363 +les ports 80 et 22 utilisés respectivement par le serveur web HTTP et le 46.364 +serveur sécurisé SSH, et le port 21 pour le FTP. C'est donc très restrictif 46.365 +comme règles: 46.366 +</p> 46.367 +<pre class="script"> 46.368 + 46.369 +# Netfilter/iptables rules. 46.370 +# This shell function is include by /etc/init.d/firewall.sh 46.371 +# to start iptables rules. 46.372 +# 46.373 +iptables_rules() 46.374 +{ 46.375 + 46.376 +# Drop all connexions. 46.377 +iptables -P INPUT DROP 46.378 +iptables -P OUTPUT DROP 46.379 + 46.380 +# Accept all on localhost (127.0.0.1). 46.381 +iptables -A INPUT -i lo -j ACCEPT 46.382 +iptables -A OUTPUT -o lo -j ACCEPT 46.383 + 46.384 +# Accept all on the local network (192.168.0.0/24). 46.385 +iptables -A INPUT -s 192.168.0.0/24 -j ACCEPT 46.386 +iptables -A OUTPUT -d 192.168.0.0/24 -j ACCEPT 46.387 + 46.388 +# Accept port 80 for the HTTP server. 46.389 +iptables -A INPUT -i $INTERFACE -p tcp --sport 80 -j ACCEPT 46.390 +iptables -A OUTPUT -o $INTERFACE -p tcp --dport 80 -j ACCEPT 46.391 + 46.392 +# Accept port 22 for SSH. 46.393 +iptables -A INPUT -i $INTERFACE -p tcp --dport 22 -j ACCEPT 46.394 +iptables -A OUTPUT -o $INTERFACE -tcp --sport 22 -j ACCEPT 46.395 + 46.396 +# Accept port 21 for active FTP connections. 46.397 +iptables -A INPUT -i $INTERFACE -p tcp --dport 21 -j ACCEPT 46.398 +iptables -A OUTPUT -i $INTERFACE -p tcp --sport 21 -j ACCEPT 46.399 + 46.400 +} 46.401 + 46.402 +</pre> 46.403 + 46.404 +<!-- End of content --> 46.405 +</div> 46.406 + 46.407 +<!-- Footer. --> 46.408 +<div id="footer"> 46.409 + <div class="footer-right"></div> 46.410 + <a href="#top">Haut de la page</a> | 46.411 + <a href="index.html">Table des matières</a> 46.412 +</div> 46.413 + 46.414 +<div id="copy"> 46.415 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 46.416 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 46.417 + Documentation publiées sous 46.418 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 46.419 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 46.420 +</div> 46.421 + 46.422 +</body> 46.423 +</html>
47.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 47.2 +++ b/doc/handbook/network.html Sat Mar 29 12:01:05 2008 +0100 47.3 @@ -0,0 +1,195 @@ 47.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 47.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 47.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 47.7 +<head> 47.8 + <title>SliTaz Handbook - Template</title> 47.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 47.10 + <meta name="description" content="navigateur web links retawq client IRC téléchargement torrent" /> 47.11 + <meta name="expires" content="never" /> 47.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 47.13 + <meta name="publisher" content="www.slitaz.org" /> 47.14 + <meta name="author" content="Christophe Lincoln"/> 47.15 + <link rel="shortcut icon" href="favicon.ico" /> 47.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 47.17 +</head> 47.18 +<body bgcolor="#ffffff"> 47.19 + 47.20 +<!-- Header and quick navigation --> 47.21 +<div id="header"> 47.22 +<div align="right" id="quicknav"> 47.23 + <a name="top"></a> 47.24 + <a href="graphics.html">Graphisme</a> | 47.25 + <a href="index.html">Table des matières</a> 47.26 +</div> 47.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 47.28 +</div> 47.29 + 47.30 +<!-- Content. --> 47.31 +<div id="content"> 47.32 +<div class="content-right"></div> 47.33 + 47.34 +<h2><font color="#DF8F06">Internet</font></h2> 47.35 + 47.36 +<ul> 47.37 + <li><a href="#firefox">Mozilla Firefox</a> - Le navigateur Web Firefox.</li> 47.38 + <li><a href="#retawq">Retawq</a> - Navigateur Web en mode texte.</li> 47.39 + <li><a href="#links">Links</a> - Le navigateur Web Links fournit 47.40 + un mode graphique et un mode texte.</li> 47.41 + <li><a href="#rhapsody">Rhapsody</a> - Client de chat IRC.</li> 47.42 + <li><a href="#gitmail">Ghost In The Mail </a> - Client mail.</li> 47.43 + <li><a href="#transmission">Transmission</a> - Client BitTorrent léger.</li> 47.44 + <li><a href="#gftp">gFTP</a> - Client FTP simple et rapide.</li> 47.45 + <li><a href="#pscan">pscan</a> - Scanner de ports.</li> 47.46 + <li><a href="cmdline.html#wget">Télécharger en ligne de commandes.</a></li> 47.47 +</ul> 47.48 + 47.49 +<a name="firefox"></a> 47.50 +<h3><font color="#6c0023">Mozilla Firefox - Navigateur web</font></h3> 47.51 +<p> 47.52 +SliTaz est fier de fournir Mozilla Firefox, l'un des meilleurs navigateur Web 47.53 +au monde, sécurisé, convivial, rapide, respectant les standards, et largement 47.54 +personnalisable via un système de <em>plugins</em>. La prise en main du 47.55 +logiciel se fait rapidement et intuitivement, pour lancer Firefox sur SliTaz 47.56 +il suffit de séléctionner depuis le menu du gestionnaire de fenêtres ---> 47.57 +Internet --> Mozilla Firefox. Les fichiers de configuration du navigateur 47.58 +Web sont stockés dans le répertoire personnel, et cachés (commencent par un 47.59 +point) et se nomment <code>~/.mozilla/firefox</code>. 47.60 +</p> 47.61 +<p> 47.62 +Astuces : En associant le mode LiveCD à un media USB (<em>flash key</em>), 47.63 +vous garderez vos marques pages et <em>plugins</em> partout ou vous allez. 47.64 +</p> 47.65 +<a name="retawq"></a> 47.66 +<h3><font color="#6c0023">Retawq - Navigateur web</font></h3> 47.67 +<p> 47.68 +Toutes les versions de SliTaz fournissent le navigateur web Retawq en mode texte. 47.69 +Vous pouvez lancer 'retawq' depuis la console, un terminal graphique, ou sous X 47.70 +depuis le menu ---> Internet --> Retawq. Pour lancer Retawq depuis un 47.71 +terminal, il suffit de taper <code>retawq</code> avec ou sans l'url : 47.72 +</p> 47.73 +<pre> 47.74 + $ retawq 47.75 + $ retawq <a href="http://www.slitaz.org/">http://www.slitaz.org/</a> 47.76 +</pre> 47.77 +<p> 47.78 +Le fichier de configuration personnel est dans ~/.retawq. Vous 47.79 +pouvez le modifier avec un éditeur de texte. En appuyant sur 47.80 +la touche <b> vous afficherez le fichier des marques pages 47.81 +(bookmarks.html), et la touche <h> affichera la page d'accueil. 47.82 +</p> 47.83 +<a name="links"></a> 47.84 +<h3><font color="#6c0023">Links - Navigateur web graphique et texte</font></h3> 47.85 +<p> 47.86 +Links a été le premier navigateur Web graphique proposé sur le LiveCD de 47.87 +SliTaz, il a été depuis remplaçé par Firefox, mais Links est toujours 47.88 +disponible sous forme de paquet, facilement installable via la commande : 47.89 +</p> 47.90 +<pre> 47.91 + # tazpkg get-install links 47.92 +</pre> 47.93 +<p> 47.94 +Links propose un mode graphique et un mode texte. Pour utiliser Links en 47.95 +mode graphique il faut utiliser l'option <code>-g</code>, vous pouvez ajouter 47.96 +un icône ou une entrée au menu de <a href="jwm.html">JWM</a> pour retrouver 47.97 +Links facilement. Exemples d'utilisation en ligne de commandes : 47.98 +</p> 47.99 +<pre> 47.100 + $ links -g & 47.101 + $ links -g <a href="http://www.slitaz.org/">http://www.slitaz.org/</a> & 47.102 + $ links 47.103 +</pre> 47.104 +<p> 47.105 +Les fichiers de configuration personnels sont dans ~/.links et il n'est pas 47.106 +conseillé de les modifier avec un éditeur de texte. Links fournit une interface 47.107 +de configuration via la barre d'outils du haut, c'est là que vous pouvez 47.108 +configurer la langues pour le français, les marques pages, l'affichage, etc. 47.109 +Quand vous avez modifié des options, il faut les sauvegarder via la barre de 47.110 +menu --> Configuration --> Enregistrer les options. 47.111 +</p> 47.112 +<a name="rhapsody"></a> 47.113 +<h3><font color="#6c0023">Rhapsody - Client de chat IRC</font></h3> 47.114 +<p> 47.115 +Pour lancer Rhapsody, vous pouvez utiliser la console, le terminal graphique, 47.116 +ou sous X depuis le menu. Pour vous connecter au serveur de TuxFamily, vous 47.117 +pouvez utiliser la commande ci-dessous, en modifiant votre pseudo. Une fois 47.118 +connecté vous pouvez utiliser la commande IRC: /join pour joindre le canal 47.119 +nommé #tuxfamily : 47.120 +</p> 47.121 +<pre> 47.122 + $ rhapsody 47.123 + /connect irc.tuxfamily.org 47.124 + /join #tuxfamily 47.125 +</pre> 47.126 +<p> 47.127 +Vous pouvez personnaliser rhapsody via le fichier ~/.rhapsodyrc, ou 47.128 +utiliser <Ctrl+T> pour afficher les options. 47.129 +</p> 47.130 +<a name="gitmail"></a> 47.131 +<h3><font color="#6c0023">Ghost In The Mail - Client mail</font></h3> 47.132 +<p> 47.133 +Pour envoyer rapidement des mails, sans devoir configurer de compte, vous 47.134 +pouvez utiliser Ghost In The Mail (gitmail). Ce client mail minimum, propose 47.135 +une interface GTK simple, avec le support des pièces jointes. Il vous permet 47.136 +d'envoyer des mails en utilisant le protocole SMTP avec votre compte de 47.137 +messagerie existant. Vous trouverez gitmail via le menu --> Internet 47.138 +--> Ghost In The Mail. 47.139 +</p> 47.140 +<a name="transmission"></a> 47.141 +<h3><font color="#6c0023">Transmission - Client BitTorrent léger</font></h3> 47.142 +<p> 47.143 +Transmission est un client BitTorrent, rapide, léger, et proposant une 47.144 +interface GTK+ simple d'utilisation. Transmission offre une option 47.145 +"Préférences" qui permet de limiter le taux d'uploads et de 47.146 +downloads, le port à utiliser, le dossier de téléchargement, et de gérer 47.147 +les copies de vos fichiers torrents. Vous trouverez le client GTK+ via le menu 47.148 +--> Internet --> Transmission. Site web du projet : 47.149 +<a href="http://transmission.m0k.org/">http://transmission.m0k.org/</a> 47.150 +</p> 47.151 +<a name="gftp"></a> 47.152 +<h3><font color="#6c0023">gFTP - Client FTP simple et rapide</font></h3> 47.153 +<p> 47.154 +L'application gFTP est un client de transfert FTP très simple d'utilisation, 47.155 +rapide et ergonomique. Il dispose de la reprise des transferts interrompus, 47.156 +d'une gestion complète des signets (sites favoris), ou encore de la gestion 47.157 +des proxies FTP et HTTP. De plus gFTP permet le glisser déposer entre ses 47.158 +deux fenêtres, de faire plusieurs transferts en même temps, de comparer ses 47.159 +deux fenêtres, de mémoriser les mots de passes, de définir une application 47.160 +externe pour la visualisation (ex Links) et l'édition des fichiers (ex Geany), 47.161 +ce qui permet de travailler directement sur le serveur. Sur SliTaz vous 47.162 +trouverez gFTP via le menu du gestionnaire de fenêtres --> Internet --> 47.163 +gFTP. 47.164 +</p> 47.165 + 47.166 +<a name="pscan"></a> 47.167 +<h3><font color="#6c0023">pscan - Scanner de ports</font></h3> 47.168 +<p> 47.169 +Pscan est un petit utiliatire du projet Busybox, permettant de scanner les 47.170 +ports d'un machine. Vous pouvez utiliser <code>pscan</code> pour scanner 47.171 +l'hôte local ou un hôte distant, en utilisant le nom ou l'adresse IP de la 47.172 +machine. Pscan va tester tous les ports de 1 à 1024 et afficher une liste 47.173 +de ceux qui sont ouvert, le protocole et le service associé (ssh, www, etc) : 47.174 +</p> 47.175 +<pre> 47.176 + $ pscan localhost 47.177 +</pre> 47.178 + 47.179 +<!-- End of content --> 47.180 +</div> 47.181 + 47.182 +<!-- Footer. --> 47.183 +<div id="footer"> 47.184 + <div class="footer-right"></div> 47.185 + <a href="#top">Haut de la page</a> | 47.186 + <a href="index.html">Table des matières</a> 47.187 +</div> 47.188 + 47.189 +<div id="copy"> 47.190 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 47.191 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 47.192 + Documentation publiées sous 47.193 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 47.194 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 47.195 +</div> 47.196 + 47.197 +</body> 47.198 +</html>
48.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 48.2 +++ b/doc/handbook/office.html Sat Mar 29 12:01:05 2008 +0100 48.3 @@ -0,0 +1,120 @@ 48.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 48.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 48.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 48.7 +<head> 48.8 + <title>SliTaz Handbook - Bureautique</title> 48.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 48.10 + <meta name="description" content="éditeur de texte base de donné lecteur PDF" /> 48.11 + <meta name="expires" content="never" /> 48.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 48.13 + <meta name="publisher" content="www.slitaz.org" /> 48.14 + <meta name="author" content="Christophe Lincoln"/> 48.15 + <link rel="shortcut icon" href="favicon.ico" /> 48.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 48.17 +</head> 48.18 +<body bgcolor="#ffffff"> 48.19 + 48.20 +<!-- Header and quick navigation --> 48.21 +<div id="header"> 48.22 +<div align="right" id="quicknav"> 48.23 + <a name="top"></a> 48.24 + <a href="network.html">Internet</a> | 48.25 + <a href="index.html">Table des matières</a> 48.26 +</div> 48.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 48.28 +</div> 48.29 + 48.30 +<!-- Content. --> 48.31 +<div id="content"> 48.32 +<div class="content-right"></div> 48.33 + 48.34 +<h2><font color="#DF8F06">Bureautique</font></h2> 48.35 + 48.36 +<ul> 48.37 + <li><a href="#abiword">Abiword</a> - Traitement de texte.</li> 48.38 + <li><a href="#osmo">Osmo</a> - Organiseur personnel.</li> 48.39 + <li><a href="#sqlite">SQLite</a> - Petit moteur de base de données SQL.</li> 48.40 + <li><a href="#epdfview">ePDFView</a> - Visualisateur léger de PDF.</li> 48.41 +</ul> 48.42 + 48.43 +<a name="abiword"></a> 48.44 +<h3><font color="#6c0023">Abiword - Traitement de texte</font></h3> 48.45 +<p> 48.46 +Abiword est une application de traitement de texte très riche en fonctionnalités. 48.47 +C'est un outils léger, rapide, simple et intuitif, proposant sont propore 48.48 +format (.abw) supportant les formats OpenOffice et Microsoft Word et peut 48.49 +exporter en HTML ou PDF. Pour installer Abiword sur SliTaz il suffit de lancer : 48.50 +</p> 48.51 +<pre> 48.52 + # tazpkg get-install abiword 48.53 +</pre> 48.54 + 48.55 +<a name="osmo"></a> 48.56 +<h3><font color="#6c0023">Osmo - Organiseur personnel</font></h3> 48.57 +<p> 48.58 +Osmo est un petit organisateur personnel fournissant un calendrier, une liste 48.59 +des tâches et des contact avec la possibilité d'ouvrir directement un 48.60 +navigateur Web ou un client de messagerie via un clique un URL ou une adresse 48.61 +email. Osmo propose aussi un calendrier de l'année, un calcultaeur de date et 48.62 +la possibilité de prendre des notes classées par jours. Osmo est installé par 48.63 +défaut sur la version standard du LiveCD avec une icône sur la barre des tâches 48.64 +et une entrée dans le la catégorie <em>Office</em> du menu de JWM. A 48.65 +noter que si vous utilisé un media USB associé au LiveCD, vous retrouverez vos 48.66 +données à chaque utilisation. Si vous avez un système installé, vous pouvez 48.67 +synchroniser les données du media USB avec celles de votre système en utilisant 48.68 +par exemple Grsync. Osmo conserve vos données dans le répertoire caché : 48.69 +<code>~/.osmo</code>. 48.70 +</p> 48.71 + 48.72 +<a name="sqlite"></a> 48.73 +<h3><font color="#6c0023">SQLite - Petit moteur de base de données SQL</font></h3> 48.74 +<p> 48.75 +SQLite est un petit moteur de base de données relationnelles SQL dont la base 48.76 +de données entière est stockée dans un seul fichier, il est performant, il 48.77 +offre une grande rapidité d'exécution des requêtes, de plus il implémente la 48.78 +plus part de la norme SQL92. SQLite est idéal pour gérer de petits sites web 48.79 +tout en nécessitant un déploiement minimal. En mode graphique, vous pouvez 48.80 +lancer SQLite depuis le menu du gestionnaire de fenêtres JWM. Le site web 48.81 +officiel du projet est : 48.82 +<a href="http://www.sqlite.org/">http://www.sqlite.org/</a> 48.83 +</p> 48.84 + 48.85 +<a name="epdfview"></a> 48.86 +<h3><font color="#6c0023">ePDFView - Visualisateur léger de PDF</font></h3> 48.87 +<p> 48.88 +Pour lire des documents PDF, SliTaz propose le paquet <code>epdfview</code>, 48.89 +fournissant un visualisateur PDF léger, rapide et simple à prendre en main. 48.90 +ePDFView utilise les bibliothèque de rendu Poppler, propose une interface 48.91 +GTK+ intuitive vous permettant agrandir, de passer d'une page à l'autre, 48.92 +d'afficher l'index ou encore de faire une recherche. Pour installer ePDFView : 48.93 +</p> 48.94 +<pre> 48.95 + # tazpkg get-install epdfview 48.96 +</pre> 48.97 +<p> 48.98 +Une fois unstallé vous pouvez ajouter une entrée au menu du gestionnaire de 48.99 +fenêtre <a href="jwm.html">JWM</a>, par exemple dans la catégorie 48.100 +<em>Office</em>. Si vous utilisez Enlightenment l'application aura 48.101 +automatiquement une entrée dans le menu Bureautique (<em>Office</em>) 48.102 +</p> 48.103 + 48.104 +<!-- End of content --> 48.105 +</div> 48.106 + 48.107 +<!-- Footer. --> 48.108 +<div id="footer"> 48.109 + <div class="footer-right"></div> 48.110 + <a href="#top">Haut de la page</a> | 48.111 + <a href="index.html">Table des matières</a> 48.112 +</div> 48.113 + 48.114 +<div id="copy"> 48.115 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 48.116 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 48.117 + Documentation publiées sous 48.118 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 48.119 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 48.120 +</div> 48.121 + 48.122 +</body> 48.123 +</html>
49.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 49.2 +++ b/doc/handbook/packages.html Sat Mar 29 12:01:05 2008 +0100 49.3 @@ -0,0 +1,182 @@ 49.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 49.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 49.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 49.7 +<head> 49.8 + <title>SliTaz Handbook - Paquets logiciels</title> 49.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 49.10 + <meta name="description" content="slitaz tazpkg package paquets logiciel précompilés" /> 49.11 + <meta name="expires" content="never" /> 49.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 49.13 + <meta name="publisher" content="www.slitaz.org" /> 49.14 + <meta name="author" content="Christophe Lincoln"/> 49.15 + <link rel="shortcut icon" href="favicon.ico" /> 49.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 49.17 +</head> 49.18 +<body bgcolor="#ffffff"> 49.19 + 49.20 +<!-- Header and quick navigation --> 49.21 +<div id="header"> 49.22 +<div align="right" id="quicknav"> 49.23 + <a name="top"></a> 49.24 + <a href="security.html">Sécurité du système</a> | 49.25 + <a href="index.html">Table des matières</a> 49.26 +</div> 49.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 49.28 +</div> 49.29 + 49.30 +<!-- Content. --> 49.31 +<div id="content"> 49.32 +<div class="content-right"></div> 49.33 + 49.34 +<h2><font color="#DF8F06">Gestion des paquets</font></h2> 49.35 + 49.36 +<ul> 49.37 + <li><a href="#tazpkg">Gestionnaire de paquet Tazpkg.</a></li> 49.38 + <li><a href="#packages-intro">C'est quoi des paquets ?</a></li> 49.39 + <li><a href="#commands">Commandes principales.</a></li> 49.40 + <li> 49.41 + <a href="http://www.slitaz.org/doc/manuals/tazpkg.html">Tazpkg manuel</a> 49.42 + - Sur un système SliTaz le manuel de Tazpkg se trouvent dans le répertoire 49.43 + /usr/share/doc/tazpkg, disponible au format xHTML, vous pouvez directement 49.44 + le consulter via l'entrée Documentation du menu du gestionnaire de fenêtre 49.45 + JWM.</li> 49.46 +</ul> 49.47 + 49.48 +<a name="tazpkg"></a> 49.49 +<h3><font color="#6c0023">Gestionnaire de paquet Tazpkg</font></h3> 49.50 +<p> 49.51 +Ce chapître décrit la gestion des paquets (.tazpkg) sur votre système. SliTaz 49.52 +fournit <code>tazpkg</code>, c'est une petite application gérant les paquets 49.53 +SliTaz portant l'extension <code>.tazpkg</code>. Le gestionnaire de paquets 49.54 +vous permet de lister les paquets installés, d'afficher une courte description 49.55 +du paquet, d'en installer de nouveaux depuis le Web, d'en désintaller, ou encore 49.56 +d'extraire un paquet dans un répertoire donné. 49.57 +Tazpkg a été créé pour SliTaz, il est écrit en script SHell depuis rien 49.58 +(<em>from scratch</em>). De plus, il propose une gestion des dépendances et 49.59 +un système de mises à jour de tous les paquets installés. 49.60 +</p> 49.61 +<p> 49.62 +Pour utiliser les commandes de <code>tazpkg</code> touchant au système , vous 49.63 +devez avoir un accès administrateur (root), vous pouvez utiliser 49.64 +<code>su</code> suivi du mot de passe root. Lancé sans arguments <code>tazpkg</code> 49.65 +affichera une petite aide, avec une liste des commandes possibles, vous pouvez 49.66 +aussi utiliser la commande <code>usage</code> pour afficher cette aide. 49.67 +</p> 49.68 + 49.69 +<h4>Fonctionnement de Tazpkg</h4> 49.70 +<p> 49.71 +Tazpkg utilise quelques répertoires et fichiers pour puiser des informations 49.72 +et stocker les paquets téléchargés en cache. Pour connaître le miroir depuis 49.73 +lequel les paquets doivent être télécharger, Tazpkg lit le fichier texte : 49.74 +/var/lib/tazpkg/mirror contenant simplement l'URL sur une ligne. Pour 49.75 +connaître la liste des paquets disponibles, Tazpkg télécharge et lit un 49.76 +fichier nommé packages.list (ce fichier peut aussi être lu en ligne via un 49.77 +navigateur web). Pour connaître les informations au sujet des paquets 49.78 +installés sur le système, Tazpkg scrute le contenu du répertoire : 49.79 +/var/lib/tazpkg/installed. Ce répertoire réunit tous les meta fichiers 49.80 +d'informations sur les paquets. Ces meta fichiers, quand à eux, contiennent 49.81 +toutes les données utiles pour installer/désinstaller un paquet, lister les 49.82 +fichiers installés ou encore afficher une brève description. 49.83 +</p> 49.84 + 49.85 +<a name="packages-intro"></a> 49.86 +<h3><font color="#6c0023">C'est quoi des paquets ?</font></h3> 49.87 +<p> 49.88 +Dans le monde GNU/Linux et open source en général, les logiciels sont appelés 49.89 +des paquets (<em>packages</em>). Les développeurs de ces paquets distribuent leur 49.90 +travail sous forme de fichiers contenant le code source, ces fichiers sont au 49.91 +format text et peuvent se lire avec un simple éditeur de texte, le code est 49.92 +donc ouvert (<em>open source</em>). 49.93 +</p> 49.94 +<p> 49.95 +Pour que ce code source fonctionne sur un ordinnateur, il faut qu'il soit 49.96 +compilé ou construit, afin de produire un ou des fichiers binaires que la 49.97 +machine sait utiliser. Les binaires sont des séquences de 0 et 1. Pour vous 49.98 +éviter de compiler le code source des applications, les distributions GNU/Linux 49.99 +ou BSD, vous proposent un système de paquets précompilés et prêts à fonctionner. 49.100 +Ces paquets précompilés sont facilement installables via une seule commande ou 49.101 +quelques manipulations à la souris, plusieurs distributions ont créé leur 49.102 +propre format de paquets binaires telles que Debian, RedHat ou Gentoo. 49.103 +SliTaz fournit les outils minimaux pour manipuler des paquets Debian (.deb) 49.104 +et RedHat (.rmp), ces outils sont propulsés par Busybox et ne sont pas aussi 49.105 +puissant que les originaux. 49.106 +</p> 49.107 +<p> 49.108 +SliTaz a créé son propre format de paquet (.tazpkg), simple, rapide, utilisant 49.109 +un minimum de dépendances et surtout ultra léger. Le format des paquets est aussi 49.110 +spécifique à SliTaz. La gestionairre de paquet permet d'avoir le contrôle sur 49.111 +tous les fichiers installés et leur version, ce qui permet une maintenance plus 49.112 +simple et une mise à jour automatique des paquets. Si vous compilez vos propres 49.113 +paquets depuis les sources de manière traditionnelle, vous serez obligé de 49.114 +recompiler pour avoir une nouvelle version et vous devrez surveiller en amont, 49.115 +pour chaque nouvelle version. Cela dit, SliTaz offre la possibilité d'installer 49.116 +des paquets sources de manière semi-automatisée, via l'utilisation de 49.117 +<a href="http://www.slitaz.org/doc/cookbook/wok-tools.html">Tazwok</a>, notez 49.118 +que c'est plutôt destiné à un public averti et que les mises à jour ne sont 49.119 +pas fournies pour ce genre de paquets. 49.120 +</p> 49.121 + 49.122 +<a name="commands"></a> 49.123 +<h2><font color="#DF8F06">Commandes principales</font></h2> 49.124 +<p> 49.125 +Le gestionnaire de paquet Tazpkg est un outil en ligne de commandes, il a été 49.126 +conçu pour être simple et rapide à prendre en main. Toutes les commandes sont 49.127 +décrites dans <a href="http://www.slitaz.org/doc/manuals/tazpkg.html" 49.128 +>le manuel du gestionnaire de paquet</a>. Pour commencer il vous suffit de 49.129 +connaître le nom du gestionnaire de paquet : <code>tazpkg</code>. Lancé sans 49.130 +arguments, tazpkg va afficher une liste des commandes disponibles avec une 49.131 +courte description. 49.132 +</p> 49.133 + 49.134 +<h4>Garder un système à jour</h4> 49.135 +<p> 49.136 +Il y deux commandes qui devraient être lancées régulièrement par 49.137 +l'administrateur (root). La commande qui recharge la dernière liste des paquets 49.138 +et celle qui met à jour tous les paquets installés. Cela permet de garder un 49.139 +système plus sécurisé et d'avoir les dernières nouveautés. Pour recharger la 49.140 +liste c'est <code>recharge</code> et pour mettre à jour <code>upgrade</code>, 49.141 +vous pouvez lancer ces deux commandes sur la même ligne et utiliser le 49.142 +copier/coller dans un terminal : 49.143 +</p> 49.144 +<pre> 49.145 + # tazpkg recharge && tazpkg upgrade 49.146 +</pre> 49.147 + 49.148 +<h4>Installer des paquets</h4> 49.149 +<p> 49.150 +Le gestionnaire de paquet vous permet d'installer de nombreux paquets pour 49.151 +ajouter des fonctionnalités au système ou de disposer d'applications 49.152 +supplémentaires. La manière la plus courante d'installer un paquet est 49.153 +d'utiliser la commande <code>get-install</code> qui va télécharger, installer, 49.154 +vérifier les dépendances sur le paquet et cela de manière automatique. Pour 49.155 +installer un paquet vous devez connaître le nom du paquet. Pour vous aider à 49.156 +trouver le nom d'un paquet, vous pouvez utiliser la commande de recherhe 49.157 +<code>search</code> ou afficher la liste complète des paquets disponibles sur 49.158 +le miroir via la commande <code>list-mirror</code>. Pour installer le client 49.159 +de messagerie Sylpheed, il faudra par exemple lancer : 49.160 +</p> 49.161 +<pre> 49.162 + # tazpkg get-install sylpheed 49.163 +</pre> 49.164 + 49.165 + 49.166 +<!-- End of content --> 49.167 +</div> 49.168 + 49.169 +<!-- Footer. --> 49.170 +<div id="footer"> 49.171 + <div class="footer-right"></div> 49.172 + <a href="#top">Haut de la page</a> | 49.173 + <a href="index.html">Table des matières</a> 49.174 +</div> 49.175 + 49.176 +<div id="copy"> 49.177 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 49.178 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 49.179 + Documentation publiées sous 49.180 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 49.181 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 49.182 +</div> 49.183 + 49.184 +</body> 49.185 +</html>
50.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 50.2 +++ b/doc/handbook/secure-shell.html Sat Mar 29 12:01:05 2008 +0100 50.3 @@ -0,0 +1,145 @@ 50.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 50.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 50.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 50.7 +<head> 50.8 + <title>SliTaz Handbook - Template</title> 50.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 50.10 + <meta name="description" content="SSH dropbear scp admin distance sécurisé" /> 50.11 + <meta name="expires" content="never" /> 50.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 50.13 + <meta name="publisher" content="www.slitaz.org" /> 50.14 + <meta name="author" content="Christophe Lincoln"/> 50.15 + <link rel="shortcut icon" href="favicon.ico" /> 50.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 50.17 +</head> 50.18 +<body bgcolor="#ffffff"> 50.19 + 50.20 +<!-- Header and quick navigation --> 50.21 +<div id="header"> 50.22 +<div align="right" id="quicknav"> 50.23 + <a name="top"></a> 50.24 + <a href="system-tools.html">Outils système</a> | 50.25 + <a href="index.html">Table des matières</a> 50.26 +</div> 50.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 50.28 +</div> 50.29 + 50.30 +<!-- Content. --> 50.31 +<div id="content"> 50.32 +<div class="content-right"></div> 50.33 + 50.34 +<h2><font color="#DF8F06">SHell sécurisé (SSH)</font></h2> 50.35 + 50.36 +<ul> 50.37 + <li><a href="#about">A propos de Dropbear.</a></li> 50.38 + <li><a href="#dbclient">Connexion à un hôte distant</a> - (dbclient).</li> 50.39 + <li><a href="#scp">Transfert de fichier à distance</a> - (scp).</li> 50.40 + <li><a href="#dropbearkey">Générer des clés rsa et/ou dss</a> - (dropbearkey).</li> 50.41 + <li><a href="#start-stop-restart">Démarrer, arrêter, redémarrer le serveur 50.42 + SSH.</a></li> 50.43 +</ul> 50.44 + 50.45 +<a name="about"></a> 50.46 +<h3><font color="#6c0023">A propos de Dropbear</font></h3> 50.47 +<p> 50.48 +Contrôle et administration à distance avec Dropbear et le protocole sécurisé 50.49 +SSH. Dropbear est un petit client et serveur sécurisé, supportant le protocole 50.50 +SSH 2. Dropbear est compatible avec OpenSSH et utilise ~/.ssh/authorized_keys 50.51 +pour la gestion des clés publiques. Dropbear fournit aussi une version de 50.52 +<code>scp</code>, permettant la copie de fichiers entre des machines distantes 50.53 +manière sécurisée. 50.54 +</p> 50.55 +<p> 50.56 +Site web du projet : 50.57 +<a href="http://matt.ucc.asn.au/dropbear/dropbear.html" 50.58 +>matt.ucc.asn.au/dropbear/dropbear.html</a> 50.59 +</p> 50.60 +<a name="dbclient"></a> 50.61 +<h3><font color="#6c0023">Connexion à un hôte distant avec dbclient</font></h3> 50.62 +<p> 50.63 +Les fichiers de configuration pour le client SSH sont dans ~/.ssh de chaque 50.64 +répertoire utilisateur, il contient les fichiers authorized_keys et 50.65 +known_hosts. Le répertoire ~/.ssh et le fichier known_hosts, sont créés 50.66 +automatiquement la première fois que vous lancez le client sécurisé. 50.67 +</p> 50.68 +<p> 50.69 +Pour se connecter à un hôte distant avec son nom d'utilisateur et le nom de 50.70 +machine, vous pouvez utiliser la commande : 50.71 +</p> 50.72 +<pre> 50.73 + $ dbclient utilisateur@machine.org 50.74 +</pre> 50.75 +<p> 50.76 +Vous pouvez aussi utiliser l'adresse IP de la machine : 50.77 +</p> 50.78 +<pre> 50.79 + $ dbclient user@192.168.0.2 50.80 +</pre> 50.81 +<a name="scp"></a> 50.82 +<h3><font color="#6c0023">Transfert de fichier à distance avec scp</font></h3> 50.83 +<p> 50.84 +Pour copier un fichier de votre ordinateur à un autre, scp s'utilse de 50.85 +la manière suivante. Pour copier un fichier se nommant page.html vers un 50.86 +répertoire de l'utilisateur. Ne pas oublier les <code>:</code> après le 50.87 +nom de machine ou l'adresse IP : 50.88 +</p> 50.89 +<pre> 50.90 + $ scp page.html user@machine.org:dossier/sous-dossier 50.91 +</pre> 50.92 +<p> 50.93 +Copier un fichier d'une machine distante vers la vôtre : 50.94 +</p> 50.95 +<pre> 50.96 + $ scp user@machine.org:dossier/sous-dossier/page.html /dossier/votre/machine 50.97 +</pre> 50.98 +<a name="dropbearkey"></a> 50.99 +<h3><font color="#6c0023">Générer des clés rsa et/ou dss avec dropbearkey</font></h3> 50.100 +<p> 50.101 +Dropbear fournit <code>dropbearkey</code> pour générer des clés sécurisées rsa 50.102 +et dss. A noter que quand vous démarrez le serveur pour la première fois, des 50.103 +clés sécurisées seront générées automatiquement si elles n'existent pas. Vous 50.104 +pouvez utiliser <code>dropbearkey</code> avec les aruments ci-dessous : 50.105 +</p> 50.106 +<pre> 50.107 + # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key 50.108 + # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key 50.109 +</pre> 50.110 +<a name="start-stop-restart"></a> 50.111 +<h3><font color="#6c0023">Démarrer, arrêter, redémarrer le serveur SSH</font></h3> 50.112 +<p> 50.113 +Par défaut SliTaz ne lance pas le serveur SSH au démarrage du système, pour 50.114 +qu'il soit lancé automatiquement, il faut ajouter <code>dropbear</code> à la 50.115 +variable RUN_DAEMONS du fichier <code>/etc/rcS.conf</code>. Pour démarrer, 50.116 +arrêter, redémarrer le serveur SSH vous pouvez utiliser la commande : 50.117 +<code>/etc/init.d/dropbear [start|stop|restart]</code>. Exemple pour démarrer 50.118 +le serveur : 50.119 +</p> 50.120 +<pre> 50.121 + # /etc/init.d/dropbear start 50.122 +</pre> 50.123 +<p> 50.124 +A noter que le serveur supporte différentes options à lui passer lors de son 50.125 +lancement. Pour modifier les valeurs par défaut il suffit de modifier le 50.126 +fichier de configuration des démons : <code>/etc/daemons.conf</code>. 50.127 +</p> 50.128 + 50.129 +<!-- End of content --> 50.130 +</div> 50.131 + 50.132 +<!-- Footer. --> 50.133 +<div id="footer"> 50.134 + <div class="footer-right"></div> 50.135 + <a href="#top">Haut de la page</a> | 50.136 + <a href="index.html">Table des matières</a> 50.137 +</div> 50.138 + 50.139 +<div id="copy"> 50.140 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 50.141 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 50.142 + Documentation publiées sous 50.143 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 50.144 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 50.145 +</div> 50.146 + 50.147 +</body> 50.148 +</html>
51.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 51.2 +++ b/doc/handbook/security.html Sat Mar 29 12:01:05 2008 +0100 51.3 @@ -0,0 +1,146 @@ 51.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 51.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 51.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 51.7 +<head> 51.8 + <title>SliTaz Handbook - Sécurité du système</title> 51.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 51.10 + <meta name="description" content="secure root passwd user services ports" /> 51.11 + <meta name="expires" content="never" /> 51.12 + <meta name="modified" content="2007-12-12 22:00:00" /> 51.13 + <meta name="publisher" content="www.slitaz.org" /> 51.14 + <meta name="author" content="Christophe Lincoln"/> 51.15 + <link rel="shortcut icon" href="favicon.ico" /> 51.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 51.17 +</head> 51.18 +<body bgcolor="#ffffff"> 51.19 + 51.20 +<!-- Header and quick navigation --> 51.21 +<div id="header"> 51.22 +<div align="right" id="quicknav"> 51.23 + <a name="top"></a> 51.24 + <a href="chroot-env.html">Environnement chrooté</a> | 51.25 + <a href="index.html">Table des matières</a> 51.26 +</div> 51.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 51.28 +</div> 51.29 + 51.30 +<!-- Content. --> 51.31 +<div id="content"> 51.32 +<div class="content-right"></div> 51.33 + 51.34 +<h2><font color="#DF8F06">SliTaz et la sécurité du système</font></h2> 51.35 + 51.36 +<ul> 51.37 + <li><a href="#policy">Politique de sécurité.</a></li> 51.38 + <li><a href="#root">Root</a> - L'administrateur système.</li> 51.39 + <li><a href="#busybox">Busybox</a> - Configuration du fichier /etc/busybox.conf</li> 51.40 + <li><a href="#ssh">Serveur SSH</a> - Options conseillées.</li> 51.41 + <li><a href="network-config.html#firewall">Firewall Netfilter</a> - 51.42 + Le pare-feu réseau.</li> 51.43 + <li><a href="web-apps.html#pscan">Pscan</a> - Vérifier les ports ouverts 51.44 + ou fermés.</li> 51.45 +</ul> 51.46 + 51.47 +<a name="policy"></a> 51.48 +<h3><font color="#6c0023">Politique de sécurité</font></h3> 51.49 +<p> 51.50 +SliTaz porte une grande attention à la sécurité du système. Les applications 51.51 +sont testées de nombreux mois avant d'être inclues dans la distribution. Lors 51.52 +du boot, un minimum de services sont lancés par les scripts rc. Pour avoir une 51.53 +liste des démons lancés au démarrage il faut regarder la variable RUN_DAEMONS 51.54 +du fichier de configuration /etc/rcS.conf. 51.55 +</p> 51.56 +<pre> 51.57 + $ cat /etc/rcS.conf | grep RUN_DAEMONS 51.58 +</pre> 51.59 +<p> 51.60 +Pour connaître les processus actifs, leur PID et leures resources mémoire, 51.61 +vous pouvez utiliser la commande 'ps' pour lister les processus en cours ou 51.62 +lancer l'utilitaire Htop : 51.63 +</p> 51.64 +<pre> 51.65 + $ ps 51.66 + $ htop 51.67 +</pre> 51.68 + 51.69 +<a name="root"></a> 51.70 +<h3><font color="#6c0023">Root - L'administrateur système</font></h3> 51.71 +<p> 51.72 +Root vient de l'anglais racine, sur un système GNU/Linux l'utilisateur 51.73 +<em>root</em> est l'administrateur système, il a tous les droits sur les 51.74 +fichiers du système et ceux de tous les utilisateurs. Il est conseillé de ne 51.75 +jamais se loguer en tant que <em>root</em> et d'utiliser la commande 51.76 +<code>su</code> suivie du mot de passe de l'utilisateur <em>root</em>, pour 51.77 +obtenir les droits absolus. Ne pas se loguer en root et surfer sur internet 51.78 +par exemple, permet d'avoir une double barrière en cas d'attaque ou d'intrusion 51.79 +suite à un téléchargement. C'est à dire qu'un <em>cracker</em> tentant de 51.80 +prendre le contrôle de votre machine, devra d'abord craquer votre mot de passe 51.81 +pour ensuite tenter de craquer celui de l'administrateur <em>root</em>. 51.82 +</p> 51.83 +<p> 51.84 +Un système GNU/Linux sécurisé a donc au minimum 2 utilisateurs, un pour 51.85 +travailler et <em>root</em> pour administrer, configurer ou mettre à jour le 51.86 +système. Il est aussi conseillé de confier l'administration du système à une 51.87 +personne. 51.88 +</p> 51.89 + 51.90 + 51.91 +<a name="busybox"></a> 51.92 +<h3><font color="#6c0023">Busybox</font></h3> 51.93 +<p> 51.94 +Le fichier busybox.conf, configure les applets, et leurs droits respectifs. 51.95 +Sur le LiveCD de SliTaz les commandes: su, passwd, loadkmap, mount, reboot, 51.96 +halt, peuvent être lancées par tous les utilisateurs, le propriétaire et le 51.97 +groupe des commandes est root (<code>* = ssx root.root</code>). Le fchier 51.98 +<code>/etc/busybox.conf</code> n'est lisible que par root, il a les droits 51.99 +600. A noter que la commande <code>passwd</code> ne fonctionne pas bien si 51.100 +elle n'est pas ssx, les utilisateurs du système ne peuvent pas changer leur 51.101 +propre mot de passe. 51.102 +</p> 51.103 + 51.104 +<a name="ssh"></a> 51.105 +<h3><font color="#6c0023">Serveur SSH</font></h3> 51.106 +<p> 51.107 +Ce petit texte au sujet de la sécurité est un complément à la page titrée 51.108 +<a href="secure-shell.html">SHell sécurisé (SSH)</a>. Sur SliTaz, le serveur 51.109 +SSH Dropbear n'est pas lancé par défaut, il faut l'ajouter à la variable 51.110 +<code>RUN_DAEMON</code> du fichier de configuration <code>/etc/rcS.conf</code> 51.111 +pour qu'il se lance à chaque démarrage du système. Ou lancer le serveur 51.112 +manuellement : 51.113 +</p> 51.114 +<pre> 51.115 + # /etc/init.d/dropbear start 51.116 +</pre> 51.117 +<p> 51.118 +Par défaut dropbear est lancé avec les options : 51.119 +</p> 51.120 +<pre class="script"> 51.121 + -w N'autorise pas de login pour root. 51.122 + -g N'autorise pas de login avec mot de passe pour root. 51.123 +</pre> 51.124 +<p> 51.125 +Vous pouvez ajouter de nouvelles options en éditant le fichier de configuration 51.126 +des démons : <code>/etc/daemons.conf</code>. Pour connaître toutes les options 51.127 +possibles, vous pouvez taper : <code>dropbear -h</code>. 51.128 +</p> 51.129 + 51.130 +<!-- End of content --> 51.131 +</div> 51.132 + 51.133 +<!-- Footer. --> 51.134 +<div id="footer"> 51.135 + <div class="footer-right"></div> 51.136 + <a href="#top">Haut de la page</a> | 51.137 + <a href="index.html">Table des matières</a> 51.138 +</div> 51.139 + 51.140 +<div id="copy"> 51.141 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 51.142 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 51.143 + Documentation publiées sous 51.144 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 51.145 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 51.146 +</div> 51.147 + 51.148 +</body> 51.149 +</html>
52.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 52.2 +++ b/doc/handbook/system-admin.html Sat Mar 29 12:01:05 2008 +0100 52.3 @@ -0,0 +1,305 @@ 52.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 52.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 52.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 52.7 +<head> 52.8 + <title>SliTaz Handbook - Administration du système</title> 52.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 52.10 + <meta name="description" content="configuration de SliTaz langue clavier fstab heure horloge" /> 52.11 + <meta name="expires" content="never" /> 52.12 + <meta name="modified" content="2007-12-04 12:30:00" /> 52.13 + <meta name="publisher" content="www.slitaz.org" /> 52.14 + <meta name="author" content="Christophe Lincoln"/> 52.15 + <link rel="shortcut icon" href="favicon.ico" /> 52.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 52.17 +</head> 52.18 +<body bgcolor="#ffffff"> 52.19 + 52.20 +<!-- Header and quick navigation --> 52.21 +<div id="header"> 52.22 +<div align="right" id="quicknav"> 52.23 + <a name="top"></a> 52.24 + <a href="network-config.html">Configuration du réseau</a> | 52.25 + <a href="index.html">Table des matières</a> 52.26 +</div> 52.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 52.28 +</div> 52.29 + 52.30 +<!-- Content. --> 52.31 +<div id="content"> 52.32 +<div class="content-right"></div> 52.33 + 52.34 +<h2><font color="#DF8F06">Administration du système</font></h2> 52.35 + 52.36 +<ul> 52.37 + <li><a href="#locale">Configurer la langue</a> - Définir une locale 52.38 + pour le système ou une session utilisateur.</li> 52.39 + <li><a href="#keymap">Configurer le clavier.</a></li> 52.40 + <li><a href="#shell">Personnaliser son shell</a> - Le fichier ~/.profile, 52.41 + ash et sh.</li> 52.42 + <li><a href="#clock">Régler l'horloge</a> - Modifier le fuseau horaire.</li> 52.43 + <li><a href="#users-admin">Gestion des utilisateurs et groupes.</a></li> 52.44 + <li><a href="#local.sh">Ajouter des commandes exécutées au boot.</a></li> 52.45 + <li><a href="#cron">Exécuter des commandes à horaire fixe</a> - 52.46 + Utilisation de crond et crontab.</li> 52.47 + <li><a href="network-config.html">Configuration du réseau.</a></li> 52.48 +</ul> 52.49 + 52.50 +<a name="locale"></a> 52.51 +<h3><font color="#6c0023">Configuration de la langue</font></h3> 52.52 +<p> 52.53 +SliTaz sauvegarde la configuration de la locale par défaut dans le fichier 52.54 +/etc/locale.conf qui est lu par /etc/profile, à chaque login. Le fichier 52.55 +/etc/locale.conf est généré lors du premier boot grâce au script 52.56 +/etc/init.d/i18n.sh, lancé au démarrage. Il suffit donc de modifier le 52.57 +fichier /etc/locale.conf avec un éditeur de texte, ou de relancer 52.58 +l'utilitaire <code>tazlocale</code> pour changer la locale par défaut du 52.59 +système : 52.60 +</p> 52.61 +<pre> 52.62 + # tazlocale 52.63 +</pre> 52.64 +<p> 52.65 +Pour utiliser la langue lors d'une session , vous pouvez aussi ajouter 2 52.66 +lignes au fichier ~/.profile, propre à chaque utilisateur, exportant la 52.67 +configuration : 52.68 +</p> 52.69 +<pre class="script"> 52.70 + 52.71 +export LANG=fr_CH 52.72 +export LC_ALL=fr_CH 52.73 + 52.74 +</pre> 52.75 +<a name="keymap"></a> 52.76 +<h3><font color="#6c0023">Configuration du clavier</font></h3> 52.77 +<p> 52.78 +La configuration du clavier et sauvegardée dans /etc/kmap.conf, comme 52.79 +pour la locale, vous pouvez modifier ce fichier à la main ou en lançant 52.80 +<code>tazkmap</code>, en tant qu'administrateur (<em>root</em>) : 52.81 +</p> 52.82 +<pre> 52.83 + # tazkmap 52.84 +</pre> 52.85 +<p> 52.86 +Le clavier et chargé au démarrage par le script /etc/init.d/i18n.sh. 52.87 +Note : i18n pour internationalisation, et kmap c'est l'extension des 52.88 +fichiers de clavier utilisé par Busybox. 52.89 +</p> 52.90 +<a name="shell"></a> 52.91 +<h3><font color="#6c0023">Personnaliser son shell</font></h3> 52.92 +<p> 52.93 +Après un login vous êtes dans votre shell. Sur SliTaz vous disposez du 52.94 +shell <code>ash</code> et <code>sh</code> et un lien sur Ash, ce shell est 52.95 +fournit par Busybox. Ash est léger, rapide, et conforme au normes. Pour 52.96 +changer le shell par défaut d'un utilisateur, il faut passer par le 52.97 +fichier /etc/passwd, et modifier la ligne correspondante. Lors d'un login, 52.98 +le fichier /etc/profile est lu, puis c'est le fichier personnel ~/.profife. 52.99 +Vous pouvez modifier l'un et l'autre avec un éditeur de texte, pour y 52.100 +configurer la langue, d'autres aliases, etc. 52.101 +</p> 52.102 +<h4>Exemple: ~/.profile</h4> 52.103 +<pre class="script"> 52.104 +# ~/.profile: executed by Bourne-compatible login shells. 52.105 +# 52.106 + 52.107 +# Aliases. 52.108 +alias ls='ls -F' 52.109 +alias df='df -h' 52.110 + 52.111 +# Env variables. 52.112 +export EDITOR=nano 52.113 + 52.114 +</pre> 52.115 +<a name="clock"></a> 52.116 +<h3><font color="#6c0023">Régler l'horloge</font></h3> 52.117 +<p> 52.118 +Pour connaître l'heure système actuelle vous pouvez utiliser la commande 52.119 +<code>date</code>. Sur SliTaz la configuration du fuseau horaire est 52.120 +sauvegardée dans le fichier /etc/TZ. Vous pouvez modifier se fichier via 52.121 +un des <a href="utilities.html">éditeurs</a> disponibles ou simplement en 52.122 +utilisant la commande <code>echo</code>, exemple pour la zone Europe/Zurich : 52.123 +</p> 52.124 +<pre> 52.125 + # echo "Europe/Zurich" > /etc/TZ 52.126 +</pre> 52.127 +<h4>hwclock</h4> 52.128 +<p> 52.129 +Pour faire un réglage fin de l'horloge vous pouvez utiliser 'hwclock', cet 52.130 +utilitaire permet de synchroniser l'horloge système avec l'horloge matériel, 52.131 +ou l'inverse. 52.132 +<p> 52.133 +Synchroniser l'horloge système avec l'horloge matériel 52.134 +(--utc = universal time, --localtime = local time) : 52.135 +</p> 52.136 +<pre> 52.137 + # hwclock --hctosys --utc 52.138 +</pre> 52.139 +<p> 52.140 +Synchroniser l'horloge matériel avec l'horloge système : 52.141 +</p> 52.142 +<pre> 52.143 + # hwclock --systohc --utc 52.144 +</pre> 52.145 +<p> 52.146 +Vous pouvez aussi connaître et synchroniser l'horloge système avec un serveur de 52.147 +temps sur le réseau avec la commande 'rdate', l'option <code>-p</code> affiche 52.148 +l'heure du serveur : 52.149 +</p> 52.150 +<pre> 52.151 + $ rdate -p tick.grayware.com 52.152 +</pre> 52.153 +<p> 52.154 +Pour se synchroniser avec un serveur de temps, il faut être root : 52.155 +</p> 52.156 +<pre> 52.157 + # rdate -s tick.grayware.com 52.158 +</pre> 52.159 +<a name="users-admin"></a> 52.160 +<h3><font color="#6c0023">Gestion des utilisateurs et groupes</font></h3> 52.161 +<p> 52.162 +La gestion des utilisateurs et groupes du système peut se faire totalement 52.163 +en ligne de commandes. Vous pouvez par exemple facilement ajouter ou supprimer 52.164 +des utilisateurs, créer des groupes, ou encore modifier les mots de passe. 52.165 +Par défaut, SliTaz configure un utilisateur hacker sans mot de passe, afin de 52.166 +ne pas se connecter en tant que root, même en mode LiveCD. Pour ce connecter 52.167 +en tant que super-utilisateur (root) il faut utiliser la commande 52.168 +<code>su</code>. 52.169 +</p> 52.170 +<h4>Mot de passe</h4> 52.171 +<p> 52.172 +Pour modifier un mot de passe il faut utiliser la commande <code>passwd</code> 52.173 +valable aussi pour root : 52.174 +</p> 52.175 +<pre> 52.176 + $ passwd 52.177 + ou: 52.178 + # passwd 52.179 + ou encore: 52.180 + # passwd hacker 52.181 +</pre> 52.182 +<h4>Ajouter un utilisateur ou un groupe</h4> 52.183 +<p> 52.184 +L'ajout d'utilisateurs se fait avec la commande <code>adduser</code>, et 52.185 +celui d'un groupe avec <code>addgroup</code>. Vous obtiendrez de l'aide en 52.186 +tapant ces commandes suivies de l'option <code>--help</code>. La commande 52.187 +ci-dessous ajoute l'utilisateur pomme avec comme shell par défaut Ash : 52.188 +</p> 52.189 +<pre> 52.190 + # adduser pomme -s /bin/ash 52.191 +</pre> 52.192 +<p> 52.193 +Et pour un groupe (nom du groupe: partage et gid: 100): 52.194 +</p> 52.195 +<pre> 52.196 + # addgroup -g 100 partage 52.197 +</pre> 52.198 +<p> 52.199 +Pour ajouter un utilisateur existant dans un groupe existant, vous devez 52.200 +éditer les fichiers /etc/group et /etc/gshadow, car l'applet adduser fournit 52.201 +avec Busybox n'offre pas toutes les options fournies par le programme 52.202 +original. 52.203 +</p> 52.204 +<h4>Supprimer un utilisateur ou un groupe</h4> 52.205 +<p> 52.206 +Vous pouvez facilement supprimer un utilisateur du système ou un groupe avec 52.207 +les commade <code>deluser</code> et <code>delgroup</code> : 52.208 +</p> 52.209 +<pre> 52.210 + # deluser pomme 52.211 + Et pour un groupe : 52.212 + # delgroup partage 52.213 +</pre> 52.214 +<a name="local.sh"></a> 52.215 +<h3><font color="#6c0023">Ajouter des commandes exécutées au boot</font></h3> 52.216 +<p> 52.217 +Lors du boot divers scripts sont exécutés, afin de configurer des services ou 52.218 +autres, tel que le démarrage du serveur web, la mise en réseau, etc. Sur 52.219 +SliTaz il y a un script: /etc/init.d/local.sh, qui vous permet de rajouter 52.220 +facilement des commandes qui seront lancées au démarrage du système. Vous 52.221 +pouvez aussi créer de nouveaux scripts dans /etc/init.d, leurs liens dans 52.222 +/etc/rc.scripts pour les scripts shell et utiliser /etc/rc.d pour les liens 52.223 +sur les scripts de démarrage des démons système : 52.224 +</p> 52.225 +<pre> 52.226 + # nano /etc/init.d/local.sh 52.227 +</pre> 52.228 +<a name="cron"></a> 52.229 +<h3><font color="#6c0023">Exécuter des commandes à horaire fixe</font></h3> 52.230 +<p> 52.231 +Le démon Crond permet d'exécuter automatiquement des commandes à une date et 52.232 +une heure précise, ou selon un cycle. C'est très utile pour des tâches 52.233 +routinières d'administration système. Le répertoire utilisé par Cron est : 52.234 +<code>/var/spool/cron/crontabs</code>. 52.235 +</p> 52.236 +<p> 52.237 +Chaque utilisateur du système peut avoir ces propres tâches, elles sont 52.238 +définies dans le fichier /var/spool/cron/crontabs/user. L'utilitaire crontab 52.239 +permet, entre autre de lister les tâches propre à un utilisateur. La syntaxe 52.240 +de ces fichiers est la suivante : 52.241 +</p> 52.242 +<pre class="script"> 52.243 +mm hh jj MMM JJJ tâche > log 52.244 +</pre> 52.245 +<p> 52.246 +Nous allons créer le fichier pour root, et tester le démon 'crond', avec une 52.247 +tâche exécutée toutes les minutes, qui écrit la date dans le fichier 52.248 +/tmp/crond.test. A noter que l'utilitaire <code>crontab</code> a une option 52.249 +d'édition des fichiers cron, utilisant 'vi', non fourni avec SliTaz. A la 52.250 +place vous pouvez utiliser GNU nano (<Ctrl+X> pour enregistrer et 52.251 +quitter) : 52.252 +</p> 52.253 +<pre> 52.254 + # nano /var/spool/cron/crontabs/root 52.255 +</pre> 52.256 +<pre class="script"> 52.257 +* * * * * date >> /tmp/crond.test 52.258 +</pre> 52.259 +<p> 52.260 +Lancez <code>crond</code> en fond avec l'option <code>-b</code> (backgroud), 52.261 +configurée via le fichier <code>/etc/daemons.conf</code> et en utilisant le 52.262 +script de démarrage : 52.263 +</p> 52.264 +<pre> 52.265 + # /etc/init.d/crond start 52.266 +</pre> 52.267 +<p> 52.268 +Vous pouvez attendre quelques minutes, et afficher le contenu du 52.269 +fichier: /tmp/crond.test... OK : 52.270 +</p> 52.271 +<pre> 52.272 + # cat /tmp/crond.test 52.273 +</pre> 52.274 +<p> 52.275 +Pour arrêter ou redémarrer le démon crond : 52.276 +</p> 52.277 +<pre> 52.278 + # /etc/init.d/crond stop 52.279 + Ou : 52.280 + # /etc/init.d/crond restart 52.281 +</pre> 52.282 +<h4>Lancer le démon crond à chaque démarrage</h4> 52.283 +<p> 52.284 +Pour lancer le démon 'crond' à chaque démarrage du système, vous pouvez 52.285 +l'ajouter à la variable <code>START_DAEMONS</code> du fichier de configuration 52.286 +<code>/etc/rcS.conf</code> à la suite ou avant le serveur Web ou le serveur SSH. 52.287 +</p> 52.288 + 52.289 +<!-- End of content --> 52.290 +</div> 52.291 + 52.292 +<!-- Footer. --> 52.293 +<div id="footer"> 52.294 + <div class="footer-right"></div> 52.295 + <a href="#top">Haut de la page</a> | 52.296 + <a href="index.html">Table des matières</a> 52.297 +</div> 52.298 + 52.299 +<div id="copy"> 52.300 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 52.301 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 52.302 + Documentation publiées sous 52.303 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 52.304 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 52.305 +</div> 52.306 + 52.307 +</body> 52.308 +</html>
53.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 53.2 +++ b/doc/handbook/system-tools.html Sat Mar 29 12:01:05 2008 +0100 53.3 @@ -0,0 +1,156 @@ 53.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 53.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 53.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 53.7 +<head> 53.8 + <title>SliTaz Handbook - Outils système</title> 53.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 53.10 + <meta name="description" content="" /> 53.11 + <meta name="expires" content="never" /> 53.12 + <meta name="modified" content="2000-01-31 21:30:00" /> 53.13 + <meta name="publisher" content="www.slitaz.org" /> 53.14 + <meta name="author" content="Christophe Lincoln"/> 53.15 + <link rel="shortcut icon" href="favicon.ico" /> 53.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 53.17 +</head> 53.18 +<body bgcolor="#ffffff"> 53.19 + 53.20 +<!-- Header and quick navigation --> 53.21 +<div id="header"> 53.22 +<div align="right" id="quicknav"> 53.23 + <a name="top"></a> 53.24 + <a href="x-window.html">Système de fenêtres X</a> | 53.25 + <a href="index.html">Table des matières</a> 53.26 +</div> 53.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 53.28 +</div> 53.29 + 53.30 +<!-- Content. --> 53.31 +<div id="content"> 53.32 +<div class="content-right"></div> 53.33 + 53.34 +<h2><font color="#DF8F06">Outils système</font></h2> 53.35 + 53.36 +<ul> 53.37 + <li><a href="#clex">Clex</a> - Gestionnaire de fichiers mode texte.</li> 53.38 + <li><a href="#emelfm2">emelFM2</a> - Gestionnaire de fichiers.</li> 53.39 + <li><a href="#htop">Htop</a> - Visionneur de processus système.</li> 53.40 + <li><a href="#mountbox">Mountbox</a> - Monter des périphériques.</li> 53.41 + <li><a href="#gparted">Gparted</a> - Gestion des partitions d'un disque 53.42 + dur.</li> 53.43 + <li><a href="network-config.html#netbox">Netbox</a> - Configuration 53.44 + graphique du réseau.</li> 53.45 +</ul> 53.46 + 53.47 +<a name="clex"></a> 53.48 +<h3><font color="#6c0023">Clex - Gestionnaire de fichiers mode texte</font></h3> 53.49 +<p> 53.50 +Pour naviguer dans vos répertoires vous pouvez utiliser la ligne de commande et 53.51 +<code>cd</code>, ou lancer 'Clex File Manager' un gestionnaire de fichiers ncurses. 53.52 +Clex et facile d'utilisation, rapide, et facilement configurable via un panel 53.53 +de configuration, ou via le fichier ~/.clexrc et ~/.clexbm pour les marques 53.54 +pages (bookmarks). Pour lancer clex depuis un terminal ou une console : 53.55 +</p> 53.56 +<pre> 53.57 + $ clex 53.58 +</pre> 53.59 + 53.60 +<a name="emelfm2"></a> 53.61 +<h3><font color="#6c0023">emelFM2 - Gestionnaire de fichiers</font></h3> 53.62 +<p> 53.63 +L'application emelFM2, est un gestionnaire de fichiers, fournissant toutes les 53.64 +fonctions utiles aux tâches quotidiennes, telles que le montage de périphériques, 53.65 +des icônes de navigation, l'ouverture d'un terminal dans le répertoire courant, 53.66 +le glisser/déposer, création de répertoires, renommage, ou encore la gestion 53.67 +des permissions. Il propose aussi un éditeur/visualisateur de fichier texte, 53.68 +des commandes utilisateur, des marques pages pour une navigation plus rapide, 53.69 +et bien plus. Le gestionnaire emelFM2 propose aussi des options à passer en 53.70 +ligne de commade lors de son lancement. Vous pouvez spécifier le répertoire 53.71 +de la poubelle, du panel 1 et/ou 2, pour connaître toutes les options : 53.72 +<code>$ emelfm2 --help</code>. 53.73 +</p> 53.74 +<p> 53.75 +Le menu contextuel (click de droite sur le fichier/répertoire) permet de 53.76 +facilement désarchiver les archives <code>.taz.gz</code>, de compresséer, créer 53.77 +des archives ou comparer des fichiers. Vous pouvez aussi créer des liens 53.78 +symboliques via le bouton "Créer un lien...". Une fois pris en main, emelFM2 53.79 +permet de travailler rapidement et efficacement. 53.80 +</p> 53.81 + 53.82 +<a name="htop"></a> 53.83 +<h3><font color="#6c0023">Htop - Visionneur de processus système</font></h3> 53.84 +<p> 53.85 +Htop est un visionneur de processus système affichant les processus, 53.86 +l'utilisation du ou des processeurs, l'état de la mémoire vive (RAM) et swap. 53.87 +IL affiche aussi le nombres de tâches, le temps depuis lequel la machine 53.88 +tourne, les PID ou les commandes actives. Htop s'utilise au clavier en mode 53.89 +console, supporte la souris avec un terminal X (Xterm) et fournit diveres 53.90 +options de configuration (F2). Htop peut aussi être utilisé pour tuer un 53.91 +processus et les flèches ou un clique de souris permettent de séléctonner 53.92 +une ligne. A noter qu'Htop fonctionne via SSH est peut servir à surveiller 53.93 +un serveur à distance : 53.94 +<pre> 53.95 + $ htop 53.96 +</pre> 53.97 + 53.98 +<a name="mountbox"></a> 53.99 +<h3><font color="#6c0023">Mountbox - Monter un périphérique</font></h3> 53.100 +<p> 53.101 +Mountbox est une petite interface GTK à la commande <code>mount</code> 53.102 +permettant de monter rapidement un media tel qu'une clé USB, disque dur ou 53.103 +cdrom. Mountbox peut se lancer depuis un terminal ou via le menu Outils système 53.104 +(System tools). Il suffit de spécifier les prériphérique (Device) et le point 53.105 +de montage, c'est à dire le répertoire depuis lequel vous voulez accéder aux 53.106 +données du media en question. Généralement un cdrom se monte sur /media/cdrom, 53.107 +une clé USB dans /media/flash et les disque durs de la machine local dans /mnt. 53.108 +A noter que le Handbook contient aussi des informations au sujet de 53.109 +<a href="cmdline.html#mount">la commande mount</a>. 53.110 +</p> 53.111 + 53.112 +<a name="gparted"></a> 53.113 +<h3><font color="#6c0023">Gparted - Gestion des partitions d'un disque dur</font></h3> 53.114 +<p> 53.115 +Gparted est une application graphique permettant de gérer les partitions d'un 53.116 +disque dur local ou media USB. Il permet de formater, redimensionner et 53.117 +vérifier une ou des partitions d'un disque dur, c'est l'outil à utiliser si 53.118 +vous devez préparer un partitions, graphiquement, pour installer SliTaz. Gparted 53.119 +support les systèmes de fichiers propores à GNU/Linux (ext2 et ext3) via mkfs 53.120 +et Parted automatiquement proposé en dépendences. Pour installer Gparted et 53.121 +le lancer depuis le terminal : 53.122 +</p> 53.123 +<pre> 53.124 + # tazpkg get-install gparted 53.125 + # gparted & 53.126 +</pre> 53.127 +<p> 53.128 +A noter que si vous désirez une entrée dans le menu de JWM, vous pouvez 53.129 +utiliser <code>subox</code> pour demander le mot de passe root avant de lancer 53.130 +Gparted. 53.131 +</p> 53.132 +<h4>Support FAT et NTFS</h4> 53.133 +<p> 53.134 +Pour avoir le support du système de fichiers FAT16 ou FAT32 de Windows, vous 53.135 +devez installer le paquet <code>dosfstools</code>. Pour le support NTFS en 53.136 +lecture/écriture vous aurez besoin de : <code>fuse</code>, <code>ntfs-3g</code> 53.137 +et <code>ntfprogs</code>. 53.138 +</p> 53.139 + 53.140 +<!-- End of content --> 53.141 +</div> 53.142 + 53.143 +<!-- Footer. --> 53.144 +<div id="footer"> 53.145 + <div class="footer-right"></div> 53.146 + <a href="#top">Haut de la page</a> | 53.147 + <a href="index.html">Table des matières</a> 53.148 +</div> 53.149 + 53.150 +<div id="copy"> 53.151 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 53.152 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 53.153 + Documentation publiées sous 53.154 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 53.155 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 53.156 +</div> 53.157 + 53.158 +</body> 53.159 +</html>
54.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 54.2 +++ b/doc/handbook/template.html Sat Mar 29 12:01:05 2008 +0100 54.3 @@ -0,0 +1,56 @@ 54.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 54.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 54.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 54.7 +<head> 54.8 + <title>SliTaz Handbook - Template</title> 54.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 54.10 + <meta name="description" content="" /> 54.11 + <meta name="expires" content="never" /> 54.12 + <meta name="modified" content="2000-02-03 19:30:00" /> 54.13 + <meta name="publisher" content="www.slitaz.org" /> 54.14 + <meta name="author" content="Christophe Lincoln"/> 54.15 + <link rel="shortcut icon" href="favicon.ico" /> 54.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 54.17 +</head> 54.18 +<body bgcolor="#ffffff"> 54.19 + 54.20 +<!-- Header and quick navigation --> 54.21 +<div id="header"> 54.22 +<div align="right" id="quicknav"> 54.23 + <a name="top"></a> 54.24 + <a href="http://www.slitaz.org/">www.slitaz.org</a> 54.25 +</div> 54.26 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 54.27 +</div> 54.28 + 54.29 +<!-- Content. --> 54.30 +<div id="content"> 54.31 +<div class="content-right"></div> 54.32 + 54.33 +<h2><font color="#DF8F06">Template</font></h2> 54.34 + 54.35 +<p> 54.36 +CONTENT 54.37 +</p> 54.38 + 54.39 + 54.40 +<!-- End of content --> 54.41 +</div> 54.42 + 54.43 +<!-- Footer. --> 54.44 +<div id="footer"> 54.45 + <div class="footer-right"></div> 54.46 + <a href="#top">Haut de la page</a> | 54.47 + <a href="index.html">Table des matières</a> 54.48 +</div> 54.49 + 54.50 +<div id="copy"> 54.51 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 54.52 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 54.53 + Documentation publiées sous 54.54 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 54.55 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 54.56 +</div> 54.57 + 54.58 +</body> 54.59 +</html>
55.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 55.2 +++ b/doc/handbook/utilities.html Sat Mar 29 12:01:05 2008 +0100 55.3 @@ -0,0 +1,211 @@ 55.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 55.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 55.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 55.7 +<head> 55.8 + <title>SliTaz Handbook - Utilitaires</title> 55.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 55.10 + <meta name="description" content="clex file manager sqlite base de donnée cdrkit" /> 55.11 + <meta name="expires" content="never" /> 55.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 55.13 + <meta name="publisher" content="www.slitaz.org" /> 55.14 + <meta name="author" content="Christophe Lincoln"/> 55.15 + <link rel="shortcut icon" href="favicon.ico" /> 55.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 55.17 +</head> 55.18 +<body bgcolor="#ffffff"> 55.19 + 55.20 +<!-- Header and quick navigation --> 55.21 +<div id="header"> 55.22 +<div align="right" id="quicknav"> 55.23 + <a name="top"></a> 55.24 + <a href="office.html">Bureautique</a> | 55.25 + <a href="index.html">Table des matières</a> 55.26 +</div> 55.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 55.28 +</div> 55.29 + 55.30 +<!-- Content. --> 55.31 +<div id="content"> 55.32 +<div class="content-right"></div> 55.33 + 55.34 +<h2><font color="#DF8F06">Les utilitaires</font></h2> 55.35 + 55.36 +<ul> 55.37 + <li><a href="#calc">Bc</a> - Calculatrice.</li> 55.38 + <li><a href="#cdrkit">Cdrkit</a> - Gravure et manipultaion de CD/DVD-R 55.39 + ou RW.</li> 55.40 + <li><a href="#nano">Nano</a> - GNU nano, l'éditeur de texte par 55.41 + défaut sur SliTaz.</li> 55.42 + <li><a href="#leafpad">LeafPad</a> - Editeur GTK+ léger et rapide.</li> 55.43 + <li><a href="#isomaster">ISO Master</a> - Éditeur graphique 55.44 + d'images ISO.</li> 55.45 + <li><a href="#xpad">Xpad</a> - Mini application de prise de notes.</li> 55.46 +</ul> 55.47 + 55.48 +<a name="calc"></a> 55.49 +<h3><font color="#6c0023">Calculatrice</font></h3> 55.50 +<p> 55.51 +Les opérations de mathématiques peuvent se faire avec la calculatrice en 55.52 +mode texte Bc. Ouvrez un terminal ou tapez directement dans la console 55.53 +<code>bc</code>, pour quitter il faut taper <code>quit</code> : 55.54 +</p> 55.55 +<pre> 55.56 + $ bc 55.57 + 23+45 <ENTER> 55.58 + 68 55.59 + 55.60 + quit 55.61 +</pre> 55.62 + 55.63 +<a name="cdrkit"></a> 55.64 +<h3><font color="#6c0023">Cdrkit - Gravure et manipultaion de CD/DVD-R ou RW</font></h3> 55.65 +<p> 55.66 +Pour graver et manipuler des CD/DVD-R ou RW, SliTaz fournit les outils CdrKit 55.67 +et une interace grphique nomée <code>burnbox</code> que vous trouverez dans 55.68 +le menu d'un des gestionnaires de fenêtres, soit JWM ou Enlightenment. 55.69 +L'outils <code>wodim</code> permet de graver un CD/DVD et d'effacer des 55.70 +CD/DVD-RW, quand a <code>genisoimage</code>, il permet de créer des images 55.71 +gravables au format ISO 9660. La gravure en ligne de commande nous impose de 55.72 +connaître le nom du périphérique/graveur (dev). Wodim offre plusieurs 55.73 +possibilités pour connaître le graveur à utiliser et plusieurs façcon de 55.74 +spécifier le périphérique lors de la gravure. Si vous lancez Wodim avec 55.75 +l'options <code>-devices</code>, il tentera de devinner automatiquement le nom 55.76 +du bon graveur et l'affichera, l'option <code>-checkdrive</code> permet de 55.77 +vérifier les graveurs reconnus. Quand au bus, il peut être connu via l'option 55.78 +<code>-scanbus</code>. Exemple (en étant <em>root</em>) : 55.79 +</p> 55.80 +<pre> 55.81 + # wodim -devices 55.82 + Ou : 55.83 + # wodim -checkdrive 55.84 + Pour le bus : 55.85 + # wodim -scanbus 55.86 +</pre> 55.87 +<h4>Créer une image ISO 9660</h4> 55.88 +<p> 55.89 +Pour graver des données sur un CD/DVD, vous devez disposer d'une image ISO. 55.90 +Pour commencer il faut créer un répertoire contenant tous les fichiers 55.91 +destinés à être graver, vous pouvez copier vos fichiers en ligne de commande 55.92 +avec <code>cp</code>, en mode texte avec le gestionnaire de fichiers Clex ou 55.93 +graphiquement avec emelFM2. Exemple en commandes (vous pouvez être simple 55.94 +utilisateur), création d'un répertoire <code>iso/</code> à la racine de 55.95 +l'espace utilisateur et copie de tous les fichiers contenu dans 55.96 +<code>Documents/</code> : 55.97 +</p> 55.98 +<pre> 55.99 + $ mkdir ~/iso 55.100 + $ cp -a Documents/* ~/iso 55.101 +</pre> 55.102 +<p> 55.103 +Création d'une image ISO nommée <code>image.iso</code>, en utilisant l'outil 55.104 +<code>genisoimage</code> et en spécifiant la racine du répertoire contenant les 55.105 +fichiers à insérer dans l'ISO : 55.106 +</p> 55.107 +<pre> 55.108 + $ genisoimage -o image.iso ~/iso 55.109 +</pre> 55.110 +<p> 55.111 +A noter qu'il existe de multiples options pour créer des images ISO, une des 55.112 +plus utilisée est l'extension <code>-R</code>, signifiant <em>Rock ridge</em> 55.113 +et permettant d'utiliser des noms de 255 caractères sans trop de 55.114 +restrictions, supportant les liens symboliques et les droits sur les fichiers. 55.115 +Pour connaître toutes les options disponibles, vous pouvez utiliser l'option 55.116 +<code>-help</code>. Exemple de création en utilisant l'option <code>-R</code> : 55.117 +</p> 55.118 +<pre> 55.119 + $ genisoimage -o image.iso -R ~/iso 55.120 +</pre> 55.121 +<h4>Graver une image ISO</h4> 55.122 +<p> 55.123 +Pour graver une image au format ISO 9660 créée vous même ou téléchargée depuis 55.124 +le web, il faut utiliser <code>wodim</code> en spécifiant le bon périphérique 55.125 +(<code>dev</code>) du graveur de CD/DVD. Exemple de gravure en mode volubile 55.126 +(<code>-v</code>) avec un <em>device</em> reconnu comme <code>hdc</code> et 55.127 +des données contenues dans une image ISO nomée <code>image.iso</code> : 55.128 +</p> 55.129 +<pre> 55.130 + # wodim -v dev=/dev/hdc image.iso 55.131 +</pre> 55.132 +<p> 55.133 +Autre exemple en spécifiant une vitesse (<em>speed</em>) de gravage de 8 : 55.134 +</p> 55.135 +<pre> 55.136 + # wodim -v speed=8 dev=/dev/hdc image.iso 55.137 +</pre> 55.138 + 55.139 +<a name="nano"></a> 55.140 +<h3><font color="#6c0023">Nano</font></h3> 55.141 +<p> 55.142 +L'éditeur de texte par défaut sur SliTaz est GNU Nano. Une fois lancé vous 55.143 +pouvez utiliser <Ctrl + g> pour afficher l'aide. Pour lancer Nano vous 55.144 +pouvez taper la commande <code>nano</code> depuis une console, le terminal 55.145 +graphique xterm, ou sous X depuis le menu --> Editors --> Nano. 55.146 +</p> 55.147 +<p> 55.148 +Le fichier d'initialisation du système est /etc/nanorc, il inclu les fichiers 55.149 +de colorisation syntaxique contenus dans /usr/share/nano. Le fichier de config 55.150 +utilisateur est ~/.nanorc. Pour éditer directement un fichier, vous pouvez 55.151 +lancer Nano suivi du fichier à éditer. Exemple (<Ctrl+X> pour quitter et 55.152 +enregistrer) : 55.153 +</p> 55.154 +<pre> 55.155 + $ nano Templates/script-shell.sh 55.156 +</pre> 55.157 + 55.158 +<a name="leafpad"></a> 55.159 +<h3><font color="#6c0023">LeafPad</font></h3> 55.160 +<p> 55.161 +En mode graphique SliTaz fournit LeafPad, un éditeur ultra léger et rapide, 55.162 +très pratique pour prendre des notes, ou éditer des fichiers de configuration. 55.163 +Vous trouverez l'application dans le menu de JWM et e17 ou vous pouvez aussi 55.164 +lancer directement LeafPad sur un fichier via un terminal : 55.165 +</p> 55.166 +<pre> 55.167 + $ leafpad Templates/script-shell.sh 55.168 +</pre> 55.169 + 55.170 +<a name="isomaster"></a> 55.171 +<h3><font color="#6c0023">ISO Master - Éditeur graphique d'images ISO</font></h3> 55.172 +<p> 55.173 +ISO master est un outils graphique permettant déditer, manipuler et créer des 55.174 +images ISO gravables. L'outils est simple et intuitif, il vous permet de créer 55.175 +rapidement des images ISO de la taille que vous désirez, pour ensuite les graver 55.176 +ou les stocker. 55.177 +</p> 55.178 +<p> 55.179 +Site Web : <a href="http://littlesvr.ca/isomaster/">http://littlesvr.ca/isomaster/</a> 55.180 +</p> 55.181 + 55.182 +<a name="xpad"></a> 55.183 +<h3><font color="#6c0023">Xpad - Mini application de prise de notes</font></h3> 55.184 +<p> 55.185 +Xpad est une petite application permettant la prise de notes rapide via des 55.186 +billets affichable sur le bureau. Chaque note consite en un <em>pad</em> 55.187 +que vous pouvez cacher et personnaliser via un clic de droite sur la fenêtre 55.188 +en question. Une fois lancé vous pouvez fermer Xpad via le dock situé sur la 55.189 +barre des tâches du gestionnaire de fenêtres. Les notes sont sauvegardée dans 55.190 +votre répertoire personnel et disponnibles à chaque session (si vous utiliser 55.191 +un media USB avec le LiveCD ou sur un système 55.192 +<a href="install.html">installé</a>). 55.193 +</p> 55.194 + 55.195 +<!-- End of content --> 55.196 +</div> 55.197 + 55.198 +<!-- Footer. --> 55.199 +<div id="footer"> 55.200 + <div class="footer-right"></div> 55.201 + <a href="#top">Haut de la page</a> | 55.202 + <a href="index.html">Table des matières</a> 55.203 +</div> 55.204 + 55.205 +<div id="copy"> 55.206 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 55.207 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 55.208 + Documentation publiées sous 55.209 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 55.210 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 55.211 +</div> 55.212 + 55.213 +</body> 55.214 +</html>
56.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 56.2 +++ b/doc/handbook/web-server.html Sat Mar 29 12:01:05 2008 +0100 56.3 @@ -0,0 +1,257 @@ 56.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 56.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 56.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 56.7 +<head> 56.8 + <title>SliTaz Handbook - Serveur web LightTPD</title> 56.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 56.10 + <meta name="description" content="serveur wenhttpd LightTPD host hosting configuration perl python CGI auth" /> 56.11 + <meta name="expires" content="never" /> 56.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 56.13 + <meta name="publisher" content="www.slitaz.org" /> 56.14 + <meta name="author" content="Christophe Lincoln"/> 56.15 + <link rel="shortcut icon" href="favicon.ico" /> 56.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 56.17 +</head> 56.18 +<body bgcolor="#ffffff"> 56.19 + 56.20 +<!-- Header and quick navigation --> 56.21 +<div id="header"> 56.22 +<div align="right" id="quicknav"> 56.23 + <a name="top"></a> 56.24 + <a href="packages.html">Gestion des paquets</a> | 56.25 + <a href="index.html">Table des matières</a> 56.26 +</div> 56.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 56.28 +</div> 56.29 + 56.30 +<!-- Content. --> 56.31 +<div id="content"> 56.32 +<div class="content-right"></div> 56.33 + 56.34 +<h2><font color="#DF8F06">Serveur web LightTPD</font></h2> 56.35 + 56.36 +<ul> 56.37 + <li><a href="#about">A propos de LightTPD.</a></li> 56.38 + <li><a href="#var-www">/var/www</a> - Racine des documents du serveur.</li> 56.39 + <li><a href="#Public">~/Public</a> - Répertoire public des utilisateurs.</li> 56.40 + <li><a href="#config">lighttpd.conf</a> - Fichier de configuration de 56.41 + LightTPD.</li> 56.42 + <li><a href="#start-stop-restart">Démarrer, arrêter, redémarrer le 56.43 + serveur web.</a></li> 56.44 + <li><a href="http://localhost/">http://localhost/</a></li> 56.45 + <li><a href="http://localhost/server-status">http://localhost/server-status</a></li> 56.46 + <li><a href="#cgi-perl">Scripts CGI et Perl</a> - Configurer le serveur pour 56.47 + le support des scripts CGI utilisant Perl.</li> 56.48 + <li><a href="#cgi-python">Scripts CGI et Python</a> - Scripts CGI utilisant 56.49 + Python.</li> 56.50 + <li><a href="#auth">Authentification</a> - Protéger un ou des répertoires 56.51 + avec nom d'utilisateur et mots de passes.</li> 56.52 +</ul> 56.53 + 56.54 +<a name="about"></a> 56.55 +<h3><font color="#6c0023">A propos de LightTPD</font></h3> 56.56 +<p> 56.57 +Ce chapitre décrit l'utilisation et la configuration du serveur web LightTPD. 56.58 +C'est un serveur HTTP sécurisé, rapide, flexible, et utilisant une petite 56.59 +empreinte mémoire. Il permet une gestion intelligente de la charge CPU, et 56.60 +support FastCGI, CGI, Auth, Output-Compression, réécriture d'URL, etc. 56.61 +LightTPD est un serveur idéal pour héberger son propre site, sur une ancienne 56.62 +machine, et donc à moindre frais. 56.63 +</p> 56.64 +<p> 56.65 +Sur SliTaz le serveur web est automatiquement lancé au boot du système et il 56.66 +est préconfiguré avec PHP. La racine des documents servis par défaut par le 56.67 +serveur sont dans /var/www et contient une page <code>index.html</code>, 56.68 +s'affichant par défaut, avec des images dans le répertoire images/. Site web 56.69 +de LightTPD : <a href="http://www.lighttpd.net/">http://www.lighttpd.net/</a> 56.70 +</p> 56.71 +<a name="var-www"></a> 56.72 +<h3><font color="#6c0023">/var/www - Racine des documents du serveur</font></h3> 56.73 +<p> 56.74 +Le répertoire /var/www est le répertoire racine des documents servis par 56.75 +défaut. Vous y avez accès via l'url <a href="http://localhost/" 56.76 +>http://localhost/</a>. Ce répertoire contient un page index.html s'affichant 56.77 +automatiquement lors d'une requête. Si vous ne voulez héberger qu'un site, 56.78 +vous pouvez mettre tous les document dans /var/www, et si vous voulez héberger 56.79 +plusieurs sites, il faut créer des hôtes virtuels. 56.80 +</p> 56.81 +<a name="Public"></a> 56.82 +<h3><font color="#6c0023">~/Public - Répertoire public des utilisateurs</font></h3> 56.83 +<p> 56.84 +SliTaz propose aux utilisateurs du système d'avoir un espace public pour y 56.85 +mettre des documents, HTML en général. Ce répertoire se nomme Public et doit 56.86 +se trouver à la racine de votre répertoire maison, tel que : 56.87 +/home/hacker/Public. Pour créer ce répertoire vous pouvez utliser la commande : 56.88 +</p> 56.89 +<pre> 56.90 + $ mkdir ~/Public 56.91 +</pre> 56.92 +<p> 56.93 +Vous pouvez ensuite y avoir accès via l'url http://localhost/~user/. Exemple 56.94 +pour l'utilisateur hacker : 56.95 +<a href="http://localhost/~hacker/">http://localhost/~hacker/</a>. Vous pouvez 56.96 +aussi utiliser le nom de machine ou l'adresse IP, pour vous y connecter depuis 56.97 +une autre machine. 56.98 +</p> 56.99 +<a name="config"></a> 56.100 +<h3><font color="#6c0023">/etc/lighttpd/lighttpd.conf - Fichier de configuration de LightTPD</font></h3> 56.101 +<p> 56.102 +Le fichier de configuration principal de LightTPD se trouve dans 56.103 +/etc/lighttpd, et se nomme lighttpd.conf. Le fichier de configuration fourni 56.104 +par SliTaz est auto documenté, il suffit de le parcourir. Vous trouverez 56.105 +d'autres exemples sur le site web de LightTPD. Sur SliTaz vous touverez aussi 56.106 +un fichier <code>vhosts.conf</code> destiné à la configuration d'éventuels 56.107 +hôtes virtuels (pour hébérger plusieurs sites sur le même serveur). 56.108 +</p> 56.109 +<a name="start-stop-restart"></a> 56.110 +<h3><font color="#6c0023">Démarrer, arrêter, redémarrer le serveur web</font></h3> 56.111 +<p> 56.112 +Par défaut SliTaz démarre le serveur au boot, pour qu'il ne soit pas lancé 56.113 +automatiquement vous devez supprimer <code>lighttpd</code> de la variable 56.114 +RUN_DAEMONS qui elle, se trouve dans le fichier de configuration du système 56.115 +d'initialisation <code>/etc/rcS.conf</code>. Pour démarrer, arrêter, 56.116 +redémarrer le serveur web vous pouvez utiliser la commande 56.117 +<code>/etc/init.d/lighttpd [start|stop|restart]</code>. Exemple pour 56.118 +redémarrer le serveur après modification du fichier de configuration : 56.119 +</p> 56.120 +<pre> 56.121 + # /etc/init.d/lighttpd restart 56.122 +</pre> 56.123 + 56.124 +<a name="cgi-perl"></a> 56.125 +<h3><font color="#6c0023">Scripts CGI et Perl</font></h3> 56.126 +<p> 56.127 +Pour configurer le serveur LightTPD afin qu'il trouve le chemin du binaire 56.128 +<code>perl</code> et l'utiliser avec les scripts CGI/Perl, vous devez modifier 56.129 +le fichier de configuration du serveur. Exemple en utilisant Geany : 56.130 +</p> 56.131 +<pre> 56.132 + # geany /etc/lighttpd/lighttpd.conf & 56.133 +</pre> 56.134 +<pre class="script"> 56.135 +# CGI module. You can install Perl and assign .pl and .cgi script 56.136 +# to /usr/bin/perl 56.137 +$HTTP["url"] =~ "/cgi-bin/" { 56.138 + cgi.assign = ( 56.139 + ".sh" => "/bin/sh", 56.140 + ".cgi" => "/usr/bin/perl, 56.141 + ".pl" => "/usr/bin/perl 56.142 + ) 56.143 +} 56.144 +</pre> 56.145 + 56.146 +<a name="cgi-python"></a> 56.147 +<h3><font color="#6c0023">Scripts CGI et Python</font></h3> 56.148 +<p> 56.149 +Pour configurer le serveur LightTPD afin qu'il trouve le chemin du binaire 56.150 +<code>python</code> et l'utiliser avec les scripts CGI/Python, vous devez 56.151 +avoir installé le paquet Python et modifier le fichier de configuration du 56.152 +serveur. Pour installer Python et éditer le fichiers de configuration du 56.153 +serveur web en utilisant Geany : 56.154 +</p> 56.155 +<pre> 56.156 + # tazpkg get-install python 56.157 + # geany /etc/lighttpd/lighttpd.conf & 56.158 +</pre> 56.159 +<pre class="script"> 56.160 +# CGI module. You can install Perl and assign .pl and .cgi script 56.161 +# to /usr/bin/perl 56.162 +$HTTP["url"] =~ "/cgi-bin/" { 56.163 + cgi.assign = ( 56.164 + ".sh" => "/bin/sh", 56.165 + ".cgi" => "/usr/bin/python, 56.166 + ".py" => "/usr/bin/python 56.167 + ) 56.168 +} 56.169 +</pre> 56.170 +<p> 56.171 +Pour que les modifications soient prisent en compte, et utiliser vos premier 56.172 +scripts CGI/Python sur SliTaz, vous devez encore redémarrer LightTPD : 56.173 +</p> 56.174 +<pre> 56.175 + # /etc/init.d/lighttpd restart 56.176 +</pre> 56.177 + 56.178 +<a name="auth"></a> 56.179 +<h3><font color="#6c0023">Authentification - Protéger des répertoires</font></h3> 56.180 +<p> 56.181 +LightTPD fournit un module d'authentification permettant par exemple, de 56.182 +protéger un répertoire. Le serveur propose plusieurs méthodes d'authentification, 56.183 +pour commencer nous allons utiliser la méthode basique sans cryptage des mots 56.184 +de passes. Afin de pouvoir charger le module <code>mod_auth</code>, vous devez 56.185 +avoir installer le paquets lighttpd-modules (<code>tazpkg get-install 56.186 +lighttpd-modules</code>), une fois le paquet installé il faut ajouter 56.187 +<code>mod_auth</code> à la liste des modules : 56.188 +</p> 56.189 +<pre class="script"> 56.190 +# Modules to load. 56.191 +# See /usr/lib/lighttpd for all available modules. 56.192 +# 56.193 +server.modules = ( 56.194 + "mod_access", 56.195 + "mod_auth", 56.196 + "...", 56.197 +) 56.198 +</pre> 56.199 +<p> 56.200 +Maintenant vous pouvez configurer le modules en spécifiant le niveau de debug 56.201 +la méthode (<code>plain</code>) et le chemin vers le fichier qui contiendra la 56.202 +liste des noms:pass autorisés à voir le ou les répertoires protégés. Il faut 56.203 +aussi définir le ou les répertoires qui demandent authentification. Dans cet 56.204 +exemple nous protégeons le répertoire <code>admin/</code> et autorisons son 56.205 +accès à l'utililisateur hacker (<code>user=hacker</code>) : 56.206 +</p> 56.207 +<pre class="script"> 56.208 +# Authentification for protected directory. 56.209 +auth.debug = 2 56.210 +auth.backend = "plain" 56.211 +auth.backend.plain.userfile = "/etc/lighttpd/plain.passwd" 56.212 +auth.require = ( "/admin/" => 56.213 +( 56.214 +"method" => "basic", 56.215 +"realm" => "Password protected area", 56.216 +"require" => "user=hacker" 56.217 +) 56.218 +) 56.219 +</pre> 56.220 +<p> 56.221 +Pour finir il suffit de créer le fichier des mots de passes, d'ajouter un 56.222 +utilisateur et de redémarrer le serveur pour tester. La syntaxe pour les fichiers 56.223 +basiques est <code>nom:pass</code>. Vous pouvez créer et ajouter un utilisateur 56.224 +à ce fichier avec la commande <code>echo</code> ou l'éditer avec votre éditeur 56.225 +de texte préféré. Pour un utilisateur:motdepasse <code>hacker:root</code> dans 56.226 +un fichier de mots de passes <code>/etc/lighttpd/plain.passwd</code> : 56.227 +</p> 56.228 +<pre> 56.229 + # echo "hacker:root" > /etc/lighttpd/plain.passwd 56.230 + Ou/et : 56.231 + # nano /etc/lighttpd/plain.passwd 56.232 +</pre> 56.233 +<p> 56.234 +Pour redémarrer le serveur et ensuite tester avec une adresse du type 56.235 +http://localhost/admin/ : 56.236 +</p> 56.237 +<pre> 56.238 + # /etc/init.d/lighttpd restart 56.239 +</pre> 56.240 + 56.241 +<!-- End of content --> 56.242 +</div> 56.243 + 56.244 +<!-- Footer. --> 56.245 +<div id="footer"> 56.246 + <div class="footer-right"></div> 56.247 + <a href="#top">Haut de la page</a> | 56.248 + <a href="index.html">Table des matières</a> 56.249 +</div> 56.250 + 56.251 +<div id="copy"> 56.252 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 56.253 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 56.254 + Documentation publiées sous 56.255 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 56.256 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 56.257 +</div> 56.258 + 56.259 +</body> 56.260 +</html>
57.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 57.2 +++ b/doc/handbook/x-window.html Sat Mar 29 12:01:05 2008 +0100 57.3 @@ -0,0 +1,321 @@ 57.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 57.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 57.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 57.7 +<head> 57.8 + <title>SliTaz Handbook - Système X</title> 57.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 57.10 + <meta name="description" content="configuration du serveur Xvesa JWM window manager gestionnaire de fenêtres startx" /> 57.11 + <meta name="expires" content="never" /> 57.12 + <meta name="modified" content="2007-12-03 12:30:00" /> 57.13 + <meta name="publisher" content="www.slitaz.org" /> 57.14 + <meta name="author" content="Christophe Lincoln"/> 57.15 + <link rel="shortcut icon" href="favicon.ico" /> 57.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 57.17 +</head> 57.18 +<body bgcolor="#ffffff"> 57.19 + 57.20 +<!-- Header and quick navigation --> 57.21 +<div id="header"> 57.22 +<div align="right" id="quicknav"> 57.23 + <a name="top"></a> 57.24 + <a href="system-admin.html">Administration système</a> | 57.25 + <a href="index.html">Table des matières</a> 57.26 +</div> 57.27 +<h1><font color="#3E1220">SliTaz Handbook</font></h1> 57.28 +</div> 57.29 + 57.30 +<!-- Content. --> 57.31 +<div id="content"> 57.32 +<div class="content-right"></div> 57.33 + 57.34 +<h2><font color="#DF8F06">Système de fenêtres X</font></h2> 57.35 + 57.36 +<ul> 57.37 + <li><a href="#about">A propos de X.</a></li> 57.38 + <li><a href="#slim">Slim</a> - Gestionnaire de connexion.</li> 57.39 + <li><a href="#startx">startx</a> - Session graphique depuis une console Linux.</li> 57.40 + <li><a href="#config">Configurer votre session X</a> - Personnaliser 57.41 + votre session via un seul fichier.</li> 57.42 + <li><a href="#xorg">Xorg</a> - Serveur X complet</li> 57.43 + <li><a href="#terminalX">Utiliser Xvesa comme terminal X</a> - Lancer une 57.44 + session graphique depuis une machine distante.</li> 57.45 + <li><a href="#fonts">Polices de caractères</a> - Installer des <em>fonts</em>.</li> 57.46 + <li><a href="jwm.html">JWM (Joe's Window Manager)</a> - Gestionnaire de 57.47 + fenêtres. Présentation et instructions pour créer un thème ou/et modifier 57.48 + le menu.</li> 57.49 + <li><a href="enlightenment.html">Enlightenment (e17)</a> - Environnement 57.50 + de bureau complet, léger, rapide, facilement configurable et simplement 57.51 + beau.</li> 57.52 +</ul> 57.53 + 57.54 +<a name="about"></a> 57.55 +<h3><font color="#6c0023">A propos de X</font></h3> 57.56 +<p> 57.57 +Ce petit chapitre décrit l'utilisation et la configuration d'une session 57.58 +graphique sur votre système. En mode LiveCD, SliTaz fournit le serveur Xvesa 57.59 +(KDrive), il est léger, rapide et s'adapte à tous type de matériel. Le terminal 57.60 +graphique ar défaut est XTerm, L'émulateur de termial à onglet Mrxvt est 57.61 +installable avec Tazpkg. 57.62 +</p> 57.63 + 57.64 +<a name="slim"></a> 57.65 +<h3><font color="#6c0023">Slim - Gestionnaire de session</font></h3> 57.66 +<p> 57.67 +Slim est un gestionnaire de connexion simple à utiliser et configurer, très 57.68 +léger et personnalisable via un système de thèmes. Le fichier de configuration 57.69 +est <code>/etc/slim.conf</code>, il définit le serveur graphique à utiliser 57.70 +avec d'éventuelles options, les commandes à utiliser, les gestionnaires de 57.71 +fenêtres disponnibles via la touche <code>F1</code>, l'utilisateur par défaut 57.72 +ou encore le thème graphique à utiliser. Slim propose aussi quelques 57.73 +utilisateurs spéciaux permettant de sortir du login avec <code>exit</code>, 57.74 +obtenir un Xterm avec <code>console</code>, redémarrer ou éteindre le système 57.75 +avec <code>reboot</code> ou <code>halt</code> suivi du mot de passe root. 57.76 +</p> 57.77 +<p> 57.78 +En mode LiveCD vous pouvez désactiver le lancement de Slim via l'option de boot 57.79 +<code>screen=text</code>, sur un système installé vous pouvez désintaller le 57.80 +paquet ou supprimer slim de la variable <code>RUN_DAEMONS</code> du fichier 57.81 +<code>/etc/rcS.conf</code>. 57.82 +</p> 57.83 +<p> 57.84 +Site Web proposant une section avec des thèmes: 57.85 +<a href="http://slim.berlios.de/">http://slim.berlios.de/</a> 57.86 +</p> 57.87 + 57.88 +<a name="startx"></a> 57.89 +<h3><font color="#6c0023">startx - Session graphique depuis une console Linux</font></h3> 57.90 +<p> 57.91 +Pour lancer une session graphique il suffit de taper <code>startx</code> 57.92 +dans le terminal après l'authentification (login). Si c'est la première 57.93 +fois que vous démarrez X avec l'utilisateur courant, la commande 57.94 +<code>startx</code> exécutera <code>tazx</code> pour configurer la session. La 57.95 +configuration est ensuite sauvegardée dans le fichier ~/.xsession, que 57.96 +vous pouvez modifier avec un éditeur de texte. Pour lancer X : 57.97 +</p> 57.98 +<pre> 57.99 + $ startx 57.100 +</pre> 57.101 + 57.102 +<a name="config"></a> 57.103 +<h3><font color="#6c0023">Configuration de votre session X</font></h3> 57.104 +<p> 57.105 +Par default SliTaz lance le gestionnaire de connexion Slim, une fois le nom 57.106 +d'utilisateur et le mot de passe entré, Slim va exécuter le fichiers 57.107 +<code>~/.xinitrc</code> que vous pouvez modifier à la main ou en utilisant 57.108 +<code>tazx</code>. Si vous voulez par exemple Openbox comme gestionnaire 57.109 +de fenêtres par défaut: 57.110 +</p> 57.111 +<pre> 57.112 + $ tazx openbox 57.113 +</pre> 57.114 +<h4>Avec startx</h4> 57.115 +<p> 57.116 +Quand vous lancez <code>startx</code>, le script cherche le fichier 57.117 +~/.xsession contenant ligne par ligne les applications à exécuter lors d'une 57.118 +session graphique. Ce fichier commence par lancer le serveur X avec la bonne 57.119 +résolution d'écran, suivi de diverses applications, comme un terminal xterm, 57.120 +ou Links, et pour finir on peut lancer le gestionnaire de fenêtre. 57.121 +</p> 57.122 +<h4>Exemple d'un fichier ~/.xsession</h4> 57.123 +<pre class="script"> 57.124 +# ~/.xsession: Start X session on you SliTaz system. 57.125 +# 57.126 +Xvesa -ac -shadow -screen 1024x768x24 -mouse /dev/input/mice,5 & 57.127 +sleep 2 & 57.128 +lxpanel & 57.129 +xterm -bg black -fg white -geometry 80x16+20+20 & 57.130 +exec jwm 57.131 + 57.132 +</pre> 57.133 + 57.134 +<a name="xorg"></a> 57.135 +<h3><font color="#6c0023">Xorg</font></h3> 57.136 +<p> 57.137 +Par défaut SliTaz fournit le mini serveur graphique Xvesa, le serveur Xorg 57.138 +complet est disponible dans la séléction des paquets du miroir. Xorg est un 57.139 +serveur complet, mais utilise plus de resources qu'Xvesa, si votre résolution 57.140 +est bien supportée par le mini serveur et que le taux de rafraîchissement 57.141 +vous convient, il n'y a pas de raison d'utiliser Xorg. 57.142 +</p> 57.143 +<p> 57.144 +Il n'y a pas d'interface graphique de configuration, il va donc falloir passer 57.145 +par quelques commandes, l'installation et configuration du serveur est 57.146 +relativement simple et vous pourrez toujours revenir en arrière pour réutiliser 57.147 +Xvesa. Xorg est distribué sous forme modulaire, c'est à dire que vous aurez 57.148 +besoin d'installer que le serveur, quelques fichiers de configuration et le 57.149 +bon driver pour votre carte graphique. Cela dit, le paquet 57.150 +<code>xorg-serveur</code> a les bonnes dépendances pour fonctionner directement 57.151 +avec le driver générique <code>vesa</code>. Pour installer le minimum: 57.152 +</p> 57.153 +<pre> 57.154 + # tazpkg get-install xorg-server 57.155 +</pre> 57.156 +<p> 57.157 +Une fois installé vous pouvez directemnt passer à la configuration ou encore 57.158 +installer le bon driver si vous le connaissez, exemple pour un carte Nvidia 57.159 +et pour lister tous les drivers disponibles : 57.160 +</p> 57.161 +<pre> 57.162 + # tazpkg get-install xorg-xf86-video-nv 57.163 + Liste: 57.164 + # tazpkg search xf86-video -l 57.165 +</pre> 57.166 +<h4>Configuration automatique du serveur</h4> 57.167 +<p> 57.168 +Pour configurer le serveur Xorg vous avez deux possibilités, utiliser l'option 57.169 +<code>Xorg -configure</code> ou le script <code>xorgconfig</code>. Il est 57.170 +recommendé de commencer par utiliser la configuration automatique avec 57.171 +l'option <code>-configure</code> du serveur. La configuration automatique 57.172 +d'Xorg doit se faire en mod texte sans serveur X lançé, une fois la commande 57.173 +éxécutée, vous pouvez tester la configuration ou, faire confiance et 57.174 +directement copier le fichier générer dans <code>/etc/X11</code>. Pour finir, 57.175 +vous devrez encore modifier la configuration de Slim pour qu'il utilise Xorg 57.176 +et non Xvesa. Pour vous retrouver en mode text, sortez de votre session et 57.177 +tapez simplement exit au login de Slim. Un fois en mode texte, vous pouvez 57.178 +configurer Xorg et copier le fichier, tout cela en tant qu'administrateur root: 57.179 +</p> 57.180 +<pre> 57.181 + # Xorg -configure 57.182 + # cp /root/xorg.conf.new /etc/X11/xorg.conf 57.183 +</pre> 57.184 +<h4>Utiliser Xorg avec Slim</h4> 57.185 +<p> 57.186 +Dans le fichier de configuration de Slim (<code>/etc/slim.conf</code>), il 57.187 +faut commenter (<code>#</code>) les lignes lançant Xvesa et ces options et 57.188 +renseigner <code>default_xserver </code>: 57.189 +</p> 57.190 +<pre class="script"> 57.191 +default_xserver /usr/bin/Xorg 57.192 +#default_xserver /usr/bin/Xvesa 57.193 +#xserver_arguments -ac -shadow dpms +extension Composite -screen 1024x768x24 57.194 +</pre> 57.195 +<p> 57.196 +Slim fonctionne comme un démon, il peut être stoppé ou démarré depuis une 57.197 +console texte, exemple pour démarrer le démon à la main: 57.198 +</p> 57.199 +<pre> 57.200 + # /etc/init.d/slim start 57.201 +</pre> 57.202 +<h4>xorg.conf - Fichier de configuration</h4> 57.203 +<p> 57.204 +Xorg utilise le fichiers de configuration <code>/etc/X11/xorg.conf</code>, ce 57.205 +fichier peut être généré automatiquement et édité avec votre éditeur de texte 57.206 +préféré. Le fichier de configuration et divisé en plusieures sections comprenant 57.207 +la configuration des chemins, des modules à charger, du clavier, de la souris 57.208 +ou encore de l'écran par défaut. Ce docuement ne fournit que quelques exemples, 57.209 +il est conseillé d'utiliser une fois <code>xorgconfig</code> pour générer un 57.210 +fichier complet et l'utiliser comme exemple. 57.211 +</p> 57.212 +<p> 57.213 +Clavier (fr_CH): 57.214 +</p> 57.215 +<pre class="script"> 57.216 +Section "InputDevice" 57.217 + Identifier "Keyboard0" 57.218 + Driver "kbd" 57.219 + Option "XkbRules" "xorg" 57.220 + Option "XkbModel" "pc105" 57.221 + Option "XkbLayout" "ch" 57.222 + Option "XkbVariant" "fr" 57.223 +EndSection 57.224 +</pre> 57.225 +<p> 57.226 +Souris avec detection automatique du protocol: 57.227 +</p> 57.228 +<pre class="script"> 57.229 +Section "InputDevice" 57.230 + Identifier "Mouse0" 57.231 + Driver "mouse" 57.232 + Option "Protocol" "auto" 57.233 + Option "Device" "/dev/input/mice" 57.234 + Option "ZAxisMapping" "4 5 6 7" 57.235 +EndSection 57.236 +</pre> 57.237 +<p> 57.238 +Extension Composite pour les effets de bureau: 57.239 +</p> 57.240 +<pre class="script"> 57.241 +Section "Extensions" 57.242 + Option "Composite" "1" 57.243 +EndSection 57.244 +</pre> 57.245 + 57.246 +<a name="terminalX"></a> 57.247 +<h3><font color="#6c0023">Utiliser Xvesa comme terminal X</font></h3> 57.248 +<p> 57.249 +Vous pouvez utiliser Xvesa comme terminal X, si vous avez une machine sur 57.250 +le réseau acceptant les connexions Xdmcp. Pour cela vous pouvez lancer 57.251 +le serveur avec l'option <code>-query</code> suivi du nom de machine ou de 57.252 +l'adresse IP. Exemple avec la machine 192.168.0.2 du réseau locale : 57.253 +</p> 57.254 +<pre> 57.255 + $ Xvesa -ac -shadow -screen 1024x768x24 -query 192.168.0.2 57.256 +</pre> 57.257 +<p> 57.258 +L'utilisation du serveur graphique à distance peut être d'une grande utilité, 57.259 +la rapidité d'exécution des applications va fortement dépendre du débit de la 57.260 +connexion internet et de la puissance de la machine distante. Cette technique 57.261 +fonctionne très bien au sein d'un réseau local et permet d'utiliser les 57.262 +applications installées sur la machine distante, directement sur l'écran de la 57.263 +machine locale depuis laquelle vous avez décidez de travailler. A noter que la 57.264 +machine distante peut disposer de plusieurs comptes utilisés simultanément à 57.265 +distance et/ou en accès direct. 57.266 +</p> 57.267 + 57.268 +<a name="fonts"></a> 57.269 +<h3><font color="#6c0023">Polices de caractères</font></h3> 57.270 +<p> 57.271 +La gestion des polices de caractères (<em>fonts</em>) est propulsée par le 57.272 +paquet Fontconfig. Ce paquet fournit divers outils pour ajouter, lister et 57.273 +manipuler les polices. Les <em>fonts</em> peuvent être installées en espace 57.274 +utilisateur ou au niveau du système, cela veut dire que chaque utilisateur 57.275 +peut disposer de ses propres polices ou que l'administrateur (<em>root</em>) 57.276 +peut installer des polices utilisables par tous les utilisateurs du système. 57.277 +Si vous utilisez un media USB associé au <a href="livecd.html">LiveCD</a> 57.278 +de SliTaz, vous pouvez facilement installer des polices et les retrouver 57.279 +à chaque utilisation du cdrom. 57.280 +</p> 57.281 +<h4>Installer des <em>fonts</em></h4> 57.282 +<p> 57.283 +Au niveau du système, les polices s'installent dans le répertoire : 57.284 +<code>/usr/share/fonts</code>, de base, SliTaz fournit les polices TTF Vera, 57.285 +elles prennent peu de place et ont un rendu correct. En espace utilisateur, 57.286 +les polices s'installent dans le répertoire caché : <code>.fonts/</code>, ce 57.287 +répertoire doit se situer à la racine de l'espace utilisateur. Pour créer un 57.288 +répertoire personnel destiné à accueillir des nouvelles polices, vous pouvez 57.289 +utiliser le gestionnaire de fenêtres graphique emelFM2, Clex ou utiliser 57.290 +la ligne de commande : 57.291 +</p> 57.292 +<pre> 57.293 + $ mkdir ~/.fonts 57.294 +</pre> 57.295 +<p> 57.296 +Une fois que vous avez installé de nouvelles polices, vous devez lancer 57.297 +l'outil <code>fc-cache</code> pour générer les fichiers de configuration, 57.298 +faire en sorte que vos <em>fonts</em> soient disponibles et utilisables par 57.299 +les applications graphiques : 57.300 +</p> 57.301 +<pre> 57.302 + $ fc-cache 57.303 +</pre> 57.304 + 57.305 +<!-- End of content --> 57.306 +</div> 57.307 + 57.308 +<!-- Footer. --> 57.309 +<div id="footer"> 57.310 + <div class="footer-right"></div> 57.311 + <a href="#top">Haut de la page</a> | 57.312 + <a href="index.html">Table des matières</a> 57.313 +</div> 57.314 + 57.315 +<div id="copy"> 57.316 + Copyright © 2007 <a href="http://www.slitaz.org/">SliTaz</a> - 57.317 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 57.318 + Documentation publiées sous 57.319 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 57.320 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 57.321 +</div> 57.322 + 57.323 +</body> 57.324 +</html>
58.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 58.2 +++ b/doc/index.html Sat Mar 29 12:01:05 2008 +0100 58.3 @@ -0,0 +1,154 @@ 58.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 58.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 58.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 58.7 +<head> 58.8 + <title>SliTaz - Documentation</title> 58.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 58.10 + <meta name="description" content="Documentation du projet SliTaz GNU/Linux shell howto make live-cd" /> 58.11 + <meta name="keywords" lang="fr" content="Système, libre, gnu, linux, logiciels opensource, livecd, autonome" /> 58.12 + <meta name="robots" content="index, follow, all" /> 58.13 + <meta name="revisit-after" content="7 days" /> 58.14 + <meta name="expires" content="never" /> 58.15 + <meta name="modified" content="2008-01-01 12:00:00" /> 58.16 + <meta name="author" content="Christophe Lincoln"/> 58.17 + <meta name="publisher" content="www.slitaz.org" /> 58.18 + <link rel="shortcut icon" href="../favicon.ico" /> 58.19 + <link rel="stylesheet" type="text/css" href="../slitaz.css" /> 58.20 +</head> 58.21 +<!-- 58.22 + This is SliTaz documentation main page with access to all the pages 58.23 + in the doc category with cookbook, user-guide, howto, and the pages of 58.24 + this directory. Please check your code with the W3C validator before 58.25 + publishing any documents. 58.26 +--> 58.27 +<body bgcolor="#ffffff"> 58.28 + 58.29 +<!-- Header --> 58.30 +<div id="header"> 58.31 + <a name="top"></a> 58.32 +<!-- Access --> 58.33 +<div id="access"> 58.34 + <a href="#content" title="Aller au contenu de la page">Contenu</a> | 58.35 + <a href="../en/doc/" title="English documentation">English</a> 58.36 +</div> 58.37 + <a href="http://www.slitaz.org/"><img id="logo" 58.38 + src="../pics/website/logo.png" title="www.slitaz.org" alt="www.slitaz.org" 58.39 + style="border: 0px solid ; width: 200px; height: 74px;" /></a> 58.40 + <p id="titre">#!/GNU/Linux</p> 58.41 +</div> 58.42 + 58.43 +<!-- Navigation menu --> 58.44 +<div id="nav"> 58.45 +<div id="nav_top"></div> 58.46 + <ul> 58.47 + <li><a href="../about/" title="Informations au sujet du projet SliTaz">A propos du projet</a></li> 58.48 + <li><a href="../get/" title="Téléchargements - LiveCD et sous projets">Obtenir SliTaz</a></li> 58.49 + <li><a href="../doc/" title="Handbook, Cookbook et manuels">Documentation</a></li> 58.50 + <li><a href="../packages/" title="Paquets logiciels disponibles">Paquets</a></li> 58.51 + <li><a href="../mailing-list.html" title="Support, contact et collaboration">Liste de discussion</a></li> 58.52 + <li><a href="../devel/" title="Le coin du développeur">Développement</a></li> 58.53 + <li><a href="../artwork/" title="Artwork, couleurs et images">Art & graphisme</a></li> 58.54 + <li><a href="../search.html" title="Rechercher des infos et/ou de la doc">Recherche</a></li> 58.55 + <li><a href="../sitemap.html" title="Vue globale du site web">Plan du site</a></li> 58.56 + <li><a href="http://forum.slitaz.org/" title="Forum d'aide et support">Forum</a></li> 58.57 + </ul> 58.58 +<div id="nav_bottom"> 58.59 +<div id="nav_bottom_img"></div> 58.60 +</div> 58.61 +</div> 58.62 + 58.63 +<!-- Content top. --> 58.64 +<div id="content_top"> 58.65 +<div class="top_left"></div> 58.66 +<div class="top_right"></div> 58.67 +</div> 58.68 + 58.69 +<!-- Content --> 58.70 +<div id="content"> 58.71 +<a name="content"></a> 58.72 + 58.73 +<h1><font color="#3E1220">Documentation</font></h1> 58.74 +<h2><font color="#DF8F06">Livres - Handbook & Cookbook</font></h2> 58.75 + 58.76 +<ul> 58.77 + <li><a href="handbook/">Handbook</a> - Le livre de main de SliTaz. 58.78 + Référence au sujet de l'utilisation du système au niveau utilisateur, 58.79 + administrateur et développeur en général. Il réunit des travaux de 58.80 + référence, des mini manuels et une collection d'instructions destinées à 58.81 + fournir un livre complet, de haute qualité, facilement consultable et 58.82 + fournissant des réponses rapides sur un sujet spécifique. Le Handbook 58.83 + explique comment <a href="handbook/livecd.html">utiliser le LiveCD</a>, 58.84 + donne les instructions d'installation, fournit des références pour vous 58.85 + aidez à lancer une ligne de commandes, installer des paquets logiciels <a 58.86 + href="handbook/gen-livecd.html">générer un LiveCD</a> et touche à de 58.87 + nombreux sujets, de près ou de loin. C'est le livre que nous vous 58.88 + conseillons de consulter en premier, de reconsulter, de lire en entier 58.89 + et d'apprendre par coeur...</li> 58.90 + <li><a href="cookbook/">Cookbook</a> - Le livre de cuisine de Slitaz. 58.91 + Déscription des étapes de création de SliTaz, en commençant par la 58.92 + compilation du noyau Linux, en passant par l'installation d'un server 58.93 + graphique (Xvesa), des bibliothèques GTK+ et d'applications graphiques. 58.94 + Le Cookbook est un livre technique permettant de construire un système 58.95 + GNU/Linux depuis les sources, il demande du temps et de la motivation. 58.96 + Le Cookbook contient aussi divers documents au sujet de outils SliTaz, 58.97 + du wok, de Tazwok et des paquets.</li> 58.98 +</ul> 58.99 +<h2><font color="#DF8F06">Manuels des utilitaires</font></h2> 58.100 +<ul> 58.101 + <li><a href="manuals/tazpkg.html">Tazpkg manuel</a> - Manuel du 58.102 + gestionnaire de paquets logiciels sur SliTaz. Il permet d'installer de 58.103 + nouveaux programmes, mettre à jours les paquets installés, en supprimer, 58.104 + etc.</li> 58.105 + <li><a href="manuals/tazlito.html">Tazlito manuel</a> - Manuel de l'outil 58.106 + de manipulation/génération du LiveCD de SliTaz (SliTaz Live Tool).</li> 58.107 + <li><a href="manuals/tazwok.html">Tazwok manuel</a> - Manuel de Tazwok, 58.108 + outils de compilation et générateur de paquets pour SliTaz.</li> 58.109 +</ul> 58.110 + 58.111 +<h2><font color="#DF8F06">Notes de publication</font></h2> 58.112 +<p> 58.113 +Les notes de publication de SliTaz fournissent des informations spécifique au 58.114 +sujet d'une version stable du système et donne quelques astuces utiles pour 58.115 +commencer à utiliser SliTaz. Sur le corps du LiveCD, les notes de publication 58.116 +sont instalées et accessible depuis le menu "Documentation". 58.117 +</p> 58.118 + 58.119 +<p> 58.120 +<a href="releases/1.0/relnotes.fr.html" 58.121 + >SliTaz GNU/Linux 1.0 - Notes de publication</a> 58.122 + [ <a href="releases/1.0/relnotes.fr.html">xHTML</a> ] 58.123 + [ <a href="releases/1.0/relnotes.fr.txt">Text</a> ] 58.124 +</p> 58.125 + 58.126 +<!-- End of content with round corner --> 58.127 +</div> 58.128 +<div id="content_bottom"> 58.129 +<div class="bottom_left"></div> 58.130 +<div class="bottom_right"></div> 58.131 +</div> 58.132 + 58.133 +<!-- Start of footer and copy notice --> 58.134 +<div id="copy"> 58.135 +<p> 58.136 +Dernière modification : 2008-01-01 12:00:00 - 58.137 +<a href="#top">Haut de la page</a> 58.138 +</p> 58.139 +<p> 58.140 +Copyright © 2008 <a href="http://www.slitaz.org/">SliTaz</a> - 58.141 +<a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a> 58.142 +</p> 58.143 +<!-- End of copy --> 58.144 +</div> 58.145 + 58.146 +<!-- Bottom and logo's --> 58.147 +<div id="bottom"> 58.148 +<p> 58.149 +<a href="http://validator.w3.org/check?uri=referer"><img 58.150 + src="../pics/website/xhtml10.png" alt="Valid XHTML 1.0" 58.151 + title="Code validé XHTML 1.0" 58.152 + style="width: 80px; height: 15px;" /></a> 58.153 +</p> 58.154 +</div> 58.155 + 58.156 +</body> 58.157 +</html>
59.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 59.2 +++ b/doc/manuals/tazlito.html Sat Mar 29 12:01:05 2008 +0100 59.3 @@ -0,0 +1,235 @@ 59.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 59.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 59.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 59.7 +<head> 59.8 + <title>Tazlito Manual - SliTaz Live Tool</title> 59.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 59.10 + <meta name="description" content="" /> 59.11 + <meta name="expires" content="never" /> 59.12 + <meta name="modified" content="2007-08-03 13:26:42" /> 59.13 + <style type="text/css"><!-- 59.14 + body { font: 90% sans-serif, vernada, arial; margin: 0; } 59.15 + #header { background: #f0ba08; color: black; height: 50px; 59.16 + border-top: 1px solid black; border-bottom: 1px solid black; } 59.17 + #content { margin: 0px 50px 26px 50px; } 59.18 + h1 { margin: 14px 0px 0px 16px; } 59.19 + li { line-height: 1.4em; } 59.20 + pre { padding: 5px; color: black; background: #e1e0b0; } 59.21 + pre.script { padding: 10px; color: black; background: #e8e8e8; 59.22 + border: 1px inset #333333; } 59.23 + code { font-size: 100%; color: #669900; background: transparent; } 59.24 + hr { color: white; background: white; height: 1px; border: 0; } 59.25 + --></style> 59.26 +</head> 59.27 +<body bgcolor="#ffffff"> 59.28 +<div id="header"> 59.29 +<h1><font color="#3e1220">Tazlito Manual</font></h1> 59.30 +</div> 59.31 +<hr /> 59.32 +<!-- Start content --> 59.33 +<div id="content"> 59.34 + 59.35 +<h2>NOM</h2> 59.36 +<p> 59.37 +Tazlito - SliTaz Live Tool. 59.38 +</p> 59.39 + 59.40 +<h2>SYNTAXE</h2> 59.41 +<pre> 59.42 +tazlito [command] [list|iso|flavor] [dir] 59.43 +</pre> 59.44 + 59.45 +<h2>DESCRIPTION</h2> 59.46 +<p> 59.47 +Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire 59.48 +l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne 59.49 +aussi la possibilité de générer une distribution depuis une liste de paquets 59.50 +préalablements téléchargés et stockés dans un répertoire. Pour fonctionner, 59.51 +l'application Tazlito utilise un fichier de configuration système 59.52 +/etc/slitaz-tools/tazlito.conf ou un fichier tazlito.conf se trouvant dans le 59.53 +répertoire courant. Ce fichier de configuration peut facilement être généré 59.54 +automatiquement par Tazlito, il spécifie le nom de l'image ISO, le nom du 59.55 +volume, le préparateur, le chemin vers le repositoire des paquets et celui 59.56 +vers la distribution. Tazlito permet aussi de configurer un répertoire 59.57 +contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors 59.58 +de la génération de la distribution. 59.59 +</p> 59.60 +<p> 59.61 +Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur 59.62 +SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez 59.63 +aussi un complément d'informations au sujet de création de sa propre version 59.64 +du LiveCD, via le livre de cuisine (Cookbook) de SliTaz 59.65 +(http://www.slitaz.org/doc/cookbook/) et le Handbook. 59.66 +</p> 59.67 + 59.68 +<h2>COMMANDES</h2> 59.69 +<h3><font color="#6c0023">usage</font></h3> 59.70 +<p> 59.71 +La commande 'usage' affiche une liste des commandes disponibles avec une 59.72 +courte description : 59.73 +</p> 59.74 +<pre> 59.75 + # tazlito usage 59.76 +</pre> 59.77 +<h3><font color="#6c0023">stats</font></h3> 59.78 +<p> 59.79 +Stats affiche les variables de configuration, le chemin vers les différents 59.80 +fichiers et répertoires et les informations sur l'image ISO : 59.81 +</p> 59.82 +<pre> 59.83 + # tazlito stats 59.84 +</pre> 59.85 +<h3><font color="#6c0023">gen-config</font></h3> 59.86 +<p> 59.87 +La commande 'gen-config' vous permet de générer une fichier de configuration 59.88 +prêt à être édité. Par défaut le fichier est créé dans le répertoire courant 59.89 +et peut aussi l'être dans un autre répertoire si spécifié : 59.90 +</p> 59.91 +<pre> 59.92 + # tazlito gen-config 59.93 + # tazlito gen-config /path/to/distro 59.94 +</pre> 59.95 +<h3><font color="#6c0023">configure</font></h3> 59.96 +<p> 59.97 +La commande configure permet de configurer le fichier de configuration 59.98 +système ou celui trouvé dans le répertoire courant : 59.99 +</p> 59.100 +<pre> 59.101 + # tazlito configure 59.102 +</pre> 59.103 +<h3><font color="#6c0023">gen-iso</font></h3> 59.104 +<p> 59.105 +La commande 'gen-iso' pour <em>Generate ISO</em> permet de générer une nouvelle 59.106 +image ISO du LiveCD suite à des modifications et ajouter dans le système 59.107 +racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire 59.108 +contenant la structure du système Live, cette structure peur facilement être 59.109 +construite avec la commande 'extract-distro', modifiée et reconstruite via : 59.110 +</p> 59.111 +<pre> 59.112 + # tazlito gen-iso 59.113 +</pre> 59.114 +<h3><font color="#6c0023">gen-initiso</font></h3> 59.115 +<p> 59.116 +La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en 59.117 +reconstruisant préalablement l'initramfs compressé du système. L'initramfs 59.118 +contient tous le système racine de la distribution et doit être reconstruite 59.119 +en cas de modifications sur les fichiers. 59.120 +</p> 59.121 +<pre> 59.122 + # tazlito gen-initiso 59.123 +</pre> 59.124 +<h3><font color="#6c0023">list-flavors</font></h3> 59.125 +<p> 59.126 +La commande 'list-flavors' télécharge si nécessaire et affiche la liste des 59.127 +différentes saveurs disponibles. On peut forcer le téléchargement avec 59.128 +'--recharge'. 59.129 +</p> 59.130 +<pre> 59.131 + # tazlito list-flavors 59.132 + # tazlito list-flavors --recharge 59.133 +</pre> 59.134 +<h3><font color="#6c0023">get-flavor</font></h3> 59.135 +<p> 59.136 +La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers 59.137 +nécessaires à 'gen-distro' pour refabriquer une saveur. 59.138 +</p> 59.139 +<pre> 59.140 + # tazlito get-flavor saveur-particuliere 59.141 +</pre> 59.142 +<h3><font color="#6c0023">show-flavor</font></h3> 59.143 +<p> 59.144 +La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses 59.145 +dimensions après refabrication. Les options '--brief' et '--noheader' réduisent 59.146 +l'affichage produit. 59.147 +</p> 59.148 +<pre> 59.149 + # tazlito show-flavor saveur-particuliere 59.150 + # tazlito show-flavor saveur-particuliere --brief 59.151 + # tazlito show-flavor saveur-particuliere --brief --noheader 59.152 +</pre> 59.153 +<h3><font color="#6c0023">gen-flavor</font></h3> 59.154 +<p> 59.155 +La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur 59.156 +à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor 59.157 +produit pourra être ensuite envoyé à slitaz.org. 59.158 +</p> 59.159 +<pre> 59.160 + # tazlito gen-flavor nouvelle-saveur 59.161 +</pre> 59.162 +<h3><font color="#6c0023">extract-distro</font></h3> 59.163 +<p> 59.164 +La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du 59.165 +LiveCD, pour en reconstruire la structure (Racine du cdrom et du système). 59.166 +Il est ensuite possible de faire les modifications ou ajouts souhaités, pour 59.167 +reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple 59.168 +d'utilisation : 59.169 +</p> 59.170 +<pre> 59.171 + # tazlito extract-distro slitaz-cooking.iso 59.172 +</pre> 59.173 +<h3><font color="#6c0023">gen-distro</font></h3> 59.174 +<p> 59.175 +La commande <em>Generate Distribution</em> permet de générer la structure du 59.176 +système Live et une image ISO via une liste de paquets. Pour fonctionner, cette 59.177 +commande a besoin d'une liste de paquets, d'un répertoire contenant tous les 59.178 +paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution. 59.179 +La liste de paquets peut être extraite d'une saveur par la commande get-flavor. 59.180 +Si l'on utilise le Live-CD, les options --cdrom et --iso=<image-iso> permettent 59.181 +de refabriquer les packets qui placent des fichiers dans /boot sans être obligé 59.182 +de les télécharger et récupère les fichiers additionnels du Live-CD. 59.183 +Le chemin vers les différents répertoires sont à configurer dans le fichier de 59.184 +configuration utilisé et les paquets peuvent être téléchargés depuis les 59.185 +miroirs de SliTaz ou générés par Tazwok. Pour générer une distro : 59.186 +</p> 59.187 +<pre> 59.188 + # tazlito gen-distro 59.189 + # tazlito gen-distro --cdrom 59.190 + # tazlito gen-distro --iso=slitaz.iso 59.191 + # tazlito gen-distro package-list 59.192 +</pre> 59.193 +<h3><font color="#6c0023">clean-distro</font></h3> 59.194 +<p> 59.195 +Supprime tous les fichiers générés ou extraits de la structure du LiveCD : 59.196 +</p> 59.197 +<pre> 59.198 + # tazlito clean-distro 59.199 +</pre> 59.200 +<h3><font color="#6c0023">addhacker</font></h3> 59.201 +<p> 59.202 +La commande 'addhacker' permet d'ajouter l'utilisateur Hacker à la distribution, 59.203 +cela permet d'avoir un compte utilisateur sans mot de passe. A noter que cette 59.204 +commande effectue un changement de permissions sur tous les fichiers contenus 59.205 +dans <code>/home/hacker</code> : 59.206 +</p> 59.207 +<pre> 59.208 + # tazlito addhacker 59.209 +</pre> 59.210 +<h3><font color="#6c0023">check-distro</font></h3> 59.211 +<p> 59.212 +Cette commande permet simplement de vérifier si les fichiers non installés par 59.213 +des paquets, sont bien présents dans la distro : 59.214 +</p> 59.215 +<pre> 59.216 + # tazlito check-distro 59.217 +</pre> 59.218 +<h3><font color="#6c0023">burn-iso</font></h3> 59.219 +<p> 59.220 +Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer 59.221 +l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle 59.222 +du fichier de configuration courant, mais il est possible de spécifier une 59.223 +autre image via la ligne de commande : 59.224 +</p> 59.225 +<pre> 59.226 + # tazlito burn-iso 59.227 + # tazlito burn-iso slitaz-hacked.iso 59.228 +</pre> 59.229 + 59.230 +<h2>MAINTENEUR</h2> 59.231 +<p> 59.232 +Christophe Lincoln <pankso at slitaz.org> 59.233 +</p> 59.234 + 59.235 +<!-- End content --> 59.236 +</div> 59.237 +</body> 59.238 +</html>
60.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 60.2 +++ b/doc/manuals/tazpkg.html Sat Mar 29 12:01:05 2008 +0100 60.3 @@ -0,0 +1,324 @@ 60.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 60.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 60.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 60.7 +<head> 60.8 + <title>Tazpkg Manual - Manuel du gestionnaire de paquets 'tazpkg'</title> 60.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 60.10 + <meta name="description" content="tazpkg manuel utilisation documentation description commandes" /> 60.11 + <meta name="expires" content="never" /> 60.12 + <meta name="modified" content="2008-02-06 00:02:00" /> 60.13 + <style type="text/css"><!-- 60.14 + body { font: 90% sans-serif, vernada, arial; margin: 0; } 60.15 + #header { background: #f0ba08; color: black; height: 50px; 60.16 + border-top: 1px solid black; border-bottom: 1px solid black; } 60.17 + #content { margin: 0px 50px 26px 50px; } 60.18 + h1 { margin: 14px 0px 0px 16px; } 60.19 + li { line-height: 1.4em; } 60.20 + pre { padding: 5px; color: black; background: #e1e0b0; } 60.21 + pre.script { padding: 10px; color: black; background: #e8e8e8; 60.22 + border: 1px inset #333333; } 60.23 + code { font-size: 100%; color: #669900; background: transparent; } 60.24 + hr { color: white; background: white; height: 1px; border: 0; } 60.25 + --></style> 60.26 +</head> 60.27 +<body bgcolor="#ffffff"> 60.28 +<div id="header"> 60.29 +<h1><font color="#3e1220">Tazpkg Manual</font></h1> 60.30 +</div> 60.31 +<hr /> 60.32 +<!-- Start content --> 60.33 +<div id="content"> 60.34 + 60.35 +<h2>NOM</h2> 60.36 +<p> 60.37 +Tazpkg - Tiny autonomous zone package manager 60.38 +</p> 60.39 + 60.40 +<h2>SYNTAXE</h2> 60.41 +<pre> 60.42 + tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt] 60.43 +</pre> 60.44 + 60.45 +<h2>DESCRIPTION</h2> 60.46 +<p> 60.47 +Tazpkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant 60.48 +d'installer, lister, télécharger, mettre à jour ou enlever des paquets 60.49 +précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de 60.50 +recherche et une commande pour la création de paquets. Il a été créé pour les 60.51 +besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets 60.52 +utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de 60.53 +fichiers (fs) compressé avec gzip, la recette et une éventuelle description. 60.54 +Tazpkg fournit aussi un système de gestion des dépendances basé sur les 60.55 +recettes des paquets. La recette contient toutes les informations au sujet du 60.56 +paquet, elle peut aussi contenir les fonctions de pre et post installation. 60.57 +Cette même recette est par ailleurs utilisée par Tazwok pour compiler les 60.58 +sources et créer un paquet tazpkg. 60.59 +</p> 60.60 +<p> 60.61 +Tazpkg est écrit en script shell depuis rien (from scratch), compatible 60.62 +Bash, et fonctionnant avec Ash du projet Busybox. Tazpkg est distribué 60.63 +sous license libre GNU gpl v3. 60.64 +</p> 60.65 + 60.66 +<h2>COMMANDES</h2> 60.67 +<h3><font color="#6c0023">list</font></h3> 60.68 +<p> 60.69 +Liste et compte les paquets installés sur le système. Cette commande permet 60.70 +d'afficher sur une colonne la liste tous les paquets installés, vous pouvez 60.71 +aussi utiliser la commande de recherche (search) pour avoir une liste en 60.72 +fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister 60.73 +les catégories, les paquets en fonction de leur catégorie et les paquets 60.74 +bloqués : 60.75 +</p> 60.76 +<pre> 60.77 + # tazpkg list 60.78 + # tazpkg list cat|categories 60.79 + # tazpkg list blocked 60.80 +</pre> 60.81 +<h3><font color="#6c0023">xhtml-list</font></h3> 60.82 +<p> 60.83 +La commande 'xhtml-list' permet de créer une liste au format xHTML des 60.84 +paquets installés sur le système, une fois générée, cette liste peut être 60.85 +lue avec votre navigateur Web préféré. Cette commande peut être lancée 60.86 +en tant que simple utilisateur et crée par défaut une liste nommée 60.87 +'installed-packages.html' dans le répertoire courant. A noter que vous 60.88 +pouvez aussi changer le nom de la liste générée via la ligne de 60.89 +commande : 60.90 +</p> 60.91 +<pre> 60.92 + # tazpkg xhtml-list 60.93 + # tazpkg xhtml-list list-name.html 60.94 +</pre> 60.95 +<h3><font color="#6c0023">list-mirror</font></h3> 60.96 +<p> 60.97 +Liste et compte les paquets disponnibles sur le miroir. Cette commande va 60.98 +afficher le dernier fichier packages.list rechargé depuis le miroir, si la 60.99 +liste des paquets n'existe pas, il vous sera demandé de lancer la commande 60.100 +'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste 60.101 +des paquets disponibles. L'option --diff est utilisée pour afficher le 60.102 +fichier des différences entre la dernière et l'actuelle liste des paquets : 60.103 +</p> 60.104 +<pre> 60.105 + # tazpkg list-mirror 60.106 + # tazpkg list-mirror --diff 60.107 +</pre> 60.108 +<h3><font color="#6c0023">info</font></h3> 60.109 +<p> 60.110 +Donne les informations disponibles dans la recette du paquet en question, sa 60.111 +version, sa catégorie, le mainteneur, son site Web et ses éventuelles 60.112 +dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) : 60.113 +</p> 60.114 +<pre> 60.115 + # tazpkg info busybox 60.116 +</pre> 60.117 +<h3><font color="#6c0023">desc</font></h3> 60.118 +<p> 60.119 +Description du paquet (si elle existe). Cette commande affiche le fichier 60.120 +description.txt propre à chaque paquet, la description est un simple fichier 60.121 +texte ne dépassant pas le 80 caractères pour un affichage standard dans un 60.122 +terminal. Si la description du paquet n'existe pas, vous pouvez la créer et 60.123 +l'envoyer au mainteneur du paquet (quelques lignes suffisent) : 60.124 +</p> 60.125 +<pre> 60.126 + # tazpkg desc busybox 60.127 +</pre> 60.128 +<h3><font color="#6c0023">list-files</font></h3> 60.129 +<p> 60.130 +Liste et compte les fichiers installés avec un paquet. Cette commande va 60.131 +simplement lire et classer le fichier files.list propre à chaque paquet, ce 60.132 +fichier est généré automatiquement lors de la création, il est aussi utilisé 60.133 +pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour 60.134 +lister les fichier installés avec le paquet bc : 60.135 +</p> 60.136 +<pre> 60.137 + # tazpkg list-files bc 60.138 +</pre> 60.139 +<h3><font color="#6c0023">search</font></h3> 60.140 +<p> 60.141 +Recherche de paquets par patron ou nom de paquet. La commande 60.142 +va chercher le terme voulu dans les paquets installés et dans la liste des 60.143 +paquets disponibles sur le miroir. Pour obtenir la plus récente liste des 60.144 +paquets installables depuis internet, il suffit de lancer 'tazpkg recharge' 60.145 +avant d'effectuer une recherche : 60.146 +</p> 60.147 +<pre> 60.148 + # tazpkg search gcc 60.149 +</pre> 60.150 +<h3><font color="#6c0023">search-files</font></h3> 60.151 +<p> 60.152 +La commande 'search-file' permet de rechercher un fichier parmi tous les 60.153 +fichiers installés par tous les paquets. Cette commande est très utile pour 60.154 +trouver le chemin complet vers un fichier et savoir si un fichier est bien 60.155 +présent sur le système. Exemple : 60.156 +</p> 60.157 +<pre> 60.158 + $ tazpkg search-file libnss 60.159 +</pre> 60.160 +<h3><font color="#6c0023">install</font></h3> 60.161 +<p> 60.162 +Cette commande permet l'installation d'un paquet local avec l'extension 60.163 +.tazpkg. Voir la commande 'get-install' pour installer un paquet depuis 60.164 +internet. A noter que vous pouvez forcer l'installation via l'option 60.165 +--forced, désinstaller et réinstaller ou encore spécifier la racine du système 60.166 +dans lequel vous désirez installer le paquets via l'option --root= : 60.167 +</p> 60.168 +<pre> 60.169 + # tazpkg install package-1.0.tazpkg 60.170 + Ou : 60.171 + # tazpkg install path/to/package-1.0.tazpkg --forced 60.172 + Ou : 60.173 + # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs 60.174 +</pre> 60.175 +<h3><font color="#6c0023">install-list</font></h3> 60.176 +<p> 60.177 +Installation d'un set de paquets listés dans un fichier. Cette commande 60.178 +permet d'installer plusieurs paquets en une seule commande et peut aussi être 60.179 +forcée : 60.180 +</p> 60.181 +<pre> 60.182 + # tazpkg install-list my-packages.list 60.183 + # tazpkg install-list my-packages.list --forced 60.184 +</pre> 60.185 +<h3><font color="#6c0023">remove</font></h3> 60.186 +<p> 60.187 +Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette 60.188 +commande va supprimer tous les fichiers installés avec le paquet, pour 60.189 +afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg 60.190 +suivie du nom du paquet en question. Exemple avec le paquet bc : 60.191 +</p> 60.192 +<pre> 60.193 + # tazpkg remove bc 60.194 +</pre> 60.195 +<h3><font color="#6c0023">extract</font></h3> 60.196 +<p> 60.197 +Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le 60.198 +répertoire de destination, le paquet sera extrait dans le répertoire courant 60.199 +en utilisant le nom paquet-version : 60.200 +</p> 60.201 +<pre> 60.202 + # tazpkg extract package.tazpkg 60.203 + # tazpkg extract package.tazpkg target/dir 60.204 +</pre> 60.205 +<h3><font color="#6c0023">pack</font></h3> 60.206 +<p> 60.207 +La commande 'pack' permet de créer un paquet depuis un répertoire préparé à 60.208 +l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer 60.209 +manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création 60.210 +automatique de paquets). Pour empaqueter un paquet : 60.211 +</p> 60.212 +<pre> 60.213 + # tazpkg pack package-version 60.214 +</pre> 60.215 +<h3><font color="#6c0023">repack</font></h3> 60.216 +<p> 60.217 +La commande 'repack' permet de recréer un paquet depuis les fichiers présents 60.218 +sur le système où il a été précédemment installé. Pour réempaqueter un paquet : 60.219 +</p> 60.220 +<pre> 60.221 + # tazpkg repack package 60.222 +</pre> 60.223 +<h3><font color="#6c0023">recharge</font></h3> 60.224 +<p> 60.225 +Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette 60.226 +commande va télécharger la plus récente liste des paquets installables depuis 60.227 +le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne 60.228 +liste. Une fois la liste à jour, vous pouvez la consulter via la commande 60.229 +'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg. 60.230 +Pour réafficher la liste des différences, vous pouvez utiliser la commande 60.231 +'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système, 60.232 +vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des 60.233 +paquets : 60.234 +</p> 60.235 +<pre> 60.236 + # tazpkg recharge 60.237 +</pre> 60.238 +<h3><font color="#6c0023">upgrade</font></h3> 60.239 +<p> 60.240 +La commande 'upgrade' permet de mettre à jour tous les paquets installés et 60.241 +disponibles sur le miroir courant. La mise à jour des paquets est une 60.242 +importante partie du système, elle permet de garder un système sécurisé avec 60.243 +les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit 60.244 +régulièrement des mises à jours de sécurité et propose généralement les 60.245 +dernières versions des logiciels. A noter que cette fonction est destinée aux 60.246 +personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis 60.247 +à jour seront perdus lors de l'arrêt du système. Pour garder un système un 60.248 +jour : 60.249 +</p> 60.250 +<pre> 60.251 + # tazpkg upgrade 60.252 +</pre> 60.253 +<h3><font color="#6c0023">check</font></h3> 60.254 +<p> 60.255 +La commande 'check' permet de vérifier les dépendances sur les paquets 60.256 +installés et de vérifier si tous les fichiers nécessaires à la reconstruction 60.257 +des paquets sont bien présents : 60.258 +</p> 60.259 +<pre> 60.260 + # tazpkg check 60.261 +</pre> 60.262 +<h3><font color="#6c0023">block ou unblock</font></h3> 60.263 +<p> 60.264 +Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet 60.265 +installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste 60.266 +des paquets bloqués est contenue dans le fichier : 60.267 +/var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main. 60.268 +Pour bloquer ou débloquer un paquet tel que Grub : 60.269 +</p> 60.270 +<pre> 60.271 + # tazpkg block grub 60.272 + Ou : 60.273 + # tazpkg unblock grub 60.274 +</pre> 60.275 +<h3><font color="#6c0023">get</font></h3> 60.276 +<p> 60.277 +Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé 60.278 +est stocké dans le répertoire courant, pour connaître le chemin vous pouvez 60.279 +utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit 60.280 +de lancer la commande : 60.281 +</p> 60.282 +<pre> 60.283 + # tazpkg get grub 60.284 +</pre> 60.285 +<h3><font color="#6c0023">get-install</font></h3> 60.286 +<p> 60.287 +Installer un paquet depuis un mirroir sur internet. La commande 'get-install' 60.288 +commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas 60.289 +déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la 60.290 +liste des paquets sur le miroir il faut utiliser la commande 'list-mirror' 60.291 +(voir aussi recharge). Pour installer un paquet tel que 'grub' : 60.292 +</p> 60.293 +<pre> 60.294 + # tazpkg get-install grub 60.295 +</pre> 60.296 +<h3><font color="#6c0023">clean-cache</font></h3> 60.297 +<p> 60.298 +Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation 60.299 +de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour 60.300 +gagner de la bande passante en cas de réinstallation, mais il se peut que vous 60.301 +vouliez libérer de la place sur le disque dur ou que vous désiriez 60.302 +retélécharger des paquets : 60.303 +</p> 60.304 +<pre> 60.305 + # tazpkg clean-cache 60.306 +</pre> 60.307 +<h3><font color="#6c0023">setup-mirror</font></h3> 60.308 +<p> 60.309 +Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors 60.310 +l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant 60.311 +par des espaces. A noter que vous pouvez aussi modifier à la main le 60.312 +fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant 60.313 +la liste (packages.list) et les paquets : 60.314 +</p> 60.315 +<pre> 60.316 + # tazpkg setup-mirror 60.317 +</pre> 60.318 + 60.319 +<h2>MAINTENEUR</h2> 60.320 +<p> 60.321 +Christophe Lincoln <pankso at slitaz.org> 60.322 +</p> 60.323 + 60.324 +</div> 60.325 +<!-- End content --> 60.326 +</body> 60.327 +</html>
61.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 61.2 +++ b/doc/manuals/tazwok.html Sat Mar 29 12:01:05 2008 +0100 61.3 @@ -0,0 +1,231 @@ 61.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 61.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 61.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 61.7 +<head> 61.8 + <title>Tazwok Manual</title> 61.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 61.10 + <meta name="description" content="" /> 61.11 + <meta name="expires" content="never" /> 61.12 + <meta name="modified" content="2008-02-06 15:05:00" /> 61.13 + <style type="text/css"><!-- 61.14 + body { font: 90% sans-serif, vernada, arial; margin: 0; } 61.15 + #header { background: #f0ba08; color: black; height: 50px; 61.16 + border-top: 1px solid black; border-bottom: 1px solid black; } 61.17 + #content { margin: 0px 50px 26px 50px; } 61.18 + h1 { margin: 14px 0px 0px 16px; } 61.19 + li { line-height: 1.4em; } 61.20 + pre { padding: 5px; color: black; background: #e1e0b0; } 61.21 + pre.script { padding: 10px; color: black; background: #e8e8e8; 61.22 + border: 1px inset #333333; } 61.23 + code { font-size: 100%; color: #669900; background: transparent; } 61.24 + hr { color: white; background: white; height: 1px; border: 0; } 61.25 + --></style> 61.26 +</head> 61.27 +<body bgcolor="#ffffff"> 61.28 +<div id="header"> 61.29 +<h1><font color="#3e1220">Tazwok Manual</font></h1> 61.30 +</div> 61.31 +<hr /> 61.32 +<!-- Start content --> 61.33 +<div id="content"> 61.34 + 61.35 +<h2>NOM</h2> 61.36 +<p> 61.37 +Tazwok - SliTaz sources and packages cooker. 61.38 +</p> 61.39 + 61.40 +<h2>SYNTAXE</h2> 61.41 +<pre> 61.42 + tazwok [command] [package|list|category|dir] [--option] 61.43 +</pre> 61.44 + 61.45 +<h2>DESCRIPTION</h2> 61.46 +<p> 61.47 +Tazwok est un outils en ligne de commande permettant de configurer et de 61.48 +compiler un paquet depuis les sources. Tazwok permet aussi de créer des 61.49 +paquets prêts à être utilisé par Tazpkg, le gestionnaire de paquets créer 61.50 +pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette 61.51 +et toutes les informations nécessaires à la construction du paquet, cette 61.52 +recette est aussi utilisée par Tazpkg et se compose de différentes variables 61.53 +et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf) 61.54 +pour connaître le chemin vers le wok, les paquets sources et les paquets 61.55 +(.tazpkg) générés. Il est aussi capable de générer une liste paquets avec 61.56 +leurs sommes md5, des créer un nouveau paquet de manière interactive, de faire 61.57 +une recherche, de nettoyer les fichiers générés ou encore de cuire plusieurs 61.58 +paquets en une seule fois (Voir les commandes disponibles). 61.59 +</p> 61.60 +<p> 61.61 +Tazwok est écript en script shell depuis rien (from scratch), compatible Bash, 61.62 +et fonctionnant avec Ash du projet Busybox. Tazwok est distribué sous license 61.63 +libre GNU gpl v3. Les recettes avec leures commades sont basée sur le livre 61.64 +de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet 61.65 +de Tazwok et du dévellopement de SliTaz. 61.66 +</p> 61.67 + 61.68 +<h2>COMMANDES</h2> 61.69 +<h3><font color="#6c0023">usage</font></h3> 61.70 +<p> 61.71 +La commande 'usage' affiche la liste des commandes diponibles avec une petite 61.72 +description en English : 61.73 +</p> 61.74 +<pre> 61.75 + # tazwok usage 61.76 +</pre> 61.77 +<h3><font color="#6c0023">stats</font></h3> 61.78 +<p> 61.79 +Stats affiche les informations contenue dans le fichier de configuration et 61.80 +le nombre de paquets disponibles dans le wok : 61.81 +</p> 61.82 +<pre> 61.83 + # tazwok stats 61.84 +</pre> 61.85 +<h3><font color="#6c0023">list</font></h3> 61.86 +<p> 61.87 +La commande 'list' permet de lister l'ensemble des paquets contenus dans le 61.88 +wok ou de lister les catégories par défauts (vous pouvez créer la votre). Elle 61.89 +permet aussi de lister les paquets d'une catégorie : 61.90 +</p> 61.91 +<pre> 61.92 + # tazwok list 61.93 + # tazwok list category 61.94 +</pre> 61.95 +<h3><font color="#6c0023">info</font></h3> 61.96 +<p> 61.97 +Cette commande donne des informations sur le paquet, nom, version, etc. Info 61.98 +ce base sur la recette du paquet pour connaître les informations, c'est les 61.99 +mêmes infos affichées par Tazpkg et les paquets installés : 61.100 +</p> 61.101 +<pre> 61.102 + # tazwok info package 61.103 +</pre> 61.104 +<h3><font color="#6c0023">check-log</font></h3> 61.105 +<p> 61.106 +Lors de la compilation et génération du paquet binaire, Tazwok génére quelques 61.107 +messages de log stockés dans un fichier 'process.log'. Pour les afficher : 61.108 +</p> 61.109 +<pre> 61.110 + # tazwok check-log package 61.111 +</pre> 61.112 +<h3><font color="#6c0023">search</font></h3> 61.113 +<p> 61.114 +Search permet de faire une recherche de paquet dans le wok. Vous pouvez 61.115 +spécifier un terme ou un nom de paquet : 61.116 +</p> 61.117 +<pre> 61.118 + # tazwok search name 61.119 +</pre> 61.120 +<h3><font color="#6c0023">compile</font></h3> 61.121 +<p> 61.122 +Compile va compiler. Cette commande utilise les régles de compilation 61.123 +(compile_rules) spécifiées dans la recette du paquet en question, pour 61.124 +compiler les sources. A noter qu'il n'y a pas forcement de régles de 61.125 +compilation, des paquets sont directement généré par 'genpkg' et que la 61.126 +commande 'cook' permet de compiler les sources et générer le paquet binaire 61.127 +en une seule fois. Exemple : 61.128 +</p> 61.129 +<pre> 61.130 + # tazwok compile package 61.131 +</pre> 61.132 +<h3><font color="#6c0023">genpkg</font></h3> 61.133 +<p> 61.134 +Genpkg pour <em>Generate package</em>, va générer le paquet (.tazpkg) en 61.135 +utilisant la fonction 'genpkg_rules' trouvée dans sa recette et compresser 61.136 +les fichiers. Une fois le paquet généré, il est stocké dans le repositoire 61.137 +des paquetss spécifié dans le fichier de configuration ('tazwok stats' pour 61.138 +afficher la configuration courante). Le paquet peut ensuite facilement 61.139 +s'installer via Tazpkg ou être utilisé par Tazlito pour générer une 61.140 +distribution LiveCD automatiquement. A noter que les fichiers standards tels 61.141 +que les locales, le pixmap ou le fichier.desktop sont automatiquement copiés 61.142 +dans $fs/usr/share, si les chemins sont standards ou si le fichier existe dans 61.143 +/stuff. Utilisation de 'genpkg' : 61.144 +</p> 61.145 +<pre> 61.146 + # tazwok genpkg package 61.147 +</pre> 61.148 +<h3><font color="#6c0023">cook</font></h3> 61.149 +<p> 61.150 +Cook va simplement compiler et empaqueter les paquet en une seule fois : 61.151 +</p> 61.152 +<pre> 61.153 + # tazwok cook package 61.154 +</pre> 61.155 +<h3><font color="#6c0023">cook-list</font></h3> 61.156 +<p> 61.157 +Cette commade va lancer 'tazwok cook' sur tous les paquets contenus dans la 61.158 +liste spécifiées en argument. Cook-list est utilisés par exemple, pour cuire 61.159 +le système de base, les applications de base, le système X, etc. Avant de 61.160 +lancer cette commande avec un grand nombre de paquets, il est conseillé de 61.161 +cuire une fois le système de base (base-system) sans la glibc. Sur SliTaz, 61.162 +vous trouverez des exemples de liste de cuisson (cooklist) dans le répertoire 61.163 +des exemples /usr/share/examples/tazwok/cooklists : 61.164 +</p> 61.165 +<pre> 61.166 + # tazwok cook-list packages.cooklist 61.167 +</pre> 61.168 +<h3><font color="#6c0023">clean</font></h3> 61.169 +<p> 61.170 +Clean permet simplement de supprimer tous les fichiers générés par la 61.171 +compilation et l'empaquetage, pour recommencer à cuire (cook) : 61.172 +</p> 61.173 +<pre> 61.174 + # tazwok clean package 61.175 +</pre> 61.176 +<h3><font color="#6c0023">new-tree</font></h3> 61.177 +<p> 61.178 +La commande 'new-tree' permet de créer un nouveau paquet dans le wok et 61.179 +peut s'utiliser de manière interactive. New-tree va créer le répertoire du 61.180 +paquet et une recette modèle (receipt), cette recette peur être éditée avec 61.181 +votre éditeur de texte préféré et peut se configurer via l'option 61.182 +'--interactive'. Pour vous aider vous pouvez regarder des recettes existantes 61.183 +et lire la documentation du Cookbook. Exemple d'utilisation : 61.184 +</p> 61.185 +<pre> 61.186 + # tazwok new-tree package 61.187 + # tazwok new-tree package --interactive 61.188 +</pre> 61.189 +<h3><font color="#6c0023">gen-list</font></h3> 61.190 +<p> 61.191 +La commande 'gen-list' permet de générer une liste de paquets (packages.list), 61.192 +leurs sommes md5 (packages.md5) et en option une liste de paquet contenant plus 61.193 +d'informations (packages.txt). Les simples listes sont crées en se basant sur 61.194 +les paquets contenus dans un répertoire. La liste au format texte est construite 61.195 +avec les recettes contenues dans un wok. Le répertoire des paquets par défaut 61.196 +est celui spécifié dans le fichier de configuration, vous avez aussi la 61.197 +possibilité de spécifier le répertoire à utiliser sur la ligne de commande. 61.198 +Utilisation de la commande 'gen-list' : 61.199 +</p> 61.200 +<pre> 61.201 + # tazwok gen-list 61.202 + # tazwok gen-list --text 61.203 + # tazwok gen-list /path/to/repository 61.204 +</pre> 61.205 +<h3><font color="#6c0023">gen-clean-wok et clean-wok</font></h3> 61.206 +<p> 61.207 +La commande 'gen-clean-wok' permet de générer un wok propre depuis le wok 61.208 +courant. Cette commande est utile pour sauvegarder un version du wok ou copier 61.209 +un wok pour tester avec un autre. Quand à la commande 'clean-wok', elle va 61.210 +nettoyer tous les paquets du wok courant et supprimer tous les fichiers 61.211 +générés. Pour récupérer un wok propre ou nettoyer le wok actuel : 61.212 +</p> 61.213 +<pre> 61.214 + # tazwok gen-clean-wok path/to/new-wok 61.215 + # tazwok clean-wok 61.216 +</pre> 61.217 +<h3><font color="#6c0023">remove</font></h3> 61.218 +<p> 61.219 +Supprime le paquet spécifié du wok, avec tous les fichiers, stuff et recette 61.220 +y compris : 61.221 +</p> 61.222 +<pre> 61.223 + # tazwok remove package 61.224 +</pre> 61.225 + 61.226 +<h2>MAINTENEUR</h2> 61.227 +<p> 61.228 +Christophe Lincoln <pankso at slitaz.org> 61.229 +</p> 61.230 + 61.231 +<!-- End content --> 61.232 +</div> 61.233 +</body> 61.234 +</html>
62.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 62.2 +++ b/doc/manuals/template.html Sat Mar 29 12:01:05 2008 +0100 62.3 @@ -0,0 +1,60 @@ 62.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 62.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 62.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 62.7 +<head> 62.8 + <title>Taz Manual - Template</title> 62.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 62.10 + <meta name="description" content="" /> 62.11 + <meta name="expires" content="never" /> 62.12 + <meta name="modified" content="2007-08-03 13:26:42" /> 62.13 + <style type="text/css"><!-- 62.14 + body { font: 90% sans-serif, vernada, arial; margin: 0; } 62.15 + #header { background: #f0ba08; color: black; height: 50px; 62.16 + border-top: 1px solid black; border-bottom: 1px solid black; } 62.17 + #content { margin: 0px 50px 26px 50px; } 62.18 + h1 { margin: 14px 0px 0px 16px; } 62.19 + li { line-height: 1.4em; } 62.20 + pre { padding: 5px; color: black; background: #e1e0b0; } 62.21 + pre.script { padding: 10px; color: black; background: #e8e8e8; 62.22 + border: 1px inset #333333; } 62.23 + code { font-size: 100%; color: #669900; background: transparent; } 62.24 + hr { color: white; background: white; height: 1px; border: 0; } 62.25 + --></style> 62.26 +</head> 62.27 +<body bgcolor="#ffffff"> 62.28 +<div id="header"> 62.29 +<h1><font color="#3e1220">Taz Manual</font></h1> 62.30 +</div> 62.31 +<hr /> 62.32 +<!-- Start content --> 62.33 +<div id="content"> 62.34 + 62.35 +<h2>NOM</h2> 62.36 +<p> 62.37 +Taz - Tiny autonomus zone 62.38 +</p> 62.39 + 62.40 +<h2>SYNTAXE</h2> 62.41 +<pre> 62.42 +taz [command] [package|dir|pattern] [dir] 62.43 +</pre> 62.44 + 62.45 +<h2>DESCRIPTION</h2> 62.46 +<p> 62.47 + 62.48 +</p> 62.49 + 62.50 +<h2>COMMANDES</h2> 62.51 +<p> 62.52 + 62.53 +</p> 62.54 + 62.55 +<h2>MAINTENEUR</h2> 62.56 +<p> 62.57 + 62.58 +</p> 62.59 + 62.60 +<!-- End content --> 62.61 +</div> 62.62 +</body> 62.63 +</html>
63.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 63.2 +++ b/doc/releases/1.0/book.css Sat Mar 29 12:01:05 2008 +0100 63.3 @@ -0,0 +1,170 @@ 63.4 +/* 63.5 + CSS style for SliTaz GNU/Linux *book. 63.6 + Pankso 2007 - www.slitaz.org 63.7 +*/ 63.8 + 63.9 +body { 63.10 + font: 13px sans-serif, vernada, arial; 63.11 + background: #222222; 63.12 + margin: 0; 63.13 + padding-bottom: 100%; 63.14 +} 63.15 + 63.16 +#header { 63.17 + background: #BFB06B url(images/css/header.png) repeat-x top; 63.18 + color: black; 63.19 + height: 50px; 63.20 + border-top: 1px solid black; 63.21 + border-bottom: 1px solid black; 63.22 +} 63.23 +#quicknav { 63.24 + margin-right: 6px; 63.25 + text-align: right; 63.26 + font-size: 12px; 63.27 + } 63.28 +#quicknav { 63.29 + margin-right: 6px; 63.30 +} 63.31 + 63.32 +#quicknav a { 63.33 + background: inherit; 63.34 + color: #222222; 63.35 +} 63.36 + 63.37 +#quicknav a:hover { 63.38 + background: inherit; 63.39 + color: #EDEDED; 63.40 +} 63.41 + 63.42 +/* content. */ 63.43 + 63.44 +#content { 63.45 + background: white url(images/css/content-tl.png) no-repeat top left; 63.46 + color: black; 63.47 + padding: 20px; 63.48 + margin: 30px 50px 0px 50px; 63.49 + width: auto; 63.50 + text-align: justify; 63.51 +} 63.52 + 63.53 +#content li { 63.54 + line-height: 1.5em; 63.55 + text-align: left; 63.56 +} 63.57 + 63.58 +/* Footer. */ 63.59 + 63.60 +#footer { 63.61 + font-size: 11px; 63.62 + font-weight: bold; 63.63 + background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left; 63.64 + color: black; 63.65 + height: 20px; 63.66 + padding: 6px 0px 0px 10px; 63.67 + margin: 0px 50px 0px 50px; 63.68 + width: auto; 63.69 + text-align: center ; 63.70 +} 63.71 + 63.72 +#footer a { 63.73 + text-decoration: none; 63.74 + background: #eaeaea; 63.75 + color: #3E1220; 63.76 +} 63.77 + 63.78 +#footer a:hover { 63.79 + background: #eaeaea; 63.80 + color: #DF8F06; 63.81 +} 63.82 + 63.83 +/* Legal informations */ 63.84 + 63.85 +#copy { 63.86 + font-size: 11px ; 63.87 + text-align: center ; 63.88 + background: transparent; 63.89 + color: #a8a8a8; 63.90 + padding-top: 20px; 63.91 +} 63.92 + 63.93 +#copy a { 63.94 + background: inherit; 63.95 + color: #a8a8a8; 63.96 +} 63.97 + 63.98 +#copy a:hover { 63.99 + background: inherit; 63.100 + color: #EDEDED; 63.101 +} 63.102 + 63.103 +/* Div for round corners. */ 63.104 + 63.105 +.content-right, .footer-right { 63.106 + width: 16px; 63.107 + color: white; 63.108 + background-color: #333333; 63.109 +} 63.110 +.content-right { 63.111 + background: url(images/css/content-tr.png) no-repeat top right; 63.112 + height: 16px; 63.113 + right: 50px; 63.114 + top: 82px; 63.115 + position: absolute; 63.116 +} 63.117 + 63.118 +.footer-right { 63.119 + background: url(images/css/footer-br.png) no-repeat bottom right; 63.120 + height: 20px; 63.121 + float: right; 63.122 +} 63.123 + 63.124 +/* General HTML entities for content. */ 63.125 + 63.126 +h1 { 63.127 + margin: 0px 0px 0px 16px; 63.128 +} 63.129 + 63.130 +h2 { 63.131 + margin: 12px 0; 63.132 + color: #484B7C; 63.133 + background: white; 63.134 +} 63.135 + 63.136 +h3 { 63.137 + font-weight: bold; 63.138 + color: #6c0023; 63.139 + background: white; 63.140 +} 63.141 + 63.142 +a { 63.143 + text-decoration: underline; 63.144 +} 63.145 +a:hover { 63.146 + text-decoration: none; 63.147 +} 63.148 + 63.149 +pre { 63.150 + padding: 5px; 63.151 + color: black; 63.152 + background: #e1e0b0; 63.153 +} 63.154 +pre.script { 63.155 + padding: 10px; 63.156 + color: black; 63.157 + background: #e8e8e8; 63.158 + border: 1px inset #333333; 63.159 +} 63.160 + 63.161 +code { 63.162 + font-size: 12px; 63.163 + color: #669900; 63.164 + background: transparent; 63.165 +} 63.166 + 63.167 +li { 63.168 + line-height: 1.4em; 63.169 +} 63.170 + 63.171 +hr { 63.172 + border: 0pt none; 63.173 +}
64.1 Binary file doc/releases/1.0/favicon.ico has changed
65.1 Binary file doc/releases/1.0/images/css/content-tl.png has changed
66.1 Binary file doc/releases/1.0/images/css/content-tr.png has changed
67.1 Binary file doc/releases/1.0/images/css/footer-bl.png has changed
68.1 Binary file doc/releases/1.0/images/css/footer-br.png has changed
69.1 Binary file doc/releases/1.0/images/css/header.png has changed
70.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 70.2 +++ b/doc/releases/1.0/relnotes.fr.html Sat Mar 29 12:01:05 2008 +0100 70.3 @@ -0,0 +1,283 @@ 70.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 70.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 70.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 70.7 +<head> 70.8 + <title>SliTaz GNU/Linux 1.0 - Notes de publication</title> 70.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 70.10 + <meta name="description" content="slitaz doc system releases notes information cooking" /> 70.11 + <meta name="expires" content="never" /> 70.12 + <meta name="modified" content="2008-03-14 11:30:00" /> 70.13 + <meta name="publisher" content="www.slitaz.org" /> 70.14 + <meta name="author" content="Christophe Lincoln"/> 70.15 + <link rel="shortcut icon" href="favicon.ico" /> 70.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 70.17 +</head> 70.18 +<body bgcolor="#ffffff"> 70.19 + 70.20 +<!-- Header and quick navigation --> 70.21 +<div id="header"> 70.22 +<div align="right" id="quicknav"> 70.23 + <a name="top"></a> 70.24 + <a href="http://www.slitaz.org/doc/">www.slitaz.org/doc/</a> 70.25 +</div> 70.26 +<h1><font color="#3E1220">SliTaz GNU/Linux 1.0</font></h1> 70.27 +</div> 70.28 + 70.29 +<!-- Content. --> 70.30 +<div id="content"> 70.31 +<div class="content-right"></div> 70.32 + 70.33 +<h2><font color="#DF8F06">Notes de publication</font></h2> 70.34 + 70.35 +<ul> 70.36 + <li><a href="#overview">Vue d'ensemble.</a></li> 70.37 + <li><a href="#hardware">Matériel supporté.</a></li> 70.38 + <li><a href="#livecd">Saveurs de LiveCD.</a></li> 70.39 + <li><a href="#install">Installation.</a></li> 70.40 + <li><a href="#kernel">Noyau Linux.</a></li> 70.41 + <li><a href="#packages">Paquets logiciels.</a></li> 70.42 + <li><a href="#desktop">Bureaux graphiques.</a></li> 70.43 + <li><a href="#support">Support et documentation.</a></li> 70.44 + <li><a href="#security">Sécurité.</a></li> 70.45 + <li><a href="#upgrade">De Cooking à Stable.</a></li> 70.46 + <li><a href="#people">Les personnes du projets.</a></li> 70.47 +</ul> 70.48 + 70.49 +<a name="overview"></a> 70.50 +<h3><font color="#6c0023">Vue d'ensemble</font></h3> 70.51 +<p> 70.52 +SliTaz GNU/Linux 1.0 a été publiée le 22 mars 2008 après deux ans de travail. 70.53 +SliTaz est un système libre, complet et communautaire, proposant 448 paquets 70.54 +logiciels facilement installables via le gestionnaire de paquets Tazpkg. Le 70.55 +support des LiveCD à saveur est éprouvé et permet de créer facilement une 70.56 +distribution personnalisée ou de disposer d'un système destiné à une tâche 70.57 +spécifique telle que le traitement video, le graphisme ou le développement. 70.58 +Le projet fournit un support technique aux utilisateurs via la liste de 70.59 +discussion et le forum officiel. Le livre de main ou Handbook de SliTaz, 70.60 +contient les informations et instructions pour apprendre à utiliser et finement 70.61 +configurer le système. SliTaz peut s'installer ou se mettre à jour en mode 70.62 +graphique et en mode texte via un installateur qui se veut simple, intuitif et 70.63 +rapide. La distribution peut aussi être utilisée depuis un media USB, le 70.64 +formatage et la configuration d'un périphérique USB peut se faire en quelques 70.65 +commandes avec TazUSB. 70.66 +</p> 70.67 + 70.68 +<a name="hardware"></a> 70.69 +<h3><font color="#6c0023">Matériel supporté</font></h3> 70.70 +<p> 70.71 +SliTaz GNU/Linux supporte toutes les machines à base processeur dit i486 ou 70.72 +X86, compatible Intel. Un minimum de 128 MB est conseillé pour utiliser le 70.73 +corps du LiveCD, 64 Mb pour les saveurs slitaz-loram et 16 Mb avec un peu de 70.74 +swap pour les saveurs slitaz-loram-cdrom ayant la même séléction de paquets 70.75 +que le corps. Avec une saveur loram le système est moins réactif mais permet 70.76 +d'installer SliTaz graphiquement sur de très anciennes machines. Une fois 70.77 +installée SliTaz fonctionne bien avec un minimum de 16 Mb, mais il faut 70.78 +oublier Firefox pour naviguer sur le web et utiliser Links par exemple. La 70.79 +plupart des cartes réseau et cartes son supportées par le noyau sont 70.80 +présentes, la gestion de l'énergie et activée par défaut avec l'ACPI et le 70.81 +support des batteries de PC portable se fait via les modules ac et battery, 70.82 +en mode LiveCD l'option laptop permet de charger les modules de gestion 70.83 +de la batterie au démarrage. 70.84 +</p> 70.85 + 70.86 +<a name="livecd"></a> 70.87 +<h3><font color="#6c0023">Saveurs de LiveCD</font></h3> 70.88 +<p> 70.89 +SliTaz GNU/Linux est distribuée sous la forme d'un LiveCD bootable permettant 70.90 +d'installer graphiquement le système sur disque dur et permettant d'emporter 70.91 +le système avec soi afin de retrouver ses applications et documents lors de 70.92 +déplacements. Le projet distribue une image ISO nommée core, c'est le corps 70.93 +du système fournissant une séléction de paquets multi-utilisations, permettant 70.94 +de surfer sur le Web, écouter de la musique, éditer ou extraire des pistes 70.95 +audio, créer des images, développer, installer rapidement des outils en PHP, 70.96 +gérer des bases de donées SQL, éditer des images ISO ou encore graver des 70.97 +CD/DVD. Il suffit d'un clique dans le menu des applications pour trouver les 70.98 +logiciels installés et classés par catégorie. 70.99 +</p> 70.100 +<p> 70.101 +Le corps (core) du LiveCD peut aussi se reconstruire et générer des LiveCD 70.102 +à saveur particulières graphiquement ou en ligne de commande (plus puissant). 70.103 +La manière la plus simple pour créer son propre LiveCD est de démarrer avec 70.104 +le LiveCD corps, installer les paquets voulus et générer un distribution avec 70.105 +Tazlito ou d'utiliser une des saveurs disponible sur le miroir. Pour obtenir 70.106 +une liste des saveurs disponibles, pensez à recharger la liste de temps en 70.107 +temps avec la commande 'tazlito list-flavors --recharge'. 70.108 +</p> 70.109 + 70.110 +<a name="install"></a> 70.111 +<h3><font color="#6c0023">Installation</font></h3> 70.112 +<p> 70.113 +L'installation du système est entièrement automatisée et peut se faire en mode 70.114 +graphique ou mode texte. Si vous voulez installer vos propres saveurs 70.115 +de LiveCD, il suffit de conserver slitaz-tools dans la liste des paquets de la 70.116 +saveur en question. Les prérequis matériel et autres informations utiles à 70.117 +l'installation sur disque dur sont décrits directement dans l'installateur 70.118 +et dans le Handbook. Si vous désirez partitionner un disque avant installation, 70.119 +vous pouvez rapidement utiliser Gparted en mode Live. A la fin de 70.120 +l'installation, il est possible d'installer le gestionnaire de démarrage 70.121 +(bootloader) GRUB, il est capable de démarrer des systèmes GNU/Linux, BSD ou 70.122 +Windows. Cela permet d'installer SliTaz sur la même machine qu'un autre système 70.123 +tout en laissant le choix du système à utiliser au démarrage de la machine. 70.124 +</p> 70.125 + 70.126 +<a name="kernel"></a> 70.127 +<h3><font color="#6c0023">Noyau Linux</font></h3> 70.128 +<p> 70.129 +SliTaz GNU/linux 1.0 est distribuée avec le noyau Linux 2.6.24.2, patché pour 70.130 +supporter la compression LZMA et corriger un problème d'affichage dans la 70.131 +console virtuelle. Le support des disques IDE et SCSI est intégré ainsi que 70.132 +celui des systèmes de fichiers ext2 et ext3. La plupart des cartes réseau 70.133 +ethernet sont supportées soit directement, soit sous forme de modules 70.134 +chargeables avec 'modprobe'. La capture video quant à elle nécessite les 70.135 +modules ieee1394, raw1394 et ohci1394. La gestion des modules/drivers des 70.136 +cartes son se fait avec 'soundconf'. Une liste complète de modules disponibles 70.137 +peut être obtenue via la commande 'modprobe -l'. La configuration des modules 70.138 +à charger au démarrage est située dans le fichier /etc/rcS.conf, en mode LiveCD 70.139 +vous pouvez utiliser l'option modprobe=mod1,mod2 pour charger divers modules. 70.140 +La configuration du noyau Linux de SliTaz est disponible dans le fichier 70.141 +compressé /proc/config.gz et dans le dépôt Mercurial du wok. 70.142 +</p> 70.143 + 70.144 +<a name="packages"></a> 70.145 +<h3><font color="#6c0023">Paquets logiciels</font></h3> 70.146 +<p> 70.147 +La gestion de paquets logiciels se fait avec le gestionnaire de paquets Tazpkg, 70.148 +simple, intuitif, rapide, stable et proposant un mode interactif. Parmi les 70.149 +448 paquets disponibles vous trouverez de quoi transformer votre machine en 70.150 +bureau graphique complet et moderne avec e17, en atelier de graphisme avec 70.151 +en autre Gimp et Inkscape. SliTaz peut aussi devenir un studio video avec Kino, 70.152 +une borne internet avec messagerie internet, VOIP et navigateur web. Le système 70.153 +est aussi conçu pour être un serveur puissant, léger, rapide et stable avec 70.154 +LightTPD/PHP installés par défaut, le support CGI Perl ou Python, Rsync pour 70.155 +les sauvegardes incrémentales et IPtables pour le par-feu. SliTaz peut bien sûr 70.156 +fournir un système de développement complet avec entre autre le compilateur 70.157 +GCC 4.2.2, Mercurial, l'IDE Geany et tous les paquets de développement des 70.158 +librairies. Les paquets peuvent être trouvés via la fonction de rechercher de 70.159 +Tazpkg ou via l'interface du site Web: 70.160 +<a href="http://www.slitaz.org/packages/">http://www.slitaz.org/packages/</a> 70.161 +</p> 70.162 +<p> 70.163 +Les paquets binaires du miroir peuvent être recompilés en utilisant le wok 70.164 +et Tazwok pour cuire, toutes la documentation développeur est contenue dans 70.165 +le livre de cuisine ou Cookbook de SliTaz toujours accessible depuis le site 70.166 +Web du projet. 70.167 +</p> 70.168 + 70.169 +<a name="desktop"></a> 70.170 +<h3><font color="#6c0023">Bureaux graphiques</font></h3> 70.171 +<p> 70.172 +Le bureau fourni par défaut avec le coeur du LiveCD est propulsé par JWM, un 70.173 +gestionnaire de fenêtres très léger et stable, l'intégration de la barre des 70.174 +tâches nommée LXpanel permet d'avoir un menu généré dynamiquement en fonction 70.175 +des standards de Freedesktop. Le principe du bureau est d'avoir un petit menu 70.176 +via un clique sur l'écran avec des favoris, les effets graphiques, les outils 70.177 +SliTaz pour LiveCD ou LiveUSB, tout ce qui concerne la configuration de JWM 70.178 +et les actions système. Les applications sont elles, disponibles via le menu 70.179 +des applications généré par LXpanel. 70.180 +</p> 70.181 +<p> 70.182 +Via le support des saveurs de LiveCD ou sur un système installé, vous avez 70.183 +la possibilité d'installer l'environnement de bureau Enlightenment (e17) et 70.184 +le gestionnaire de fenêtres Openbox. Les différentes sessions peuvent être 70.185 +séléctionnées via la touche F1 du gestionnaire de connexion Slim, pour 70.186 +modifier la session par défaut vous pouvez utiliser l'utilitaire 'tazx' ou 70.187 +éditer à la main votre fichier ~/.xinitrc personnel. 70.188 +</p> 70.189 + 70.190 +<a name="support"></a> 70.191 +<h3><font color="#6c0023">Support et documentation</font></h3> 70.192 +<p> 70.193 +Le projet SliTaz propose divers moyens de support et d'aide aux utilisateurs 70.194 +du système, à commencer par la liste de discussion ou Mailing List, le forum 70.195 +et le canal IRC. La documentation utilisateur est contenue dans le livre de 70.196 +main ou Hanbook. Il contient beaucoup d'informations permettant de configurer 70.197 +SliTaz dans les moindres détails. Le livre est lisible depuis le site web du 70.198 +projet. Les manuels des différents outils sont installés sur le système et 70.199 +accessibles depuis le menu Documentation. Ils décrivent toutes les commandes 70.200 +possibles avec l'outil en question. Au niveau dévelopeur, la construction 70.201 +du système ou l'utilisation du wok et des recettes sont soigeusement décrites 70.202 +dans le livre de cuisine ou Cookbook. Les livres, manuels et notes de 70.203 +publication sont en ligne: 70.204 +<a href="http://www.slitaz.org/doc/">http://www.slitaz.org/doc/</a> 70.205 +</p> 70.206 + 70.207 +<a name="security"></a> 70.208 +<h3><font color="#6c0023">Sécurité</font></h3> 70.209 +<p> 70.210 +La version stable bénéficie de mise à jour de sécurité, il est important de 70.211 +penser à recharger et mettre à jour les paquets régulièrement. Au niveau du 70.212 +réseau le par-feu est assuré pas IPtables, le serveur LightTPD supporte les 70.213 +authentifications par mots de passe cryptés et Dropbear fournit un client et un 70.214 +serveur SSH sécurisé. Les mots de passe des utilisateurs du système sont aussi 70.215 +cryptés et seul l'administarteur root peut modifier les fichiers système. Pour 70.216 +plus d'informations ou apprendre à configurer le par-feu, vous pouvez vous 70.217 +référer au Handbook. Les paquets en rapport à la sécurité sont classés dans 70.218 +la catégorie: security. 70.219 +</p> 70.220 + 70.221 +<a name="upgrade"></a> 70.222 +<h3><font color="#6c0023">De Cooking à Stable</font></h3> 70.223 +<p> 70.224 +L'installateur de SliTaz GNU/Linux propose une fonction de mise à jour système 70.225 +permettant de passer un système en cuission (Cooking) en version stable. Pour 70.226 +mettre à jour un système il vous faut démarrer sur le LiveCD stable, lancer 70.227 +l'installateur en appuyant sur Upgrade et spécifier ensuite la partition 70.228 +contenant le système à mettre à jour. L'installateur va nettoyer le système et 70.229 +réinstaller tous les paquets non présents sur le cdrom depuis le miroir. Une 70.230 +fois terminé, vous pourrez redémarrer sur votre nouvelle version de SliTaz. 70.231 +A noter que cette methode peut aussi servir à refaire une installation propre 70.232 +du système tout en retrouvant la séléction des paquets précédemment installés. 70.233 +</p> 70.234 +<p> 70.235 +A noter que l'installateur va conserver un copie des listes de paquets et une 70.236 +archive complète du répertoire des fichiers de configuration /etc (etc.tar.gz) 70.237 +dans: /var/lib/slitaz-installer 70.238 +</p> 70.239 + 70.240 +<a name="people"></a> 70.241 +<h3><font color="#6c0023">Les personnes du projet</font></h3> 70.242 +<p> 70.243 +SliTaz est fier d'être un projet communautaire et international, les personnes 70.244 +du projet sont celles qui développent la distribution, s'occupent du site Web 70.245 +corrigent les logiciels sur les dépôts Hg ou écrivent de la documentation 70.246 +officielle. En passant par la Suisse, la France, le Quebec, l'Algérie et 70.247 +l'Angleterre: 70.248 +</p> 70.249 +<ul> 70.250 + <li>Christophe Lincoln</li> 70.251 + <li>Pascal Bellard</li> 70.252 + <li>Eric Joseph-Alexandre</li> 70.253 + <li>Julien Rabier</li> 70.254 + <li>Paul Issot</li> 70.255 + <li>Andrew Miller</li> 70.256 + <li>Serge Daigle</li> 70.257 + <li>Gauthier Bar</li> 70.258 + <li>Mohamed Jabara</li> 70.259 + <li>Gwenhaël Goavec-Merou</li> 70.260 + <li>Didier Bretin</li> 70.261 +</ul> 70.262 +<p> 70.263 +Le projet tient encore à remercier tous les relecteurs, testeurs, hackers 70.264 +et utilisateurs ayant pris du temps pour faire avancer la distribution. 70.265 +</p> 70.266 + 70.267 +<!-- End of content --> 70.268 +</div> 70.269 + 70.270 +<!-- Footer. --> 70.271 +<div id="footer"> 70.272 + <div class="footer-right"></div> 70.273 + <a href="#top">Haut de la page</a> | 70.274 + <a href="index.html">Index of /usr/share/doc/slitaz</a> 70.275 +</div> 70.276 + 70.277 +<div id="copy"> 70.278 + Copyright © 2008 <a href="http://www.slitaz.org/">SliTaz</a> - 70.279 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 70.280 + Documentation publiées sous 70.281 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 70.282 + et codée en <a href="http://validator.w3.org/">xHTML 1.0 valide</a>. 70.283 +</div> 70.284 + 70.285 +</body> 70.286 +</html>
71.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 71.2 +++ b/doc/releases/1.0/relnotes.fr.txt Sat Mar 29 12:01:05 2008 +0100 71.3 @@ -0,0 +1,218 @@ 71.4 +SliTaz GNU/Linux 1.0 - Notes de publication Mars 2008 71.5 +=============================================================================== 71.6 + 71.7 + 71.8 + * Vue d'ensemble 71.9 + * Matériel supporté 71.10 + * Saveurs de LiveCD 71.11 + * Installation 71.12 + * Noyau Linux 71.13 + * Paquets logiciels 71.14 + * Bureaux graphiques 71.15 + * Support et documentation 71.16 + * Sécurité 71.17 + * De Cooking à Stable 71.18 + * Les personnes du projets 71.19 + 71.20 + 71.21 +Vue d'ensemble 71.22 +-------------- 71.23 +SliTaz GNU/Linux 1.0 a été publiée le 22 mars 2008 après deux ans de travail. 71.24 +SliTaz est un système libre, complet et communautaire, proposant 448 paquets 71.25 +logiciels facilement installables via le gestionnaire de paquets Tazpkg. Le 71.26 +support des LiveCD à saveur est éprouvé et permet de créer facilement une 71.27 +distribution personnalisé ou de disposer d'un système destiné à une tâche 71.28 +spécifique telle que le traitement video, le graphisme ou le développement. 71.29 +Le projet fournit un support technique aux utilisateurs via la liste de 71.30 +discution et le forum officiel. Le livre de main ou Handbook de SliTaz, 71.31 +contient les infomations et instructions pour apprendre à utiliser et finement 71.32 +configurer le système. SliTaz peur s'installer ou se mettre à jour en mode 71.33 +graphique et en mode texte via un installateur qui se veut simple, intuitif et 71.34 +rapide. La distribution peut aussi être utilisée depuis un media USB, le 71.35 +formatage et la configuration d'un périphérique USB peut se faire en quelques 71.36 +commandes avec TazUSB. 71.37 + 71.38 + 71.39 +Matériel supporté 71.40 +----------------- 71.41 +SliTaz GNU/Linux supporte toutes les machines à base processeur dit i486 ou 71.42 +X86, compatible Intel. Un minimum de 128 MB est conseillé pour utiliser le 71.43 +corps du LiveCD, 64 Mb pour les saveurs slitaz-loram et 16 Mb avec un peu de 71.44 +swap pour les saveurs slitaz-loram-cdrom ayant la même séléction de paquets 71.45 +que le corps. Avec une saveur loram le système est moins réactif mais permet 71.46 +d'installer SliTaz graphiquement sur de très anciennes machines. Une fois 71.47 +installée SliTaz fonctionne bien avec un minimum de 16 Mb, mais il faut 71.48 +oublier Firefox pour naviguer sur le web et utiliser Links par exemple. La 71.49 +plupart des cartes réseau et cartes son supportées par le noyau sont 71.50 +présentes, la gestion de l'energie et activée par défaut avec l'ACPI et le 71.51 +support des batteries de PC portable se fait via les modules ac et battery, 71.52 +en mode LiveCD l'option laptop permet de charger les modules de gestion 71.53 +de la batterie au démarrage. 71.54 + 71.55 + 71.56 +Saveurs de LiveCD 71.57 +----------------- 71.58 +SliTaz GNU/Linux est distribuée sous la forme d'un LiveCD bootable permettant 71.59 +d'installer graphiquement le système sur disque dur et permettant d'emporter 71.60 +le système avec soi afin de retrouver ses applications et documents lors de 71.61 +déplacements. Le projet distribue une image ISO nommée core, c'est le corps 71.62 +du système fournissant une séléction de paquets multi-utilisations, permettant 71.63 +de surfer sur le Web, écouter de la musique, éditer ou extraire des pistes 71.64 +audio, créer des images, développer, installer rapidement des outils en PHP, 71.65 +gérer des bases de donées SQL, éditer des images ISO ou encore graver des 71.66 +CD/DVD. Il suffit d'un clique dans le menu des applications pour trouver les 71.67 +logiciels installés et classés par catégorie. 71.68 + 71.69 +Le corps (core) du LiveCD peut aussi se reconstruire et générer des LiveCD's 71.70 +à saveur particulières graphiquement ou en ligne de commande (plus puissant). 71.71 +La manière la plus simple pour créer son propre LiveCD est de démarrer avec 71.72 +le LiveCD corps, installer les paquets voulus et générer un distribution avec 71.73 +Tazlito ou d'utiliser une des saveurs disponible sur le miroir. Pour obtenir 71.74 +une liste des saveurs disponibles, pensez à recharger la liste de temps en 71.75 +temps avec la commande 'tazlito list-flavors --recharge'. 71.76 + 71.77 + 71.78 +Installation 71.79 +------------ 71.80 +L'installation du système est entièrement automatisée et peut se faire en mode 71.81 +graphique ou mode texte. Si vous voulez installer vos propres saveurs 71.82 +de LiveCD, il suffit de conserver slitaz-tools dans la liste des paquets de la 71.83 +saveur en question. Les prérequis matériel et autres informations utiles à 71.84 +l'installation sur disque dur sont décrites directement dans l'installateur 71.85 +et dans le Handbook. Si vous désirez partitionner un disque avant installation, 71.86 +vous pouvez rapidement utiliser Gparted en mode Live. A la fin de 71.87 +l'installation, il est possible d'installer le gestionnaire de démarrage 71.88 +(bootloader) GRUB, il est capable de démarrer des systèmes GNU/Linux, BSD ou 71.89 +Windows. Cela permet d'installer SliTaz sur la même machine qu'un autre système 71.90 +tout en laissant le choix du système à utiliser au démarrage de la machine. 71.91 + 71.92 + 71.93 +Noyau Linux 71.94 +----------- 71.95 +SliTaz GNU/linux 1.0 est distribuée avec le noyau Linux 2.6.24.2, patché pour 71.96 +supporter la compression LZMA et corriger un problème d'affichage dans la 71.97 +console virtuelle. Le support des disques IDE et SCSI est intégré ainsi que 71.98 +celui des systèmes de fichiers ext2 et ext3. La plupart des cartes réseau 71.99 +ethernet sont supportées soit directement, soit sous forme de modules 71.100 +chargeables avec 'modprobe'. La capture video quant à elle nécessite les 71.101 +modules ieee1394, raw1394 et ohci1394. La gestion des modules/drivers des 71.102 +cartes son se fait avec 'soundconf'. Une liste complète de modules disponibles 71.103 +peut être obtenue via la commande 'modprobe -l'. La configuration des modules 71.104 +à charger au démarrage est située dans le fichier /etc/rcS.conf, en mode LiveCD 71.105 +vous pouvez utiliser l'option modprobe=mod1,mod2 pour charger divers modules. 71.106 +La configuration du noyau Linux de SliTaz est disponible dans le fichier 71.107 +compressé /proc/config.gz et dans le dépôt Mercurial du wok. 71.108 + 71.109 + 71.110 +Paquets logiciels 71.111 +----------------- 71.112 +La gestion de paquets logiciels se fait avec le gestionnaire de paquets Tazpkg, 71.113 +simple, intuitif, rapide, stable et proposant un mode interactif. Parmi les 71.114 +448 paquets disponibles vous trouverez de quoi transformer votre machine en 71.115 +bureau graphique complet et moderne avec e17, en atelier de graphisme avec 71.116 +en autre Gimp et Inkscape. SliTaz peut aussi devenir un studio video avec Kino, 71.117 +une borne internet avec messagerie internet, VOIP et navigateur web. Le système 71.118 +est aussi conçu pour être un serveur puissant, léger, rapide et stable avec 71.119 +LightTPD/PHP installés par défaut, le support CGI Perl ou Python, Rsync pour 71.120 +les sauvegardes incrémentales et IPtables pour le par-feu. SliTaz peut bien sûr 71.121 +fournir un système de développement complet avec entre autre le compilateur 71.122 +GCC 4.2.2, Mercurial, l'IDE Geany et tous les paquets de développement des 71.123 +librairies. Les paquets peuvent être trouvés via la fonction de rechercher de 71.124 +Tazpkg ou via l'interface du site Web: http://www.slitaz.org/packages/ 71.125 + 71.126 +Les paquets binaires du miroir peuvent être recompilés en utilisant le wok 71.127 +et Tazwok pour cuire, toutes la documentation développeur est contenue dans 71.128 +le livre de cuisine ou Cookbook de SliTaz toujours accessible depuis le site 71.129 +Web du projet. 71.130 + 71.131 + 71.132 +Bureaux graphiques 71.133 +------------------ 71.134 +Le bureau fourni par défaut avec le coeur du LiveCD est propulsé par JWM, un 71.135 +gestionnaire de fenêtres très léger et stable, l'intégration de la barre des 71.136 +tâches nommée LXpanel permet d'avoir un menu généré dynamiquement en fonction 71.137 +des standards de Freedesktop. Le principe du bureau est d'avoir un petit menu 71.138 +via un clique sur l'écran avec des favoris, les effets graphiques, les outils 71.139 +SliTaz pour LiveCD ou LiveUSB, tout ce qui concerne la configuration de JWM 71.140 +et les actions système. Les applications sont elles, disponibles via le menu 71.141 +des applications généré par LXpanel. 71.142 + 71.143 +Via le support des saveurs de LiveCD ou sur un système installé, vous avez 71.144 +la possibilité d'installer l'environnement de bureau Enlightenment (e17) et 71.145 +le gestionnaire de fenêtres Openbox. Les différentes sessions peuvent être 71.146 +séléctionnées via la touche F1 du gestionnaire de connexion Slim, pour 71.147 +modifier la session par défaut vous pouvez utiliser l'utilitaire 'tazx' ou 71.148 +éditer à la main votre fichier ~/.xinitrc personnel. 71.149 + 71.150 + 71.151 +Support et documentation 71.152 +------------------------ 71.153 +Le projet SliTaz propose divers moyens de support et d'aide aux utilisateurs 71.154 +du système, à commencer par la liste de discussion ou Mailing List, le forum 71.155 +et le canal IRC. La documentation utilisateur est contenue dans le livre de 71.156 +main ou Hanbook. Il contient beaucoup d'informations permettant de configurer 71.157 +SliTaz dans les moindres détails. Le livre est lisible depuis le site web du 71.158 +projet. Les manuels des différents outils sont installés sur le système et 71.159 +accessibles depuis le menu Documentation. Ils décrivent toutes les commandes 71.160 +possibles avec l'outil en question. Au niveau dévelopeur, la construction 71.161 +du système ou l'utilisation du wok et des recettes sont soigeusement décrites 71.162 +dans le livre de cuisine ou Cookbook. Les livres, manuels et notes de 71.163 +publication sont en ligne: http://www.sitaz.org/doc/ 71.164 + 71.165 + 71.166 +Sécurité 71.167 +-------- 71.168 +La version stable bénéficie de mise à jour de sécurité, il est important de 71.169 +penser à recharger et mettre à jour les paquets régulièrement. Au niveau du 71.170 +réseau le par-feu est assuré pas IPtables, le serveur LightTPD supporte les 71.171 +authentifications par mots de passe cryptés et Dropbear fournit un client et un 71.172 +serveur SSH sécurisé. Les mots de passe des utilisateurs du système sont aussi 71.173 +cryptés et seul l'administarteur root peut modifier les fichiers système. Pour 71.174 +plus d'informations ou apprendre à configurer le par-feu, vous pouvez vous 71.175 +référer au Handbook. Les paquets en rapport à la sécurité sont classés dans 71.176 +la catégorie: security. 71.177 + 71.178 + 71.179 +De Cooking à Stable 71.180 +------------------- 71.181 +L'installateur de SliTaz GNU/Linux propose une fonction de mise à jour système 71.182 +permettant de passer un système en cuission (Cooking) en version stable. Pour 71.183 +mettre à jour un système il vous faut démarrer sur le LiveCD stable, lancer 71.184 +l'installateur en appuyant sur Upgrade et spécifier ensuite la partition 71.185 +contenant le système à mettre à jour. L'installateur va nettoyer le système et 71.186 +réinstaller tous les paquets non présents sur le cdrom depuis le miroir. Une 71.187 +fois terminé, vous pourrez redémarrer sur votre nouvelle version de SliTaz. 71.188 +A noter que cette methode peut aussi servir à refaire une installation propre 71.189 +du système tout en retrouvant la séléction des paquets précédemment installés. 71.190 + 71.191 +A noter que l'installateur va conserver un copie des listes de paquets et une 71.192 +archive complète du répertoire des fichiers de configuration /etc (etc.tar.gz) 71.193 +dans: /var/lib/slitaz-installer 71.194 + 71.195 + 71.196 +Les personnes du projet 71.197 +----------------------- 71.198 +SliTaz est fier d'être un projet communautaire et international, les personnes 71.199 +du projet sont celles qui développent la distribution, s'occupent du site Web 71.200 +corrigent les logiciels sur les dépôts Hg ou écrivent de la documentation 71.201 +officielle. En passant par la Suisse, la France, le Quebec, l'Algérie et 71.202 +l'Angleterre: 71.203 + 71.204 + Christophe Lincoln 71.205 + Pascal Bellard 71.206 + Eric Joseph-Alexandre 71.207 + Julien Rabier 71.208 + Paul Issot 71.209 + Andrew Miller 71.210 + Serge Daigle 71.211 + Gauthier Bar 71.212 + Gwenhaël Goavec-Merou 71.213 + Mohamed Jabara 71.214 + Didier Bretin 71.215 + 71.216 +Le projet tient encore à remercier tous les relecteurs, testeurs, hackers 71.217 +et utilisateurs ayant pris du temps pour faire avancer la distribution. 71.218 + 71.219 + 71.220 +=============================================================================== 71.221 +