SliTaz Repositories

     1.1 --- a/README.html	Sun Jul 01 08:46:05 2012 +0100
     1.2 +++ b/README.html	Mon Oct 09 17:15:22 2017 +0100
     1.3 @@ -1,90 +1,58 @@
     1.4 -<h2>SliTaz Web Control Panel</h2>
     1.5 +<section>
     1.6 +	<header>SliTaz Web Control Panel</header>
     1.7 +	<div>
     1.8 +		<p>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 HTML 5 and all theming is done with standard CSS 3. TazPanel is published under a BSD License.</p>
     1.9  
    1.10 -<p>Tazpanel is the SliTaz Control Panel, a web interface which lets you manage the
    1.11 -full system in a radically simple way. The output xHTML code is valid xHTML 5
    1.12 -and all theming is done with standard CSS 3. TazPanel is published under a
    1.13 -BSD License.</p>
    1.14  
    1.15 +		<h3>Use it!</h3>
    1.16  
    1.17 -<h3>Use it!</h3>
    1.18 +		<p>You can clone the tazpanel repo into <tt>/var/www/tazpanel</tt> and work on this copy or clone it somewhere else and <tt>'make install'</tt>. After, add <tt>tazpanel</tt> to your <tt>/etc/hosts</tt>, type <tt>'./tazpanel start'</tt> to start the server and go to the URL: <tt>http://tazpanel:82</tt>. Panel user and password are defined in the <tt>httpd.conf</tt> and default is <tt>root:root</tt></p>
    1.19  
    1.20 -<p>You can clone the tazpanel repo into /var/www/tazpanel and work on this
    1.21 -copy or clone it somewhere else and 'make install'. After, add tazpanel to
    1.22 -your /etc/hosts, type './tazpanel start' to start the server and go to the
    1.23 -URL: http://tazpanel:82. Panel user and password are defined in the 
    1.24 -httpd.conf and default is root:root</p>
    1.25  
    1.26 +		<h3>i18n</h3>
    1.27  
    1.28 -<h3>i18n</h3>
    1.29 +		<p>TazPanel has been coded from the beginning with gettext support. Please forget <tt>'echo'</tt> and use <tt>gettext</tt>, but remember that <tt>gettext ""</tt> is equivalent to <tt>echo -n</tt>. All scripts use the same <tt>TEXTDOMAIN</tt> and the same pot files, and all translations go in the <tt>po/</tt> folder. To start a new translation please use <tt>msginit</tt> from the pot file directory. Example for French/France locale (fr_FR):</p>
    1.30 +		<pre>$ msginit -l fr_FR -o fr.po -i tazpanel.pot</pre>
    1.31 +		<p>To update all translations from a newly updated pot file:</p>
    1.32 +		<pre>$ make msgmerge</pre>
    1.33  
    1.34 -<p>TazPanel has been coded from the beginning with gettext support. Please
    1.35 -forget 'echo' and use gettext, but remember that gettext "" is equivalent
    1.36 -to echo -n. All scripts use the same TEXTDOMAIN and the same pot files, and 
    1.37 -all translations go in the po/ folder. To start a new translation please
    1.38 -use msginit from the pot file directory. Example for French/France
    1.39 -locale (fr_FR):</p>
    1.40  
    1.41 -<pre>$ msginit -l fr_FR -o fr.po -i tazpanel.pot</pre>
    1.42 +		<h3>User interface</h3>
    1.43  
    1.44 -<p>To update all translations from a newly updated pot file:</p>
    1.45 +		<p>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 official developer for the best way to implement your idea. TazPanel is fully themable and more than one theme can be installed, this will allow us to make packages in a TazPanel style! All the GUI is done with HTML 5 and CSS 3; some javascript 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</p>
    1.46  
    1.47 -<pre>$ make msgmerge</pre>
    1.48  
    1.49 +		<h3>CGI template and files</h3>
    1.50  
    1.51 -<h3>User interface</h3>
    1.52 +		<p>To start or test a new function with TazPanel you will find a file in <tt>utils/template.cgi</tt> that needs to be in the <tt>$PANEL</tt> root to work, all TazPanel CGI scripts are in that location. If you think your code is too big to fit in another script you can eventually create a new CGI page and update all links, but please to talk to the AUTHORS beforehand.</p>
    1.53 +		<dl>
    1.54 +			<dt>index.cgi</dt>
    1.55 +				<dd>Main Tazpanel CGI script</dd>
    1.56 +			<dt>boot.cgi</dt>
    1.57 +				<dd>All what happens before login</dd>
    1.58 +			<dt>network.cgi</dt>
    1.59 +				<dd>All related stuff to networking (Ethernet, Wi-Fi, services)</dd>
    1.60 +			<dt>pkgs.cgi</dt>
    1.61 +				<dd>Tazpkg packages CGI interface</dd>
    1.62 +			<dt>settings.cgi</dt>
    1.63 +				<dd>System settings and services such as time, users accounts, locales or daemons management</dd>
    1.64 +			<dt>live.cgi</dt>
    1.65 +				<dd>All tools related to Live systems (CD, USB, Frugal)</dd>
    1.66 +			<dt>hardware.cgi</dt>
    1.67 +				<dd>Devices drivers, firmware, printing</dd>
    1.68 +			<dt>help.cgi</dt>
    1.69 +				<dd>Cat the html doc and this README file</dd>
    1.70 +		</dl>
    1.71 +		<p>For common functions have a look at <tt>lib/libtazpanel</tt>, where you may find functions you need already coded such as a <tt>xhtml_header</tt> to get the style <tt>header.html</tt> in your CGI script. For the loading message you can use <tt>loading_msg</tt>. When cat is used:</p>
    1.72 +		<pre>$(gettext "Text to translate")</pre>
    1.73  
    1.74 -<p>If you develop an official SliTaz GUI for TazPanel, please follow the default 
    1.75 -style. If you need more CSS markup and you are not a coder, please ask an 
    1.76 -official developer for the best way to implement your idea. TazPanel is fully 
    1.77 -themable and more than one theme can be installed, this will allow us to make 
    1.78 -packages in a TazPanel style! All the GUI is done with xHTML 5 and CSS 3; some
    1.79 -javascript can be used, but with precautions... one more time, it's better
    1.80 -to check with a main contributor before adding too much stuff; the goal is,
    1.81 -as for all the SliTaz projects: KISS</p>
    1.82  
    1.83 +		<h3>Web server</h3>
    1.84  
    1.85 -<h3>CGI template and files</h3>
    1.86 +		<p>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:</p>
    1.87 +		<pre># httpd -p 82 u root -c /etc/slitaz/httpd.conf</pre>
    1.88 +		<p>Or use a tazpanel cmdline:</p>
    1.89 +		<pre># ./tazpanel start</pre>
    1.90  
    1.91 -<p>To start or test a new function with TazPanel you will find a file in
    1.92 -utils/template.cgi that needs to be in the $PANEL root to work, all TazPanel
    1.93 -CGI scripts are in that location. If you think your code is too big to fit
    1.94 -in another script you can eventually create a new CGI page and update all
    1.95 -links, but please to talk to the AUTHORS beforehand.</p>
    1.96 -
    1.97 -<dl>
    1.98 -	<dt>index.cgi</dt>
    1.99 -		<dd>Main Tazpanel CGI script</dd>
   1.100 -	<dt>boot.cgi</dt>
   1.101 -		<dd>All what happens before login</dd>
   1.102 -	<dt>network.cgi</dt>
   1.103 -		<dd>All related stuff to networking (eth, wifi, services)</dd>
   1.104 -	<dt>pkgs.cgi</dt>
   1.105 -		<dd>Tazpkg packages CGI interface</dd>
   1.106 -	<dt>settings.cgi</dt>
   1.107 -		<dd>System settings and services such as time, users accounts,
   1.108 -		locales or daemons management</dd>
   1.109 -	<dt>live.cgi</dt>
   1.110 -		<dd>All tools related to Live systems (CD, USB, Frugal)</dd>
   1.111 -	<dt>hardware.cgi</dt>
   1.112 -		<dd>Devices drivers, firmware, printing</dd>
   1.113 -	<dt>help.cgi</dt>
   1.114 -		<dd>Cat the html doc and this README file</dd>
   1.115 -</ul>
   1.116 -
   1.117 -<p>For common functions have a look at lib/libtazpanel, where you may find functions
   1.118 -you need already coded such as a xhtml_header to get the style header.html
   1.119 -in your CGI script. For the loading message you can use loading_msg. When
   1.120 -cat is used: `gettext "Text to translate"`</p>
   1.121 -
   1.122 -
   1.123 -<h3>Web server</h3>
   1.124 -
   1.125 -<p>Tazpanel can run with the Busybox httpd applet or LightTPD and probably Apache.
   1.126 -Start the webserver with a custom config to listen only on a local port for
   1.127 -security reasons since we run as root to perform system actions, example:</p>
   1.128 -
   1.129 -<pre># httpd -p 82 u root -c /etc/slitaz/httpd.conf</pre>
   1.130 -
   1.131 -<p>Or use a tazpanel cmdline:</p>
   1.132 -
   1.133 -<pre># ./tazpanel start</pre>
   1.134 +	</div>
   1.135 +</section>