tazpanel view README @ rev 47
Move old upgreadeable command to 'up' and small edit
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Fri Apr 08 20:17:30 2011 +0200 (2011-04-08) |
| parents | 13b1019d68d8 |
| children | cf15cb2ff715 |
line source
1 SliTaz Web Control Panel
2 ================================================================================
5 Tazpanel is the SliTaz Control Panel, a web interface who let you manage the
6 full system in a redically simple way. The output xHTML code is valid xHTML 5
7 and all theming is done with standard CSS 3.
10 Use it!
11 ------
12 You can clone the tazpanel repo into /var/www/tazpanel and work on this
13 copy or clone it someweher esle and 'make install'. After, add tazpanel to
14 your /etc/hosts, type './tazpanel start' to start the server and go to the
15 URL: http://tazpanel:8090 Panel user and password is defined in httpd.conf
16 and default is root:root
19 i18n
20 ----
21 TazPanel have been coded from the beginning with gettext support. Please
22 forget 'echo' and use gettext, but remember that gettext "" is equivalent
23 to echo -n. All script use the same TEXTDOMAIN and the same pot files, all
24 translations goes in the po/ folder. To start a new translation please
25 use msginit from the pot file directory. Example for French/France
26 locale (fr_FR):
28 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
30 To update all translations from a newly updated the pot file:
32 $ make msgmerge
35 User interface
36 --------------
37 If you develope an official SliTaz GUI for TazPanel, please follow the style.
38 If you need more CSS markup and you not a coder, please ask an official
39 developer the better way to implement your idea. TazPanel is fully themable
40 and more than one theme can be installed, this will let us make packages
41 for TazPanel style! All the GUI is done with xHTML 5 and CSS 3, some
42 javascript can be used, but with precaution... one more time, it's better
43 to check with a main contributor before adding to much stuff, the goal is,
44 as for the all SliTaz project: KISS
47 CGI template and files
48 ----------------------
49 To start or test new function with TazPanel you will find a a file in
50 utils/template.cgi that need to be in the $PANEL root to work, all TazPanel
51 CGI scripts are in that location. If you think your code is too big to fit
52 in an other script you can eventually creat a new CGI page and update all
53 links, but please to talk to the AUTHORS before.
55 * index.cgi Main Tazpanel CGI script (some stuff may be splited
56 into users.cgi, boot.cgi, etc if too big or slow)
57 * network.cgi All related stuff to networking (eth, wifi, servives)
58 * pkgs.cgi Tazpkg packages CGI interface
59 * system.cgi System settings and services such as time, users
60 accounts, locales or daemons management
61 * live.cgi All tools related to Live systems (CD, USB, Frugal)
62 * hardware.cgi Devices drivers, firmware, printing
64 For common function have a look to lib/libtazpanel you may founf functions
65 yoou need already coded such as xhtml_header to get the style header.html
66 in you CGI script. For the loading message you can use loading_msg. When
67 cat is used: `gettext "Text to translate"`
70 Web server
71 ----------
72 Tazpanel can run with Busybox httpd applet or LightTPD an propably Apache.
73 Start the webserver with custom config to listen only on local port for
74 security reason since we run as root to perform system actions, example:
76 # httpd -p 8090 u root -c /etc/slitaz/httpd.conf
78 Or use tazpanel cmdline:
80 # ./tazpanel start