slitaz-dev-tools annotate tazyad/README @ rev 62

Add tazyad (README devels :-) yad will be used to replace gtkdialog
author Christophe Lincoln <pankso@slitaz.org>
date Wed Apr 06 00:58:18 2011 +0200 (2011-04-06)
parents
children 282cc8e3e5c9
rev   line source
pankso@62 1 Yad on SliTaz
pankso@62 2 ================================================================================
pankso@62 3
pankso@62 4
pankso@62 5 Yad is the new prefered way to create GUI boxes for SliTaz desktop. We use
pankso@62 6 Yad GTK boxes for all user and administrator interfaces that can't be handled
pankso@62 7 by TazPanel (admin panel) or TazDE (desktop environment). Both are powered
pankso@62 8 by CGI scripts and use xHTML 5 and CSS 3 for the UI. Yad is a powerfull tool
pankso@62 9 witch support latest GTK actions and goodies. With our original GTKdialog
pankso@62 10 scripts some nice features was missing like for example --notification or
pankso@62 11 ENTER for event (with gtkdialog one must press a button).
pankso@62 12
pankso@62 13 If you motivated to code, please have a look at the TODO file and continue
pankso@62 14 reading :-)
pankso@62 15
pankso@62 16
pankso@62 17 Coding guidlines
pankso@62 18 ----------------
pankso@62 19 Use a function and a function_main for main= variable to keep datas,
pankso@62 20 that way we can have yad boxes commands separated from shell script.
pankso@62 21 Here is a structure example:
pankso@62 22
pankso@62 23 # function_main
pankso@62 24 # function_other
pankso@62 25 # function
pankso@62 26
pankso@62 27 Use gettext to have a translated application and forget echo. Use 'case'
pankso@62 28 as most as possible, it is the faster way to handle or parse commands
pankso@62 29 and options. Use fgrep when possible.
pankso@62 30
pankso@62 31 To start you will find a template script called tazyad, copy it and start
pankso@62 32 coding from that :-). Tazyad is commented to help you getting started.
pankso@62 33 You can also have a look to tazpkg-notify who was the first official Yad
pankso@62 34 script for SliTaz.
pankso@62 35
pankso@62 36
pankso@62 37 Missing stuff
pankso@62 38 -------------
pankso@62 39 I'm member og Yad Google group and will mail them about SliTaz using Yad
pankso@62 40 and these missing features. Yad is a small projetc but the maintainer seems
pankso@62 41 a very nice guy who listen th his users :-)
pankso@62 42
pankso@62 43 * It would be nice to have an --exit or --kill option for notification
pankso@62 44 * Not way to have a custom icon for custom button
pankso@62 45
pankso@62 46
pankso@62 47 ================================================================================