Apache-SetWWWTheme

 view release on metacpan or  search on metacpan

SetWWWTheme.pm  view on Meta::CPAN

be found at CPAN.

=head1 DESCRIPTION

The SetWWWTheme module provides a server-based look-and-feel configuration for
an entire webtree. This module allows the server to introduce a common
navigation side-bar. It also provides mechanisms to control the background
color and background picture for a web page.

This is implemented in a layered fashion. The module first reads the server
directives. This sets defaults, and decides what users may have control
over. Server directives may only be set by the webmasters. Following these,
the module reads local directives. These directives are specified in a file,
and will affect all files in that same directory, as well as subdirectories
underneath it. They are set at the user-level, and so they are subject to
the constraints imposed by the server directives. Finally, the module parses
the individual HTML files. Within a file, an HTML authour may override the
settings given in the local directives. Again, these are subject to the
constraints of the server directives.

Please note that you are not required to change anything in your pages. Your

SetWWWTheme.pm  view on Meta::CPAN

takes the full path to the file name on the file-system -- do not list this
file relative to the document root.

The creation of printable versions of pages has been greatly simplified.  
No longer is any configuration required -- the page is automatically
generated using a GET method.  Adding "?printable" to a URI will 
cause the page to be displayed in a printable manner, for example.

The server-level configuration is primarily to set defaults. It is also to
set restrictions on the configurability of the rest of the site. The
server-level configuration decides whether or not individual authours will
be permitted to, for example, change the background colour and background
image of their web pages.

Once again, the server configuration may make use of all of the following
directives. The server then decides which of these the users may override.

Local configuration

Any authour may create a text file containing directives. The name of this file
is set by the server directive @LOCALCONFIGFILE, with a default of 
LookAndFeelConfig. This file will
affect all HTML files within that directory, as well as any subdirectories.
These directives are subject to the restrictions placed by the server-level
configuration. This file is intended to be used to set common settings for a
tree. For example, one may wish to set the background colour for an entire

gpl.txt  view on Meta::CPAN

apply and the section as a whole is intended to apply in other
circumstances.

It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices.  Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.

This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.

  8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding

templates/Configuration  view on Meta::CPAN

#

#######################################################################

# This is the name of the local configuration file to look for.

@LOCALCONFIGFILE=LOOKANDFEEL;



# This next directive decides whether or not we have a sidebar by
# default.  If it is set to "1", then there will be no sidebar unless
# the users turn it on (if they are allowed to).  
# The ALLOWNOSIDEBAR directive allows the users to toggle it on and
# off. 

@NOSIDEBAR=1;
@ALLOWSIDEBARTOGGLE=1;

# the server configuration gets to decide if mere mortals are allowed
# to change things like the bgcolor and the sidebar colour.  
# 

@ALLOWBODYMOD=1;
@ALLOWSIDEBARMOD=1;

# Here is the default background colour and sidebar colour for all pages
# Reactivate the TEXT directive, if you wish.

@BGCOLOR=#FFFFFF;

templates/LookAndFeelConfig  view on Meta::CPAN

# Put this file into any directory, and it will affect any file within
# that directory and all of its subdirectories.  These files are good
# for setting a look and feel for a set of physically related files.
# For example, say you have a directory of files all on one subject, and
# you decide they should all have a blue background.  You could go
# something like this:

@BGCOLOR=#9999FF;

# Please recall that you can NOT "comment out" a directive.  You must
# deactivate it by separating the "@" from the directive name.  

@ NOSIDEBAR=0;

# That directive above is deactivated.