website annotate en/doc/handbook/gen-livecd.html @ rev 341

cookbook+handbook: fix url and up e17 art website
author Christophe Lincoln <pankso@slitaz.org>
date Fri Mar 27 22:03:09 2009 +0100 (2009-03-27)
parents bd291720c3f9
children c927e3ab1dd9
rev   line source
pankso@7 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@7 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@7 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
pankso@7 4 <head>
paul@72 5 <title>SliTaz Handbook (en) - Gen a LiveCD to taste</title>
pankso@7 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@7 7 <meta name="description" content="slitaz tazlito build livecd flavor support all in RAM" />
pankso@7 8 <meta name="expires" content="never" />
MikeDSmith25@119 9 <meta name="modified" content="2008-07-20 06:08:00" />
pankso@7 10 <meta name="publisher" content="www.slitaz.org" />
pankso@7 11 <meta name="author" content="Christophe Lincoln"/>
pankso@7 12 <link rel="shortcut icon" href="favicon.ico" />
pankso@7 13 <link rel="stylesheet" type="text/css" href="book.css" />
pankso@7 14 </head>
pankso@7 15 <body bgcolor="#ffffff">
pankso@7 16
pankso@7 17 <!-- Header and quick navigation -->
pankso@7 18 <div id="header">
pankso@7 19 <div align="right" id="quicknav">
pankso@7 20 <a name="top"></a>
pankso@7 21 <a href="liveusb.html">LiveUSB media</a> |
pankso@7 22 <a href="index.html">Table of contents</a>
pankso@7 23 </div>
pankso@7 24 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
pankso@7 25 </div>
pankso@7 26
pankso@7 27 <!-- Content. -->
pankso@7 28 <div id="content">
pankso@7 29 <div class="content-right"></div>
pankso@7 30
paul@72 31 <h2><font color="#DF8F06">Generate a LiveCD to taste</font></h2>
paul@72 32 <p>
MikeDSmith25@117 33 Create your own LiveCD quickly and easily with Tazlito.
paul@72 34 </p>
pankso@7 35
pankso@7 36 <ul>
paul@72 37 <li><a href="#intro">To begin.</a></li>
paul@72 38 <li><a href="#2cmds">A LiveCD in 2 commands.</a></li>
paul@72 39 <li><a href="#get-flavor">Get a taste.</a></li>
paul@72 40 <li><a href="#gen-distro">Generate the distribution.</a></li>
paul@72 41 <li><a href="#gen-flavor">Create a flavor.</a></li>
paul@72 42 <li><a href="#addfiles">Additional files.</a></li>
paul@72 43 <li><a href="#pkgs">Packages used.</a></li>
paul@72 44 <li><a href="#configure">Configuration file.</a></li>
pankso@7 45 </ul>
pankso@7 46
paul@72 47 <a name="intro"></a>
paul@72 48 <h3>To begin</h3>
pankso@7 49 <p>
paul@72 50 Creating your own LiveCD version of SliTaz with Tazlito
paul@138 51 takes very little time and you can choose precisely the software
paul@72 52 packages that you want to find on the system. The support
paul@72 53 of flavors permits you to generate a customized LiveCD
paul@72 54 amended by a list of packages or flavors created by the SliTaz
paul@72 55 community. Tazlito is a command line tool that is not too
paul@72 56 demanding, you can have your own ISO image in two commands
paul@122 57 or burned in one.
paul@72 58 </p>
paul@72 59 <p>
paul@72 60 The generation of the LiveCD requires a minimum of 256 MB
paul@72 61 RAM and system compression with LZMA may take some time. It's
paul@72 62 possible to create a distribution from the LiveCD or from an
MikeDSmith25@119 63 installed system. In LiveCD mode, it's advisable to use persistent
paul@72 64 media or a USB drive to store generated files and save space in RAM.
paul@72 65 </p>
paul@72 66 <p>
paul@72 67 Tazlito is used by developers to generate the official LiveCD.
paul@72 68 The only prerequisite is to have Tazlito installed, this is installed
paul@72 69 by default on SliTaz, but you can generate from another
paul@72 70 LiveCD distribution if they have the necessary packages on hand
paul@214 71 or they can be downloaded.
paul@72 72 </p>
paul@72 73 <h4>Install Tazlito on another distribution</h4>
paul@72 74 <p>
paul@72 75 Tazlito does not generate dependencies for the LiveCD, but
paul@228 76 it depends on Cdrkit to burn the image and Tazpkg to
paul@214 77 regenerate SliTaz packages you want installed. To retrieve
paul@72 78 and install Tazlito, follow the instructions in the README
paul@72 79 file in <a href="http://download.tuxfamily.org/slitaz/sources/tazlito/"
paul@72 80 >the sources of Tazlito</a>.
paul@72 81 </p>
paul@72 82
paul@72 83 <a name="2cmds"></a>
paul@72 84 <h3>A LiveCD in 2 commands</h3>
paul@72 85 <ul>
paul@72 86 <li>Get a flavor : <code>tazlito get-flavor core</code></li>
paul@72 87 <li>Optional : Amend the list of packages or add
paul@72 88 additional files.</li>
paul@72 89 <li>Generate the distribution : <code>tazlito gen-distro</code></li>
paul@72 90 </ul>
paul@72 91 <p>
MikeDSmith25@117 92 Once finished, you will find the LiveCD ISO image in the
paul@72 93 <code>/home/slitaz/distro</code>.
paul@72 94 </p>
paul@72 95 <p>
paul@72 96 For simple instructions click <a href="simple-gen-livecd.html">here</a> .
pankso@7 97 </p>
pankso@7 98
pankso@7 99 <a name="get-flavor"></a>
paul@72 100 <h3>Get a taste</h3>
pankso@7 101 <p>
paul@72 102 A flavor is a <code>.flavor</code> file containing all the necessary information
paul@72 103 for the creation of the CD. The flavor provides the list of
paul@72 104 packages (<code>distro-packages.list</code>) and additional files for the
paul@72 105 chosen flavor. A list of flavors can be downloaded and
paul@72 106 updated with Tazlito:
pankso@7 107 </p>
pankso@7 108 <pre>
paul@72 109 # tazlito list-flavors
paul@72 110 Or :
paul@72 111 # tazlito list-flavors --recharge
pankso@7 112 </pre>
paul@72 113 <p>
paul@72 114 A list of flavors will automatically be displayed, giving the
paul@72 115 size of the LiveCD and a brief description. For the remainder,
paul@72 116 the <code>get-flavor</code> command will download the flavor file,
paul@72 117 automatically extract the package list and description in
paul@72 118 the current directory and put additional files in the
paul@72 119 <code>/home/slitaz/distro/addfiles</code> directory. To store <em>flavors</em>,
paul@72 120 we suggest that you use a specific directory such as
paul@72 121 <code>/home/slitaz/flavors</code>, you can create this yourself and proceed
paul@72 122 inside:
paul@72 123 </p>
paul@72 124 <pre>
paul@72 125 # mkdir -p /home/slitaz/flavors
paul@72 126 # cd /home/slitaz/flavors
paul@72 127 </pre>
paul@72 128 <p>
paul@72 129 To download and/or extract the files in a particular flavor:
paul@72 130 </p>
paul@72 131 <pre>
paul@72 132 # tazlito get-flavor particular-flavor
paul@72 133 </pre>
paul@72 134 <p>
paul@72 135 The description of the flavor can be displayed with the
paul@72 136 <code>show-flavor</code> command. Once the chosen flavor is downloaded
paul@72 137 you can start to generate the distribution.
paul@72 138
paul@72 139 </p>
pankso@7 140
pankso@7 141 <a name="gen-distro"></a>
paul@72 142 <h3>Generate the distribution</h3>
pankso@7 143 <p>
paul@72 144 For your first ISO, we advise you to test without modifying
paul@72 145 the list, then you can start to delete or add packages
paul@72 146 at will. But beware, the base system packages are essential.
paul@72 147 The <code>gen-distro</code> command generates an ISO image with all the
paul@72 148 packages on the list, it must be run as root and be in the
paul@72 149 same directory as the list and the configuration file.
paul@72 150 To generate a LiveCD:
pankso@7 151 </p>
pankso@7 152 <pre>
pankso@7 153 # tazlito gen-distro
pankso@7 154 </pre>
pankso@7 155 <p>
paul@72 156 Voil&agrave;, your first LiveCD ISO image is generated in <code>/home/slitaz/distro</code>,
paul@72 157 but without an account for the user hacker.
paul@72 158 </p>
paul@72 159 <h4>The user hacker</h4>
paul@72 160 <p>
paul@72 161 If you want to have a hacker user account, we must add one
paul@72 162 and then recreate the compressed root filesystem:
pankso@7 163 </p>
pankso@7 164 <pre>
paul@72 165 # tazlito addhacker
pankso@7 166 # tazlito gen-initiso
pankso@7 167 </pre>
paul@72 168 <h4>Clean and regenerate distro</h4>
pankso@7 169 <p>
paul@72 170 To continue to go further, you can simply add one or two packages
paul@72 171 to the list, clean the distro and regenerate the root
paul@72 172 filesystem with a new ISO image:
pankso@7 173 </p>
pankso@7 174 <pre>
paul@72 175 # tazlito clean-distro
paul@72 176 # tazlito gen-distro
paul@72 177 </pre>
paul@72 178 <p>
paul@130 179 Tazlito also offers several possibilities, such as burning the
paul@214 180 ISO, copying additional files into the system or directly
paul@129 181 on to the cdrom. The Tazlito <a href="../manuals/tazlito.en.html">Manual</a>
paul@129 182 provides more information.
paul@129 183
paul@72 184 </p>
paul@72 185
paul@72 186 <a name="gen-flavor"></a>
paul@72 187 <h3>Create a flavor</h3>
paul@72 188 <p>
paul@72 189 Tazlito allows you to easily create your own flavor from
paul@138 190 the results of generating the distribution (<code>gen-distro</code>).
paul@72 191 The file will contain all the flavor's additional files,
paul@72 192 a description and a list of packages which can be reused later
paul@72 193 and updated according to the versions of packages. To generate
paul@138 194 your own flavor responding to one or two questions:
paul@72 195 </p>
paul@72 196 <pre>
paul@72 197 # tazlito gen-flavor new-flavor
paul@72 198 </pre>
paul@72 199 <p>
paul@72 200 Once your flavor is fully functioning and well tested, you
paul@72 201 can send it to slitaz.org to make it available to all and sundry,
paul@72 202 listed via <code>list-flavor</code> and usable via <code>get-flavor</code>. To send
paul@72 203 a flavor you have several means, announce through the mailing list,
paul@72 204 save the file online and report on the forum or send by mail
paul@72 205 to a contributor of the project.
paul@72 206 </p>
paul@72 207
paul@72 208 <a name="addfiles"></a>
paul@72 209 <h3>Additional files</h3>
paul@72 210 <p>
paul@72 211 The files containing flavors usually have additional files
paul@72 212 copied directly into the filesystem or the root of the cdrom.
paul@72 213 The path to the files used is specified in the configuration
paul@166 214 file <code>tazlito.conf</code> - by default, the files are
paul@72 215 located in <code>/home/slitaz/distro/addfiles</code>. The additional files
paul@159 216 the core flavor provides are for example, the window manager
paul@72 217 JWM and some wallpapers. It is easy enough to modify, add
paul@72 218 or delete files in the root filesystem (<code>rootfs</code>) or the root
paul@72 219 of the CD (<code>rootcd</code>) and regenerate the distribution.
paul@72 220 To clean and regenerate the distribution:
paul@72 221 </p>
paul@72 222 <pre>
paul@72 223 # tazlito clean-distro
paul@72 224 # tazlito gen-distro
pankso@7 225 </pre>
pankso@7 226
paul@72 227 <a name="pkgs"></a>
paul@72 228 <h3>Packages used</h3>
paul@72 229 <p>
paul@72 230 To create your distro you need SliTaz packages. Tazlito and
paul@72 231 Tazpkg allow us to recreate packages from a SliTaz system
paul@72 232 in operation or to download packages directly depending on
paul@72 233 the flavor chosen. By default, SliTaz packages are located
paul@72 234 in the directory <code>/home/slitaz/packages</code>, but you can change
paul@72 235 this via the Tazlito configuration file (tazlito.conf).
paul@72 236 </p>
paul@72 237 <p>
paul@72 238 If you want to retrieve packages manually, you can use
paul@72 239 FTP software such as gFTP (installed by default on SliTaz)
paul@72 240 or the command line and <code>wget</code> to download official packages.
paul@72 241 The direct URL to package versions:
paul@72 242 <a href="ftp://download.tuxfamily.org/slitaz/packages/"
paul@72 243 >ftp://download.tuxfamily.org/slitaz/packages/</a>
paul@72 244 </p>
paul@72 245 <p>
paul@72 246 You can also use your own packages by putting them in the
paul@72 247 packages directory. If you are looking for documentation
paul@72 248 about the creation of SliTaz packages, you can refer to the
paul@72 249 <a href="../cookbook/">Cookbook</a>.
paul@72 250 </p>
paul@72 251
paul@72 252 <a name="configure"></a>
paul@72 253 <h3>Configuration file</h3>
paul@72 254 <p>
paul@72 255 By default, Tazlito uses the system configuration file
paul@72 256 <code>/etc/tazlito/tazlito.conf</code> or the <code>tazlito.conf</code>
paul@72 257 located in the current directory. This means that you can use the default
paul@72 258 file or a configuration file specific to the distro you want to
paul@72 259 create. This file can change the name of the ISO image, the
paul@72 260 name of the maintainer and the paths to the working
paul@72 261 directories. To create and configure your own configuration
paul@72 262 file, you just need to run Tazlito with the <code>configure</code>
paul@72 263 command from the working directory of the distro.
paul@72 264 Assuming you have the tree of the distro in <code>/home/slitaz/distro</code>
paul@72 265 and you're located within:
paul@72 266 </p>
paul@72 267 <pre>
paul@72 268 $ tazlito configure
paul@72 269 </pre>
paul@72 270 <p>
paul@72 271 Once you've answered the questions, you can either
paul@214 272 create the ISO image, rebuild the root filesystem and ISO, or
paul@72 273 generate a new distro with the list of packages.
paul@72 274 </p>
pankso@7 275
pankso@7 276 <!-- End of content -->
pankso@7 277 </div>
pankso@7 278
pankso@7 279 <!-- Footer. -->
pankso@7 280 <div id="footer">
pankso@7 281 <div class="footer-right"></div>
pankso@7 282 <a href="#top">Top of the page</a> |
pankso@7 283 <a href="index.html">Table of contents</a>
pankso@7 284 </div>
pankso@7 285
pankso@7 286 <div id="copy">
pankso@7 287 Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
pankso@7 288 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
pankso@7 289 Documentation is under
pankso@7 290 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
pankso@7 291 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
pankso@7 292 </div>
pankso@7 293
pankso@7 294 </body>
pankso@7 295 </html>
paul@72 296