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

makegraphs: tune cpuinfo
author Pascal Bellard <pascal.bellard@slitaz.org>
date Fri Jan 15 08:08:28 2021 +0000 (2021-01-15)
parents 2ed2aa3f16a9
children
rev   line source
pankso@62 1 Yad on SliTaz
pankso@62 2 ================================================================================
pankso@62 3
pankso@62 4
paul@265 5 Yad is the new preferred way to create GUI boxes for the 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
paul@66 8 by CGI scripts and use xHTML 5 and CSS 3 for the UI. Yad is a powerful tool
paul@66 9 which supports the latest GTK actions and goodies. With our original GTKdialog
paul@66 10 scripts some nice features were missing like for example --notification or
pankso@62 11 ENTER for event (with gtkdialog one must press a button).
pankso@62 12
paul@76 13 If you're motivated to code, please have a look at the TODO file and continue
pankso@62 14 reading :-)
pankso@62 15
pankso@62 16
paul@265 17 Coding guidelines
pankso@62 18 ----------------
paul@66 19 Use a function and a function_main for main= variable to keep data,
paul@66 20 that way we can have yad boxes commands separated from shell scripts.
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'
paul@66 28 as much 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
paul@66 32 coding from that :-). Tazyad is commented to help you get started.
paul@66 33 You can also have a look to tazpkg-notify which 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 -------------
paul@66 39 I'm a member of Yad Google group and will mail them about SliTaz using Yad
paul@66 40 and these missing features. Yad is a small project but the maintainer seems
paul@66 41 a very nice guy who listens to his users :-)
pankso@62 42
pankso@62 43 * It would be nice to have an --exit or --kill option for notification
paul@66 44 * No way to have a custom icon for custom button
pankso@62 45
pankso@62 46
pankso@62 47 ================================================================================