slitaz-pizza annotate README @ rev 77

pizza.cgi: Limit flavor name size for ISO label limitation
author Eric Joseph-Alexandre <erjo@slitaz.org>
date Wed Nov 21 01:45:12 2012 +0100 (2012-11-21)
parents c63cfd9530a0
children ef95ba3b16ce
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 ================================================================================