website rev 623

pt: remove scratchbook
author Claudinei Pereira <claudinei@slitaz.org>
date Wed Mar 31 03:09:00 2010 +0000 (2010-03-31)
parents 767b3325187b
children d4a085d5de0e
files pt/doc/scratchbook/base-apps.html pt/doc/scratchbook/base-ncurses.html pt/doc/scratchbook/base-system.html pt/doc/scratchbook/book.css pt/doc/scratchbook/boot-scripts.html pt/doc/scratchbook/favicon.ico pt/doc/scratchbook/gtk-apps.html pt/doc/scratchbook/gtk-libs.html pt/doc/scratchbook/images/css/content-tl.png pt/doc/scratchbook/images/css/content-tr.png pt/doc/scratchbook/images/css/footer-bl.png pt/doc/scratchbook/images/css/footer-br.png pt/doc/scratchbook/images/css/header.png pt/doc/scratchbook/index.html pt/doc/scratchbook/locale.html pt/doc/scratchbook/template.html pt/doc/scratchbook/x-window-system.html pt/doc/scratchbook/xorg.html
line diff
     1.1 --- a/pt/doc/scratchbook/base-apps.html	Wed Mar 31 03:06:23 2010 +0000
     1.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.3 @@ -1,553 +0,0 @@
     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="en" lang="en">
     1.7 -<head>
     1.8 -    <title>SliTaz Scratchbook - Base Applications</title>
     1.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    1.10 -    <meta name="description" content="" />
    1.11 -    <meta name="expires" content="never" />
    1.12 -    <meta name="modified" content="2008-11-22 17:00: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 of contents</a> |
    1.26 -    <a href="base-ncurses.html">Base ncurses</a>
    1.27 -</div>
    1.28 -<h1><font color="#3E1220">SliTaz Scratchbook</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">Base Applications</font></h2>
    1.37 -<p>
    1.38 -Install and configure libraries and basic applications.
    1.39 -</p>
    1.40 -<ul>
    1.41 -    <li><a href="base-apps.html#about">About the chapter</a> - Description and environmental variable ($fs)</li>
    1.42 -    <li><a href="base-apps.html#bc">bc-1.06</a> - Text mode calculator.</li>
    1.43 -    <li><a href="base-apps.html#zlib">zlib-1.2.3</a> - Compression libraries.</li>
    1.44 -    <li><a href="base-apps.html#pcre">pcre-7.4</a> - Perl-compatible regular expressions.</li>
    1.45 -    <li><a href="base-apps.html#e2fsprogs">e2fsprogs-1.39</a> - Filesystem management utilities.</li>
    1.46 -    <li><a href="base-apps.html#dropbear">dropbear-0.50</a> - Lightweight SSH server and client.</li>
    1.47 -    <li><a href="base-apps.html#lighttpd">lighttpd-1.4.18</a> - HTTP web server.</li>
    1.48 -    <li><a href="base-apps.html#iptables">iptables-1.3.7</a> - Netfilter, Linux firewall.</li>
    1.49 -    <li><a href="base-apps.html#sqlite">sqlite-3.5.1</a> - Small SQL database engine.</li>
    1.50 -    <li><a href="base-apps.html#cdrkit">cdrkit-1.1.5</a> - Tools for manipulating cdrom
    1.51 -    and ISO images.</li>
    1.52 -    <li><a href="base-apps.html#cpio">cpio-2.8</a> - Archiver used for SliTaz packages and
    1.53 -    initramfs.</li>
    1.54 -    <li><a href="base-apps.html#microperl">microperl-5.8.8</a> - A tiny Perl.</li>
    1.55 -    <li><a href="base-apps.html#module-init-tools">module-init-tools-3.2</a> - Tools for
    1.56 -    manipulating the kernel modules.</li>
    1.57 -    <li><a href="base-apps.html#kernel-modules">Copy and compress the Kernel modules.</a></li>
    1.58 -    <li><a href="base-apps.html#initramfs-iso">Generate the initramfs and an ISO image.</a></li>
    1.59 -</ul>
    1.60 -<a name="about"></a>
    1.61 -<h3><font color="#6c0023">About</font></h3>
    1.62 -<p>
    1.63 -This chapter describes the facilities libraries and basic text mode applications supplied with
    1.64 -SliTaz.
    1.65 -</p>
    1.66 -<h4>Assign an environment variable ($fs)</h4>
    1.67 -<p>
    1.68 -An environmental variable can't specify the path to the directory, just the name of the directory. 
    1.69 -We will affect a variable '$fs' to indicate the path to the root filesystem
    1.70 -(rootfs). To do this, we venture into the working directory SliTaz/, and type:
    1.71 -</p>
    1.72 -<pre> # export fs=$PWD/rootfs
    1.73 -</pre>
    1.74 -<p>
    1.75 -To check:
    1.76 -</p>
    1.77 -<pre> # echo $fs
    1.78 -</pre>
    1.79 -<a name="bc"></a>
    1.80 -<h3><font color="#6c0023">bc-1.06 - Text mode calculator</font></h3>
    1.81 -<p>
    1.82 -The application bc (<a href="http://www.gnu.org/software/bc/">www.gnu.org/software/bc/</a>) provides 
    1.83 -a small calculator. When compiling the utility, dc is also built, 
    1.84 -but not installed by SliTaz. Note that dc is also available with BusyBox. If you decide to copy dc, you 
    1.85 -need to delete the link to BusyBox (if it exists). We use a directory _pkg (package) for installation, 
    1.86 -use strip to clean the executables and copy the utilities:
    1.87 -</p>
    1.88 -<pre> # cd src
    1.89 - # wget http://ftp.gnu.org/pub/gnu/bc/bc-1.06.tar.gz
    1.90 - # tar xzfv bc-1.06.tar.gz
    1.91 - # cd bc-1.06
    1.92 - # ./configure --prefix=/usr --infodir=/usr/share/info \
    1.93 -   --mandir=/usr/share/man
    1.94 - # make
    1.95 - # make DESTDIR=$PWD/_pkg install
    1.96 - # strip -vs _pkg/usr/bin/*
    1.97 - # cp -avi _pkg/usr/bin/bc $fs/usr/bin
    1.98 -</pre>
    1.99 -<h4>libs</h4>
   1.100 -<p>
   1.101 -A small <code>ldd</code> on bc should produce:
   1.102 -</p>
   1.103 -<pre class="script">        libc.so.6 =&gt; /lib/libc.so.6 (0x40029000)
   1.104 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
   1.105 -</pre>
   1.106 -<a name="zlib"></a>
   1.107 -<h3><font color="#6c0023">zlib-1.2.3 - Compression libraries</font></h3>
   1.108 -<p>
   1.109 -The zlib (<a href="http://www.zlib.net/">http://www.zlib.net/</a>) package provides compression 
   1.110 -and decompression functions used by among others, the SSH server Dropbear and the X server:
   1.111 -</p>
   1.112 -<pre> # cd ..
   1.113 - # wget http://www.gzip.org/zlib/zlib-1.2.3.tar.bz2
   1.114 - # tar xjfv zlib-1.2.3.tar.bz2
   1.115 - # cd zlib-1.2.3
   1.116 - # ./configure --shared --prefix=/usr
   1.117 - # make
   1.118 - # strip -vs libz.so*
   1.119 - # cp -av libz.so* $fs/usr/lib
   1.120 -</pre>
   1.121 -<a name="pcre"></a>
   1.122 -<h3><font color="#6c0023">pcre-7.4 - Perl-compatible regular expressions</font></h3>
   1.123 -<p>
   1.124 -The package pcre (<a href="http://www.pcre.org/">http://www.pcre.org/</a>) provides libraries of 
   1.125 -functions for Perl compatible regular expressions used by among others, the web server Lighttpd:
   1.126 -</p>
   1.127 -<pre> # cd ..
   1.128 - # wget ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-7.4.tar.gz
   1.129 - # tar xzfv pcre-7.4.tar.gz
   1.130 - # cd pcre-7.4
   1.131 - # ./configure --prefix=/usr
   1.132 - # make
   1.133 - # make DESTDIR=$PWD/_pkg install
   1.134 - # strip -vs _pkg/usr/bin/*
   1.135 - # strip -vs _pkg/usr/lib/*
   1.136 - # cp -av _pkg/usr/bin/* $fs/usr/bin
   1.137 - # cp -av _pkg/usr/lib/*.so* $fs/usr/lib
   1.138 -</pre>
   1.139 -<a name="e2fsprogs"></a>
   1.140 -<h3><font color="#6c0023">e2fsprogs-1.39 - Filesystem management utilities</font></h3>
   1.141 -<p>
   1.142 -The e3fsprogs (<a href="http://e2fsprogs.sourceforge.net/">http://e2fsprogs.sourceforge.net/</a>) provides 
   1.143 -utilities for handling ext2 and ext3 filesystems. We will not take all of them because we need the space. 
   1.144 -It should be noted that we use fsck of BusyBox:
   1.145 -</p>
   1.146 -<pre> # cd ..
   1.147 - # wget http://puzzle.dl.sourceforge.net/sourceforge/e2fsprogs/e2fsprogs-1.39.tar.gz
   1.148 - # tar xzf e2fsprogs-1.39.tar.gz
   1.149 - # cd e2fsprogs-1.39
   1.150 - # ./configure --prefix=/usr --with-root-prefix="" \
   1.151 -   --enable-elf-shlibs --disable-evms --sysconfdir=/etc \
   1.152 -   --infodir=/usr/share/info --mandir=/usr/share/man
   1.153 - # make
   1.154 - # make DESTDIR=$PWD/_pkg install
   1.155 - # strip -vs _pkg/sbin/*
   1.156 - # strip -vs _pkg/lib/*
   1.157 - # strip -vs _pkg/usr/bin/*
   1.158 - # strip -vs _pkg/usr/sbin/*
   1.159 - # strip -vs _pkg/usr/lib/*
   1.160 -</pre>
   1.161 -<p>
   1.162 -Install the utilities, configuration files and libraries in the rootfs of SliTaz. Be careful if you  
   1.163 -used fsck, that you didn't destroy the link to BusyBox:
   1.164 -</p>
   1.165 -<pre> # cp -i _pkg/sbin/{badblocks,blkid,dumpe2fs,e2fsck,e2image} $fs/sbin
   1.166 - # cp -i _pkg/sbin/{e2label,findfs,logsave,mke2fs,mkfs.*} $fs/sbin
   1.167 - # cp -i _pkg/sbin/{resize2fs,tune2fs} $fs/sbin
   1.168 - # cp -a _pkg/lib/* $fs/lib
   1.169 - # rm -rf $fs/lib/libss*
   1.170 - # cp -a _pkg/etc/* $fs/etc
   1.171 - # cp -a _pkg/usr/bin/* $fs/usr/bin
   1.172 - # cp -a _pkg/usr/sbin/* $fs/usr/sbin
   1.173 - # cp -ad _pkg/usr/lib/*.so $fs/usr/lib
   1.174 - # rm -rf $fs/usr/lib/libss*
   1.175 -</pre>
   1.176 -<p>
   1.177 -You can also copy files from the French locale:
   1.178 -</p>
   1.179 -<pre> # mkdir $fs/usr/share/locale
   1.180 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   1.181 -</pre>
   1.182 -<a name="dropbear"></a>
   1.183 -<h3><font color="#6c0023">Dropbear-0.50 - Lightweight SSH client and server</font></h3>
   1.184 -<p>
   1.185 -Dropbear (<a href="http://matt.ucc.asn.au/dropbear/dropbear.html">http://matt.ucc.asn.au/dropbear/dropbear.html</a>) 
   1.186 -is a small secure client/server supporting SSH 2. Dropbear is compatible with
   1.187 -OpenSSH and uses ~/.ssh/authorized_keys for the management of public keys. Dropbear also
   1.188 -provides a version of scp, which must be compiled with 'make scp':
   1.189 -</p>
   1.190 -<pre> # cd ..
   1.191 - # wget http://matt.ucc.asn.au/dropbear/releases/dropbear-0.50.tar.gz
   1.192 - # tar xzf dropbear-0.50.tar.gz
   1.193 - # cd dropbear-0.50
   1.194 - # ./configure --prefix=/usr
   1.195 - # make
   1.196 - # make scp
   1.197 - # make DESTDIR=$PWD/_pkg install
   1.198 - # strip -v scp
   1.199 - # strip -v _pkg/usr/bin/*
   1.200 - # strip -v _pkg/usr/sbin/*
   1.201 -</pre>
   1.202 -<p>
   1.203 -Install the client and tools in /usr/bin, and the server in /usr/sbin:
   1.204 -</p>
   1.205 -<pre> # cp scp $fs/usr/bin
   1.206 - # cp -a _pkg/usr/bin/* $fs/usr/bin
   1.207 - # cp -a _pkg/usr/sbin/* $fs/usr/sbin
   1.208 -</pre>
   1.209 -<h4>libs</h4>
   1.210 -<pre class="script">        libutil.so.1 =&gt; /lib/libutil.so.1 (0x40025000)
   1.211 -        libz.so.1 =&gt; /usr/lib/libz.so.1 (0x40028000)
   1.212 -        libcrypt.so.1 =&gt; /lib/libcrypt.so.1 (0x4003b000)
   1.213 -        libc.so.6 =&gt; /lib/libc.so.6 (0x40068000)
   1.214 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
   1.215 -</pre>
   1.216 -<p>
   1.217 -Copy the library libutil.so.1 to $fs/lib, if this is not already the case. Other libraries 
   1.218 -should be present following the construction of the base system:
   1.219 -</p>
   1.220 -<pre> # cp -a /lib/libutil* $fs/lib
   1.221 -</pre>
   1.222 -<h4>Configure Dropbear</h4>
   1.223 -<p>
   1.224 -The user configuration files authorized_keys and known_hosts are in ~/.ssh. This directory and the 
   1.225 -file known_hosts are created automatically the first time the user launches dbclient. The system 
   1.226 -configuration files for the Dropbear server are in /etc/dropbear:
   1.227 - </p>
   1.228 -<pre> # mkdir $fs/etc/dropbear
   1.229 -</pre>
   1.230 -<p>
   1.231 -You must generate the secure keys before starting the Dropbear server on SliTaz. 
   1.232 -You can use dropbearkey with the following commands:
   1.233 -</p>
   1.234 -<pre> # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key
   1.235 - # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key
   1.236 -</pre>
   1.237 -<p>
   1.238 -On SliTaz, you can start the SSH server with the command:
   1.239 -</p>
   1.240 -<pre> # /etc/init.d/dropbear start
   1.241 -</pre>
   1.242 -<a name="lighttpd"></a>
   1.243 -<h3><font color="#6c0023">lighttpd-1.4.18 - HTTP Web server</font></h3>
   1.244 -<p>
   1.245 -Lighttpd (<a href="http://www.lighttpd.net/">www.lighttpd.net</a>) is a light, secure and powerful web server. 
   1.246 -The project is very active and the server's configuration simple. It supports virtual hosts, CGI scripts, 
   1.247 -and allows intelligent management of the CPU:
   1.248 -</p>
   1.249 -<pre> # cd ..
   1.250 - # wget http://www.lighttpd.net/download/lighttpd-1.4.18.tar.gz
   1.251 - # tar xzf lighttpd-1.4.18.tar.gz
   1.252 - # cd lighttpd-1.4.18
   1.253 - # ./configure -enable-shared --disable-ipv6 --prefix=/usr \
   1.254 -   --libdir=/usr/lib/lighttpd --mandir=/usr/share/man
   1.255 - # make
   1.256 - # make DESTDIR=$PWD/_pkg install
   1.257 - # strip -vs _pkg/usr/bin/*
   1.258 - # strip -vs _pkg/usr/sbin/*
   1.259 - # strip -vs _pkg/usr/lib/lighttpd/*
   1.260 -</pre>
   1.261 -<p>
   1.262 -Install the server and generated libraries. We will then copy some of the modules (9):
   1.263 -</p>
   1.264 -<pre> # cp _pkg/usr/bin/* $fs/usr/bin
   1.265 - # cp _pkg/usr/sbin/* $fs/usr/sbin
   1.266 - # mkdir $fs/usr/lib/lighttpd
   1.267 - Modules :
   1.268 - # cp _pkg/usr/lib/lighttpd/mod_access.so $fs/usr/lib/lighttpd
   1.269 - # cp _pkg/usr/lib/lighttpd/mod_accesslog.so $fs/usr/lib/lighttpd
   1.270 - # cp _pkg/usr/lib/lighttpd/mod_alias.so $fs/usr/lib/lighttpd
   1.271 - # cp _pkg/usr/lib/lighttpd/mod_auth.so $fs/usr/lib/lighttpd
   1.272 - # cp _pkg/usr/lib/lighttpd/mod_cgi.so $fs/usr/lib/lighttpd
   1.273 - # cp _pkg/usr/lib/lighttpd/mod_compress.so $fs/usr/lib/lighttpd
   1.274 - # cp _pkg/usr/lib/lighttpd/mod_rewrite.so $fs/usr/lib/lighttpd
   1.275 - # cp _pkg/usr/lib/lighttpd/mod_status.so $fs/usr/lib/lighttpd
   1.276 - # cp _pkg/usr/lib/lighttpd/mod_userdir.so $fs/usr/lib/lighttpd
   1.277 -</pre>
   1.278 -<h4>libs</h4>
   1.279 -<p>
   1.280 -There should be a libdl.so.2 library; if missing, we can copy:
   1.281 -</p>
   1.282 -<pre> # cp -a /lib/libdl* $fs/lib
   1.283 -</pre>
   1.284 -<h4>/var/www - root of documents served</h4>
   1.285 -<p>
   1.286 -/var/www is the root directory of documents served by default. You can access this via the url http://localhost/. 
   1.287 -This directory contains an <code>index.html</code> automatically displayed by a query. 
   1.288 -We will create the directory /var/www, to see what's placed inside:
   1.289 -</p>
   1.290 -<pre> # mkdir -p $fs/var/www
   1.291 -</pre>
   1.292 -<h4>lighttpd.conf - Lighttpd configuration file</h4>
   1.293 -<p>
   1.294 -The Lighttpd main configuration file is located at /etc/lighttpd and is called lighttpd.conf. 
   1.295 -The configuration file SliTaz provides is self-explanatary, just browse. You can find other examples on the 
   1.296 -Lighttpd website and as well as an example configuration in /doc in the Lighttpd archive:
   1.297 -</p>
   1.298 -<pre> # cp -a ../slitaz-tools-1.1/etc/lighttpd $fs/etc
   1.299 -</pre>
   1.300 -<p>
   1.301 -Creating the directory containing the log files:
   1.302 -</p>
   1.303 -<pre> # mkdir $fs/var/log/lighttpd
   1.304 -</pre>
   1.305 -<h4>User and group www</h4>
   1.306 -<p>
   1.307 -We will add a user and a group for the web server, it adds security and there is no reason for it to be run a root. 
   1.308 -The default user on SliTaz is 'www', but you can change this in the configuration file lighttpd.conf. 
   1.309 -The BusyBox application adduser has some limitations, so we add user 'www' manually. We also change permissions on 
   1.310 -the directory of web server logs:
   1.311 -</p>
   1.312 -<pre> # echo "www:x:80:80:www:/var/www:/bin/sh" &gt;&gt; $fs/etc/passwd
   1.313 - # echo "www:*:13509:0:99999:7:::" &gt;&gt; $fs/etc/shadow
   1.314 - # echo "www:*:13509:0:99999:7:::" &gt;&gt; $fs/etc/shadow-
   1.315 - # chroot $fs /bin/ash
   1.316 - /# addgroup -g 80 www
   1.317 - /# chown www.www /var/log/lighttpd
   1.318 - # exit
   1.319 -</pre>
   1.320 -<p>
   1.321 -To start the web server, you can use script /etc/init.d/lighttpd provided by SliTaz tools, by typing: 
   1.322 -<code>/etc/init.d/lighttpd start</code>. You can also automate its 
   1.323 -launch at boot with a link /etc/init.d/lighttpd pointing to /etc/rc.d/60lighttpd.
   1.324 -</p>
   1.325 -<a name="iptables"></a>
   1.326 -<h3><font color="#6c0023">iptables-1.3.7 - Netfilter, Linux firewall</font></h3>
   1.327 -<p>
   1.328 -Netfilter (<a href="http://www.netfilter.org/">www.netfilter.org</a>) is the module which provides the Linux 
   1.329 -kernel firewall functions, shared internet connections (NAT) and the archiving of network traffic. 
   1.330 -The iptables command allows you to configure Netfilter using iptables-restore 
   1.331 -and iptable-save, to save and restore the Netfilter configuration:
   1.332 -</p>
   1.333 -<pre> # cd ..
   1.334 - # wget http://www.netfilter.org/projects/iptables/files/iptables-1.3.7.tar.bz2
   1.335 - # tar xjf iptables-1.3.7.tar.bz2
   1.336 - # cd iptables-1.3.7
   1.337 - # make KERNEL_DIR=../linux-2.6.20 BINDIR=/sbin \
   1.338 -   LIBDIR=/lib MANDIR=/usr/share/man
   1.339 - # make KERNEL_DIR=../linux-2.6.20 BINDIR=/sbin \
   1.340 -   LIBDIR=/lib MANDIR=/usr/share/man \
   1.341 -   DESTDIR=$PWD/_pkg install
   1.342 - # strip  _pkg/sbin/*
   1.343 - # strip  _pkg/lib/iptables/*
   1.344 -</pre>
   1.345 -<p>
   1.346 -Installing the iptables* applications and libraries sufficient for a basic firewall:
   1.347 -</p>
   1.348 -<pre> # cp -a _pkg/sbin/iptables* $fs/sbin
   1.349 - # mkdir $fs/lib/iptables
   1.350 - # cp -a _pkg/lib/iptables/{libipt_standard.so,libipt_conntrack.so} \
   1.351 -   $fs/lib/iptables
   1.352 - # cp -a _pkg/lib/iptables/{libipt_tcp.so,libipt_udp.so} $fs/lib/iptables
   1.353 -</pre>
   1.354 -<p>
   1.355 -To satisfy the iptables dependencies, you must copy the libnsl* library:
   1.356 -</p>
   1.357 -<pre> # cp -va /lib/libnsl* $fs/lib/tls
   1.358 - # strip $fs/lib/libnsl*
   1.359 -</pre>
   1.360 -<a name="sqlite"></a>
   1.361 -<h3><font color="#6c0023">sqlite-3.5.1 - Small SQL database engine</font></h3>
   1.362 -<p>
   1.363 -This package provides sqlite3 (<a href="http://www.sqlite.org/">www.sqlite.org</a>) and sqlite3.so* 
   1.364 -libraries. SQLite is fast and efficient and integrates directly to programs using database files: 
   1.365 -</p>
   1.366 -<pre> # cd ..
   1.367 - # wget http://www.sqlite.org/sqlite-3.5.1.tar.gz
   1.368 - # tar xzf sqlite-3.5.1.tar.gz
   1.369 - # cd sqlite-3.5.1
   1.370 - # ./configure --prefix=/usr --disable-tcl
   1.371 - # make
   1.372 - # make DESTDIR=$PWD/_pkg install
   1.373 - # strip _pkg/usr/lib/*.so*
   1.374 - # strip _pkg/usr/bin/*
   1.375 -</pre>
   1.376 -<p>
   1.377 -Installing the sqlite3 utility and libraries in the rootfs of SliTaz:
   1.378 -</p>
   1.379 -<pre> # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
   1.380 - # cp -a _pkg/usr/bin/* $fs/usr/bin
   1.381 -</pre>
   1.382 -<a name="cdrkit"></a>
   1.383 -<h3><font color="#6c0023">cdrkit-1.1.5 - Tools for manipulating cdrom and ISO images</font></h3>
   1.384 -<p>
   1.385 -cdrkit (<a href="http://www.cdrkit.org/">www.cdrkit.org</a>) provides tools for manipulating cdroms. 
   1.386 -SliTaz installs by default wodim for burning and genisoimage to create an ISO image. 
   1.387 -The compilation is a bit different (cmake), but shouldn't pose any problems:
   1.388 -</p>
   1.389 -<pre> # cd ..
   1.390 - # wget http://cdrkit.org/releases/cdrkit-1.1.5.tar.gz
   1.391 - # tar xzf cdrkit-1.1.5.tar.gz
   1.392 - # cd cdrkit-1.1.5
   1.393 - # make
   1.394 - # make install PREFIX=$PWD/_pkg/usr
   1.395 - # strip -v _pkg/usr/bin/*
   1.396 - # strip -v _pkg/usr/sbin/*
   1.397 - # cp _pkg/usr/bin/genisoimage $fs/usr/bin
   1.398 - # cp _pkg/usr/bin/wodim $fs/usr/bin
   1.399 -</pre>
   1.400 -<p>
   1.401 -Copy the library libcap.so.1 required by wodim:
   1.402 -</p>
   1.403 -<pre> # cp -a /lib/libcap.so* $fs/lib
   1.404 -</pre>
   1.405 -<a name="cpio"></a>
   1.406 -<h3><font color="#6c0023">cpio-2.8 - Archiver</font></h3>
   1.407 -<p>
   1.408 -<code>cpio</code> (<a href="http://www.gnu.org/software/cpio/">http://www.gnu.org/software/cpio/</a>) provides tools for 
   1.409 -manipulating cpio archives. The archive format is used for packages and the SliTaz initramfs image of the cdrom. 
   1.410 -Note that BusyBox provides a version of cpio that only unpacks archives:
   1.411 -</p>
   1.412 -<pre> # cd ..
   1.413 - # wget ftp://sunsite.cnlab-switch.ch/mirror/gnu/cpio/cpio-2.8.tar.gz
   1.414 - # tar xzf cpio-2.8.tar.gz
   1.415 - # cd cpio-2.8
   1.416 - # ./configure --prefix=/usr --bindir=/bin \
   1.417 -   --libexecdir=/usr/bin --mandir=/usr/share/man \
   1.418 -   --infodir=/usr/share/info
   1.419 - # make
   1.420 - # make DESTDIR=$PWD/_pkg install
   1.421 - # strip -v _pkg/bin/*
   1.422 - # strip -v _pkg/usr/bin/*
   1.423 -</pre>
   1.424 -<p>
   1.425 -Installing <code>cpio</code> in /bin and <code>rmt</code> in /usr/bin. You can also install the French locale files:
   1.426 -</p>
   1.427 -<pre> # cp -a _pkg/bin/* $fs/bin
   1.428 - # cp -a _pkg/usr/bin/* $fs/usr/bin
   1.429 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   1.430 -</pre>
   1.431 -<a name="microperl"></a>
   1.432 -<h3><font color="#6c0023">microperl-5.8.8 - A tiny Perl</font></h3>
   1.433 -<p>
   1.434 -Microperl is a tiny implementation of Perl using the most basic functions of the language. 
   1.435 -You can find more info in the source archive and the file <code>README.micro</code>. 
   1.436 -We use a small <code>sed</code> on the configuration file that searches for microperl modules 
   1.437 -in /usr/lib/perl5. We also create a link to the #! /usr/bin/perl script:
   1.438 -</p>
   1.439 -<pre> # wget http://ftp.funet.fi/pub/CPAN/src/perl-5.8.8.tar.gz
   1.440 - # tar xzf perl-5.8.8.tar.gz
   1.441 - # cd perl-5.8.8
   1.442 - # sed -i s/'usr\/local'/'usr'/ uconfig.sh
   1.443 - # sed -i s/'perl5\/5.9'/'perl5'/ uconfig.sh
   1.444 - # sed -i s/'unknown'/'i486-pc-linux-gnu'/ uconfig.sh
   1.445 - # make -f Makefile.micro regen_uconfig
   1.446 - # make -f Makefile.micro
   1.447 - # strip microperl
   1.448 - # cp microperl $fs/usr/bin
   1.449 - # chroot $fs /bin/ash
   1.450 - /# cd /usr/bin
   1.451 - /# ln -s microperl perl
   1.452 - /# exit
   1.453 -</pre>
   1.454 -<a name="module-init-tools"></a>
   1.455 -<h3><font color="#6c0023">module-init-tools-3.2 - Utilities for manipulating kernel modules</font></h3>
   1.456 -<p>
   1.457 -The <a href="http://ftp.kernel.org/pub/linux/utils/kernel/module-init-tools/">module-init-tools</a> 
   1.458 -from kernel.org: modprobe, insmod, rmmod and lsmod. We have chosen to use these because we can compile 
   1.459 -modutils/modprobe to support compressed (.gz) modules to save space. To do this we use the option 
   1.460 ---enable-zlib, we then clean and copy the binaries. We do not take everything that has been created, 
   1.461 -only what we need: depmod, insmod, modinfo, modprobe and rmmod in /sbin and lsmod in /bin:
   1.462 -</p>
   1.463 -<pre> # cd ..
   1.464 - # wget http://ftp.kernel.org/pub/linux/utils/kernel/module-init-tools/module-init-tools-3.2.tar.bz2
   1.465 - # tar xjf module-init-tools-3.2.tar.bz2
   1.466 - # cd module-init-tools-3.2
   1.467 - # ./configure --enable-zlib --prefix=/usr --sbindir=/sbin --bindir=/bin \
   1.468 -   --sysconfdir=/etc --infodir=/usr/share/info --mandir=/usr/share/man
   1.469 - # make
   1.470 - # make DESTDIR=$PWD/_pkg install
   1.471 - # strip -v _pkg/sbin/{depmod,insmod,modinfo,modprobe,rmmod}
   1.472 - # strip -v _pkg/bin/lsmod
   1.473 - # cp -i _pkg/sbin/{depmod,insmod,modinfo,modprobe,rmmod} $fs/sbin
   1.474 - # cp -i _pkg/bin/lsmod $fs/bin
   1.475 - # cd ..
   1.476 -</pre>
   1.477 -<a name="kernel-modules"></a>
   1.478 -<h3><font color="#6c0023">Copy kernel modules</font></h3>
   1.479 -<p>
   1.480 -Copy files from linux-2.6.20/_pkg:
   1.481 -</p>
   1.482 -<pre> # cp -a linux-2.6.20/_pkg/lib/* $fs/lib
   1.483 -</pre>
   1.484 -<h4>Compress kernel modules</h4>
   1.485 -<p>
   1.486 -Compress modules, this step will gain us back around 50% of available space.
   1.487 -We begin by moving into the rootfs, then we search for all files with the 
   1.488 -<code>.ko</code> extension, and compress them. You
   1.489 -can also do this with the 'gzmodtaz.sh' script found in SliTaz tools:
   1.490 -</p>
   1.491 -<pre> # cd $fs
   1.492 -</pre>
   1.493 -<p>
   1.494 -With 'gztazmod.sh':
   1.495 -</p>
   1.496 -<pre> # cp -v ../src/slitaz-tools-1.1/utils/gztazmod.sh sbin
   1.497 - # ./sbin/gztazmod.sh lib/modules/2.6.20-slitaz
   1.498 -</pre>
   1.499 -<p>
   1.500 -Or by hand:
   1.501 -</p>
   1.502 -<pre> # cd lib/modules/2.6.20-slitaz
   1.503 - # find . -name "*.ko" -exec gzip '{}' \;
   1.504 - # sed 's/\.ko/.ko.gz/g' modules.dep &gt; tmp.dep
   1.505 - # rm modules.dep
   1.506 - # mv tmp.dep modules.dep
   1.507 -</pre>
   1.508 -<a name="initramfs-iso"></a>
   1.509 -<h3><font color="#6c0023">Generate the initramfs and an ISO image</font></h3>
   1.510 -<p>
   1.511 -To create a new ISO image, you can use 'mktaziso' in 
   1.512 -<a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a>.  
   1.513 -Or you can create a new initramfs image, copy it to /boot in the root of the cdrom
   1.514 -(rootcd) and finally generate an ISO image with genisoimage:
   1.515 -</p>
   1.516 -<pre> # cd $fs
   1.517 - # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
   1.518 - # cd ..
   1.519 - # cp rootfs.gz rootcd/boot
   1.520 - # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \
   1.521 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
   1.522 -   -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
   1.523 -</pre>
   1.524 -<p>
   1.525 -Test iso image:
   1.526 -</p>
   1.527 -<pre> # qemu -cdrom slitaz-test.iso
   1.528 -</pre>
   1.529 -
   1.530 -<h4>Following chapter</h4>
   1.531 -<p>
   1.532 -The next chapter is called <a href="base-ncurses.html">Base Ncurses</a>. It
   1.533 -covers the installation and configuration of the ncurses libraries and
   1.534 -applications.
   1.535 -</p> 
   1.536 -
   1.537 -<!-- End of content -->
   1.538 -</div>
   1.539 -
   1.540 -<!-- Footer. -->
   1.541 -<div id="footer">
   1.542 -	<div class="footer-right"></div>
   1.543 -	<a href="base-apps.html#top">Top of the page</a> | 
   1.544 -	<a href="index.html">Table of contents</a>
   1.545 -</div>
   1.546 -
   1.547 -<div id="copy">
   1.548 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   1.549 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   1.550 -    Documentation is under
   1.551 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   1.552 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   1.553 -</div>
   1.554 -
   1.555 -</body>
   1.556 -</html>
     2.1 --- a/pt/doc/scratchbook/base-ncurses.html	Wed Mar 31 03:06:23 2010 +0000
     2.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.3 @@ -1,444 +0,0 @@
     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="en" lang="en">
     2.7 -<head>
     2.8 -    <title>SliTaz Scratchbook - Base Ncurses</title>
     2.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    2.10 -    <meta name="description" content="" />
    2.11 -    <meta name="expires" content="never" />
    2.12 -    <meta name="modified" content="2008-11-22 17:00: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 of contents</a> |
    2.26 -    <a href="locale.html">Locale &amp; i18n</a>
    2.27 -</div>
    2.28 -<h1><font color="#3E1220">SliTaz Scratchbook</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">Ncurses libraries and applications</font></h2>
    2.37 -<p>
    2.38 -Installation and configuration of ncurses libraries and applications.
    2.39 -</p>
    2.40 -<ul>
    2.41 -    <li><a href="base-ncurses.html#about">About the chapter.</a> - Description and environmental
    2.42 -    variable ($fs)</li>
    2.43 -    <li><a href="base-ncurses.html#ncurses">ncurses-5.6</a> -  Utilities and libraries for terminal.</li>
    2.44 -    <li><a href="base-ncurses.html#clex">clex-3.16</a> - File manager.</li>
    2.45 -    <li><a href="base-ncurses.html#nano">nano-2.0.6</a> - Advanced text editor with colored syntax.</li>
    2.46 -    <li><a href="base-ncurses.html#retawq">retawq-0.2.6c</a> - Navigate the web in text 
    2.47 -    mode using ncurses.</li>
    2.48 -    <li><a href="base-ncurses.html#htop">htop-0.6.5</a> - System process viewer.</li>
    2.49 -    <li><a href="base-ncurses.html#dialog">dialog-1.1-20070409</a> - GUI shell scripts.</li>
    2.50 -    <li><a href="base-ncurses.html#ninvaders">ninvaders-0.1.1</a> - Space Invaders clone.</li>
    2.51 -    <li><a href="base-ncurses.html#bastet">bastet-0.41</a> - Bastard Tetris clone.</li>
    2.52 -    <li><a href="base-ncurses.html#rhapsody">rhapsody-0.28b</a> - IRC chat client.</li>
    2.53 -    <li><a href="base-ncurses.html#initramfs-iso">Generate the initramfs and an ISO image.</a></li>
    2.54 -</ul>
    2.55 -<a name="about"></a>
    2.56 -<h3><font color="#6c0023">About</font></h3>
    2.57 -<p>
    2.58 -This chapter describes the construction and installation of some ncurses applications 
    2.59 -and libraries in SliTaz. The procedure consists of moving into the /src directory, 
    2.60 -downloading the sources for the application in question, unpacking, reading the README or 
    2.61 -INSTALL file(s), compiling and installing the binary in SliTaz. Once the applications 
    2.62 -are installed, we can create a new initramfs, copy it to the root of the cdrom and generate 
    2.63 -a new ISO image. For this you can also use <code>mktaziso</code> in 
    2.64 -<a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a>.
    2.65 -</p>
    2.66 -<h4>Assign an environment variable ($fs)</h4>
    2.67 -<p>
    2.68 -An environmental variable can't specify the path to the directory, just the name of the directory. 
    2.69 -We will affect a variable '$fs' to indicate the path to the root filesystem
    2.70 -(rootfs). To do this, we venture into the working directory SliTaz/, and type:
    2.71 -</p>
    2.72 -<pre> # export fs=$PWD/rootfs
    2.73 -</pre>
    2.74 -<p>
    2.75 -To check:
    2.76 -</p>
    2.77 -<pre> # echo $fs
    2.78 -</pre>
    2.79 -<a name="ncurses"></a>
    2.80 -<h3><font color="#6c0023">ncurses-5.6 - Terminal utilities and libraries</font></h3>
    2.81 -<p>
    2.82 -ncurses (<a href="http://dickey.his.com/ncurses/">dickey.his.com/ncurses/</a>) contains 
    2.83 -functions to display text in different ways on the screen of a Linux terminal and also provides 
    2.84 -the terminfo file. Ncurses libraries are used among others by retawq, nano and some games. 
    2.85 -We install the libraries in /lib and the rest in /usr/bin with a small strip to clean the executables:
    2.86 -</p>
    2.87 -<pre> # cd src
    2.88 - # wget ftp://invisible-island.net/ncurses/ncurses-5.6.tar.gz
    2.89 - # tar xzf ncurses-5.6.tar.gz
    2.90 - # cd ncurses-5.6
    2.91 - # ./configure --prefix=/usr \
    2.92 -   --libdir=/lib --sysconfdir=/etc \
    2.93 -   --infodir=/usr/share/info --mandir=/usr/share/man \
    2.94 -   --with-shared --without-debug --without-ada
    2.95 - # make
    2.96 - # make DESTDIR=$PWD/_pkg install
    2.97 - # strip -v _pkg/lib/*
    2.98 - # strip -v _pkg/usr/bin/*
    2.99 -</pre>
   2.100 -<p>
   2.101 -Copy the libncurses library and some applications in SliTaz. The reset utility is used at the end of 
   2.102 -the rcS initialization script to remove the Linux logo. If you wish, you can copy the associated utilities 
   2.103 -(tic, tack, toe, etc), being careful not to delete the link to BusyBox:
   2.104 -</p>
   2.105 -<pre> # cp -a _pkg/lib/libncurses.so* $fs/lib
   2.106 - # cp -ia _pkg/usr/bin/{clear,ncurses5-config,tset,reset} \
   2.107 -   $fs/usr/bin
   2.108 -</pre>
   2.109 -<p>
   2.110 -Copy terminfo files, we only use a few files. If you want more, you can copy:
   2.111 -</p>
   2.112 -<pre> # mkdir -v $fs/usr/share/terminfo
   2.113 - # mkdir -v $fs/usr/share/terminfo/{a,l,r,v,x}
   2.114 - # cp _pkg/usr/share/terminfo/a/ansi \
   2.115 -   $fs/usr/share/terminfo/a
   2.116 - # cp _pkg/usr/share/terminfo/l/linux \
   2.117 -   $fs/usr/share/terminfo/l
   2.118 - # cp _pkg/usr/share/terminfo/r/rxvt \
   2.119 -   $fs/usr/share/terminfo/r
   2.120 - # cp _pkg/usr/share/terminfo/x/{xterm,xterm-color,xterm-new,xterm-vt220} \
   2.121 -   $fs/usr/share/terminfo/x
   2.122 - # cp _pkg/usr/share/terminfo/v/{vt100,vt102*} \
   2.123 -   $fs/usr/share/terminfo/v
   2.124 -</pre>
   2.125 -<p>
   2.126 -Copy the tabset files:
   2.127 -</p>
   2.128 -<pre> # cp -a _pkg/usr/share/tabset $fs/usr/share
   2.129 -</pre>
   2.130 -<a name="clex"></a>
   2.131 -<h3><font color="#6c0023">clex-3.16 - File Manager</font></h3>
   2.132 -<p>
   2.133 -CLEX (<a href="http://www.clex.sk/">http://www.clex.sk/</a>) is a small ncurses file 
   2.134 -manager (160 KB). The configuration file (rc) is ~/clexrc; ~/.clexbm is used for 
   2.135 -bookmarks:
   2.136 -</p>
   2.137 -<pre> # cd ..
   2.138 - # wget http://www.clex.sk/download/clex-3.16.tar.gz
   2.139 - # tar xzf clex-3.16.tar.gz
   2.140 - # cd clex-3.16
   2.141 - # ./configure --prefix=/usr --infodir=/usr/share/info \
   2.142 -   --mandir=/usr/share/man
   2.143 - # make
   2.144 - # make DESTDIR=$PWD/_pkg install
   2.145 - # strip -v _pkg/usr/bin/clex
   2.146 -</pre>
   2.147 -<p>
   2.148 -Install the clex binary in the rootfs of SliTaz:
   2.149 -</p>
   2.150 -<pre> # cp _pkg/usr/bin/clex $fs/usr/bin
   2.151 -</pre>
   2.152 -<h4>libs</h4>
   2.153 -<p>
   2.154 -If we execute the <code>ldd</code> command on clex, the following dependancies should be displayed:
   2.155 -</p>
   2.156 -<pre class="script">        libncurses.so.5 =&gt; /lib/libncurses.so.5 (0x40025000)
   2.157 -        libc.so.6 =&gt; /lib/libc.so.6 (0x40064000)
   2.158 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
   2.159 -</pre>
   2.160 -<a name="nano"></a>
   2.161 -<h3><font color="#6c0023">nano-2.0.6 - Advanced Text Editor</font></h3>
   2.162 -<p>
   2.163 -GNU nano (<a href="http://www.nano-editor.org/">www.nano-editor.org</a>)  is a well known, 
   2.164 -fast, effective GNU/Linux text editor that supports colored syntax.
   2.165 -This is the default text editor in SliTaz:
   2.166 -</p>
   2.167 -<pre> # cd ..
   2.168 - # wget http://www.nano-editor.org/dist/v2.0/nano-2.0.6.tar.gz
   2.169 - # tar xzf nano-2.0.6.tar.gz
   2.170 - # cd nano-2.0.6
   2.171 - # ./configure --enable-all --enable-extra --prefix=/usr \
   2.172 -   --infodir=/usr/share/info --mandir=/usr/share/man \
   2.173 -   --sysconfdir=/etc
   2.174 - # make
   2.175 - # make DESTDIR=$PWD/_pkg install
   2.176 - # strip -v _pkg/usr/bin/nano
   2.177 -</pre>
   2.178 -<p>
   2.179 -Copy the nano binary and the rnano link in SliTaz:
   2.180 -</p>
   2.181 -<pre> # cp -a _pkg/usr/bin/* $fs/usr/bin
   2.182 -</pre>
   2.183 -<p>
   2.184 -Copy the configuration files in _pkg/usr/share/nano to our rootfs:
   2.185 -</p>
   2.186 -<pre> # cp -a _pkg/usr/share/nano $fs/usr/share
   2.187 -</pre>
   2.188 -<h4>libs</h4>
   2.189 -<p>
   2.190 -If we execute the <code>ldd</code> command on nano, the following dependancies 
   2.191 -should be displayed:
   2.192 -</p>
   2.193 -<pre class="script">        libncurses.so.5 =&gt; /lib/libncurses.so.5 (0x40025000)
   2.194 -        libc.so.6 =&gt; /lib/libc.so.6 (0x40064000)
   2.195 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
   2.196 -</pre>
   2.197 -<h4>locale</h4>
   2.198 -<p>
   2.199 -About the language, you can copy the .mo files created when installing nano from
   2.200 -/usr/share/locale/(fr,en,de,es,etc)/LC_MESSAGES to the rootfs. Example for the French language:
   2.201 -</p>
   2.202 -<pre> # cp -a _pkg/usr/share/locale/fr/LC_MESSAGES $fs/usr/share/locale/fr
   2.203 -</pre>
   2.204 -<h4>Customize nano</h4>
   2.205 -<p>
   2.206 -You can customize nano via /etc/nanorc or ~/.nanorc for each user of the system. It's in 
   2.207 -this file that you can define the colors used by nano through the files in /usr/share/nano. 
   2.208 -You will find a broad example of this file in the archive of nano and
   2.209 -<a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a>.
   2.210 -</p>
   2.211 -<p>
   2.212 -For a system configuration file, you can copy the file in SliTaz tools to /etc in the rootfs:
   2.213 -</p>
   2.214 -<pre> # cd ..
   2.215 - # cp -a slitaz-tools-1.1/etc/nanorc $fs/etc
   2.216 -</pre>
   2.217 -<a name="retawq"></a>
   2.218 -<h3><font color="#6c0023">retawq-0.2.6c - Text mode Web browser</font></h3>
   2.219 -<p>
   2.220 -retawq (<a href="http://retawq.sourceforge.net/">retawq.sourceforge.net</a>) 
   2.221 -is a small text-only web browser. We only flag a few useful options when configuring, 
   2.222 -retawq needs terminfo files, libncurses libraries and libthread:
   2.223 -</p>
   2.224 -<pre> # wget http://switch.dl.sourceforge.net/sourceforge/retawq/retawq-0.2.6c.tar.gz
   2.225 - # tar xzf retawq-0.2.6c.tar.gz
   2.226 - # cd retawq-0.2.6c
   2.227 - # ./configure --enable-i18n --enable-local-cgi --path-prefix=/usr \
   2.228 -   --path-doc=/usr/share/doc/retawq --path-man=/usr/share/man
   2.229 - # make
   2.230 - # strip -v retawq
   2.231 -</pre>
   2.232 -<p>
   2.233 -Copy the retawq binary in SliTaz:
   2.234 -</p>
   2.235 -<pre> # cp retawq $fs/usr/bin
   2.236 -</pre>
   2.237 -<h4>libs</h4>
   2.238 -<pre class="script">        libncurses.so.5 =&gt; /lib/libncurses.so.5 (0x40025000)
   2.239 -        libpthread.so.0 =&gt; /lib/libpthread.so.0 (0x40064000)
   2.240 -        libc.so.6 =&gt; /lib/libc.so.6 (0x40074000)
   2.241 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
   2.242 -</pre>
   2.243 -<p>
   2.244 -You can copy the lipthread library from your host system or use the minimum package 
   2.245 -glibc-2.3.6 distributed by SliTaz:
   2.246 -</p>
   2.247 -<pre> # cp -a /lib/libpthread* $fs/lib
   2.248 - # strip --strip-unneeded $fs/lib/*
   2.249 -</pre>
   2.250 -<h4>locale</h4>
   2.251 -<p>
   2.252 -For language, you can copy the .mo files in /i18n of the retawq archive to 
   2.253 -/usr/share/locale/(fr,en,es,etc)/LC_MESSAGES. Example for the French language, 
   2.254 -renaming the file to retawq.mo:
   2.255 -</p>
   2.256 -<pre> # cp -v i18n/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/retawq.mo
   2.257 -</pre>
   2.258 -<h4>Customize retawq</h4>
   2.259 -<p>
   2.260 -To personalize retawq, you can use a ~/.retawq directory containing a config file. 
   2.261 -You can also save bookmarks (html) in the root directory of the user. You will find an
   2.262 -examples/ in the archive of retawq (or SliTaz tools) containing a bookmarks.html 
   2.263 -page with a list of favorite web sites. You can also copy the docs (/documents) from retawq 
   2.264 -to /usr/share/doc/retawq.
   2.265 -</p>
   2.266 -<a name="htop"></a>
   2.267 -<h3><font color="#6c0023">htop-6.0.5 - System process viewer</font></h3>
   2.268 -<p>
   2.269 -
   2.270 -htop (<a href="http://htop.sourceforge.net/">htop.sourceforge.net/</a>) is software 
   2.271 -that displays system processes using ncurses.
   2.272 -</p>
   2.273 -<p>
   2.274 -Returning to the /src directory, download, unpack, configure, compile and clean (with strip):
   2.275 -</p>
   2.276 -<pre> # cd ..
   2.277 - # wget http://switch.dl.sourceforge.net/sourceforge/htop/htop-0.6.5.tar.gz
   2.278 - # tar xzf htop-0.6.5.tar.gz
   2.279 - # cd htop-0.6.5
   2.280 - # ./configure --prefix=/usr --mandir=/usr/share/man
   2.281 - # make
   2.282 - # make DESTDIR=$PWD/_pkg install
   2.283 - # strip -v _pkg/usr/bin/htop
   2.284 -</pre>
   2.285 -<p>
   2.286 -Copy the htop binary in SliTaz:
   2.287 -</p>
   2.288 -<pre> # cp _pkg/usr/bin/htop $fs/usr/bin
   2.289 -</pre>
   2.290 -<p>
   2.291 -You can still copy the htop icon found in: _pkg/usr/share/pixmaps.
   2.292 -</p>
   2.293 -<h4>libs</h4>
   2.294 -<pre class="script">        libm.so.6 =&gt; /lib/libm.so.6 (0xb7f97000)
   2.295 -        libncurses.so.5 =&gt; /lib/libncurses.so.5 (0xb7f55000)
   2.296 -        libc.so.6 =&gt; /lib/libc.so.6 (0xb7e20000)
   2.297 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0xb7fc9000)
   2.298 -</pre>
   2.299 -<a name="dialog"></a>
   2.300 -<h3><font color="#6c0023">dialog-1.1.20070409 - GUI shell scripts</font></h3>
   2.301 -<p>
   2.302 -
   2.303 -dialog (<a href="http://invisible-island.net/dialog/dialog.html">invisible-island.net/dialog/dialog.html</a>), 
   2.304 -is a utility to build GUI-based consoles:
   2.305 -</p>
   2.306 -<pre> # cd ..
   2.307 - # wget ftp://invisible-island.net/dialog/dialog.tar.gz
   2.308 - # tar xzf dialog.tar.gz
   2.309 - # cd dialog-1.1-20070409
   2.310 - # ./configure --enable-nls --with-ncurses --prefix=/usr \
   2.311 -   --sysconfdir=/etc --mandir=/usr/share/man
   2.312 - # make
   2.313 - # make DESTDIR=$PWD/_pkg install
   2.314 - # strip -v _pkg/usr/bin/dialog
   2.315 -</pre>
   2.316 -<p>
   2.317 -Copy dialog binary in SliTaz:
   2.318 -</p>
   2.319 -<pre> # cp _pkg/usr/bin/dialog $fs/usr/bin
   2.320 -</pre>
   2.321 -<h4>libs</h4>
   2.322 -<pre class="script">        libncurses.so.5 =&gt; /lib/libncurses.so.5 (0x40027000)
   2.323 -        libm.so.6 =&gt; /lib/libm.so.6 (0x40066000)
   2.324 -        libc.so.6 =&gt; /lib/libc.so.6 (0x40089000)
   2.325 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
   2.326 -</pre>
   2.327 -<h4>locale</h4>
   2.328 -<p>
   2.329 -You can install locale files if you wish:  
   2.330 -</p>
   2.331 -<pre> # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   2.332 -</pre>
   2.333 -<p>
   2.334 -The dialog configuration file is /etc/dialogrc and/or ~/.dialogrc for each user.
   2.335 -There are also full examples of scripts in the /sample directory in the sources of dialog.
   2.336 -</p>
   2.337 -<a name="ninvaders"></a>
   2.338 -<h3><font color="#6c0023">Ninvaders-0.1.1 - Space Invaders clone</font></h3>
   2.339 -<p>
   2.340 -
   2.341 -ninvaders (<a href="http://ninvaders.sourceforge.net/">http://ninvaders.sourceforge.net/</a>) 
   2.342 -is a clone of the popular Space Invaders game (46 KB). We begin by placing ourselves in the 
   2.343 -/src directory, then we download, untar, compile, clean using strip and copy the nInvaders binary 
   2.344 -in /usr/games of SliTaz:
   2.345 -</p>
   2.346 -<pre> # cd ..
   2.347 - # wget http://ovh.dl.sourceforge.net/sourceforge/ninvaders/ninvaders-0.1.1.tar.gz
   2.348 - # tar xzf ninvaders-0.1.1.tar.gz
   2.349 - # cd ninvaders-0.1.1
   2.350 - # make
   2.351 - # strip -v nInvaders
   2.352 - # cp nInvaders $fs/usr/games
   2.353 -</pre>
   2.354 -<a name="bastet"></a>
   2.355 -<h3><font color="#6c0023">bastet-0.41 -  Bastard Tetris clone</font></h3>
   2.356 -<p>
   2.357 -A game of Tetris (17 KB):
   2.358 -</p>
   2.359 -<pre> # wget http://fph.altervista.org/prog/bastet-0.41.tgz
   2.360 - # tar xzf bastet-0.41.tgz
   2.361 - # cd bastet-0.41
   2.362 - # make
   2.363 - # strip bastet
   2.364 - # cp bastet $fs/usr/games
   2.365 - # mkdir -p $fs/var/games
   2.366 - # touch $fs/var/games/bastet.scores
   2.367 - # chmod 666 $fs/var/games/bastet.scores
   2.368 -</pre>
   2.369 -<a name="rhapsody"></a>
   2.370 -<h3><font color="#6c0023">rhapsody-0.28b - IRC chat client</font></h3>
   2.371 -<p>
   2.372 -Rhapsody (<a href="http://rhapsody.sourceforge.net/">http://rhapsody.sourceforge.net/</a>) 
   2.373 -is a fast and lightweight chat client supporting the IRC protocol. It provides a menu for 
   2.374 -managing servers, channels and configuration. It is therefore easy to use:
   2.375 -</p>
   2.376 -<pre> # cd ..
   2.377 - # wget http://switch.dl.sourceforge.net/sourceforge/rhapsody/rhapsody_0.28b.tgz
   2.378 - # tar xzf rhapsody_0.28b.tgz
   2.379 - # cd rhapsody-0.28b
   2.380 - # ./configure -i /usr/bin -d /usr/share/doc/rhapsody
   2.381 - # make
   2.382 - # strip -v rhapsody
   2.383 -</pre>
   2.384 -<p>
   2.385 -Install the binary and help files in SliTaz. We must adjust permissions on 
   2.386 -these files so that everyone can read:
   2.387 -</p>
   2.388 -<pre> # cp rhapsody $fs/usr/bin
   2.389 - # mkdir $fs/usr/share/doc/rhapsody
   2.390 - # cp -a help $fs/usr/share/doc/rhapsody/help
   2.391 - # chmod 644 $fs/usr/share/doc/rhapsody/help/*
   2.392 -</pre>
   2.393 -<h4>libs</h4>
   2.394 -<p>
   2.395 -Rhapsody uses the following libraries:
   2.396 -</p>
   2.397 -<pre class="script">        libncurses.so.5 =&gt; /lib/libncurses.so.5 (0x40026000)
   2.398 -        libc.so.6 =&gt; /lib/libc.so.6 (0x40066000)
   2.399 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000))
   2.400 -</pre>
   2.401 -<h4>Rhapsody use the following libraries:</h4>
   2.402 -<p>
   2.403 -You can customize rhapsody via ~/.rhapsodyrc or use &lt;Ctrl+T&gt;  for options:
   2.404 -</p>
   2.405 -<a name="initramfs-iso"></a>
   2.406 -<h3><font color="#6c0023">Generate the initramfs and an ISO image</font></h3>
   2.407 -<p>
   2.408 -To create a new ISO image, you can use 'mktaziso' in SliTaz tools.  
   2.409 -Or you can create a new initramfs image, copy it to /boot in the root of the cdrom
   2.410 -(rootcd) and finally generate an ISO image with genisoimage:
   2.411 -</p>
   2.412 -<pre> # cd $fs
   2.413 - # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
   2.414 - # cd ..
   2.415 - # cp rootfs.gz rootcd/boot
   2.416 - # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
   2.417 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
   2.418 -   -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
   2.419 -</pre>
   2.420 -<h4>Following chapter</h4>
   2.421 -<p>
   2.422 -The next chapter describes the installation of the
   2.423 -<a href="locale.html">locales</a>
   2.424 -and i18n.
   2.425 -</p>
   2.426 -
   2.427 -
   2.428 -<!-- End of content -->
   2.429 -</div>
   2.430 -
   2.431 -<!-- Footer. -->
   2.432 -<div id="footer">
   2.433 -	<div class="footer-right"></div>
   2.434 -	<a href="base-ncurses.html#top">Top of the page</a> | 
   2.435 -	<a href="index.html">Table of contents</a>
   2.436 -</div>
   2.437 -
   2.438 -<div id="copy">
   2.439 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   2.440 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   2.441 -    Documentation is under
   2.442 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   2.443 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   2.444 -</div>
   2.445 -
   2.446 -</body>
   2.447 -</html>
     3.1 --- a/pt/doc/scratchbook/base-system.html	Wed Mar 31 03:06:23 2010 +0000
     3.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     3.3 @@ -1,675 +0,0 @@
     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="en" lang="en">
     3.7 -<head>
     3.8 -    <title>SliTaz Scratchbook - Base System</title>
     3.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    3.10 -    <meta name="description" content="" />
    3.11 -    <meta name="expires" content="never" />
    3.12 -    <meta name="modified" content="2008-11-22 17:00: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">Table of contents</a> |
    3.25 -    <a href="base-apps.html">Base apps</a>
    3.26 -</div>
    3.27 -<h1><font color="#3E1220">SliTaz Scratchbook</font></h1>
    3.28 -</div>
    3.29 -
    3.30 -<!-- Content. -->
    3.31 -<div id="content">
    3.32 -<div class="content-right"></div>
    3.33 -
    3.34 -
    3.35 -<h2><font color="#df8f06">Base System</font></h2>
    3.36 -<p>
    3.37 -Build a SliTaz GNU/Linux distro running in RAM and using BusyBox.
    3.38 -</p>
    3.39 -<ul>
    3.40 -    <li><a href="base-system.html#about">About.</a></li>
    3.41 -    <li><a href="base-system.html#src">Wget src.</a></li>
    3.42 -    <li><a href="base-system.html#prepa">Unpack and prepare the Linux kernel.</a></li>
    3.43 -    <li><a href="base-system.html#rootfs">Creation of the Root System</a>, the root
    3.44 -     file System (rootfs).</li>
    3.45 -    <li><a href="base-system.html#config">Configure the box.</a></li>
    3.46 -    <li><a href="base-system.html#initramfs">Generate the initramfs</a>, compressed cpio archive.</li>
    3.47 -    <li><a href="base-system.html#rootcd">Construction of the root of the cdrom</a> (rootcd), and the 
    3.48 -    configuration files of Syslinux.</li>
    3.49 -    <li><a href="base-system.html#mkiso">Create an ISO image with genisoimage or mkisofs.</a></li>
    3.50 -    <li><a href="base-system.html#testiso">Burn or test the ISO with Qemu.</a></li>
    3.51 -</ul>
    3.52 -<a name="about"></a>
    3.53 -<h3><font color="#6c0023">About</font></h3>
    3.54 -<p>
    3.55 -This document describes the construction of the SliTaz base system and why we use a
    3.56 -Linux Kernel, BusyBox and Syslinux to boot the system. SliTaz uses an initramfs 
    3.57 -archive unpacked in RAM by the kernel at boot. We will create a box to hold a 
    3.58 -root of 3 to 4MB and use strip on the libraries and binaries to save space.
    3.59 -</p>
    3.60 -<p>
    3.61 -The scripts and configuration files are created with GNU nano, using the keystroke 
    3.62 -&lt;ctrl+x&gt; to save and exit. But of course you are free to replace with your own text editor.
    3.63 -</p>
    3.64 -<p>
    3.65 -This document is based on a howto found in the archive of BusyBox, which is itself based on 
    3.66 -a paper presented by Erik Anderson in the Embedded Systems Conference in 2001.
    3.67 -</p>
    3.68 -<a name="src"></a>
    3.69 -<h3><font color="#6c0023">Wget src</font></h3>
    3.70 -<p>
    3.71 -Create a src directory for downloading and compiling:
    3.72 -</p>
    3.73 -<pre> # mkdir -p src
    3.74 - # cd src
    3.75 -</pre>
    3.76 -<ul>
    3.77 -    <li>Linux Kernel 2.6.20
    3.78 -    (<a href="http://www.kernel.org/">http://www.kernel.org/</a>).
    3.79 -    <pre># wget ftp://ftp.kernel.org/pub/linux/kernel/v2.6/linux-2.6.20.tar.bz2</pre>
    3.80 -    </li>
    3.81 -    <li>Busybox 1.2.2
    3.82 -    (<a href="http://www.busybox.net/">http://www.busybox.net/</a>).
    3.83 -    <pre># wget http://www.busybox.net/downloads/busybox-1.2.2.tar.bz2</pre>
    3.84 -    </li>
    3.85 -    <li>Syslinux 3.35
    3.86 -    (<a href="http://syslinux.zytor.com/">http://syslinux.zytor.com/</a>).
    3.87 -    <pre># wget ftp://ftp.kernel.org/pub/linux/boot/syslinux/syslinux-3.35.tar.gz</pre>
    3.88 -    </li>
    3.89 -    <li>SliTaz tools 1.1. Download SliTaz tools, unpack, save the file in src/ and that's it:
    3.90 -	<pre> # wget http://download.tuxfamily.org/slitaz/sources/tools/slitaz-tools-1.1.tar.gz
    3.91 - # tar xzf slitaz-tools-1.1.tar.gz</pre>
    3.92 -    </li>
    3.93 -</ul>
    3.94 -<a name="prepa"></a>
    3.95 -<h3><font color="#6c0023">Unpack and prepare the Linux Kernel</font></h3>
    3.96 -<p>
    3.97 -We will begin by compiling a Linux kernel, which may take a little time.
    3.98 -</p>
    3.99 -<h4>Linux Kernel</h4>
   3.100 -<p>
   3.101 -Your kernel must support the intramfs filesystem, otherwise the cdrom will not start. You can 
   3.102 -also install the modules in a directory so as not to touch the host system. The configuration 
   3.103 -of the Linux kernel sources is done by <code>make menuconfig</code> using ncurses or graphically 
   3.104 -with <code>make gconfig</code> or <code>make xconfig</code> using GTK development packages and/or 
   3.105 -QT respectively. You can find in <a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a>,
   3.106 -Makefiles for the various 2.6.xx kernels.
   3.107 -</p>
   3.108 -<p>
   3.109 -A feature of the 2.6 kernels is that if we make menuconfig, xconfig or config for the first time, 
   3.110 -the setup menu is displayed based on the configuration of our current kernel.
   3.111 -</p>
   3.112 -<p>
   3.113 -The options depend on your needs, you can install module-init-tools to support compressed modules 
   3.114 -or for a minimal install, you can select only the vital options.
   3.115 -</p>
   3.116 -<p>
   3.117 -We start by changing into the sources, <code>make mrproper</code> to put things in order, then we start a 
   3.118 -configuration interface: gconfig, xconfig, menuconfig or oldconfig:
   3.119 -</p>
   3.120 -<pre> # tar xjf linux-2.6.20.tar.bz2
   3.121 - # cd linux-2.6.20
   3.122 - # make mrproper
   3.123 - # cp ../slitaz-tools-1.1/Makefiles/linux-2.6.20-slitaz.config .config
   3.124 - # make oldconfig
   3.125 - (# make menuconfig)
   3.126 - # make bzImage
   3.127 - # make modules
   3.128 - # make INSTALL_MOD_PATH=$PWD/_pkg modules_install
   3.129 - # cd ..
   3.130 -</pre>
   3.131 -<p>
   3.132 -If you want more info on compiling kernels, there are many textbooks. Note that you can install the 
   3.133 -kernel and after rebooting, you can compile your own kernel following the same instructions.
   3.134 -</p>
   3.135 -<a name="rootfs"></a>
   3.136 -<h3><font color="#6c0023">Creation of the root system (rootfs)</font></h3>
   3.137 -<p>
   3.138 -The next step will create a file named 'rootfs' - Root File System, in the working directory SliTaz/:
   3.139 -</p>
   3.140 -<pre> # mkdir ../rootfs
   3.141 -</pre>
   3.142 -<h4>Install BusyBox</h4>
   3.143 -<p>
   3.144 -BusyBox (<a href="http://www.busybox.net/">www.busybox.net</a>) is a single executable offering 
   3.145 -versions of the main tools necessary to use a Linux kernel. It is (mainly) intended to be used 
   3.146 -embedded and can do almost anything. As well as proposing (coreutils) shell commands and a daemons 
   3.147 -system, it also provides a websever and client/server (DHCP, udhcpc).
   3.148 -</p>
   3.149 -<pre> # tar xjf busybox-1.2.2.tar.bz2
   3.150 -</pre>
   3.151 -<p>
   3.152 -Configure and compile, remembering the dumpkmap options, init, etc - you can find help in the Makefile in 
   3.153 -SliTaz Busybox tools. Make install creates a _install directory in the current directory:
   3.154 -</p>
   3.155 -<pre> # cd busybox-1.2.2
   3.156 - # cp ../slitaz-tools-1.1/Makefiles/busybox-1.2.2.config .config
   3.157 - # make oldconfig
   3.158 - (# make menuconfig)
   3.159 - # make
   3.160 - # make install
   3.161 - # chmod 4755 _install/bin/busybox
   3.162 -</pre>
   3.163 -<p>
   3.164 -Copy files compiled by BusyBox in the directory _install to the root file system (rootfs):
   3.165 -</p>
   3.166 -<pre> # cp -a _install/* ../../rootfs
   3.167 -</pre>
   3.168 -<p>
   3.169 -The linuxrc link pointing to /bin/busybox, folders /bin, /lib and /sbin were added to the directory
   3.170 -/rootfs - you can check this. It may be that the link isn't there if you didn't select the option
   3.171 -initrd support in Busybox. We'll delete the linuxrc link and create a link for init that points to 
   3.172 -/bin/busybox:
   3.173 -</p>
   3.174 -<pre> # cd ../../rootfs
   3.175 - # ls -CF
   3.176 - bin/  linuxrc@  sbin/  usr/
   3.177 -
   3.178 - # rm linuxrc
   3.179 - # ln -s bin/busybox init
   3.180 -</pre>
   3.181 -<h4>ldd on BusyBox</h4>
   3.182 -<p>
   3.183 -The ldd command can show any libraries used by a program. Libraries used by Busybox may differ 
   3.184 -depending on the host system. On Debian for example, copying the libraries in /lib/tls. The following 
   3.185 -commands are given using 'v' for verbose mode. To eliminate the symbols of executable binaries
   3.186 -and shared libraries we can utilize strip. Note you may also use the mklibs or uClibc libraries.
   3.187 -</p>
   3.188 -<pre> # mkdir lib
   3.189 -</pre>
   3.190 -<p>
   3.191 -SliTaz or another:
   3.192 -</p>
   3.193 -<pre> # cp /lib/{libcrypt.so.1,libm.so.6,libc.so.6} lib
   3.194 - # cp /lib/ld-linux.so.2 lib
   3.195 -</pre>
   3.196 -<p>
   3.197 -Example on Debian Etch:
   3.198 -</p>
   3.199 -<pre> # cp /lib/tls/{libcrypt.so.1,libm.so.6,libc.so.6} lib
   3.200 - # cp /lib/ld-linux.so.2 lib
   3.201 -</pre>
   3.202 -<p>
   3.203 -Cleanup libraries with strip:
   3.204 -</p>
   3.205 -<pre> # strip -v lib/*
   3.206 -</pre>
   3.207 -<h4>Linux tree and configuration</h4>
   3.208 -<p>
   3.209 -Make some directories for a classic Linux branch SliTaz installation. /dev for devices, /etc, /home, 
   3.210 -/usr, /proc, /root and co. To learn more about the hierarchy of a file system and its contents, 
   3.211 -there is a File System Hierarchy Standard available in various formats at 
   3.212 -<a href="http://www.pathname.com/fhs/">www.pathname.com/fhs/</a>.
   3.213 -</p>
   3.214 -<p>
   3.215 -You are free to create your own directory tree. In traditional Unix systems, /usr usually contains
   3.216 -files from the distribution, /dev contains devices (devices), /etc contains configuration files,
   3.217 -/lib libraries, /home for home users and /var for variable data. Note that we do not create 
   3.218 -/lib, /bin or /sbin - these are created when BusyBox is installed.
   3.219 -</p>
   3.220 -<pre> # mkdir -p dev etc root home proc media mnt sys tmp var
   3.221 - # mkdir -p usr/{lib,local,games,share} \
   3.222 -   var/{cache,lib,lock,log,games,run,spool} \
   3.223 -   media/{cdrom,flash,usbdisk}
   3.224 -</pre>
   3.225 -<p>
   3.226 -Change permissions on the /tmp directory:
   3.227 -</p>
   3.228 -<pre> # chmod 1777 tmp
   3.229 -</pre>
   3.230 -<p>
   3.231 -Setting up glibc - note /etc/ld.so.conf and /etc/rpc are not essential for a micro system:
   3.232 -</p>
   3.233 -<pre> # touch etc/ld.so.conf
   3.234 - # cp /etc/rpc etc
   3.235 -</pre>
   3.236 -<h4>Create the devices in /dev</h4>
   3.237 -<p>
   3.238 -This can be done with the script 'mkdevs.sh' found in BusyBox, or with our script 'mktazdevs.sh' in
   3.239 -SliTaz tools. If you want more details, read the scripts. If you use the BusyBox version, we must
   3.240 -still create the pts directory:
   3.241 -</p>
   3.242 -<pre> # cp ../src/slitaz-tools-1.1/utils/mktazdevs.sh bin
   3.243 - # ./bin/mktazdevs.sh dev
   3.244 -or:
   3.245 - # cp ../src/busybox-1.2.2/examples/bootfloppy/mkdevs.sh bin
   3.246 - # ./bin/mkdevs.sh dev
   3.247 - # mkdir -p dev/{pts,input,shm,net,usb}
   3.248 -</pre>
   3.249 -<p>
   3.250 -Note that we start mdev-s with the rcS script to create devices dynamically at boot.
   3.251 -</p>
   3.252 -<h4>Support for the resolution of hostnames (DNS)</h4>
   3.253 -<p>
   3.254 -Copy the libraries libnss_* of the host system into our SliTaz system. These libraries are used for
   3.255 -name resolution and are cleaned with strip:
   3.256 -</p>
   3.257 -<pre> # cp /lib/{libnss_dns.so.2,libnss_files.so.2} lib
   3.258 - # cp /lib/libresolv.so.2 lib
   3.259 - # strip -v lib/*.so*
   3.260 -</pre>
   3.261 -<a name="config"></a>
   3.262 -<h3><font color="#6c0023">Configuration of your box</font></h3>
   3.263 -<p>
   3.264 -Create the necessary files in /etc. For more info, just look at the contents of the files. 
   3.265 -We start by creating some files relevant to the core operating system.
   3.266 -</p>
   3.267 -<h4>Network</h4>
   3.268 -<p>
   3.269 -Create basic files used to configure the network:
   3.270 -</p>
   3.271 -<pre> # echo "127.0.0.1      localhost" &gt; etc/hosts
   3.272 - # echo "localnet    127.0.0.1" &gt; etc/networks
   3.273 - # echo "slitaz" &gt; etc/hostname
   3.274 - # echo "order hosts,bind" &gt; etc/host.conf
   3.275 - # echo "multi on" &gt;&gt; etc/host.conf
   3.276 -</pre>
   3.277 -<h4>/etc/nsswitch.conf</h4>
   3.278 -<p>
   3.279 -Configuration files used to resolve names:
   3.280 -</p>
   3.281 -<pre> # nano etc/nsswitch.conf
   3.282 -</pre>
   3.283 -<pre class="script"># /etc/nsswitch.conf: GNU Name Service Switch config.
   3.284 -#
   3.285 -
   3.286 -passwd:     files
   3.287 -group:      files
   3.288 -shadow:     files
   3.289 -
   3.290 -hosts:      files dns
   3.291 -networks:   files
   3.292 -
   3.293 -</pre>
   3.294 -<h4>/etc/securetty</h4>
   3.295 -<p>
   3.296 -/etc/securetty lists terminals that can connect to root:
   3.297 -</p>
   3.298 -<pre> # nano etc/securetty
   3.299 -</pre>
   3.300 -<pre class="script"># /etc/securetty: List of terminals on which root is allowed to login.
   3.301 -#
   3.302 -console
   3.303 -
   3.304 -# For people with serial port consoles
   3.305 -ttyS0
   3.306 -
   3.307 -# Standard consoles
   3.308 -tty1
   3.309 -tty2
   3.310 -tty3
   3.311 -tty4
   3.312 -tty5
   3.313 -tty6
   3.314 -tty7
   3.315 -
   3.316 -</pre>
   3.317 -<h4>/etc/shells</h4>
   3.318 -<p>
   3.319 -/etc/shells, a shells list of valid connections. This file is used by the SSH server (Dropbear):
   3.320 -</p>
   3.321 -<pre> # nano etc/shells
   3.322 -</pre>
   3.323 -<pre class="script"># /etc/shells: valid login shells.
   3.324 -/bin/sh
   3.325 -/bin/ash
   3.326 -/bin/hush
   3.327 -
   3.328 -</pre>
   3.329 -<h4>/etc/issue and /etc/motd</h4>
   3.330 -<p>
   3.331 -/etc/issue is displayed at the end of boot and the message of the day is displayed after logging in:
   3.332 -</p>
   3.333 -<pre> # echo "SliTaz GNU/Linux 1.0 Kernel \r \l" &gt; etc/issue
   3.334 - # echo "" &gt;&gt; etc/issue
   3.335 - # nano etc/motd
   3.336 -</pre>
   3.337 -<pre class="script">
   3.338 - (°-  { Get documentation in: /usr/share/doc.
   3.339 - //\    Use: 'less' or 'more' to read files, 'su' to be root. }
   3.340 - v_/_
   3.341 -
   3.342 -SliTaz is distributed in the hope that it will be useful, but
   3.343 -with ABSOLUTELY NO WARRANTY.
   3.344 -
   3.345 -</pre>
   3.346 -<h4>/etc/busybox.conf</h4>
   3.347 -<p>
   3.348 -The configuration file for BusyBox, it can set duties on BusyBox applications. For more information, you can read the
   3.349 -<a href="http://www.slitaz.org/en/doc/handbook/security.html">security</a> page in the Handbook. BusyBox.conf file:
   3.350 -
   3.351 -</p>
   3.352 -<pre> # nano etc/busybox.conf
   3.353 -</pre>
   3.354 -<pre class="script"># /etc/busybox.conf: SliTaz GNU/linux Busybox configuration.
   3.355 -#
   3.356 -
   3.357 -[SUID]
   3.358 -# Allow command to be run by anyone.
   3.359 -su = ssx root.root
   3.360 -passwd = ssx root.root
   3.361 -loadkmap = ssx root.root
   3.362 -mount = ssx root.root
   3.363 -reboot = ssx root.root
   3.364 -halt = ssx root.root
   3.365 -
   3.366 -</pre>
   3.367 -<p>
   3.368 -For added security, change the permissions on the file:
   3.369 -</p>
   3.370 -<pre> # chmod 600 etc/busybox.conf
   3.371 -</pre>
   3.372 -<h4>/etc/inittab</h4>
   3.373 -<p>
   3.374 -Minimal configuration file for init. It helps to have a root console without having to 
   3.375 -go through the login and a console on tty2.
   3.376 -</p>
   3.377 -<pre> # nano etc/inittab
   3.378 -</pre>
   3.379 -<pre class="script"># /etc/inittab: init configuration for SliTaz GNU/Linux.
   3.380 -
   3.381 -::sysinit:/etc/init.d/rcS
   3.382 -::respawn:-/bin/sh
   3.383 -tty2::askfirst:-/bin/sh
   3.384 -::ctrlaltdel:/bin/umount -a -r
   3.385 -::ctrlaltdel:/sbin/reboot
   3.386 -
   3.387 -</pre>
   3.388 -<p>
   3.389 -You will also find a wider example of an inittab file in the archive of BusyBox.
   3.390 -</p>
   3.391 -<h4>/etc/profile</h4>
   3.392 -<p>
   3.393 -This file is read at each login and affects all users. We must use the ./profile 
   3.394 -config file for each individual user:
   3.395 -</p>
   3.396 -<pre> # nano etc/profile
   3.397 -</pre>
   3.398 -<pre class="script"># /etc/profile: system-wide .profile file for the Bourne shells
   3.399 -
   3.400 -PATH="/usr/sbin:/usr/bin:/sbin:/bin:/usr/games"
   3.401 -LD_LIBRARY_PATH="/usr/lib:/lib"
   3.402 -
   3.403 -if [ "`id -u`" -eq 0 ]; then
   3.404 -  PS1='\e[1m\u@\h:\w\#\e[m '
   3.405 -else
   3.406 -  PS1='\e[1m\u@\h:\w\$\e[m '
   3.407 -fi
   3.408 -
   3.409 -DISPLAY=:0.0
   3.410 -
   3.411 -export PATH LD_LIBRARY_PATH PS1 DISPLAY ignoreeof
   3.412 -umask 022
   3.413 -
   3.414 -</pre>
   3.415 -<h4>Users, groups and passwords</h4>
   3.416 -<p>
   3.417 -Create configuration files of users, groups and passwords in /etc/ {passwd, shadow, group, gshadow}, and adjust permissions:
   3.418 -</p>
   3.419 -<pre> # echo "root:x:0:0:root:/root:/bin/sh" &gt; etc/passwd
   3.420 - # echo "root::13525:0:99999:7:::" &gt; etc/shadow
   3.421 - # echo "root:x:0:" &gt; etc/group
   3.422 - # echo "root:*::" &gt; etc/gshadow
   3.423 - # chmod 640 etc/shadow
   3.424 - # chmod 640 etc/gshadow
   3.425 -</pre>
   3.426 -<p>
   3.427 -You can add other users, like hacker is used by the LiveCD mode. You can also configure a password for the root user 
   3.428 -with the <code>passwd</code> command. To add an existing user to an existing group, you must edit /etc/group and /etc/gshadow because 
   3.429 -the applet <code>adduser</code> provided by BusyBox doesn't offer all of the options provided by the original program.
   3.430 -</p>
   3.431 -<h4>/etc/fstab or /etc/mtab</h4>
   3.432 -<p>
   3.433 -List filesystems to be mounted:
   3.434 -</p>
   3.435 -<pre> # nano etc/fstab
   3.436 -</pre>
   3.437 -<pre class="script"># /etc/fstab: information about static file system.
   3.438 -#
   3.439 -proc            /proc        proc    defaults          0       0
   3.440 -sysfs           /sys         sysfs   defaults          0       0
   3.441 -devpts          /dev/pts     devpts  defaults          0       0
   3.442 -tmpfs           /dev/shm     tmpfs   defaults          0       0
   3.443 -
   3.444 -</pre>
   3.445 -<p>
   3.446 -/etc/mtab is used by other mkfs*, for listing the mounted partitions. It needs /proc because there is a link on /proc/mounts:
   3.447 -</p>
   3.448 -<pre> # chroot . /bin/ash
   3.449 - /# ln -s /proc/mounts /etc/mtab
   3.450 -</pre>
   3.451 -<h4>Keyboard</h4>
   3.452 -<p>
   3.453 -You can create a kmap file specific to your keyboard with the dumpkmap command provided by BusyBox. 
   3.454 -You can find some kmap files in SliTaz tools. To create a fr_CH kmap file:
   3.455 -</p>
   3.456 -<pre> /# mkdir /usr/share/kmap
   3.457 - /# /bin/busybox dumpkmap &gt; /usr/share/kmap/fr_CH.kmap
   3.458 - /# exit
   3.459 -</pre>
   3.460 -<p>
   3.461 -Once this is done, you can automatically load your keyboard with loadkmap in a /etc/init.d/rcS script:
   3.462 -</p>
   3.463 -<h4>/usr/share/doc</h4>
   3.464 -<p>
   3.465 -You can also add various documents, such as a SliTaz user manual, which you can download as a tar.gz from the website:
   3.466 -</p>
   3.467 -<pre> # mkdir -p usr/share/doc
   3.468 -</pre>
   3.469 -<h4>Installing the udhcpc script</h4>
   3.470 -<p>
   3.471 -Udhcpc DHCP client supplied by Busybox is fast and stable, but is developed independently. 
   3.472 -Web site: <a href="http://udhcp.busybox.net/">http://udhcp.busybox.net/</a>. You can use the default 
   3.473 -script found in the archive of BusyBox. This script goes into /usr/share/udhcpc/default.script, 
   3.474 -but this can be changed via the command line. On SliTaz, the client is started at boot by the script 
   3.475 -/etc/init.d/network.sh via the configuration file /etc/network.conf:
   3.476 -</p>
   3.477 -<pre> # mkdir usr/share/udhcpc
   3.478 - # cp ../src/busybox-1.2.2/examples/udhcp/simple.script \
   3.479 -   usr/share/udhcpc/default.script
   3.480 - # chmod +x usr/share/udhcpc/default.script
   3.481 -</pre>
   3.482 -<h4>/etc/init.d/rcS</h4>
   3.483 -<p>
   3.484 -To finish off this draft, you must create the init script /etc/init.d/rcS to mount the filesystems 
   3.485 -and run some commands. For more information, you can look at the
   3.486 -<a href="http://www.slitaz.org/en/doc/cookbook/boot-scripts.html">boot scripts</a> page.
   3.487 -You can change the value of the variable KMAP= for the keyboard:
   3.488 -</p>
   3.489 -<pre> # mkdir etc/init.d
   3.490 - # nano etc/init.d/rcS
   3.491 -</pre>
   3.492 -<pre class="script">#! /bin/sh
   3.493 -# /etc/init.d/rcS: rcS initial script.
   3.494 -#
   3.495 -
   3.496 -KMAP=fr_CH
   3.497 -
   3.498 -echo "Processing /etc/init.d/rcS... "
   3.499 -
   3.500 -/bin/mount proc
   3.501 -/bin/mount -a
   3.502 -/bin/hostname -F /etc/hostname
   3.503 -/sbin/ifconfig lo 127.0.0.1 up
   3.504 -/sbin/loadkmap &lt; /usr/share/kmap/$KMAP.kmap
   3.505 -
   3.506 -
   3.507 -</pre>
   3.508 -<pre> # chmod +x etc/init.d/rcS
   3.509 -</pre>
   3.510 -<h4>Note</h4>
   3.511 -<p>
   3.512 -Note that you can still install the tazpkg package manager (10 kb) that we created,
   3.513 -you will find information to install in the source tarball. You can also install various 
   3.514 -files from SliTaz tools, such as the licence.
   3.515 -</p>
   3.516 -
   3.517 -<a name="initramfs"></a>
   3.518 -<h3><font color="#6c0023">Build an initramfs cpio archive</font></h3>
   3.519 -<p>
   3.520 -The initramfs is a <code>cpio</code> archive generated from the root of the system, 
   3.521 -it is decompressed in RAM by the Linux kernel at boot to create the filesystem (also in RAM). 
   3.522 -To generate an initramfs archive, using the root directory of system files (rootfs), we 
   3.523 -facilitate a search with <code>find</code> and add some pipes <code>|</code>. 
   3.524 -Then we create a cpio archive using <code>gzip</code> which we put in the working directory.
   3.525 -</p>
   3.526 -<p>
   3.527 -The SliTaz initramfs <strong>rootfs.gz</strong> is the root system, but with a <code>.gz</code> 
   3.528 -extension. If you want to change the name, you need to edit the configuration file for 
   3.529 -isolinux: isolinux.cfg or the menu.lst for GRUB.
   3.530 -</p>
   3.531 -<p>
   3.532 -Generation of the initramfs:
   3.533 -</p>
   3.534 -<pre> # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
   3.535 -</pre>
   3.536 -<p>
   3.537 -You should have a file rootfs.gz about 1 to 2MB in the working directory SliTaz/.
   3.538 -</p>
   3.539 -<p>
   3.540 -For a new image, when making changes in rootfs, simply copy the new rootfs.gz archive to rootcd/boot 
   3.541 -and create a new image with <code>genisoimage</code> or <code>mkisofs</code>. For this you can also 
   3.542 -use <strong>mktaziso</strong> within SliTaz tools. This script will check if the directories are present, 
   3.543 -create a new compressed cpio archive and generate a new bootable ISO image.
   3.544 -</p>
   3.545 -<a name="rootcd"></a>
   3.546 -<h3><font color="#6c0023">Make rootcd files</font></h3>
   3.547 -<p>
   3.548 -The following steps will help you create the root of the bootable CD-ROM. We begin by creating the rootcd, 
   3.549 -boot and isolinux directories for the cd-rom files:
   3.550 -</p>
   3.551 -<pre> # cd ..
   3.552 - # mkdir -p rootcd/boot/isolinux
   3.553 -</pre>
   3.554 -<p>
   3.555 -Optionally, you can create some other directories in which to place various data, such as HTML documents or packages.
   3.556 -</p>
   3.557 -<a name="linux"></a>
   3.558 -<h4>Copy the kernel</h4>
   3.559 -<p>
   3.560 -Just copy the kernel previously compiled to rootcd/boot:
   3.561 -</p>
   3.562 -<pre> # cp src/linux-2.6.20/arch/i386/boot/bzImage rootcd/boot
   3.563 -</pre>
   3.564 -<h4>Copy the initramfs into rootcd/boot</h4>
   3.565 -<p>
   3.566 -Copy the rootfs.gz to rootcd/boot. We must not forget to generate a new initramfs archive for any changes 
   3.567 -made to the rootfs (root file system):
   3.568 -</p>
   3.569 -<pre> # cp rootfs.gz rootcd/boot
   3.570 -</pre>
   3.571 -<h4>Install the isolinux bootloader</h4>
   3.572 -<p>
   3.573 -The bootloader isolinux - simply copy the isolinux.bin from the source archive of Syslinux:
   3.574 -</p>
   3.575 -<pre> # cd src
   3.576 - # tar xzf syslinux-3.35.tar.gz
   3.577 - # cp syslinux-3.35/isolinux.bin ../rootcd/boot/isolinux
   3.578 - # cd ..
   3.579 -</pre>
   3.580 -<h4>isolinux.cfg - Configure isolinux</h4>
   3.581 -<p>
   3.582 -Here is an example of an isolinux.cfg file that should work well. You can change it if you wish:
   3.583 -</p>
   3.584 -<pre> # nano rootcd/boot/isolinux/isolinux.cfg
   3.585 -</pre>
   3.586 -<pre class="script">display display.txt
   3.587 -default slitaz
   3.588 -label slitaz
   3.589 -    kernel /boot/bzImage
   3.590 -    append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
   3.591 -implicit 0
   3.592 -prompt 1
   3.593 -timeout 80
   3.594 -
   3.595 -</pre>
   3.596 -<p>
   3.597 -Here are some changes that you might like to make in isolinux.cfg:
   3.598 -</p>
   3.599 -<ul>
   3.600 -    <li>The timeout value is the number of seconds to wait before booting 
   3.601 -	You can make it 0 or delete the line to start instantly, or choose to wait as long as 10s.</li>
   3.602 -    <li>prompt can be set to 0 to disable the 'boot:' prompt.</li>
   3.603 -    <li>You can add more lines to view the contents of several text files when the user presses F1, F2, F3, etc.</li>
   3.604 -</ul>
   3.605 -<h4>display.txt</h4>
   3.606 -<p>
   3.607 -A small welcome note, powered by isolinux, you can modify this file if you wish:
   3.608 -</p>
   3.609 -<pre> # nano rootcd/boot/isolinux/display.txt
   3.610 -</pre>
   3.611 -<pre class="script">/*       _\|/_
   3.612 -         (o o)
   3.613 - +----oOO-{_}-OOo---------------------------------------------------+
   3.614 -     ____  _ _ _____
   3.615 -    / ___|| (_)_   _|_ _ ____
   3.616 -    \___ \| | | | |/ _` |_  /
   3.617 -     ___) | | | | | (_| |/ /
   3.618 -    |____/|_|_| |_|\__,_/___|
   3.619 -
   3.620 - SliTaz GNU/Linux - Temporary Autonomous Zone
   3.621 -
   3.622 -     &lt;ENTER&gt; to boot.
   3.623 -
   3.624 -                                                                   */
   3.625 -</pre>
   3.626 -<a name="mkiso"></a>
   3.627 -<h3><font color="#6c0023">Create an ISO image with genisoimage or mkisofs</font></h3>
   3.628 -<pre> # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
   3.629 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
   3.630 -   -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
   3.631 -</pre>
   3.632 -<p>
   3.633 -For each change in the root of the box, you must create a new ISO image.
   3.634 -</p>
   3.635 -<p>
   3.636 -You can create a small script that will generate a new compressed cpio archive and a new image, 
   3.637 -or use mktaziso within SliTaz tools. Note that you can also use GRUB to boot the box.
   3.638 -</p>
   3.639 -<a name="testiso"></a>
   3.640 -<h3><font color="#6c0023">Burn or test ISO image with Qemu</font></h3>
   3.641 -<p>
   3.642 -You can burn the ISO image with Graveman, k3b or wodim and boot it. Simple burning command using wodim (also valid for cdrecord), with a 2.6.XX. kernel:
   3.643 -</p>
   3.644 -<pre># wodim -v -speed=24 -data slitaz-cooking.iso
   3.645 -</pre>
   3.646 -<h4>Qemu</h4>
   3.647 -<p>
   3.648 -Note that you can test the ISO image with the software emulator Qemu (On Debian # aptitude install qemu). 
   3.649 -To emulate the newly created ISO image, simply type:
   3.650 -</p>
   3.651 -<pre># qemu -cdrom slitaz-cooking.iso
   3.652 -</pre>
   3.653 -<h4>Following chapter</h4>
   3.654 -<p>
   3.655 -The next chapter <a href="base-apps.html">Base applications</a> provides all the instructions to install 
   3.656 -and configure the basic applications and libraries.
   3.657 -</p>
   3.658 -
   3.659 -<!-- End of content -->
   3.660 -</div>
   3.661 -
   3.662 -<!-- Footer. -->
   3.663 -<div id="footer">
   3.664 -	<div class="footer-right"></div>
   3.665 -	<a href="base-system.html#top">Top of the page</a> | 
   3.666 -	<a href="index.html">Table of contents</a>
   3.667 -</div>
   3.668 -
   3.669 -<div id="copy">
   3.670 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   3.671 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   3.672 -    Documentation is under
   3.673 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   3.674 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   3.675 -</div>
   3.676 -
   3.677 -</body>
   3.678 -</html>
     4.1 --- a/pt/doc/scratchbook/book.css	Wed Mar 31 03:06:23 2010 +0000
     4.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.3 @@ -1,170 +0,0 @@
     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: auto;
    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 information */
    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 --- a/pt/doc/scratchbook/boot-scripts.html	Wed Mar 31 03:06:23 2010 +0000
     5.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     5.3 @@ -1,207 +0,0 @@
     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="en" lang="en">
     5.7 -<head>
     5.8 -    <title>SliTaz Scratchbook - Boot Scripts</title>
     5.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    5.10 -    <meta name="description" content="" />
    5.11 -    <meta name="expires" content="never" />
    5.12 -    <meta name="modified" content="2008-11-22 17:00: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 &amp; i18n</a> |
    5.25 -    <a href="index.html">Table of contents</a> |
    5.26 -    <a href="x-window-system.html">X window system</a>
    5.27 -</div>
    5.28 -<h1><font color="#3E1220">SliTaz Scratchbook</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 -<h2><font color="#df8f06">Boot scripts</font></h2>
    5.36 -<p>
    5.37 -The startup and shutdown scripts with their configuration files.
    5.38 -</p>
    5.39 -
    5.40 -<ul>
    5.41 -  	<li><a href="boot-scripts.html#intro">SliTaz and startup.</a></li>
    5.42 -	<li><a href="boot-scripts.html#init.d">/etc/init.d/*</a> - Directory of scripts and daemons.</li>
    5.43 -	<li><a href="boot-scripts.html#rcS">/etc/init.d/rcS</a> - Primary initialization script.</li>
    5.44 -	<li><a href="boot-scripts.html#rc-scripts">Specific scripts and daemons</a> - Scripts and
    5.45 -	daemons with a very specific task.</li>
    5.46 -	<li><a href="boot-scripts.html#inittab">/etc/inittab</a> - Configuration file init.</li>
    5.47 -</ul>
    5.48 -
    5.49 -<a name="intro"></a>
    5.50 -<h3><font color="#6c0023">SliTaz and startup</font></h3>
    5.51 -
    5.52 -<p>
    5.53 -SliTaz does not use a level of execution (runlevel), the
    5.54 -system is initialized via a primary script and its main 
    5.55 -configuration file. This script itself launches some other smaller 
    5.56 -scripts which deal with the internationalization or the
    5.57 -commands placed for the system to start.
    5.58 -</p>
    5.59 -
    5.60 -<a name="init.d"></a>
    5.61 -<h3><font color="#6c0023">/etc/init.d/* - Directory of scripts and daemons</font></h3>
    5.62 -<p>
    5.63 -The directory /etc/init.d contains all of the rc scripts,
    5.64 -scripts finishing with '.sh' are simple shell scripts and
    5.65 -daemons such as 'dropbear' or 'lighttpd' are scripts
    5.66 -that launch a service. The daemon scripts can start, stop or
    5.67 -restart through the command:
    5.68 -</p>
    5.69 -<pre> # /etc/init.d/daemon [start|stop|restart]
    5.70 -</pre>
    5.71 -<p>
    5.72 -On SliTaz you will find a /etc/init.d/README describing the
    5.73 -basic function of rc scripts. Also note that all startup
    5.74 -scripts and daemons can call upon the <code>/etc/init.d/rc.functions</code>
    5.75 -file. This file makes it possible to include various functions
    5.76 -in rc scripts. SliTaz uses a function <code>status</code> to check whether
    5.77 -the previous command has succeeded (0) or not.
    5.78 -</p>
    5.79 -
    5.80 -<a name="rcS"></a>
    5.81 -<h3><font color="#6c0023">/etc/init.d/rcS - Primary initialization script</font></h3>
    5.82 -<p>
    5.83 -The <code>/etc/init.d/rcS</code> script configures all the 
    5.84 -basic services and initializes the base system. It begins by 
    5.85 -mounting the filesystems and starts services like syslogd, klogd,
    5.86 -mdev and cleans up the system and so on. It
    5.87 -uses the configuration file <code>/etc/rcS.conf</code> to locate which daemons
    5.88 -and scripts to launch at startup. You can browse the script
    5.89 -to know which commands are executed:
    5.90 -</p>
    5.91 -<pre> # nano rootfs/etc/init.d/rcS 
    5.92 -</pre>
    5.93 -
    5.94 -
    5.95 -<a name="rc-scripts"></a>
    5.96 -<h3><font color="#6c0023">Specific scripts and daemons</font></h3>
    5.97 -
    5.98 -<h4>bootopts.sh - LiveCD mode options</h4>
    5.99 -<p>
   5.100 -This script is used to configure the LiveCD options passed
   5.101 -at boot time and is readable via the /proc/cmdline file. 
   5.102 -This is the script that allows you to use a USB key or 
   5.103 -external hard disk <code>/home</code>  partition with the option home=usb
   5.104 -or home=sda[1-9] or directly specify the language and 
   5.105 -keyboard parameters.
   5.106 -</p>
   5.107 -
   5.108 -<h4>network.sh - Initializing the network</h4>
   5.109 -<p>
   5.110 -This script searches the network.sh configuration file 
   5.111 -/etc/network.conf for the network interface to use; if one wants to
   5.112 -launch the DHCP client (or not) or if you want to use a fixed 
   5.113 -(static) IP. On SliTaz the /etc/init.d/network.sh 
   5.114 -script configures the network interfaces to start using the 
   5.115 -information contained in /etc/network.conf. If the variable 
   5.116 -$DHCP is equal to yes, then the /etc/init.d/network.sh 
   5.117 -script launches the DHCP client on the $INTERFACE interface.
   5.118 -</p>
   5.119 -
   5.120 -<h4>i18n.sh - Internationalization</h4>
   5.121 -<p>
   5.122 -SliTaz backs up the configuration of the default locale in
   5.123 -/etc/locale.conf which is read by /etc/profile at each 
   5.124 -login. The /etc/locale.conf is generated during boot time
   5.125 -thanks to the /etc/i18n.sh script. This script launches the
   5.126 -'tazlocale' application if /etc/locale.conf doesn't exist. 
   5.127 -We use the same process for the keyboard layout using 'tazkmap' 
   5.128 -and the /etc/kmap.conf configuration file. Both applications 
   5.129 -are installed and located in /sbin and use dialog and the 
   5.130 -ncurses library. The script also checks whether the 
   5.131 -configuration file for the time zone /etc/TZ exists, 
   5.132 -otherwise it creates one relying on the keyboard configuration.
   5.133 -</p>
   5.134 -
   5.135 -<h4>local.sh - Local commands</h4>
   5.136 -<p>
   5.137 -The /etc/init.d/local.sh script allows the system administrator
   5.138 -to add local commands to be executed at boot. Example:
   5.139 -</p>
   5.140 -<pre class="script">#!/bin/sh
   5.141 -# /etc/init.d/local.sh: Local startup commands.
   5.142 -# All commands here will be executed at boot time.
   5.143 -#
   5.144 -. /etc/init.d/rc.functions
   5.145 -
   5.146 -echo "Starting local startup commands... "
   5.147 -
   5.148 -</pre>
   5.149 -
   5.150 -<h4>rc.shutdown</h4>
   5.151 -<p>
   5.152 -This script is invoked by /etc/inittab during system shutdown.
   5.153 -It also stops all daemons via the variable RUN_DAEMONS in 
   5.154 -the primary <code>/etc/rcS.conf</code> configuration file.
   5.155 -</p>
   5.156 -
   5.157 -<a name="inittab"></a>
   5.158 -<h3><font color="#6c0023">/etc/inittab - Configuration file init</font></h3>
   5.159 -<p>
   5.160 -The first file read by the Kernel at boot. It defines the 
   5.161 -initialization script (/etc/init.d/rcS), shells (ttys) and
   5.162 -actions in the event of a reboot or disruption. You will find
   5.163 -a complete example with accompanying notes in <a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a>:
   5.164 -</p>
   5.165 -<pre class="script"># /etc/inittab: init configuration for SliTaz GNU/Linux.
   5.166 -# Boot-time system configuration/initialization script.
   5.167 -#
   5.168 -::sysinit:/etc/init.d/rcS
   5.169 -
   5.170 -# /sbin/getty respawn shell invocations for selected ttys.
   5.171 -tty1::respawn:/sbin/getty 38400 tty1
   5.172 -tty2::respawn:/sbin/getty 38400 tty2
   5.173 -tty3::respawn:/sbin/getty 38400 tty3
   5.174 -tty4::respawn:/sbin/getty 38400 tty4
   5.175 -tty5::respawn:/sbin/getty 38400 tty5
   5.176 -tty6::respawn:/sbin/getty 38400 tty6
   5.177 -
   5.178 -# Stuff to do when restarting the init 
   5.179 -# process, or before rebooting.
   5.180 -::restart:/etc/init.d/rc.shutdown
   5.181 -::restart:/sbin/init
   5.182 -::ctrlaltdel:/sbin/reboot
   5.183 -::shutdown:/etc/init.d/rc.shutdown
   5.184 -
   5.185 -</pre>
   5.186 -<h4>Following chapter</h4>
   5.187 -<p>
   5.188 -The next chapter continues on with the <a href="x-window-system.html">X window system</a>.
   5.189 -</p>
   5.190 -
   5.191 -<!-- End of content -->
   5.192 -</div>
   5.193 -
   5.194 -<!-- Footer. -->
   5.195 -<div id="footer">
   5.196 -	<div class="footer-right"></div>
   5.197 -	<a href="boot-scripts.html#top">Top of the page</a> | 
   5.198 -	<a href="index.html">Table of contents</a>
   5.199 -</div>
   5.200 -
   5.201 -<div id="copy">
   5.202 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   5.203 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   5.204 -    Documentation is under
   5.205 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   5.206 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   5.207 -</div>
   5.208 -
   5.209 -</body>
   5.210 -</html>
     6.1 Binary file pt/doc/scratchbook/favicon.ico has changed
     7.1 --- a/pt/doc/scratchbook/gtk-apps.html	Wed Mar 31 03:06:23 2010 +0000
     7.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.3 @@ -1,304 +0,0 @@
     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="en" lang="en">
     7.7 -<head>
     7.8 -    <title>SliTaz Scratchbook - GTK+ Applications</title>
     7.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    7.10 -    <meta name="description" content="" />
    7.11 -    <meta name="expires" content="never" />
    7.12 -    <meta name="modified" content="2008-11-22 17:00: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 id="quicknav" align="right">
    7.23 -    <a name="top"></a>
    7.24 -    <a href="gtk-libs.html">Gtk-libs</a> |
    7.25 -    <a href="index.html">Table of contents</a>
    7.26 -</div>
    7.27 -<h1><font color="#3e1220">SliTaz Scratchbook</font></h1>
    7.28 -</div>
    7.29 -
    7.30 -<!-- Content. -->
    7.31 -<div id="content">
    7.32 -<div class="content-right"></div>
    7.33 -
    7.34 -
    7.35 -<h2><font color="#df8f06">GTK+ Applications</font></h2>
    7.36 -<p>
    7.37 -Compiliation and installation of applications using GTK+.
    7.38 -</p>
    7.39 -<ul>
    7.40 -    <li><a href="gtk-apps.html#about">About this chapter.</a> - Description and environmental variable ($fs)</li>
    7.41 -    <li><a href="gtk-apps.html#leafpad">leafpad-0.8.10</a> - Simple text editor.</li>
    7.42 -    <li><a href="gtk-apps.html#gitmail">gitmail-0.4</a> -  Ghost In The Mail, mail client.</li>
    7.43 -    <li><a href="gtk-apps.html#gqview">gqview-2.0.4</a>  - Images Manager.</li>
    7.44 -    <li><a href="gtk-apps.html#mtpaint">mtpaint-3.11</a>  - Image creation and processing.</li>
    7.45 -    <li><a href="gtk-apps.html#transmission">Transmission-0.72</a> - Lightweight BitTorrent client.</li>
    7.46 -    <li><a href="gtk-apps.html#emelfm2">emelfm2-0.3.5</a> - File Manager.</li>
    7.47 -    <li><a href="gtk-apps.html#geany">geany-0.11</a> - Integrated Development Environment.</li>
    7.48 -    <li><a href="gtk-apps.html#gftp">gftp-2.0.18</a> - Fast and simple FTP client.</li>
    7.49 -    <li><a href="gtk-apps.html#xpad">xpad-2.12</a> - Mini note taking application.</li>
    7.50 -</ul>
    7.51 -<a name="about"></a>
    7.52 -<h3><font color="#6c0023">About</font></h3>
    7.53 -<p>
    7.54 -This chapter describes the commands for the compilation and installation of
    7.55 -GTK+ applications distributed by default on the SliTaz LiveCD. The installation 
    7.56 -of GTK+ libraries are described in the
    7.57 -<a href="http://www.slitaz.org/doc/scratchbook/gtk-libs.html">GTK+ libs</a> chapter.
    7.58 -</p>
    7.59 -<h4>Environmental variable ($fs)</h4>
    7.60 -<p>
    7.61 -If you do not specify any path to the rootfs directory, export the environmental variable:
    7.62 -</p>
    7.63 -<pre> # export fs=$PWD/rootfs
    7.64 -</pre>
    7.65 -<p>
    7.66 -To check:
    7.67 -</p>
    7.68 -<pre> # echo $fs
    7.69 -</pre>
    7.70 -<a name="leafpad"></a>
    7.71 -<h3><font color="#6c0023">leafpad-0.8.10 - Simple text editor</font></h3>
    7.72 -<p>
    7.73 -Website: <a href="http://tarot.freeshell.org/leafpad/">http://tarot.freeshell.org/leafpad/</a>
    7.74 -</p>
    7.75 -<pre> # wget http://savannah.nongnu.org/download/leafpad/leafpad-0.8.10.tar.gz
    7.76 - # tar xzf leafpad-0.8.10.tar.gz
    7.77 - # cd leafpad-0.8.10
    7.78 - # ./configure --prefix=/usr
    7.79 - # make
    7.80 - # make DESTDIR=$PWD/_pkg install
    7.81 - # strip _pkg/usr/bin/*
    7.82 -</pre>
    7.83 -<h4>Install in rootfs</h4>
    7.84 -<pre> # cp _pkg/usr/bin/* $fs/usr/bin
    7.85 - # cp _pkg/usr/share/pixmaps/leafpad.png $fs/usr/share/pixmaps
    7.86 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
    7.87 -</pre>
    7.88 -<a name="gitmail"></a>
    7.89 -<h3><font color="#6c0023">gitmail-0.4 - Ghost In The Mail, mail client</font></h3>
    7.90 -<p>
    7.91 -Ghost in the mail allows users to quickly and easily send mail via SMTP.
    7.92 -</p>
    7.93 -<p>
    7.94 -Website: <a href="http://gitmail.sourceforge.net/">http://gitmail.sourceforge.net/</a>
    7.95 -</p>
    7.96 -<pre> # wget http://switch.dl.sourceforge.net/sourceforge/gitmail/gitmail-0.4.tar.gz
    7.97 - # tar xzf gitmail-0.4.tar.gz
    7.98 - # cd GhostInTheMail-0.4
    7.99 - # ./configure --prefix=/usr
   7.100 - # make
   7.101 - # make DESTDIR=$PWD/_pkg \
   7.102 -   gitmaildocdir=/usr/share/doc/GhostInTheMail \
   7.103 -   install
   7.104 - # strip _pkg/usr/bin/*
   7.105 -</pre>
   7.106 -<h4>Install in rootfs</h4>
   7.107 -<pre> # cp _pkg/usr/bin/* $fs/usr/bin
   7.108 -</pre>
   7.109 -<a name="gqview"></a>
   7.110 -<h3><font color="#6c0023">gqview-2.0.4 - Images Manager</font></h3>
   7.111 -<p>
   7.112 -Website: <a href="http://gqview.sourceforge.net/">http://gqview.sourceforge.net/</a>
   7.113 -</p>
   7.114 -<pre> # wget http://belnet.dl.sourceforge.net/sourceforge/gqview/gqview-2.0.4.tar.gz
   7.115 - # tar xzf gqview-2.0.4.tar.gz
   7.116 - # cd gqview-2.0.4
   7.117 - # ./configure --prefix=/usr --mandir=/usr/share/man
   7.118 - # make
   7.119 - # make DESTDIR=$PWD/_pkg install
   7.120 - # strip _pkg/usr/bin/*
   7.121 -</pre>
   7.122 -<h4>Install in rootfs</h4>
   7.123 -<pre> # cp _pkg/usr/bin/* $fs/usr/bin
   7.124 - # cp _pkg/usr/share/pixmaps/* $fs/usr/share/pixmaps
   7.125 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   7.126 -</pre>
   7.127 -<a name="mtpaint"></a>
   7.128 -<h3><font color="#6c0023">mtpaint-3.11 - Image creation and processing</font></h3>
   7.129 -<p>
   7.130 -Website: <a href="http://mtpaint.sourceforge.net/">http://mtpaint.sourceforge.net/</a>
   7.131 -</p>
   7.132 -<pre> # wget http://switch.dl.sourceforge.net/sourceforge/mtpaint/mtpaint-3.11.tar.bz2
   7.133 - # tar xjf mtpaint-3.11.tar.bz2
   7.134 - # cd mtpaint-3.11
   7.135 - # ./configure --cpu=i486 --prefix=/usr intl
   7.136 - # make
   7.137 - # strip src/mtpaint
   7.138 -</pre>
   7.139 -<h4>Install in rootfs</h4>
   7.140 -<pre> # cp src/mtpaint $fs/usr/bin
   7.141 - # cp po/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/mtpaint.mo
   7.142 - # cp src/icons1/icon.xpm $fs/usr/share/pixmaps/mtpaint.xpm
   7.143 -</pre>
   7.144 -<a name="transmission"></a>
   7.145 -<h3><font color="#6c0023">Transmission-0.72 - Lightweight BitTorrent client</font></h3>
   7.146 -<p>
   7.147 -Tranmission BitTorrent client is fast, lightweight and easy to use. The compiled package provides 
   7.148 -the command line client (transmissioncli) and a GTK+ client (transmission-gtk). We install the GTK+ client, 
   7.149 -the command line client is distributed as a separate SliTaz package (*.tazpkg).
   7.150 -</p>
   7.151 -<p>
   7.152 -Website: <a href="http://transmission.m0k.org/">http://transmission.m0k.org/</a>
   7.153 -</p>
   7.154 -<pre> # wget http://download.m0k.org/transmission/files/Transmission-0.72.tar.gz
   7.155 - # tar xzf Transmission-0.72.tar.gz
   7.156 -
   7.157 - La version 0.72 est mal archivée:
   7.158 - # mv "Transmission .72" Transmission-0.72
   7.159 -
   7.160 - # cd Transmission-0.72
   7.161 - # ./configure --prefix=/usr  --disable-openssl
   7.162 - # make
   7.163 - # strip gtk/transmission-gtk
   7.164 - # strip cli/transmissioncli
   7.165 -</pre>
   7.166 -<h4>Install in rootfs</h4>
   7.167 -<pre> # cp gtk/transmission-gtk $fs/usr/bin
   7.168 - # cp gtk/transmission.png $fs/usr/share/pixmaps
   7.169 - # cp gtk/po/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/transmission-gtk.mo
   7.170 -</pre>
   7.171 -<a name="emelfm2"></a>
   7.172 -<h3><font color="#6c0023">emelfm2-0.3.5 - File Manager</font></h3>
   7.173 -<p>
   7.174 -The emelFM2 application is a file manager providing lots of useful functions, 
   7.175 -such as the mounting of devices, a text viewer, opening a terminal in the current 
   7.176 -directory and so on.
   7.177 -</p>
   7.178 -<p>
   7.179 -Website: <a href="http://emelfm2.net/">http://emelfm2.net/</a>
   7.180 -</p>
   7.181 -<pre> # cd ..
   7.182 - # wget http://emelfm2.net/rel/emelfm2-0.3.5.tar.gz
   7.183 - # tar xzf emelfm2-0.3.5.tar.gz
   7.184 - # cd emelfm2-0.3.5
   7.185 - # make PREFIX=/usr
   7.186 - # make i18n PREFIX=/usr
   7.187 - # make install PREFIX=$PWD/_pkg/usr
   7.188 - # make install_i18n PREFIX=$PWD/_pkg/usr
   7.189 - # strip -v _pkg/usr/bin/*
   7.190 - # strip -v _pkg/usr/lib/emelfm2/plugins/*
   7.191 -</pre>
   7.192 -<h4>Install in rootfs</h4>
   7.193 -<pre> # cp _pkg/usr/bin/* $fs/usr/bin
   7.194 - # cp -a _pkg/usr/lib/* $fs/usr/lib
   7.195 - # cp -a _pkg/usr/share/pixmaps $fs/usr/share
   7.196 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   7.197 -</pre>
   7.198 -<a name="geany"></a>
   7.199 -<h3><font color="#6c0023">geany-0.11 - Integrated Development Environment</font></h3>
   7.200 -<p>
   7.201 -Geany is a simple, fast and light IDE offering colored syntax, tabs, autocompletion, aids to scripts and much more.
   7.202 -</p>
   7.203 -<p>
   7.204 -Website: <a href="http://geany.uvena.de/">http://geany.uvena.de/</a>
   7.205 -</p>
   7.206 -<p>
   7.207 -To compile and run geany on SliTaz, you must have the libstdc++ and libgcc1 libraries, 
   7.208 -both provided by gcc (we recompiled with gcc-4.1.1), but you can copy the libraries from the host system.
   7.209 -</p>
   7.210 -<p>
   7.211 -Note: The force is with you, if you activate it via the option --enable-the-force.
   7.212 -</p>
   7.213 -<pre> # wget http://mesh.dl.sourceforge.net/sourceforge/geany/geany-0.11.tar.gz
   7.214 - # tar xzf geany-0.11.tar.gz
   7.215 - # cd geany-0.11
   7.216 - # ./configure --prefix=/usr --mandir=/usr/share/man \
   7.217 -   --disable-vte --enable-the-force
   7.218 - # make
   7.219 - # make DESTDIR=$PWD/_pkg install
   7.220 - # strip -v _pkg/usr/bin/*
   7.221 -</pre>
   7.222 -<h4>Install in rootfs</h4>
   7.223 -<pre> # cp _pkg/usr/bin/* $fs/usr/bin
   7.224 - # cp -a _pkg/usr/share/geany $fs/usr/share
   7.225 - # cp _pkg/usr/share/pixmaps/geany.png $fs/usr/share/pixmaps
   7.226 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   7.227 -</pre>
   7.228 -<a name="gftp"></a>
   7.229 -<h3><font color="#6c0023">gftp-2.0.18 - Fast and simple FTP client</font></h3>
   7.230 -<p>
   7.231 -The gFTP application is a fast and efficient FTP client with a GTK+ graphical interface. 
   7.232 -Note that we compile without support for a text interface and ssl support. Get, untar, 
   7.233 -configure, compile and install.
   7.234 -</p>
   7.235 -<p>
   7.236 -Website: <a href="http://www.gftp.org/">http://www.gftp.org/</a>
   7.237 -</p>
   7.238 -<pre> # wget http://www.gftp.org/gftp-2.0.18.tar.gz
   7.239 - # tar xzf gftp-2.0.18.tar.gz
   7.240 - # cd gftp-2.0.18
   7.241 - # ./configure --prefix=/usr --mandir=/usr/share/man \
   7.242 -   --disable-ssl --disable-textport \
   7.243 -   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
   7.244 - # make
   7.245 - # make DESTDIR=$PWD/_pkg install
   7.246 - # strip _pkg/usr/bin/*
   7.247 -</pre>
   7.248 -<h4>Install in rootfs</h4>
   7.249 -<p>
   7.250 -SliTaz provides only the GTK+ client on the CD. Note that <code>gftp</code> is just a small 
   7.251 -script that detects the environment (console or X) and launches the right interface:
   7.252 -</p>
   7.253 -<pre> # cp _pkg/usr/bin/gftp $fs/usr/bin
   7.254 - # cp _pkg/usr/bin/gftp-gtk $fs/usr/bin
   7.255 - # cp -a _pkg/usr/share/gftp $fs/usr/share
   7.256 - # cp -a _pkg/usr/share/pixmaps $fs/usr/share
   7.257 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   7.258 -</pre>
   7.259 -<p>
   7.260 -To save a little space and avoid duplication, you can delete 'COPYING' (17 KB) 
   7.261 -included in /usr/share/gftp. The GNU licence is already present in /usr/share/licence, 
   7.262 -if you want to create a symbolic link.
   7.263 -</p>
   7.264 -<a name="xpad"></a>
   7.265 -<h3><font color="#6c0023">xpad-2.12 - Mini note taking application</font></h3>
   7.266 -<p>
   7.267 -The Xpad application can quickly take notes via various customizable (GTK+) windows.
   7.268 -</p>
   7.269 -<p>
   7.270 -Website: <a href="http://xpad.sourceforge.net/">http://xpad.sourceforge.net/</a>
   7.271 -</p>
   7.272 -<pre> # wget http://surfnet.dl.sourceforge.net/sourceforge/xpad/xpad-2.12.tar.bz2
   7.273 - # tar xjf xpad-2.12.tar.bz2
   7.274 - # cd xpad-2.12
   7.275 - # ./configure --prefix=/usr --mandir=/usr/share/man \
   7.276 -   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
   7.277 - # make
   7.278 - # make DESTDIR=$PWD/_pkg install
   7.279 - # strip _pkg/usr/bin/*
   7.280 -</pre>
   7.281 -<h4>Install in rootfs</h4>
   7.282 -<pre> # cp _pkg/usr/bin/xpad $fs/usr/bin
   7.283 - # cp -a _pkg/usr/share/pixmaps $fs/usr/share
   7.284 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   7.285 -</pre>
   7.286 -
   7.287 -
   7.288 -<!-- End of content -->
   7.289 -</div>
   7.290 -
   7.291 -<!-- Footer. -->
   7.292 -<div id="footer">
   7.293 -	<div class="footer-right"></div>
   7.294 -	<a href="gtk-apps.html#top">Top of the page</a> | 
   7.295 -	<a href="index.html">Table of contents</a>
   7.296 -</div>
   7.297 -
   7.298 -<div id="copy">
   7.299 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   7.300 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   7.301 -    Documentation is under
   7.302 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   7.303 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   7.304 -</div>
   7.305 -
   7.306 -</body>
   7.307 -</html>
     8.1 --- a/pt/doc/scratchbook/gtk-libs.html	Wed Mar 31 03:06:23 2010 +0000
     8.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     8.3 @@ -1,251 +0,0 @@
     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="en" lang="en">
     8.7 -<head>
     8.8 -    <title>SliTaz Scratchbook - GTK+ Libraries</title>
     8.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    8.10 -    <meta name="description" content="" />
    8.11 -    <meta name="expires" content="never" />
    8.12 -    <meta name="modified" content="2008-11-22 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 id="quicknav" align="right">
    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 of contents</a> |
    8.26 -	<a href="gtk-apps.html">GTK+ apps</a>
    8.27 -</div>
    8.28 -<h1><font color="#3e1220">SliTaz Scratchbook</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">GTK+ Libraries</font></h2>
    8.37 -<p>
    8.38 -Compilation and installation of GTK+ packages and libraries.
    8.39 -</p>
    8.40 -<ul>
    8.41 -	<li><a href="gtk-libs.html#about">About this chapter.</a> - Description and environmental variable ($fs)</li>
    8.42 -	<li><a href="gtk-libs.html#cairo">cairo-1.2.6</a> - 2D graphics library.</li>
    8.43 -	<li><a href="gtk-libs.html#glib">glib-2.12.4</a> - C routines.</li>
    8.44 -	<li><a href="gtk-libs.html#pango">pango-1.14.8</a> - Library for layout and rendering of text.</li>
    8.45 -	<li><a href="gtk-libs.html#atk">atk-1.12.4</a> - Accessibility toolkit.</li>
    8.46 -	<li><a href="gtk-libs.html#gtk">gtk-2.8.20</a> - The GIMP Toolkit.</li>
    8.47 -	<li><a href="gtk-libs.html#initramfs-iso">Generate the initramfs and an ISO image.</a></li>
    8.48 -</ul>
    8.49 -<a name="about"></a>
    8.50 -<h3><font color="#6c0023">About</font></h3>
    8.51 -<p>
    8.52 -This chapter describes the installation and configuration of GTK libraries 
    8.53 -on SliTaz used by lots of free software. Note that you can simply compile and 
    8.54 -create a SliTaz package that you can install on demand with tazpkg.
    8.55 -</p>
    8.56 -<p>
    8.57 -The compilation of GTK applications can take quite some time and you must meet many dependencies. 
    8.58 -You will find a guide in English: 
    8.59 -<a href="http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html">gtk-building.html</a> on developer.gnome.org. 
    8.60 -This document sets out the need to compile things in order: Glib, Pango, ATK and GTK+, etc. 
    8.61 -Before commencing you must verify that the dependencies are properly installed on your host system. 
    8.62 -Glib, Pango, ATK and GTK+ form a group of packages and are distributed by the team of GTK developers.
    8.63 -</p>
    8.64 -<h4>Environmental variable ($fs)</h4>
    8.65 -<p>
    8.66 -If you do not specify any path to the rootfs directory, export the environmental variable:
    8.67 -</p>
    8.68 -<pre> # export fs=$PWD/rootfs
    8.69 -</pre>
    8.70 -<p>
    8.71 -To check:
    8.72 -</p>
    8.73 -<pre> # echo $fs
    8.74 -</pre>
    8.75 -<a name="cairo"></a>
    8.76 -<h3><font color="#6c0023">cairo-1.2.6 - 2D graphics library</font></h3>
    8.77 -<p>
    8.78 -We begin with libcairo (<a href="http://www.cairographics.org/">http://www.cairographics.org/</a>) 
    8.79 -used to compile pango:
    8.80 -</p>
    8.81 -<pre> # cd src
    8.82 - # wget http://cairographics.org/releases/cairo-1.2.6.tar.gz
    8.83 - # tar xzf cairo-1.2.6.tar.gz
    8.84 - # cd cairo-1.2.6
    8.85 - # ./configure --prefix=/usr --mandir=/usr/share/man \
    8.86 -   --with-html-dir=/usr/share/doc
    8.87 - # make
    8.88 - # make DESTDIR=$PWD/_pkg install
    8.89 - # strip -v _pkg/usr/lib/*.so*
    8.90 -</pre>
    8.91 -<h4>Install in rootfs</h4>
    8.92 -<pre> # cp -av _pkg/usr/lib/*.so* $fs/usr/lib
    8.93 -</pre>
    8.94 -<a name="glib"></a>
    8.95 -<h3><font color="#6c0023">glib-2.12.4 - C routines</font></h3>
    8.96 -<pre> # cd ..
    8.97 - # wget ftp://ftp.gtk.org/pub/glib/2.12/glib-2.12.4.tar.bz2
    8.98 - # tar xjf glib-2.12.4.tar.bz2
    8.99 - # cd glib-2.12.4
   8.100 - # ./configure --prefix=/usr --sysconfdir=/etc \
   8.101 -   --mandir=/usr/share/man --with-html-dir=/usr/share/doc
   8.102 - # make
   8.103 - # make DESTDIR=$PWD/_pkg install
   8.104 - # strip -v _pkg/usr/bin/*
   8.105 - # strip -v _pkg/usr/lib/*.so*
   8.106 -</pre>
   8.107 -<h4>Install in rootfs</h4>
   8.108 -<p>
   8.109 -Option: the utilities glib-genmarshal and gobject-query need the /lib/tls/librt.so.1:
   8.110 -</p>
   8.111 -<pre> # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
   8.112 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   8.113 - 
   8.114 - The binaries and options:
   8.115 - # cp -a _pkg/usr/bin/* $fs/usr/bin
   8.116 -</pre>
   8.117 -<a name="pango"></a>
   8.118 -<h3><font color="#6c0023">pango-1.14.8 - Library for layout and rendering of text</font></h3>
   8.119 -<pre> # cd ..
   8.120 - # wget ftp://ftp.gtk.org/pub/pango/1.14/pango-1.14.8.tar.bz2
   8.121 - # tar xjf pango-1.14.8.tar.bz2
   8.122 - # cd pango-1.14.8
   8.123 - # ./configure --prefix=/usr --sysconfdir=/etc \
   8.124 -   --mandir=/usr/share/man --with-html-dir=/usr/share/doc
   8.125 - # make
   8.126 - # make DESTDIR=$PWD/_pkg install
   8.127 - # strip -v _pkg/usr/bin/*
   8.128 - # strip -v _pkg/usr/lib/*.so*
   8.129 - # strip -v _pkg/usr/lib/pango/1.5.0/modules/*
   8.130 -</pre>
   8.131 -<h4>Install in rootfs</h4>
   8.132 -<pre> # cp -a _pkg/usr/bin/* $fs/usr/bin
   8.133 - # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
   8.134 - # cp -a _pkg/usr/lib/pango $fs/usr/lib
   8.135 - # rm -rf $fs/usr/lib/pango/1.5.0/modules/*.la
   8.136 - # cp -a _pkg/etc $fs
   8.137 -</pre>
   8.138 -<p>
   8.139 -Create /etc/pango.modules via chroot in the rootfs (pango-querymodules uses librt.so.1):
   8.140 -</p>
   8.141 -<pre> # chroot $fs /bin/ash
   8.142 - /# pango-querymodules &gt; /etc/pango/pango.modules
   8.143 - # exit
   8.144 -</pre>
   8.145 -<a name="atk"></a>
   8.146 -<h3><font color="#6c0023">atk-1.12.4 - Accessibility toolkit</font></h3>
   8.147 -<pre> # cd ..
   8.148 - # wget http://ftp.gnome.org/pub/gnome/sources/atk/1.12/atk-1.12.4.tar.bz2
   8.149 - # tar xjf atk-1.12.4.tar.bz2
   8.150 - # cd atk-1.12.4
   8.151 - # ./configure --prefix=/usr --mandir=/usr/share/man \
   8.152 -   --with-html-dir=/usr/share/doc
   8.153 - # make
   8.154 - # make DESTDIR=$PWD/_pkg install
   8.155 - # strip -v _pkg/usr/lib/*.so*
   8.156 -</pre>
   8.157 -<h4>Install in rootfs</h4>
   8.158 -<pre> # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
   8.159 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   8.160 -</pre>
   8.161 -<a name="gtk"></a>
   8.162 -<h3><font color="#6c0023">gtk+-2.8.20 -  The GIMP Toolkit</font></h3>
   8.163 -<pre> # cd ..
   8.164 - # wget ftp://ftp.gtk.org/pub/gtk/v2.8/gtk+-2.8.20.tar.bz2
   8.165 - # tar xjf gtk+-2.8.20.tar.bz2
   8.166 - # cd gtk+-2.8.20
   8.167 - # ./configure --prefix=/usr --sysconfdir=/etc \
   8.168 -   --mandir=/usr/share/man --with-html-dir=/usr/share/doc
   8.169 - # make
   8.170 - # make DESTDIR=$PWD/_pkg install
   8.171 - # strip -v _pkg/usr/bin/*
   8.172 - # strip -v _pkg/usr/lib/*.so*
   8.173 - # strip -v --strip-unneeded \
   8.174 -   _pkg/usr/lib/gtk-2.0/2.4.0/*/*
   8.175 -</pre>
   8.176 -<h4>Install in rootfs</h4>
   8.177 -<pre> # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
   8.178 - # mkdir $fs/usr/lib/gtk-2.0
   8.179 - # cp -a _pkg/usr/lib/gtk-2.0/2.4.0 $fs/usr/lib/gtk-2.0
   8.180 - # rm -rf $fs/usr/lib/gtk-2.0/2.4.0/*/*.la
   8.181 - 
   8.182 - Locale and themes:
   8.183 - # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
   8.184 - # cp -a _pkg/usr/share/themes $fs/usr/share
   8.185 - 
   8.186 - The applications:
   8.187 - # cp  _pkg/usr/bin/gtk-query-immodules-2.0 $fs/usr/bin
   8.188 - # cp  _pkg/usr/bin/gtk-update-icon-cache $fs/usr/bin
   8.189 - # cp  _pkg/usr/bin/gdk-pixbuf-csource $fs/usr/bin
   8.190 - # cp  _pkg/usr/bin/gdk-pixbuf-query-loaders $fs/usr/bin
   8.191 - ...
   8.192 - 
   8.193 - For the gtk-demo application:
   8.194 - # cp -a _pkg/usr/bin/gtk-demo $fs/usr/bin
   8.195 - # cp -a _pkg/usr/share/gtk-2.0 $fs/usr/share
   8.196 -</pre>
   8.197 -<p>
   8.198 -Create files /etc/gtk-2.0/gtk.immodules and gdk-pixbuf.loaders via a chroot in the rootfs:
   8.199 -</p>
   8.200 -<pre> # chroot $fs /bin/ash
   8.201 - /# mkdir /etc/gtk-2.0
   8.202 - /# gtk-query-immodules-2.0 &gt; /etc/gtk-2.0/gtk.immodules
   8.203 - /# gdk-pixbuf-query-loaders &gt; /etc/gtk-2.0/gdk-pixbuf.loaders
   8.204 - # exit
   8.205 -</pre>
   8.206 -<p>
   8.207 -At this stage you can test GTK+ with the 'gtk-demo' application by creating an ISO and using qemu. 
   8.208 -You can also compile a small GTK application such as LeafPad and test! The compiliation and installation 
   8.209 -of GTK+ applications distributed by default with SliTaz are described in the next chapter
   8.210 -<a href="http://www.slitaz.org/doc/scratchbook/gtk-apps.html">GTK apps</a>.
   8.211 -</p>
   8.212 -<a name="initramfs-iso"></a>
   8.213 -<h3><font color="#6c0023">Generate the initramfs and an ISO image</font></h3>
   8.214 -<p>
   8.215 -To create a new ISO image, you can use 'mktaziso' in 
   8.216 -<a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a> .  
   8.217 -Or you can create a new initramfs image, copy it to /boot in the root of the cdrom
   8.218 -(rootcd) and finally generate an ISO image with genisoimage:
   8.219 -</p>
   8.220 -<pre> # cd $fs
   8.221 - # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
   8.222 - # cd ..
   8.223 - # cp rootfs.gz rootcd/boot
   8.224 - # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
   8.225 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
   8.226 -   -V "SliTaz" -boot-info-table rootcd 
   8.227 -</pre>
   8.228 -<h4>Following chapter</h4>
   8.229 -<p>
   8.230 -After the libraries, the
   8.231 -<a href="gtk-apps.html">GTK+ applications</a>.
   8.232 -</p>
   8.233 -
   8.234 -
   8.235 -<!-- End of content -->
   8.236 -</div>
   8.237 -
   8.238 -<!-- Footer. -->
   8.239 -<div id="footer">
   8.240 -	<div class="footer-right"></div>
   8.241 -	<a href="gtk-libs.html#top">Top of the page</a> | 
   8.242 -	<a href="index.html">Table of contents</a>
   8.243 -</div>
   8.244 -
   8.245 -<div id="copy">
   8.246 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   8.247 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   8.248 -    Documentation is under
   8.249 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   8.250 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   8.251 -</div>
   8.252 -
   8.253 -</body>
   8.254 -</html>
     9.1 Binary file pt/doc/scratchbook/images/css/content-tl.png has changed
    10.1 Binary file pt/doc/scratchbook/images/css/content-tr.png has changed
    11.1 Binary file pt/doc/scratchbook/images/css/footer-bl.png has changed
    12.1 Binary file pt/doc/scratchbook/images/css/footer-br.png has changed
    13.1 Binary file pt/doc/scratchbook/images/css/header.png has changed
    14.1 --- a/pt/doc/scratchbook/index.html	Wed Mar 31 03:06:23 2010 +0000
    14.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    14.3 @@ -1,165 +0,0 @@
    14.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    14.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    14.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    14.7 -<head>
    14.8 -    <title>SliTaz Scratchbook</title>
    14.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   14.10 -    <meta name="description" content="" />
   14.11 -    <meta name="expires" content="never" />
   14.12 -    <meta name="modified" content="2008-11-22 17:00:00" />
   14.13 -    <meta name="publisher" content="www.slitaz.org" />
   14.14 -    <meta name="author" content="Christophe Lincoln"/>
   14.15 -    <link rel="shortcut icon" href="favicon.ico" />
   14.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   14.17 -</head>
   14.18 -<body bgcolor="#ffffff">
   14.19 -
   14.20 -<!-- Header and quick navigation -->
   14.21 -<div id="header">
   14.22 -<div align="right" id="quicknav">
   14.23 -    <a name="top"></a>
   14.24 -    <a href="../index.html">SliTaz doc</a>
   14.25 -</div>
   14.26 -<h1><font color="#3E1220">SliTaz Scratchbook</font></h1>
   14.27 -</div>
   14.28 -
   14.29 -<!-- Content. -->
   14.30 -<div id="content">
   14.31 -<div class="content-right"></div>
   14.32 -
   14.33 -
   14.34 -<h2><font color="#df8f06">Scratchbook</font></h2>
   14.35 -<p>
   14.36 -Index of documents, step by step construction of a mini GNU/LINUX
   14.37 -LiveCD and installation instructions.
   14.38 -</p>
   14.39 -<h3><font color="#6c0023">Table of contents</font></h3>
   14.40 -<h4>LiveCD</h4>
   14.41 -<ul>
   14.42 -	<li><a href="index.html#intro">Introduction.</a></li>
   14.43 -	<li><a href="index.html#org">Organize a working directory.</a></li>
   14.44 -	<li><a href="base-system.html">Construction of the base SliTaz system.</a></li>
   14.45 -	<li><a href="base-apps.html">Base applications.</a></li>
   14.46 -	<li><a href="base-ncurses.html">Ncurses libraries and applications.</a></li>
   14.47 -	<li><a href="locale.html">Install and configure Locale &amp; i18n.</a></li>
   14.48 -	<li><a href="boot-scripts.html">Boot scripts.</a></li>
   14.49 -	<li><a href="x-window-system.html">X window system.</a></li>
   14.50 -	<li><a href="gtk-libs.html">GTK+ packages and libraries.</a></li>
   14.51 -	<li><a href="gtk-apps.html">GTK+ applications.</a></li>
   14.52 -	<li><a href="xorg.html">Xorg.</a></li>
   14.53 -</ul>
   14.54 -
   14.55 -<a name="intro"></a>
   14.56 -<h3><font color="#6c0023">Introduction</font></h3>
   14.57 -<p>
   14.58 -The scratchbook allows you to track the creation of the first public 
   14.59 -release of SliTaz and make a trip to the heart of GNU/LINUX. You'll
   14.60 -be able to customize your new system or create your own autonomous
   14.61 -distro running in system memory (RAM) that's fully installable on
   14.62 -a hard drive or USB key. Once started you'll be able to remove the
   14.63 -CD-ROM and still have SliTaz working. SliTaz can also be used as an
   14.64 -environment in which we can chroot or use the cdrom for multitasking. 
   14.65 -The only prerequisite is a host distribution in which you can store
   14.66 -libraries, use a compiler and development tools, etc. The host
   14.67 -system can be a chrooted development environment, a minimal
   14.68 -distro, SliTaz installed on a hard drive or a 'general' distro such
   14.69 -as Debian, Slackware, Fedora, Gentoo, Mandriva, Arch, etc. Note
   14.70 -that nothing is installed in the host system by our commands.
   14.71 -</p>
   14.72 -<p>
   14.73 -SliTaz uses the 'Swiss Army Knife' BusyBox as the basis of the system and 
   14.74 -the Linux Kernel, it runs embedded using a small memory footprint and 
   14.75 -provides many files. BusyBox is our main source of information 
   14.76 -and it's a utility of the Debian project which we use and cherish.
   14.77 -</p>
   14.78 -<p>
   14.79 -SliTaz uses the Syslinux bootloader and an archived initramfs 
   14.80 -compressed with cpio. This archive is then decompressed in memory
   14.81 -at boot by the kernel into a system of no fixed size, retaining
   14.82 -control over init. At the time of compilation or copying of 
   14.83 -applications, we use strip to clean the repositoiries. The system commands
   14.84 -genisoimage or mkisofs are used to create the iso images. To
   14.85 -finish, you can test the iso image with Qemu or engrave the 
   14.86 -generated iso on to a rewritable cdrom.
   14.87 -</p>
   14.88 -<a name="org"></a>
   14.89 -<h3><font color="#6c0023">Organize a working directory</font></h3>
   14.90 -<p>
   14.91 -To create SliTaz, we need a working directory and several subdirectories
   14.92 -Whether you have a chrooted environment for developing or a host
   14.93 -system, we advise to use a directory named distro/ in which to 
   14.94 -work. The distro/ directory can be a simple folder or a partition,
   14.95 -but you are obviously free to put all of this elsewhere.
   14.96 -</p>
   14.97 -<h4>distro/</h4>
   14.98 -<p>Contents of a working directory:
   14.99 -</p>
  14.100 -<ul>
  14.101 -	<li>rootfs/ --&gt; The root filesystem - this is the root system, designed 
  14.102 -	to operate in RAM, it is used to generate the initramfs image.</li>
  14.103 -	<li>rootfs.gz --&gt; The initramfs image of our system - a cpio 
  14.104 -	archive compressed with gzip.</li>
  14.105 -	<li>rootcd/ --&gt; The rootcd. This is the root of the cdrom files.</li>
  14.106 -	<li>src/ --&gt; The sources, Kernel, Syslinux, Busybox, Dropbear,
  14.107 -	etc (it can also be a symbolic link).</li>
  14.108 -</ul>
  14.109 -<p>
  14.110 -Thereafter, the initramfs and bootable ISO image (slitaz-cooking.iso)
  14.111 -will be created in the root directory of our work named SliTaz/.
  14.112 -</p>
  14.113 -<h4>Option: rootfs.ext2 - using a virtual hard drive</h4>
  14.114 -<p>
  14.115 -Option: rootfs.ext2 (root filesystem in ext2) is a virtual hard disk
  14.116 -formatted with ext2 and mounted on a (rootfs) loop. A device loop allows
  14.117 -a file to be used as a standard device (hard drive, floppy, etc) to build
  14.118 -a filesystem inside. This file can be any number of megabytes, we propose
  14.119 -20,480, which corresponds to 20MB:
  14.120 -</p>
  14.121 -<pre> # dd if=/dev/zero of=rootfs.ext2 bs=1k count=20480
  14.122 -</pre>
  14.123 -<p>
  14.124 -Create a ext2 filesystem named rootfs.ext2, the option -F formats the
  14.125 -file. Note that the -m 0 option doesn't allocate any space for the user
  14.126 -root - by default it occupies approximately 5% and the -t option defines
  14.127 -the type of filesystem to be used, such as ext2 or ext3:
  14.128 -</p>
  14.129 -<pre> # mkfs -t ext2 -F -m 0 rootfs.ext2
  14.130 -</pre>
  14.131 -<p>
  14.132 -We can now assemble rootfs.ext2 with a loop, thanks to the -o loop option
  14.133 -provided by the mount utility in the rootfs/ directory. You can check if 
  14.134 -the assembly went well with the <code>df-h</code> command:
  14.135 -</p>
  14.136 -<pre> # mkdir rootfs
  14.137 - # mount -o loop rootfs.ext2 rootfs
  14.138 - # df -h
  14.139 -</pre>
  14.140 -<p>
  14.141 -At the end of the session, you can dismount the volume with umount:
  14.142 -</p>
  14.143 -<pre> # umount rootfs
  14.144 -</pre>
  14.145 -<p>
  14.146 -Now we can proceed to the construction of the <a href="base-system.html">base SliTaz system</a>.
  14.147 -</p>
  14.148 -
  14.149 -<!-- End of content -->
  14.150 -</div>
  14.151 -
  14.152 -<!-- Footer. -->
  14.153 -<div id="footer">
  14.154 -	<div class="footer-right"></div>
  14.155 -	<a href="index.html#top">Top of the page</a> | 
  14.156 -	<a href="index.html">Table of contents</a>
  14.157 -</div>
  14.158 -
  14.159 -<div id="copy">
  14.160 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
  14.161 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  14.162 -    Documentation is under
  14.163 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  14.164 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
  14.165 -</div>
  14.166 -
  14.167 -</body>
  14.168 -</html>
    15.1 --- a/pt/doc/scratchbook/locale.html	Wed Mar 31 03:06:23 2010 +0000
    15.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    15.3 @@ -1,162 +0,0 @@
    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="en" lang="en">
    15.7 -<head>
    15.8 -    <title>SliTaz Scratchbook - Locale &amp; i18n</title>
    15.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   15.10 -    <meta name="description" content="" />
   15.11 -    <meta name="expires" content="never" />
   15.12 -    <meta name="modified" content="2008-11-22 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="base-ncurses.html">Base ncurses</a> |
   15.25 -    <a href="index.html">Table of contents</a> |
   15.26 -    <a href="boot-scripts.html">Boot scripts</a>
   15.27 -</div>
   15.28 -<h1><font color="#3E1220">SliTaz Scratchbook</font></h1>
   15.29 -</div>
   15.30 -
   15.31 -<!-- Content. -->
   15.32 -<div id="content">
   15.33 -<div class="content-right"></div>
   15.34 -
   15.35 -
   15.36 -<h2><font color="#df8f06">Locale &amp; i18n</font></h2>
   15.37 -<p>
   15.38 -Installation and configuration of locales.
   15.39 -</p>
   15.40 -<ul>
   15.41 -	<li><a href="locale.html#install">Locale installation.</a></li>
   15.42 -	<li><a href="locale.html#config">Config and use of locale on SliTaz.</a></li>
   15.43 -</ul>
   15.44 -<a name="install"></a>
   15.45 -<h3><font color="#6c0023">Locale installation</font></h3>
   15.46 -<p>
   15.47 -This chapter describes the installation of locales in SliTaz GNU/Linux from a SliTaz GNU/Linux host system. 
   15.48 -The installation of locales contained in the X server are described in the chapter 
   15.49 -<a href="x-window-system.html">X window system</a>. The various files copied in this chapter come from the 
   15.50 -compiliation package glibc-2.3.6 forming part of the <em>toolchain</em>.
   15.51 -</p>
   15.52 -<h4>Various file directories</h4>
   15.53 -<p>
   15.54 -We begin by creating the directories that contain libraries and files relevant to the different locales. 
   15.55 -The directory LC_MESSAGES contains the files for the translated messages (.mo), if they exist:
   15.56 -</p>
   15.57 -<pre> # mkdir -p rootfs/usr/share/{i18n,locale}
   15.58 - # mkdir -p rootfs/usr/lib/{locale,gconv}
   15.59 - # mkdir -p rootfs/usr/share/i18n/{charmaps,locales}
   15.60 - # mkdir -p rootfs/usr/share/locale/fr/LC_MESSAGES
   15.61 -</pre>
   15.62 -<p>
   15.63 -Copy the localization files for French, Swiss-French and Swiss-German in /usr/share/i18n/locales:
   15.64 -</p>
   15.65 -<pre> # cp -a /usr/share/i18n/locales/{de_CH,fr_CH,fr_FR,i18n,iso14651_t1} \
   15.66 -   rootfs/usr/share/i18n/locales
   15.67 -</pre>
   15.68 -<p>   
   15.69 -Copy the translit_* files in /usr/share/i18n/locales:
   15.70 -</p>
   15.71 -<pre> # cp -a /usr/share/i18n/locales/{translit_circle,translit_cjk_compat} \
   15.72 -   rootfs/usr/share/i18n/locales
   15.73 - # cp -a /usr/share/i18n/locales/{translit_combining,translit_compat} \
   15.74 -   rootfs/usr/share/i18n/locales   
   15.75 - # cp -a /usr/share/i18n/locales/{translit_font,translit_fraction} \
   15.76 -   rootfs/usr/share/i18n/locales
   15.77 - # cp -a /usr/share/i18n/locales/{translit_narrow,translit_neutral} \
   15.78 -   rootfs/usr/share/i18n/locales
   15.79 - # cp -a /usr/share/i18n/locales/{translit_small,translit_wide} \
   15.80 -   rootfs/usr/share/i18n/locales
   15.81 -</pre>
   15.82 -<p>
   15.83 -Copy the charmaps files in /usr/share/i18n/charmaps:
   15.84 -</p>
   15.85 -<pre> # cp -a /usr/share/i18n/charmaps/ANSI_X3.* rootfs/usr/share/i18n/charmaps
   15.86 - # cp -a /usr/share/i18n/charmaps/{ISO-8859-1.gz,ISO-8859-2.gz,ISO-8859-15.gz} \
   15.87 -   rootfs/usr/share/i18n/charmaps
   15.88 -</pre>
   15.89 -<p>
   15.90 -Copy the gconv libraries in /usr/lib/gconv to rootfs of SliTaz:
   15.91 -</p>
   15.92 -<pre> # cp /usr/lib/gconv/{ANSI_X3.110.so,gconv-modules,UNICODE.so} \
   15.93 -   rootfs/usr/lib/gconv
   15.94 - # cp /usr/lib/gconv/{ISO8859-1.so,ISO8859-2.so,ISO8859-15.so} \
   15.95 -   rootfs/usr/lib/gconv
   15.96 - # strip -v rootfs/usr/lib/gconv/*.so
   15.97 -</pre>
   15.98 -<p>
   15.99 -Copy the locale utility:
  15.100 -</p>
  15.101 -<pre> # cp /usr/bin/locale rootfs/usr/bin
  15.102 -</pre>
  15.103 -<p>
  15.104 -It's necessary that the file /usr/lib/locale/locale-archive is generated, 
  15.105 -for that we use the localedef utility while chrooted in SliTaz:
  15.106 -</p>
  15.107 -<pre> # cp /usr/bin/localedef rootfs/usr/bin
  15.108 - # chroot rootfs /bin/ash
  15.109 -</pre>
  15.110 -<p>
  15.111 -Use of <code>localedef</code> for French-speaking Switzerland and France:
  15.112 -</p>
  15.113 -<pre> /# localedef -i fr_CH -f ISO-8859-1 fr_CH
  15.114 - /# localedef -i fr_FR -f ISO-8859-1 fr_FR
  15.115 - /# exit
  15.116 -</pre>
  15.117 -<p>
  15.118 -You can delete the <code>localedef</code> binary to gain some space:
  15.119 -</p>
  15.120 -<pre> # rm rootfs/usr/bin/localedef
  15.121 -</pre>
  15.122 -<a name="config"></a>
  15.123 -<h3><font color="#6c0023">Config and use of locale</font></h3>
  15.124 -<p>
  15.125 -To use a language in a session, you can create a script launched at boot, or 
  15.126 -add 2 lines to the ~/.profile specific to each user with:
  15.127 -</p>
  15.128 -<pre class="script">
  15.129 -export LANG=fr_CH
  15.130 -export LC_ALL=fr_CH
  15.131 -
  15.132 -</pre>
  15.133 -<p>
  15.134 -Voil&agrave;, the French language should now function If you installed retawq or nano, you can check the 
  15.135 -performance of locales by copying the .mo files in the sources of Retawq or Nano to /usr/share/locale/fr/LC_MESSAGES.
  15.136 -</p>
  15.137 -<h4>Following chapter</h4>
  15.138 -<p>
  15.139 -SliTaz uses the /etc/init.d/i18n.sh script and the /etc/locale.conf configuration file to 
  15.140 -manage the system locale. This is detailed in the next chapter <a href="boot-scripts.html">Boot scripts</a>. 
  15.141 -On a working system, just modify /etc/locale.conf with a text editor or launch 'tazlocale' 
  15.142 -to change the default system locale Or to specify the language as a boot option: <code>lang=xx</code>.
  15.143 -</p>
  15.144 -
  15.145 -
  15.146 -<!-- End of content -->
  15.147 -</div>
  15.148 -
  15.149 -<!-- Footer. -->
  15.150 -<div id="footer">
  15.151 -	<div class="footer-right"></div>
  15.152 -	<a href="locale.html#top">Top of the page</a> | 
  15.153 -	<a href="index.html">Table of contents</a>
  15.154 -</div>
  15.155 -
  15.156 -<div id="copy">
  15.157 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
  15.158 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  15.159 -    Documentation is under
  15.160 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  15.161 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
  15.162 -</div>
  15.163 -
  15.164 -</body>
  15.165 -</html>
    16.1 --- a/pt/doc/scratchbook/template.html	Wed Mar 31 03:06:23 2010 +0000
    16.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    16.3 @@ -1,55 +0,0 @@
    16.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    16.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    16.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    16.7 -<head>
    16.8 -    <title>SliTaz Scratchbook - Template</title>
    16.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   16.10 -    <meta name="description" content="" />
   16.11 -    <meta name="expires" content="never" />
   16.12 -    <meta name="modified" content="2008-11-22 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="http://www.slitaz.org/en/">www.slitaz.org/en</a>
   16.25 -</div>
   16.26 -<h1><font color="#3E1220">SliTaz Scratchbook</font></h1>
   16.27 -</div>
   16.28 -
   16.29 -<!-- Content. -->
   16.30 -<div id="content">
   16.31 -<div class="content-right"></div>
   16.32 -
   16.33 -
   16.34 -<p>
   16.35 -CONTENT
   16.36 -</p>
   16.37 -
   16.38 -
   16.39 -<!-- End of content -->
   16.40 -</div>
   16.41 -
   16.42 -<!-- Footer. -->
   16.43 -<div id="footer">
   16.44 -	<div class="footer-right"></div>
   16.45 -	<a href="template.html#top">Top of the page</a> | 
   16.46 -	<a href="index.html">Table of contents</a>
   16.47 -</div>
   16.48 -
   16.49 -<div id="copy">
   16.50 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   16.51 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   16.52 -    Documentation is under
   16.53 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   16.54 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   16.55 -</div>
   16.56 -
   16.57 -</body>
   16.58 -</html>
    17.1 --- a/pt/doc/scratchbook/x-window-system.html	Wed Mar 31 03:06:23 2010 +0000
    17.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    17.3 @@ -1,470 +0,0 @@
    17.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    17.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    17.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    17.7 -<head>
    17.8 -    <title>SliTaz Scratchbook - X Window System</title>
    17.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   17.10 -    <meta name="description" content="" />
   17.11 -    <meta name="expires" content="never" />
   17.12 -    <meta name="modified" content="2008-11-22 17:00:00" />
   17.13 -    <meta name="publisher" content="www.slitaz.org" />
   17.14 -    <meta name="author" content="Christophe Lincoln"/>
   17.15 -    <link rel="shortcut icon" href="favicon.ico" />
   17.16 -    <link rel="stylesheet" type="text/css" href="book.css" />
   17.17 -</head>
   17.18 -<body bgcolor="#ffffff">
   17.19 -
   17.20 -<!-- Header and quick navigation -->
   17.21 -<div id="header">
   17.22 -<div id="quicknav" align="right">
   17.23 -	<a name="top"></a>
   17.24 -	<a href="boot-scripts.html">Boot scripts</a> |
   17.25 -	<a href="index.html">Table of contents</a> |
   17.26 -	<a href="gtk-libs.html">GTK+ libs</a>
   17.27 -</div>
   17.28 -<h1><font color="#3e1220">SliTaz Scratchbook</font></h1>
   17.29 -</div>
   17.30 -
   17.31 -<!-- Content. -->
   17.32 -<div id="content">
   17.33 -<div class="content-right"></div>
   17.34 -
   17.35 -
   17.36 -<h2><font color="#df8f06">X window system</font></h2>
   17.37 -<p>
   17.38 -Installation and basic configuration of the X window system.
   17.39 -</p>
   17.40 -<ul>
   17.41 -    <li><a href="x-window-systel.html#about">About this chapter</a> - Description and environmental
   17.42 -    variable ($fs)</li>
   17.43 -    <li><a href="x-window-systel.html#expat">expat-2.0.0</a> - XML parser library.</li>
   17.44 -    <li><a href="x-window-systel.html#freetype">freetype-2.3.1</a> - System font libraries.</li>
   17.45 -    <li><a href="x-window-systel.html#fontconfig">fontconfig 2.4.2</a> - Font management tools.</li>
   17.46 -    <li><a href="x-window-systel.html#xserver">Xserver</a> - Graphical server Xvesa of Xfree86
   17.47 -    4.6.0 and Xorg libraries.</li>
   17.48 -    <li><a href="x-window-systel.html#xterm">xterm-223</a> - Terminal emulator.</li>
   17.49 -    <li><a href="x-window-systel.html#libpng">libpng-1.2.18</a> - Libraries that manipulate PNG images.</li>
   17.50 -    <li><a href="x-window-systel.html#jwm">jwm-2.0</a> - Window manager.</li>
   17.51 -    <li><a href="x-window-systel.html#jpeg">jpeg-6b</a> - Libraries that manipulate JPEG images.</li>
   17.52 -    <li><a href="x-window-systel.html#tiff">tiff-3.8.2</a> - TIFF libraries and utilities.</li>
   17.53 -    <li><a href="x-window-systel.html#links">links-2.1pre29</a> - Graphical and text web browser.</li>
   17.54 -    <li><a href="x-window-systel.html#initramfs-iso">Generate the initramfs and an ISO image.</a></li>
   17.55 -</ul>
   17.56 -<a name="about"></a>
   17.57 -<h3><font color="#6c0023">About</font></h3>
   17.58 -<p>
   17.59 -This chapter describes the installation and configuration of the X window system on SliTaz. We will 
   17.60 -install libraries for expat, XML, fonts, a graphical server (Xvesa), a terminal emulator (xterm), 
   17.61 -various small tools and a window manager (JWM). We'll also install the JPEG libraries and Links web browser.
   17.62 -</p>
   17.63 -<h4>Environmental variable ($fs)</h4>
   17.64 -<p>
   17.65 -If you do not specify any path to the rootfs directory, export the environmental variable:
   17.66 -</p>
   17.67 -<pre> # export fs=$PWD/rootfs
   17.68 -</pre>
   17.69 -<p>
   17.70 -To check:
   17.71 -</p>
   17.72 -<pre> # echo $fs
   17.73 -</pre>
   17.74 -<a name="expat"></a>
   17.75 -<h3><font color="#6c0023">expat-2.0.0 - XML parser library</font></h3>
   17.76 -<p>
   17.77 -Expat (<a href="http://expat.sourceforge.net/">http://expat.sourceforge.net/</a>)
   17.78 -contains the XML parsing libraries:
   17.79 -</p>
   17.80 -<pre> # cd ..
   17.81 - # wget http://switch.dl.sourceforge.net/sourceforge/expat/expat-2.0.0.tar.gz
   17.82 - # tar xzf expat-2.0.0.tar.gz
   17.83 - # cd expat-2.0.0
   17.84 - # ./configure --sysconfdir=/etc --prefix=/usr \
   17.85 -   --mandir=/usr/share/man
   17.86 - # make
   17.87 - # make DESTDIR=$PWD/_pkg install
   17.88 - # strip -v _pkg/usr/lib/*
   17.89 - # strip -v _pkg/usr/bin/*
   17.90 -</pre>
   17.91 -<p>
   17.92 -Thereafter, we will install 'xterm' which needs libexpat.so.0, simply create a symbolic link and voil&agrave;. 
   17.93 -Then you can install the 'xmlwf' application and libraries in the rootfs:
   17.94 -</p>
   17.95 -<pre> # cd _pkg/usr/lib
   17.96 - # ln -s libexpat.so.1.5.0 libexpat.so.0
   17.97 - # cp -a *.so* $fs/usr/lib
   17.98 - # cd ..
   17.99 - # cp -a bin/* $fs/usr/bin
  17.100 - # cd ../..
  17.101 -</pre>
  17.102 -<h4>libs</h4>
  17.103 -Libraries used by xmlwf:
  17.104 -<pre class="script">        libexpat.so.1 =&gt; /usr/lib/libexpat.so.1 (0x40021000)
  17.105 -        libc.so.6 =&gt; /lib/tls/libc.so.6 (0x40041000)
  17.106 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0x40000000)
  17.107 -</pre>
  17.108 -<a name="freetype"></a>
  17.109 -<h3><font color="#6c0023">freetype-2.3.1 - System font libraries</font></h3>
  17.110 -<p>
  17.111 -The package freetype (<a href="http://www.freetype.org/">http://www.freetype.org/</a>) 
  17.112 -contains libraries used by X for configuring the system fonts:
  17.113 -</p>
  17.114 -<pre> # cd ..
  17.115 - # wget http://download.savannah.gnu.org/releases/freetype/freetype-2.3.1.tar.bz2
  17.116 - # tar xjf freetype-2.3.1.tar.bz2
  17.117 - # cd freetype-2.3.1
  17.118 - # ./configure --sysconfdir=/etc --prefix=/usr \
  17.119 -   --mandir=/usr/share/man
  17.120 - # make
  17.121 - # make DESTDIR=$PWD/_pkg install
  17.122 - # strip -vs _pkg/usr/lib/*
  17.123 - # cp -a _pkg/usr/bin/* $fs/usr/bin
  17.124 - # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
  17.125 -</pre>
  17.126 -<a name="fontconfig"></a>
  17.127 -<h3><font color="#6c0023">fontconfig-2.4.2 - Manage system fonts</font></h3>
  17.128 -<p>
  17.129 -The fontconfig package (<a href="http://www.fontconfig.org/wiki/">www.fontconfig.org/wiki/</a>) 
  17.130 -provides the libfontconfig library used by many programs under X. Note XFree86 also provides these 
  17.131 -utilities. We chose the original package because it works better with JWM:
  17.132 -</p>
  17.133 -<pre> # cd ..
  17.134 - # wget http://fontconfig.org/release/fontconfig-2.4.2.tar.gz
  17.135 - # tar xzf fontconfig-2.4.2.tar.gz
  17.136 - # cd fontconfig-2.4.2
  17.137 - # ./configure --sysconfdir=/etc --prefix=/usr \
  17.138 -   --mandir=/usr/share/man --localstatedir=/var
  17.139 - # make
  17.140 - # make DESTDIR=$PWD/_pkg install
  17.141 - # strip -v _pkg/usr/bin/*
  17.142 - # strip -v _pkg/usr/lib/*
  17.143 - # cp -a _pkg/usr/bin/* $fs/usr/bin
  17.144 - # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
  17.145 - # cp -a _pkg/etc $fs
  17.146 - # cp -a _pkg/var $fs
  17.147 -</pre>
  17.148 -<h4>libs</h4>
  17.149 -<p>
  17.150 -A 'ldd' on fc-cache gives the libraries below. You can also use libfreetype of XFree86:
  17.151 -</p>
  17.152 -<pre class="script">        libfreetype.so.6 =&gt; /usr/lib/libfreetype.so.6 (0xb7f12000)
  17.153 -        libz.so.1 =&gt; /usr/lib/libz.so.1 (0xb7eff000)
  17.154 -        libexpat.so.1 =&gt; /usr/lib/libexpat.so.1 (0xb7edf000)
  17.155 -        libfontconfig.so.1 =&gt; /usr/lib/libfontconfig.so.1 (0xb7eb0000)
  17.156 -        libc.so.6 =&gt; /lib/tls/libc.so.6 (0xb7d7b000)
  17.157 -        /lib/ld-linux.so.2 =&gt; /lib/ld-linux.so.2 (0xb7f8c000)
  17.158 -</pre>
  17.159 -<a name="xserver"></a>
  17.160 -<h3><font color="#6c0023">Xserver - Graphical Xvesa server of Xfree86</font></h3>
  17.161 -<p>
  17.162 -We will use the binary versions of Xvesa server (<a href="http://www.xfree86.org/">www.xfree86.org/</a>) 
  17.163 -and fonts distributed by Xfree86.org. We could also copy Xorg libraries from the host system that would 
  17.164 -be used for compiling X applications. Xvesa works well like this and simplifies things. You can also rebuild
  17.165 -<a href="xorg.html">Xorg packages</a> on your development system.
  17.166 -</p>
  17.167 -<h4>Xtinyx server - Xvesa</h4>
  17.168 -<p>
  17.169 -The Xvesa server is very light and uses tiny libraries; it is contained in the Xtinyx.tgz archive. 
  17.170 -Download and install in /usr/bin of SliTaz rootfs:
  17.171 -</p>
  17.172 -<pre> # cd ..
  17.173 - # mkdir -p XFree86-4.6.0 &amp;&amp; cd XFree86-4.6.0
  17.174 - # wget http://ftp.xfree86.org/pub/XFree86/4.6.0/binaries/Linux-ix86-glibc23/Xtinyx.tgz
  17.175 - # tar xzf Xtinyx.tgz
  17.176 - # cp bin/Xvesa $fs/usr/bin
  17.177 - # strip $fs/usr/bin/Xvesa
  17.178 - # chmod 4711 $fs/usr/bin/Xvesa
  17.179 -</pre>
  17.180 -<h4>libs for Xvesa</h4>
  17.181 -<pre class="script">        libz.so.1 =&gt; /usr/lib/libz.so.1 (0xb7ed6000)
  17.182 -        libm.so.6 =&gt; /lib/tls/libm.so.6 (0xb7eb1000)
  17.183 -        libc.so.6 =&gt; /lib/tls/libc.so.6 (0xb7d7e000)
  17.184 -        /lib/ld-linux.so.2 (0xb7ef8000)
  17.185 -</pre>
  17.186 -<h4>rgb.txt - RGB colors in X</h4>
  17.187 -<p>
  17.188 -The colors configuration file used by the X server is called: <code>rgb.txt</code>; we suggest 
  17.189 -that you copy it to the host system. The library libX11.so will seek the configuration files in 
  17.190 -/usr/share/X11, and the Xvesa server in /usr/X11R6/lib/X11; we create a link in /usr/share/X11 to enable this:
  17.191 -</p>
  17.192 -<pre> # mkdir -p $fs/usr/share/X11
  17.193 - # cp /usr/share/X11/rgb.txt $fs/usr/share/X11
  17.194 - # chroot $fs /bin/ash
  17.195 - /# mkdir -p /usr/X11R6/lib/X11/
  17.196 - /# ln -s /usr/share/X11/rgb.txt /usr/X11R6/lib/X11/rgb.txt
  17.197 - /# exit
  17.198 -</pre>
  17.199 -<h4>Xfnts - Fonts</h4>
  17.200 -<p>
  17.201 -To operate the server, we need the basic fonts; you can download them from Xfree86.org and then compile 
  17.202 -packages from Xorg, or copy them from your host system. The system fonts can be put into different folders 
  17.203 -and the cache updated with <code>lc-cache</code>. Attention, fonts take pride of place and you can only install 
  17.204 -the minimum. /usr/share/fonts contains the TrueType fonts such as bitstream-vera:
  17.205 -</p>
  17.206 -<pre> # wget http://ftp.xfree86.org/pub/XFree86/4.6.0/binaries/Linux-ix86-glibc23/Xfnts.tgz
  17.207 - # tar xzf Xfnts.tgz
  17.208 - # mkdir -p $fs/usr/X11R6/lib/X11/fonts
  17.209 - # mkdir -p $fs/usr/share/fonts/truetype
  17.210 -
  17.211 - Copy the fonts...
  17.212 - (# cp -a lib/X11/fonts/* $fs/usr/X11R6/lib/X11/fonts)
  17.213 - (# cp -a /usr/share/fonts/truetype/* $fs/usr/share/fonts/truetype
  17.214 -</pre>
  17.215 -<p>
  17.216 -Then regenerate the fonts.dir file, you must run mkfontdir on the directory in question:
  17.217 -</p>
  17.218 -<pre> # mkfontdir $fs/usr/X11R6/lib/X11/fonts/75dpi
  17.219 -</pre>
  17.220 -<p>
  17.221 -Fontconfig configuration files can be found in /etc/fonts provided by the fontconfig package. 
  17.222 -Now you can run 'fc-cache' to update the cache, and 'fc-list' for a list of fonts. You do this 
  17.223 -by chrooting into the rootfs:
  17.224 -</p>
  17.225 -<pre> # chroot $fs /bin/ash
  17.226 - # fc-cache -v
  17.227 - # fc-list
  17.228 - # exit
  17.229 -</pre>
  17.230 -<h4>Xlib locale - Localization files</h4>
  17.231 -<p>
  17.232 -On SliTaz, we installed 4 locales: C, iso8859-1, iso8859-15 and iso 8859-2 from the 
  17.233 -<a href="xorg.html">compilation of Xorg</a>. 
  17.234 -You can copy the files from the host system or use the files distributed by XFree86. 
  17.235 -Sample copy of all the locales from the host system:
  17.236 -</p>
  17.237 -<pre> # mkdir -p $fs/usr/share/X11/locale
  17.238 - # cp -a /usr/share/X11/locale/* $fs/usr/share/X11/locale
  17.239 -</pre>
  17.240 -<h4>Using X</h4>
  17.241 -<p>
  17.242 -Note that you can already use Xvesa as a X terminal if you have a machine on the network accepting XDMCP connections. 
  17.243 -For this, you can start the server with the <code>-query</code> option. For example:
  17.244 -</p>
  17.245 -<pre> # Xvesa -ac -shadow -screen 1024x768x24 -query 192.168.0.2
  17.246 -</pre>
  17.247 -<a name="xterm"></a>
  17.248 -<h3><font color="#6c0023">xterm - Terminal Emulator</font></h3>
  17.249 -<p>
  17.250 -The xterm package (<a href="http://invisible-island.net/xterm/">invisible-island.net/xterm/</a>) 
  17.251 -provides a terminal emulator for X:
  17.252 -</p>
  17.253 -<pre> # wget ftp://invisible-island.net/xterm/xterm-223.tgz
  17.254 - # tar xzf xterm-223.tgz
  17.255 - # cd xterm-223
  17.256 - # ./configure --prefix=/usr --sysconfdir=/etc \
  17.257 -   --mandir=/usr/share/man --localstatedir=/var \
  17.258 -   --with-app-defaults=/usr/share/X11/app-defaults \
  17.259 -   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
  17.260 - # make
  17.261 - # make DESTDIR=$PWD/_pkg install
  17.262 - # strip _pkg/usr/bin/*
  17.263 - # cp _pkg/usr/bin/* $fs/usr/bin
  17.264 - # cp -a _pkg/usr/share/X11/* $fs/usr/share/X11
  17.265 -</pre>
  17.266 -<h4>libs</h4>
  17.267 -<p>
  17.268 -A ldd on XTerm, we copy (and strip) the missing libraries from the host system:
  17.269 -</p>
  17.270 -<pre class="script">    libXft.so.2 =&gt; /usr/lib/libXft.so.2 (0xb7f09000)
  17.271 -    libXrender.so.1 =&gt; /usr/lib/libXrender.so.1 (0xb7f00000)
  17.272 -    libfontconfig.so.1 =&gt; /usr/lib/libfontconfig.so.1 (0xb7ed5000)
  17.273 -    libfreetype.so.6 =&gt; /usr/lib/libfreetype.so.6 (0xb7e68000)
  17.274 -    libz.so.1 =&gt; /usr/lib/libz.so.1 (0xb7e54000)
  17.275 -    libX11.so.6 =&gt; /usr/lib/libX11.so.6 (0xb7d68000)
  17.276 -    libXaw.so.7 =&gt; /usr/lib/libXaw.so.7 (0xb7d0f000)
  17.277 -    libXmu.so.6 =&gt; /usr/lib/libXmu.so.6 (0xb7cfa000)
  17.278 -    libXext.so.6 =&gt; /usr/lib/libXext.so.6 (0xb7cec000)
  17.279 -    libXt.so.6 =&gt; /usr/lib/libXt.so.6 (0xb7c9e000)
  17.280 -    libSM.so.6 =&gt; /usr/lib/libSM.so.6 (0xb7c96000)
  17.281 -    libICE.so.6 =&gt; /usr/lib/libICE.so.6 (0xb7c7f000)
  17.282 -    libncurses.so.5 =&gt; /lib/libncurses.so.5 (0xb7c3c000)
  17.283 -    libc.so.6 =&gt; /lib/libc.so.6 (0xb7b2c000)
  17.284 -    libexpat.so.1 =&gt; /usr/lib/libexpat.so.1 (0xb7b0b000)
  17.285 -    libXau.so.6 =&gt; /usr/lib/libXau.so.6 (0xb7b08000)
  17.286 -    libXdmcp.so.6 =&gt; /usr/lib/libXdmcp.so.6 (0xb7b03000)
  17.287 -    libdl.so.2 =&gt; /lib/libdl.so.2 (0xb7aff000)
  17.288 -    libXpm.so.4 =&gt; /usr/lib/libXpm.so.4 (0xb7aee000)
  17.289 -</pre>
  17.290 -<a name="libpng"></a>
  17.291 -<h3><font color="#6c0023">libpng-1.2.18 - PNG Libraries</font></h3>
  17.292 -<p>
  17.293 -PNG libraries (<a href="http://libpng.org/pub/png/libpng.html">http://libpng.org/pub/png/libpng.html</a>) 
  17.294 -are used to manipulate and format PNG images:
  17.295 -</p>
  17.296 -<pre> # wget http://puzzle.dl.sourceforge.net/sourceforge/libpng/libpng-1.2.18.tar.bz2
  17.297 - # tar xjf libpng-1.2.18.tar.bz2
  17.298 - # cd libpng-1.2.18
  17.299 - # ./configure --enable-shared --prefix=/usr \
  17.300 -   --mandir=/usr/share/man
  17.301 - # make
  17.302 - # make DESTDIR=$PWD/_pkg install
  17.303 - # strip _pkg/usr/lib/*.so*
  17.304 - # cp -a _pkg/usr/lib/libpng12.so* $fs/usr/lib
  17.305 - # cp -a _pkg/usr/bin/libpng12* $fs/usr/bin
  17.306 -</pre>
  17.307 -<a name="jwm"></a>
  17.308 -<h3><font color="#6c0023">jwm-2.0 - Window manager</font></h3>
  17.309 -<p>
  17.310 -Joe's Window Manager (<a href="http://www.joewing.net/programs/jwm/">http://www.joewing.net/programs/jwm/</a>) 
  17.311 -is an ultra light and friendly window manager. This is the default SliTaz window manager. The main configuration 
  17.312 -file: /etc/jwm/system.jwnrc includes the style and config menu:
  17.313 -</p>
  17.314 -<pre> # cd ..
  17.315 - # wget http://www.joewing.net/programs/jwm/releases/jwm-2.0.tar.bz2
  17.316 - # tar xjf jwm-2.0.tar.bz2
  17.317 - # cd jwm-2.0
  17.318 - # ./configure --prefix=/usr --mandir=/usr/share/man \
  17.319 -   --sysconfdir=/etc/jwm --disable-xinerama
  17.320 - # make
  17.321 - # strip src/jwm
  17.322 - # cp src/jwm $fs/usr/bin
  17.323 - # mkdir $fs/etc/jwm
  17.324 - # cp example.jwmrc $fs/etc/jwm/system.jwmrc
  17.325 -</pre>
  17.326 -<h4>libs</h4>
  17.327 -<p>
  17.328 -Ldd libraries that we have provided:
  17.329 -</p>
  17.330 -<pre class="script">    libX11.so.6 =&gt; /usr/lib/libX11.so.6 (0xb7e35000)
  17.331 -    libpng12.so.0 =&gt; /usr/lib/libpng12.so.0 (0xb7e12000)
  17.332 -    libXft.so.2 =&gt; /usr/lib/libXft.so.2 (0xb7e00000)
  17.333 -    libXrender.so.1 =&gt; /usr/lib/libXrender.so.1 (0xb7df7000)
  17.334 -    libfontconfig.so.1 =&gt; /usr/lib/libfontconfig.so.1 (0xb7dcc000)
  17.335 -    libfreetype.so.6 =&gt; /usr/lib/libfreetype.so.6 (0xb7d5f000)
  17.336 -    libz.so.1 =&gt; /usr/lib/libz.so.1 (0xb7d4a000)
  17.337 -    libXpm.so.4 =&gt; /usr/lib/libXpm.so.4 (0xb7d3a000)
  17.338 -    libXext.so.6 =&gt; /usr/lib/libXext.so.6 (0xb7d2c000)
  17.339 -    libc.so.6 =&gt; /lib/libc.so.6 (0xb7c1c000)
  17.340 -    libXau.so.6 =&gt; /usr/lib/libXau.so.6 (0xb7c19000)
  17.341 -    libXdmcp.so.6 =&gt; /usr/lib/libXdmcp.so.6 (0xb7c14000)
  17.342 -    libdl.so.2 =&gt; /lib/libdl.so.2 (0xb7c0f000)
  17.343 -    libm.so.6 =&gt; /lib/libm.so.6 (0xb7bea000)
  17.344 -    libexpat.so.1 =&gt; /usr/lib/libexpat.so.1 (0xb7bc9000)
  17.345 -</pre>
  17.346 -<p>
  17.347 -You can start the X server and JWM with the command below or create a script in 
  17.348 -/usr/bin/startx with the content:
  17.349 -</p>
  17.350 -<pre>Xvesa -ac -shadow -screen 1024x768x24 &amp; exec jwm
  17.351 -</pre>
  17.352 -<h4>On SliTaz</h4>
  17.353 -<p>
  17.354 -SliTaz uses the ~/.Xsession file to start a graphical session. The 'startx' command checks 
  17.355 -whether the file exists or it runs 'tazx' to configure the X system. The user guide on X 
  17.356 -window is located in: /usr/share/doc/slitaz/user-guide/x-window.html or is on the website:
  17.357 -</p>
  17.358 -<p>
  17.359 -We chose to use the Tango icons theme <a href="http://tango.freedesktop.org/">http://tango.freedesktop.org/</a>, 
  17.360 -that aren't compiled. We only use the minimum: images in 16 x 16 format that we put in /usr/share/icons.
  17.361 -</p>
  17.362 -<p>
  17.363 -To test JWM with a cooking ISO:
  17.364 -</p>
  17.365 -<pre> # Xvesa -ac -shadow -screen 800x600x24 &amp; exec jwm
  17.366 -</pre>
  17.367 -<a name="jpeg"></a>
  17.368 -<h3><font color="#6c0023">jpeg-6b - JPEG Libraries</font></h3>
  17.369 -<p>
  17.370 -Libraries handling JPEG images, and some small utilities:
  17.371 -</p>
  17.372 -<pre> # wget http://www.ijg.org/files/jpegsrc.v6b.tar.gz
  17.373 - # tar xzf jpegsrc.v6b.tar.gz
  17.374 - # cd jpeg-6b
  17.375 - # ./configure --enable-shared --prefix=/usr \
  17.376 -   --mandir=/usr/share/man
  17.377 - # make
  17.378 - # strip .libs/*
  17.379 - # cp -a .libs/*.so* $fs/usr/lib
  17.380 - # cp .libs/{cjpeg,djpeg,jpegtran} $fs/usr/bin
  17.381 -</pre>
  17.382 -<a name="tiff"></a>
  17.383 -<h3><font color="#6c0023">tiff-3.8.2 - TIFF Libraries and Utilities</font></h3>
  17.384 -<p>
  17.385 -Libraries handling TIFF images and some small optional utilities:
  17.386 -</p>
  17.387 -<pre> # wget ftp://ftp.remotesensing.org/pub/libtiff/tiff-3.8.2.tar.gz
  17.388 - # tar xzf tiff-3.8.2.tar.gz
  17.389 - # cd tiff-3.8.2
  17.390 - # ./configure  --prefix=/usr --mandir=/usr/share/man
  17.391 - # make
  17.392 - # make DESTDIR=$PWD/_pkg install
  17.393 - # strip _pkg/usr/bin/*
  17.394 - # strip _pkg/usr/lib/*.so*
  17.395 - # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
  17.396 -</pre>
  17.397 -<p>
  17.398 -You can install the utilities you want.
  17.399 -</p>
  17.400 -<a name="links"></a>
  17.401 -<h3><font color="#6c0023">links-2.1pre29 - Graphical and text mode web browser</font></h3>
  17.402 -<p>
  17.403 -Links (<a href="http://links.twibright.com/">links.twibright.com</a>) is a web browser offering 
  17.404 -graphical and text modes. It is translated into multiple languages, including French:
  17.405 -</p>
  17.406 -<pre> # cd ..
  17.407 - # wget http://links.twibright.com/download/links-2.1pre28.tar.gz
  17.408 - # tar xzf links-2.1pre28.tar.gz
  17.409 - # cd links-2.1pre28
  17.410 - # ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man \
  17.411 -   --without-directfb --without-ssl --enable-graphics --enable-javascript
  17.412 - # make
  17.413 - # make DESTDIR=$PWD/_pkg install
  17.414 - # strip -v _pkg/usr/bin/*
  17.415 - # cp -v _pkg/usr/bin/* $fs/usr/bin
  17.416 -</pre>
  17.417 -<h4>libs</h4>
  17.418 -<pre class="script">    libtiff.so.3 =&gt; /usr/lib/libtiff.so.3
  17.419 -    libjpeg.so.62 =&gt; /usr/lib/libjpeg.so.62 (0xb7ede000)
  17.420 -    libpng12.so.0 =&gt; /usr/lib/libpng12.so.0 (0xb7eba000)
  17.421 -    libz.so.1 =&gt; /usr/lib/libz.so.1 (0xb7ea7000)
  17.422 -    libX11.so.6 =&gt; /usr/lib/libX11.so.6 (0xb7dbb000)
  17.423 -    libdl.so.2 =&gt; /lib/tls/libdl.so.2 (0xb7db7000)
  17.424 -    libpcre.so.0 =&gt; /usr/lib/libpcre.so.0 (0xb7d96000)
  17.425 -    libm.so.6 =&gt; /lib/tls/libm.so.6 (0xb7d70000)
  17.426 -    libc.so.6 =&gt; /lib/tls/libc.so.6 (0xb7c3e000)
  17.427 -    libXau.so.6 =&gt; /usr/lib/libXau.so.6 (0xb7c3b000)
  17.428 -    libXdmcp.so.6 =&gt; /usr/lib/libXdmcp.so.6 (0xb7c36000)
  17.429 -    /lib/ld-linux.so.2 (0xb7f5d000)
  17.430 -</pre>
  17.431 -<a name="initramfs-iso"></a>
  17.432 -<h3><font color="#6c0023">Generate the initramfs and an ISO image</font></h3>
  17.433 -<p>
  17.434 -To create a new ISO image, you can use 'mktaziso' in 
  17.435 -<a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools</a> .  
  17.436 -Or you can create a new initramfs image, copy it to /boot in the root of the cdrom
  17.437 -(rootcd) and finally generate an ISO image with genisoimage:
  17.438 -</p>
  17.439 -<pre> # cd $fs
  17.440 - # find . -print | cpio -o -H newc | gzip -9 &gt; ../rootfs.gz
  17.441 - # cd ..
  17.442 - # cp rootfs.gz rootcd/boot
  17.443 - # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
  17.444 -   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
  17.445 -   -V "SliTaz" -boot-info-table rootcd
  17.446 -</pre>
  17.447 -<h4>Following chapter</h4>
  17.448 -<p>
  17.449 -The next chapter <a href="gtk-libs.html">GTK+ libs</a> 
  17.450 -describes the installation of GTK libraries.
  17.451 -</p>
  17.452 -
  17.453 -
  17.454 -<!-- End of content -->
  17.455 -</div>
  17.456 -
  17.457 -<!-- Footer. -->
  17.458 -<div id="footer">
  17.459 -	<div class="footer-right"></div>
  17.460 -	<a href="x-window-systel.html#top">Top of the page</a> | 
  17.461 -	<a href="index.html">Table of contents</a>
  17.462 -</div>
  17.463 -
  17.464 -<div id="copy">
  17.465 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
  17.466 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  17.467 -    Documentation is under
  17.468 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  17.469 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
  17.470 -</div>
  17.471 -
  17.472 -</body>
  17.473 -</html>
    18.1 --- a/pt/doc/scratchbook/xorg.html	Wed Mar 31 03:06:23 2010 +0000
    18.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.3 @@ -1,144 +0,0 @@
    18.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    18.5 -    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    18.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    18.7 -<head>
    18.8 -    <title>SliTaz Scratchbook - Xorg</title>
    18.9 -    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   18.10 -    <meta name="description" content="" />
   18.11 -    <meta name="expires" content="never" />
   18.12 -    <meta name="modified" content="2008-11-22 17: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 id="quicknav" align="right">
   18.23 -    <a name="top"></a>
   18.24 -    <a href="index.html">Table of contents</a>
   18.25 -</div>
   18.26 -<h1><font color="#3e1220">SliTaz Scratchbook</font></h1>
   18.27 -</div>
   18.28 -
   18.29 -<!-- Content. -->
   18.30 -<div id="content">
   18.31 -<div class="content-right"></div>
   18.32 -
   18.33 -
   18.34 -<h2><font color="#df8f06">How-to Xorg - Modular graphical server</font></h2>
   18.35 -<ul>
   18.36 -    <li><a href="xorg.html#woking">Build Xorg automatically with Tazwok.</a></li>
   18.37 -    <li><a href="xorg.html#get">Download Xorg using wget.</a></li>
   18.38 -    <li><a href="xorg.html#make">Compile Xorg by hand.</a></li>
   18.39 -</ul>
   18.40 -<p>
   18.41 -Note SliTaz uses the Xvesa server provided by XFree86 and Xorg libraries, this page describes 
   18.42 -the compilation of Xorg libraries used by SliTaz. This document is primarily aimed at 
   18.43 -develpers and contributors to the project, but it may be useful to all those seeking to rebuild 
   18.44 -Xorg and Xlib libraries from source generating a minimum of dependencies.
   18.45 -</p>
   18.46 -
   18.47 -<a name="woking"></a>
   18.48 -<h3>Build Xorg automatically with Tazwok</h3>
   18.49 -<p>
   18.50 -On SliTaz, if you have Tazwok installed, you can rebuild Xorg with a few commands. 
   18.51 -The wok contains a package called <code>xorg</code> and another named <code>xorg-dev</code>, 
   18.52 -they can compile/cook all the packages used by Xorg on SliTaz. To compile, you must have 
   18.53 -most of the development packages installed; if this is not the case:
   18.54 -</p>
   18.55 -<pre> # tazpkg get-install slitaz-dev-pkgs
   18.56 -</pre>
   18.57 -<p>
   18.58 -Then you can start to cook (if everything is ready, wok and development packages, etc), 
   18.59 -starting with the protos' (xproto, etc):
   18.60 -</p>
   18.61 -<pre> # tazwok cook xorg-dev-proto
   18.62 - # tazwok cook xorg
   18.63 - # tazwok cook xorg-dev
   18.64 -</pre>
   18.65 -
   18.66 -<a name="get"></a>
   18.67 -<h3>Download Xorg (7.2) using wget</h3>
   18.68 -<p>
   18.69 -Xorg is distributed in the form of modules, which is handy because you can only install what you want, 
   18.70 -but it takes a lot of downloads. To help, we have created a small script that downloads the minimum 
   18.71 -required for SliTaz; you can find the script <code>getXorg.sh</code> in 
   18.72 -<a href="http://www.slitaz.org/en/doc/cookbook/slitaz-tools.html">SliTaz tools (1.1)</a>.
   18.73 -This script is no longer updated, developers use the 
   18.74 -<a href="http://www.slitaz.org/en/doc/cookbook/wok-tools.html">wok and tools</a>. 
   18.75 -To use the script, it must be placed in the directory where you want to download Xorg:
   18.76 -</p>
   18.77 -<pre> # cd ..
   18.78 - # mkdir Xorg &amp;&amp; cd Xorg
   18.79 - # cp slitaz-tools-1.1/utils/getXorg-7.2.sh .
   18.80 - # ./getXorg-7.2.sh
   18.81 -</pre>
   18.82 -<a name="make"></a>
   18.83 -<h3>Compile Xorg by hand</h3>
   18.84 -<p>
   18.85 -Compiling Xorg can take a long time, there are many packages. To commence you need to 
   18.86 -compile the downloaded proto packages, you can use the command <code>make DESTDIR=$PWD/_pkg install</code> to 
   18.87 -install the package in a given directory. Example:
   18.88 -</p>
   18.89 -<pre> # cd proto
   18.90 - # tar xzf xproto-X11R7.2-7.0.10.tar.gz
   18.91 - # cd xproto-X11R7.2-7.0.10
   18.92 - # ./configure --prefix=/usr --sysconfdir=/etc \
   18.93 -   --mandir=/usr/share/man --localstatedir=/var \
   18.94 -   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
   18.95 -  # make
   18.96 -  # make install
   18.97 -</pre>
   18.98 -<p>
   18.99 -Compile libraries by taking again the options used by proto. Example using the proper package to 
  18.100 -compile xtrans, remember to run <code>ldconfig</code> if you install the package on the development machine:
  18.101 -</p>
  18.102 -<pre> # cd .. &amp;&amp; cd lib
  18.103 - # tar xzf xtrans-X11R7.2-1.0.3.tar.gz
  18.104 - # cd xtrans-X11R7.2-1.0.3
  18.105 - # ./configure --prefix=/usr --sysconfdir=/etc \
  18.106 -   --mandir=/usr/share/man --localstatedir=/var \
  18.107 -   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
  18.108 - # make
  18.109 - # make install
  18.110 - # ldconfig
  18.111 -</pre>
  18.112 -<p>
  18.113 -Once all the packaged libraries are compiled, you can begin to compile X applications such as the 
  18.114 -graphical terminal Xterm. Note: SliTaz uses the RGB package containing the /usr/share/X11/rgt.text 
  18.115 -file for defining colors. Example using the <code>xsetroot</code> application that permits 
  18.116 -you to change the background color of the screen (modify $VERSION for the version that you want downloaded):
  18.117 -</p>
  18.118 -<pre> # cd .. &amp;&amp; cd app
  18.119 - # tar xzf xsetroot-$VERSION.tar.gz
  18.120 - # cd xsetroot-$VERSION
  18.121 - # ./configure --prefix=/usr --sysconfdir=/etc \
  18.122 -   --mandir=/usr/share/man --localstatedir=/var \
  18.123 -   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
  18.124 - # make &amp;&amp; make install
  18.125 -</pre>
  18.126 -
  18.127 -
  18.128 -<!-- End of content -->
  18.129 -</div>
  18.130 -
  18.131 -<!-- Footer. -->
  18.132 -<div id="footer">
  18.133 -	<div class="footer-right"></div>
  18.134 -	<a href="xorg.html#top">Top of the page</a> | 
  18.135 -	<a href="index.html">Table of contents</a>
  18.136 -</div>
  18.137 -
  18.138 -<div id="copy">
  18.139 -    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
  18.140 -    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
  18.141 -    Documentation is under
  18.142 -    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
  18.143 -    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
  18.144 -</div>
  18.145 -
  18.146 -</body>
  18.147 -</html>