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