slitaz-pizza view README @ rev 43

Better help
author Christophe Lincoln <pankso@slitaz.org>
date Tue Mar 27 11:57:39 2012 +0200 (2012-03-27)
parents 7f228f4402eb
children ead95c9ab322
line source
1 SliTaz Pizza
2 ================================================================================
5 The SliTaz Pizza provides tools and utils to build Live systems online.
8 * Build ISO flavors online in a simple to use and modern interface
9 * Use stable packages or cooking if near to a stable release
10 * Build queue and one build at a time to be less resources intensive
11 * Can be run locally as a frontend to Tazlito or from the cmdline
12 * Produce standard and valid HTML code and wildly themable
13 * Provide a status page to follow build process for each flavor
14 * Create a tarball of the flavor receipt, list and addfiles
15 * Log activities, build process and provide useful statistics
16 * Keep ISO images and files public for a while, then archive them
17 * Uniq ID strings for each flavor and mail notification
18 * RSS feed for all newly built flavors and summary on web interface
21 Installation and Administration
22 -------------------------------
23 Pizza uses a chroot to build ISOs and a web interface to create the flavor
24 file. Pizza can be installed and setup in a few commands. The package provides
25 a pizza host utility, pizza-bot build bot for chroot and pizza.cgi which is
26 the web interface main script. So let's go through the installation:
28 # tazpkg -gi slitaz-pizza
30 Or from Hg:
32 # hg clone http://hg.slitaz.org/slitaz-pizza
33 # cd pizza && make install
35 You can display a list of commands and a short usage with the usage command.
36 Create the chroot and build environment. You may want to have a look
37 at the Pizza configuration file before processing:
39 # pizza setup
41 Now you are ready to start the build bot to build queued flavors one by one.
42 You can also chroot in the environment to build manually or test.
44 # pizza start
46 In time there may be quite a lot of ISOs and temporary files. To clean up the
47 temporary files and old flavors files:
49 # pizza purge
51 The cron task is run in the chroot and checks if any flavors have been submitted,
52 by default it checks every 20 minutes. The bot frequency can be changed by
53 editing root crontabs in the build chroot.
55 To check build queue or chroot manually you can use:
57 # pizza exec pizza-bot
58 # pizza chroot
61 Developers and translators
62 --------------------------
63 SHell script as you would expect. Keep speed in mind and security. Always
64 think to have a simple option and an advanced option, for example in rootfs
65 modification let users add custom wallpaper easily and advanced users can
66 upload a full roootfs.
68 Pizza has been coded from the beginning with gettext support. Please forget
69 'echo' and use gettext, but remember that gettext "" is equivalent to echo -n.
70 To start a new translation please use msginit from the pot file directory.
71 Example for French/France locale (fr_FR):
73 $ msginit -l fr_FR -o fr.po -i pizza.pot
76 ================================================================================