By default, the directory /usr/share/torrus/sup/webplain/ is the place for static HTML, CSS stylesheets and images.
The default CSS stylesheet files are installed in this directory. This directory must be configured with SetHandler default-handler directive.
Additional user-defined stylesheet files may be added in
webplain directory.
The default HTML templates that come with the Torrus distribution use the
global configuration variable $Torrus::Renderer::stylesheet
, which is set
in torrus-config.pl and may be overwritten in torrus-siteconfig.pl.
All generated HTML and graphical images are cached twice: first on the server, and then in your browser. Thus, if you change somehow the HTML appearance of your Torrus installation, you need to clean both caches:
torrus clearcache
This will clear the cache on the server. Then you may use your browser's ``reload'' button, or clear the whole browser cache.
The following variables may need to be set in your /etc/torrus/conf/torrus-siteconfig.pl file:
$Torrus::Renderer::companyName
$Torrus::Renderer::companyURL
$Torrus::Renderer::rendererURL
'/torrus'
. A URL that points to Torrus renderer.
$Torrus::Renderer::plainURL
'/torrus/plain'
. A URL that points to Torrus plain files directory.
Normally CSS stylesheet files are resided there..
$Torrus::ApacheHandler::authorizeUsers
1
. When true, the web interface users are required to log in.
For more documentation, see <http://perl.apache.org/>.
The whole output generation is performed by the Torrus::ApacheHandler
class.
However, you still need access to the plain directory where your CSS
resides. Typical Apache configuration would look like follows. Make sure
your configuration does not contain tab characters:
Alias /torrus/plain "/usr/share/torrus/sup/webplain" PerlRequire "/usr/share/torrus/conf_defaults/webmux.pl" <Location /torrus> SetHandler perl-script PerlHandler Torrus::ApacheHandler </Location> <Location /torrus/plain/> SetHandler default-handler Options None </Location>
The base URL would be in this case:
http://yourhost/torrus/
Note: Apache 2.0 support in Torrus is currently in its early development stage.
Note: As of now, libapreq2
library is not released yet, and only the
development version is available. You have to download and install it
manually.
mod_perl version 1.99_15 or later is supported. To the moment,
libapreq2
version 2.04_03-dev
is tested.
Make sure you use webmux2.pl
and Torrus::Apache2Handler
in your
configuration.
SetHandler modperl
directive should give better performance
than SetHandler perl-script
. Both Perl handlers work the same way
with Torrus.
Typical Apache 2.0 configuration follows:
Alias /torrus/plain "/usr/share/torrus/sup/webplain" PerlRequire "/usr/share/torrus/conf_defaults/webmux2.pl" <Location /torrus> SetHandler modperl PerlResponseHandler Torrus::Apache2Handler </Location> <Location /torrus/plain/> SetHandler default-handler Options None </Location>
The base URL would be in this case:
http://yourhost/torrus/
The following CGI parameters are recognized by mod_perl handler:
/
) is displayed.
view
name for displaying the tree element.
If not specified, the defaul view is used.
zdump(8)
for testing.
rrdtool
(see
RRDTool manuals).
hidden
parameter set to yes
.
All other parameters whose name starts with capital letter, are passed to the HTML template as-is, and may be used for your custom purposes.
Copyright (c) 2002-2005 Stanislav Sinyagin <ssinyagin@yahoo.com>