slitaz-pizza view README @ rev 23
Make pot and msgmerge
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Mon Mar 26 23:22:55 2012 +0200 (2012-03-26) |
| parents | a5164f0bb461 |
| children | 7f228f4402eb |
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 Build process
22 -------------
23 First you have to choose the distro name, provide a short description, and
24 a valid email address so Pizza can notify you when ISOs are built or in
25 case the build failed. You must also choose a skeleton to base your
26 custom distro on. Then add some packages and follow the steps. When
27 validating the build, Pizza will create a tarball of your flavors and add
28 it to the build queue, so it can take some time before your ISO image
29 is generated.
32 FAQ
33 ---
35 * Is it long to build ?
37 By default Pizza builds a distro every 20 min but skips a run if
38 another distro is still building. After it depends on the build queue,
39 and the size of your custom SliTaz distro.
41 * How long do you keep my ISO ?
43 We can't guarantee hosting for a long time actually, we will keep your
44 product as long as we can. But surely enough time to share it with
45 your friends or family.
49 Installation and Administration
50 -------------------------------
51 Pizza uses a chroot to build ISOs and a web interface to create the flavor
52 file. Pizza can be installed and setup in a few commands. The package provides
53 a pizza host utility, pizza-bot build bot for chroot and pizza.cgi which is
54 the web interface main script. So let's go through the installation:
56 # tazpkg -gi slitaz-pizza
58 Or from Hg:
60 # hg clone http://hg.slitaz.org/slitaz-pizza
61 # cd pizza && make install
63 You can display a list of commands and a short usage with the usage command.
64 Create the chroot and build environment. You may want to have a look
65 at the Pizza configuration file before processing:
67 # pizza setup
69 Now you are ready to start the build bot to build queued flavors one by one.
70 You can also chroot in the environment to build manually or test.
72 # pizza start
74 In time there may be quite a lot of ISOs and temporary files. To clean up the
75 temporary files and old flavors files:
77 # pizza purge
79 The cron task is run in the chroot and checks if any flavors have been submitted,
80 by default it checks every 20 minutes. The bot frequency can be changed by
81 editing root crontabs in the build chroot.
83 To check build queue or chroot manually you can use:
85 # pizza exec pizza-bot
86 # pizza chroot
89 Developers and translators
90 --------------------------
91 SHell script as you would expect. Keep speed in mind and security. Always
92 think to have a simple option and an advanced option, for example in rootfs
93 modification let users add custom wallpaper easily and advanced users can
94 upload a full roootfs.
96 Pizza has been coded from the beginning with gettext support. Please forget
97 'echo' and use gettext, but remember that gettext "" is equivalent to echo -n.
98 To start a new translation please use msginit from the pot file directory.
99 Example for French/France locale (fr_FR):
101 $ msginit -l fr_FR -o fr.po -i pizza.pot
104 ================================================================================