website rev 72
en: Add new LiveCD page to Hbk
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Sun Jun 22 11:21:54 2008 +0000 (2008-06-22) |
| parents | 68af7877fc92 |
| children | f7dbfd69ab3a |
| files | en/doc/handbook/gen-livecd.html en/doc/handbook/simple-gen-livecd.html |
line diff
1.1 --- a/en/doc/handbook/gen-livecd.html Fri Jun 20 14:25:00 2008 +0000 1.2 +++ b/en/doc/handbook/gen-livecd.html Sun Jun 22 11:21:54 2008 +0000 1.3 @@ -2,7 +2,7 @@ 1.4 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.5 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 1.6 <head> 1.7 - <title>SliTaz Handbook (en) - Gen LiveCD flavor</title> 1.8 + <title>SliTaz Handbook (en) - Gen a LiveCD to taste</title> 1.9 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 <meta name="description" content="slitaz tazlito build livecd flavor support all in RAM" /> 1.11 <meta name="expires" content="never" /> 1.12 @@ -28,76 +28,248 @@ 1.13 <div id="content"> 1.14 <div class="content-right"></div> 1.15 1.16 -<h2><font color="#DF8F06">Generate a LiveCD flavor</font></h2> 1.17 +<h2><font color="#DF8F06">Generate a LiveCD to taste</font></h2> 1.18 +<p> 1.19 +Create you own LiveCD quickly and easily with Tazlito. 1.20 +</p> 1.21 1.22 <ul> 1.23 - <li><a href="#tazlito">Tazlito</a> - SliTaz Live Tool.</li> 1.24 - <li><a href="#get-flavor">Get a flavor</a> - Download a flavor file.</li> 1.25 - <li><a href="#gen-distro">Gen your own distro</a> - Generate a Live distro in 1.26 - one single command.</li> 1.27 + <li><a href="#intro">To begin.</a></li> 1.28 + <li><a href="#2cmds">A LiveCD in 2 commands.</a></li> 1.29 + <li><a href="#get-flavor">Get a taste.</a></li> 1.30 + <li><a href="#gen-distro">Generate the distribution.</a></li> 1.31 + <li><a href="#gen-flavor">Create a flavor.</a></li> 1.32 + <li><a href="#addfiles">Additional files.</a></li> 1.33 + <li><a href="#pkgs">Packages used.</a></li> 1.34 + <li><a href="#configure">Configuration file.</a></li> 1.35 </ul> 1.36 1.37 -<a name="tazlito"></a> 1.38 -<h3>Tazlito - SliTaz Live Tool</h3> 1.39 +<a name="intro"></a> 1.40 +<h3>To begin</h3> 1.41 <p> 1.42 -Tazlito is a tool to help generate and configure SliTaz LiveCD ISO images. 1.43 -You can create a custom distro in two commands from a list of packages and a 1.44 -flavor file, extract an existing ISO image to hack it, create new initramfs 1.45 -and/or a new ISO. Most commands must be run by root, except the stats and the 1.46 -configuration file manipulation. Like other SliTaz tiny utils, you can simply 1.47 -type <code>tazlito usage</code> in a terminal to get a list of all 1.48 -commands with a short description in English. 1.49 +Creating your own LiveCD version of SliTaz with Tazlito 1.50 +takes little time and you can choose precisely the software 1.51 +packages that you want to find on the system. The support 1.52 +of flavors permits you to generate a customized LiveCD 1.53 +amended by a list of packages or flavors created by the SliTaz 1.54 +community. Tazlito is a command line tool that is not too 1.55 +demanding, you can have your own ISO image in two commands 1.56 +or burnt in one. 1.57 +</p> 1.58 +<p> 1.59 +The generation of the LiveCD requires a minimum of 256 MB 1.60 +RAM and system compression with LZMA may take some time. It's 1.61 +possible to create a distribution from the LiveCD or from an 1.62 +installed system. In LiveCD mode, it's advisible to use persistent 1.63 +media or a USB drive to store generated files and save space in RAM. 1.64 +</p> 1.65 +<p> 1.66 +Tazlito is used by developers to generate the official LiveCD. 1.67 +The only prerequisite is to have Tazlito installed, this is installed 1.68 +by default on SliTaz, but you can generate from another 1.69 +LiveCD distribution if they have the necessary packages on hand 1.70 +or can be downloaded. 1.71 +</p> 1.72 +<h4>Install Tazlito on another distribution</h4> 1.73 +<p> 1.74 +Tazlito does not generate dependencies for the LiveCD, but 1.75 +it depends of Cdrkit to burn the image and Tazpkg to 1.76 +regenerate SliTaz packages not already installed. To retrieve 1.77 +and install Tazlito, follow the instructions in the README 1.78 +file in <a href="http://download.tuxfamily.org/slitaz/sources/tazlito/" 1.79 + >the sources of Tazlito</a>. 1.80 +</p> 1.81 + 1.82 +<a name="2cmds"></a> 1.83 +<h3>A LiveCD in 2 commands</h3> 1.84 +<ul> 1.85 + <li>Get a flavor : <code>tazlito get-flavor core</code></li> 1.86 + <li>Optional : Amend the list of packages or add 1.87 + additional files.</li> 1.88 + <li>Generate the distribution : <code>tazlito gen-distro</code></li> 1.89 +</ul> 1.90 +<p> 1.91 +Once finished , you will find the LiveCD ISO image in the 1.92 +<code>/home/slitaz/distro</code>. 1.93 +</p> 1.94 +<p> 1.95 +For simple instructions click <a href="simple-gen-livecd.html">here</a> . 1.96 </p> 1.97 1.98 <a name="get-flavor"></a> 1.99 -<h3>Get a flavor</h3> 1.100 +<h3>Get a taste</h3> 1.101 <p> 1.102 -SliTaz LiveCD can easily be rebuilt using Tazlito flavor support. A special 1.103 -LiveCD flavor can be built from the LiveCD/RAM itself or from an installed 1.104 -system. If you want to rebuild SliTaz from the LiveCD you need at least 256 Mb 1.105 -of RAM and we recommend that you store the file on persistent media (USB key, HD, 1.106 -etc). To start you need to get a flavor file from a SliTaz mirror, open a Xterm, 1.107 -become root administrator and get the default core system: 1.108 +A flavor is a <code>.flavor</code> file containing all the necessary information 1.109 +for the creation of the CD. The flavor provides the list of 1.110 +packages (<code>distro-packages.list</code>) and additional files for the 1.111 +chosen flavor. A list of flavors can be downloaded and 1.112 +updated with Tazlito: 1.113 </p> 1.114 <pre> 1.115 - # tazlito get-flavor core 1.116 + # tazlito list-flavors 1.117 + Or : 1.118 + # tazlito list-flavors --recharge 1.119 </pre> 1.120 +<p> 1.121 +A list of flavors will automatically be displayed, giving the 1.122 +size of the LiveCD and a brief description. For the remainder, 1.123 +the <code>get-flavor</code> command will download the flavor file, 1.124 +automatically extract the package list and description in 1.125 +the current directory and put additional files in the 1.126 +<code>/home/slitaz/distro/addfiles</code> directory. To store <em>flavors</em>, 1.127 +we suggest that you use a specific directory such as 1.128 +<code>/home/slitaz/flavors</code>, you can create this yourself and proceed 1.129 +inside: 1.130 +</p> 1.131 +<pre> 1.132 + # mkdir -p /home/slitaz/flavors 1.133 + # cd /home/slitaz/flavors 1.134 +</pre> 1.135 +<p> 1.136 +To download and/or extract the files in a particular flavor: 1.137 +</p> 1.138 +<pre> 1.139 + # tazlito get-flavor particular-flavor 1.140 +</pre> 1.141 +<p> 1.142 +The description of the flavor can be displayed with the 1.143 +<code>show-flavor</code> command. Once the chosen flavor is downloaded 1.144 +you can start to generate the distribution. 1.145 + 1.146 +</p> 1.147 1.148 <a name="gen-distro"></a> 1.149 -<h3>Generate your own distro</h3> 1.150 +<h3>Generate the distribution</h3> 1.151 <p> 1.152 -The command <code>get-flavor</code> will download the core flavor, giving you a description 1.153 -and a list of packages in the current directory with some additional files in 1.154 -/home/slitaz/distro/addfiles (JWM menu, wallpapers, hacker files). From now on 1.155 -you can add or remove packages in the list (<code>distro-packages.list</code>), 1.156 -modify configuration files (<code>tazlito.conf</code>) and optionally modify 1.157 -additional files. Then simply generate a LiveCD ISO image: 1.158 +For your first ISO, we advise you to test without modifying 1.159 +the list, then you can start to delete or add packages 1.160 +at will. But beware, the base system packages are essential. 1.161 +The <code>gen-distro</code> command generates an ISO image with all the 1.162 +packages on the list, it must be run as root and be in the 1.163 +same directory as the list and the configuration file. 1.164 +To generate a LiveCD: 1.165 </p> 1.166 <pre> 1.167 # tazlito gen-distro 1.168 </pre> 1.169 <p> 1.170 -The LiveCD ISO image, root filesystem (rootfs) and the content of the CD 1.171 -(rootcd) are in /home/slitaz/distro. All repacked or downloaded packages are 1.172 -stored by default in /home/slitaz/packages. If you want to chroot in the 1.173 -rootfs to preconfigure the system, add more files in the rootcd directory or 1.174 -add users, you just have to rebuild initramfs and the ISO image to generate 1.175 -your new LiveCD: 1.176 +Voilà, your first LiveCD ISO image is generated in <code>/home/slitaz/distro</code>, 1.177 +but without an account for the user hacker. 1.178 +</p> 1.179 +<h4>The user hacker</h4> 1.180 +<p> 1.181 +If you want to have a hacker user account, we must add one 1.182 +and then recreate the compressed root filesystem: 1.183 </p> 1.184 <pre> 1.185 + # tazlito addhacker 1.186 # tazlito gen-initiso 1.187 </pre> 1.188 - 1.189 -<h4>Burn ISO and gen a flavor file</h4> 1.190 +<h4>Clean and regenerate distro</h4> 1.191 <p> 1.192 -Tazlito can also burn the LiveCD and/or create a flavor file to keep your 1.193 -modifications: 1.194 +To continue to go further, you can simply add one or two packages 1.195 +to the list, clean the distro and regenerate the root 1.196 +filesystem with a new ISO image: 1.197 </p> 1.198 <pre> 1.199 - # tazlito burn-iso 1.200 - # tazlito gen-flavor 1.201 + # tazlito clean-distro 1.202 + # tazlito gen-distro 1.203 +</pre> 1.204 +<p> 1.205 +Tazlito also provides several possibilities, such as burning the 1.206 +ISO or copying additional files in the system or directly 1.207 +on to the cdrom. 1.208 +</p> 1.209 + 1.210 +<a name="gen-flavor"></a> 1.211 +<h3>Create a flavor</h3> 1.212 +<p> 1.213 +Tazlito allows you to easily create your own flavor from 1.214 +the results of manufacturing the distribution (<code>gen-distro</code>). 1.215 +The file will contain all the flavor's additional files, 1.216 +a description and a list of packages which can be reused later 1.217 +and updated according to the versions of packages. To generate 1.218 +you own flavor responding to one or two questions: 1.219 +</p> 1.220 +<pre> 1.221 + # tazlito gen-flavor new-flavor 1.222 +</pre> 1.223 +<p> 1.224 +Once your flavor is fully functioning and well tested, you 1.225 +can send it to slitaz.org to make it available to all and sundry, 1.226 +listed via <code>list-flavor</code> and usable via <code>get-flavor</code>. To send 1.227 +a flavor you have several means, announce through the mailing list, 1.228 +save the file online and report on the forum or send by mail 1.229 +to a contributor of the project. 1.230 +</p> 1.231 + 1.232 +<a name="addfiles"></a> 1.233 +<h3>Additional files</h3> 1.234 +<p> 1.235 +The files containing flavors usually have additional files 1.236 +copied directly into the filesystem or the root of the cdrom. 1.237 +The path to the files used is specified in the configuration 1.238 +file <code>tazlito.conf</code> - by default the files are 1.239 +located in <code>/home/slitaz/distro/addfiles</code>. The additional files 1.240 +the core flavor provides are for example the window manager 1.241 +JWM and some wallpapers. It is easy enough to modify, add 1.242 +or delete files in the root filesystem (<code>rootfs</code>) or the root 1.243 +of the CD (<code>rootcd</code>) and regenerate the distribution. 1.244 +To clean and regenerate the distribution: 1.245 +</p> 1.246 +<pre> 1.247 + # tazlito clean-distro 1.248 + # tazlito gen-distro 1.249 </pre> 1.250 1.251 +<a name="pkgs"></a> 1.252 +<h3>Packages used</h3> 1.253 +<p> 1.254 +To create your distro you need SliTaz packages. Tazlito and 1.255 +Tazpkg allow us to recreate packages from a SliTaz system 1.256 +in operation or to download packages directly depending on 1.257 +the flavor chosen. By default, SliTaz packages are located 1.258 +in the directory <code>/home/slitaz/packages</code>, but you can change 1.259 +this via the Tazlito configuration file (tazlito.conf). 1.260 +</p> 1.261 +<p> 1.262 +If you want to retrieve packages manually, you can use 1.263 +FTP software such as gFTP (installed by default on SliTaz) 1.264 +or the command line and <code>wget</code> to download official packages. 1.265 +The direct URL to package versions: 1.266 +<a href="ftp://download.tuxfamily.org/slitaz/packages/" 1.267 + >ftp://download.tuxfamily.org/slitaz/packages/</a> 1.268 +</p> 1.269 +<p> 1.270 +You can also use your own packages by putting them in the 1.271 +packages directory. If you are looking for documentation 1.272 +about the creation of SliTaz packages, you can refer to the 1.273 +<a href="../cookbook/">Cookbook</a>. 1.274 +</p> 1.275 + 1.276 +<a name="configure"></a> 1.277 +<h3>Configuration file</h3> 1.278 +<p> 1.279 +By default, Tazlito uses the system configuration file 1.280 +<code>/etc/tazlito/tazlito.conf</code> or the <code>tazlito.conf</code> 1.281 + located in the current directory. This means that you can use the default 1.282 +file or a configuration file specific to the distro you want to 1.283 +create. This file can change the name of the ISO image, the 1.284 +name of the maintainer and the paths to the working 1.285 +directories. To create and configure your own configuration 1.286 +file, you just need to run Tazlito with the <code>configure</code> 1.287 +command from the working directory of the distro. 1.288 +Assuming you have the tree of the distro in <code>/home/slitaz/distro</code> 1.289 +and you're located within: 1.290 +</p> 1.291 +<pre> 1.292 + $ tazlito configure 1.293 +</pre> 1.294 +<p> 1.295 +Once you've answered the questions, you can either 1.296 +create the ISO image, rebuild the root filesystem and ISO or 1.297 +generate a new distro with the list of packages. 1.298 +</p> 1.299 1.300 <!-- End of content --> 1.301 </div> 1.302 @@ -119,3 +291,4 @@ 1.303 1.304 </body> 1.305 </html> 1.306 +
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 2.2 +++ b/en/doc/handbook/simple-gen-livecd.html Sun Jun 22 11:21:54 2008 +0000 2.3 @@ -0,0 +1,121 @@ 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 Handbook (en) - Gen LiveCD flavor</title> 2.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 2.10 + <meta name="description" content="slitaz tazlito build livecd flavor support all in RAM" /> 2.11 + <meta name="expires" content="never" /> 2.12 + <meta name="modified" content="2008-02-26 18:30:00" /> 2.13 + <meta name="publisher" content="www.slitaz.org" /> 2.14 + <meta name="author" content="Christophe Lincoln"/> 2.15 + <link rel="shortcut icon" href="favicon.ico" /> 2.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 2.17 +</head> 2.18 +<body bgcolor="#ffffff"> 2.19 + 2.20 +<!-- Header and quick navigation --> 2.21 +<div id="header"> 2.22 +<div align="right" id="quicknav"> 2.23 + <a name="top"></a> 2.24 + <a href="liveusb.html">LiveUSB media</a> | 2.25 + <a href="index.html">Table of contents</a> 2.26 +</div> 2.27 +<h1><font color="#3E1220">SliTaz Handbook (en)</font></h1> 2.28 +</div> 2.29 + 2.30 +<!-- Content. --> 2.31 +<div id="content"> 2.32 +<div class="content-right"></div> 2.33 + 2.34 +<h2><font color="#DF8F06">Generate a LiveCD flavor (Simple Guide)</font></h2> 2.35 + 2.36 +<ul> 2.37 + <li><a href="#tazlito">Tazlito</a> - SliTaz Live Tool.</li> 2.38 + <li><a href="#get-flavor">Get a flavor</a> - Download a flavor file.</li> 2.39 + <li><a href="#gen-distro">Gen your own distro</a> - Generate a Live distro in 2.40 + one single command.</li> 2.41 +</ul> 2.42 + 2.43 +<a name="tazlito"></a> 2.44 +<h3>Tazlito - SliTaz Live Tool</h3> 2.45 +<p> 2.46 +Tazlito is a tool to help generate and configure SliTaz LiveCD ISO images. 2.47 +You can create a custom distro in two commands from a list of packages and a 2.48 +flavor file, extract an existing ISO image to hack it, create new initramfs 2.49 +and/or a new ISO. Most commands must be run by root, except the stats and the 2.50 +configuration file manipulation. Like other SliTaz tiny utils, you can simply 2.51 +type <code>tazlito usage</code> in a terminal to get a list of all 2.52 +commands with a short description in English. 2.53 +</p> 2.54 + 2.55 +<a name="get-flavor"></a> 2.56 +<h3>Get a flavor</h3> 2.57 +<p> 2.58 +SliTaz LiveCD can easily be rebuilt using Tazlito flavor support. A special 2.59 +LiveCD flavor can be built from the LiveCD/RAM itself or from an installed 2.60 +system. If you want to rebuild SliTaz from the LiveCD you need at least 256 Mb 2.61 +of RAM and we recommend that you store the file on persistent media (USB key, HD, 2.62 +etc). To start you need to get a flavor file from a SliTaz mirror, open a Xterm, 2.63 +become root administrator and get the default core system: 2.64 +</p> 2.65 +<pre> 2.66 + # tazlito get-flavor core 2.67 +</pre> 2.68 + 2.69 +<a name="gen-distro"></a> 2.70 +<h3>Generate your own distro</h3> 2.71 +<p> 2.72 +The command <code>get-flavor</code> will download the core flavor, giving you a description 2.73 +and a list of packages in the current directory with some additional files in 2.74 +/home/slitaz/distro/addfiles (JWM menu, wallpapers, hacker files). From now on 2.75 +you can add or remove packages in the list (<code>distro-packages.list</code>), 2.76 +modify configuration files (<code>tazlito.conf</code>) and optionally modify 2.77 +additional files. Then simply generate a LiveCD ISO image: 2.78 +</p> 2.79 +<pre> 2.80 + # tazlito gen-distro 2.81 +</pre> 2.82 +<p> 2.83 +The LiveCD ISO image, root filesystem (rootfs) and the content of the CD 2.84 +(rootcd) are in /home/slitaz/distro. All repacked or downloaded packages are 2.85 +stored by default in /home/slitaz/packages. If you want to chroot in the 2.86 +rootfs to preconfigure the system, add more files in the rootcd directory or 2.87 +add users, you just have to rebuild initramfs and the ISO image to generate 2.88 +your new LiveCD: 2.89 +</p> 2.90 +<pre> 2.91 + # tazlito gen-initiso 2.92 +</pre> 2.93 + 2.94 +<h4>Burn ISO and gen a flavor file</h4> 2.95 +<p> 2.96 +Tazlito can also burn the LiveCD and/or create a flavor file to keep your 2.97 +modifications: 2.98 +</p> 2.99 +<pre> 2.100 + # tazlito burn-iso 2.101 + # tazlito gen-flavor 2.102 +</pre> 2.103 + 2.104 + 2.105 +<!-- End of content --> 2.106 +</div> 2.107 + 2.108 +<!-- Footer. --> 2.109 +<div id="footer"> 2.110 + <div class="footer-right"></div> 2.111 + <a href="#top">Top of the page</a> | 2.112 + <a href="index.html">Table of contents</a> 2.113 +</div> 2.114 + 2.115 +<div id="copy"> 2.116 + Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> - 2.117 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 2.118 + Documentation is under 2.119 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 2.120 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 2.121 +</div> 2.122 + 2.123 +</body> 2.124 +</html>