-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME
86 lines (63 loc) · 3.48 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
SliTaz Web Control Panel
================================================================================
Tazpanel is the SliTaz Control Panel, a web interface which lets you manage the
full system in a radically simple way. The output xHTML code is valid xHTML 5
and all theming is done with standard CSS 3. TazPanel is published under
a BSD License.
Use it!
-------
You can clone the tazpanel repo into /var/www/tazpanel and work on this copy or
clone it somewhere else and 'make install'. After, add tazpanel to your
/etc/hosts, type './tazpanel start' to start the server and go to the URL:
http://tazpanel:82. Panel user and password are defined in the httpd.conf and
default is root:root
i18n
----
TazPanel has been coded from the beginning with gettext support. Please forget
'echo' and use gettext, but remember that gettext "" is equivalent to echo -n.
All scripts use the same TEXTDOMAIN and the same pot files, and all translations
go in the po/ folder. To start a new translation please use msginit from the pot
file directory. Example for French/France locale (fr_FR):
$ msginit -l fr_FR -o fr.po -i tazpanel.pot
To update all translations from a newly updated pot file:
$ make msgmerge
User interface
--------------
If you develop an official SliTaz GUI for TazPanel, please follow the default
style. If you need more CSS markup and you are not a coder, please ask an offi-
cial developer for the best way to implement your idea. TazPanel is fully thema-
ble and more than one theme can be installed, this will allow us to make packa-
ges in a TazPanel style! All the GUI is done with xHTML 5 and CSS 3; some java-
script can be used, but with precautions... one more time, it's better to check
with a main contributor before adding too much stuff; the goal is, as for all
the SliTaz projects: KISS
CGI template and files
----------------------
To start or test a new function with TazPanel you will find a file in
utils/template.cgi that needs to be in the $PANEL root to work, all TazPanel CGI
scripts are in that location. If you think your code is too big to fit in ano-
ther script you can eventually create a new CGI page and update all links, but
please to talk to the AUTHORS beforehand.
* index.cgi Main TazPanel CGI script
* boot.cgi All what happens before login
* network.cgi All related stuff to networking (Ethernet, Wi-Fi, services)
* pkgs.cgi TazPkg packages CGI interface
* settings.cgi System settings and services such as time, users accounts,
locales or daemons management
* live.cgi All tools related to Live systems (CD, USB, Frugal)
* hardware.cgi Devices drivers, firmware, printing
* help.cgi Cat the html doc and this README file
For common functions have a look at lib/libtazpanel, where you may find functi-
ons you need already coded such as a xhtml_header to get the style header.html
in your CGI script. For the loading message you can use loading_msg. When cat is
used:
$(gettext "Text to translate")
Web server
----------
Tazpanel can run with the Busybox httpd applet or LightTPD and probably Apache.
Start the webserver with a custom config to listen only on a local port for
security reasons since we run as root to perform system actions, example:
# httpd -p 82 u root -c /etc/slitaz/httpd.conf
Or use a tazpanel cmdline:
# ./tazpanel start
================================================================================