README
======
Nes:
A powerful template system for the Web in Perl.
INSTALLATION
Requires the modules:
Mandatory:
Crypt::CBC
Crypt::Blowfish
IO::String
IO::File
For PHP Wrapper or mod_perl:
Env::C
IPC::Run
For mysql or other:
DBI
DBD::mysql
DBD::Pg
DBD:: ...
For set_nes_site script utility:
File::ShareDir
File::Copy::Recursive
* We recommend installing all modules.
Install as root:
perl Makefile.PL
make
make test
make install
Install locally:
perl Makefile.PL PREFIX=/home/USER/dir
make
make test
make install
* Change /home/USER/dir for you particular path
CONFIGURATION
Nes requires configuration of you cgi-bin and .htaccess for
directory of the Nes templates.
To active and configure Nes use utility: set_nes_site
Configured:
Examples:
Active Nes in /usr/lib/cgi-bin:
set_nes_site --cgi_dir=/usr/lib/cgi-bin
Configure Nes for directory /var/www/myweb:
set_nes_site --dir_cfg=/var/www/myweb
Configure Nes for all site:
set_nes_site --dir_cfg=/var/www
Install hello world and test examples in /var/www/test_nes:
set_nes_site --from_exam=hello_nes --to_exam=/var/www/test_nes
More help:
set_nes_site --help
* Change /usr/lib/cgi-bin and /var/www for you particular path
Configured locally:
For configured Nes locally find you path to Nes.pm and add in
iprefix in cgi_dir and from_exam options.
Examples:
Active Nes in /usr/lib/cgi-bin:
set_nes_site --cgi_dir=/usr/lib/cgi-bin --iprefix=/home/USER/path-to-Nes
More help:
set_nes_site --help
* Change /usr/lib/cgi-bin and /home/USER/path-to-Nes for you particular path
TEST YOU INSTALATION
Active Nes in cgi-bin:
set_nes_site --cgi_dir=/full-path-to/cgi-bin
* include --iprefix option if configured Nes locally.
Install hello world and test examples in directory test_nes:
set_nes_site --from_exam=hello_nes --to_exam=/full-path-to/root-www/test_nes
* include --iprefix option if configured Nes locally.
* change /full-path-to... for you particular path
Test:
http://yousite/test_nes/hello.nhtml
You must see "Hello World!" in this page
http://yousite/test_nes/test.nhtml
You must see "Hello Nes!" and Nes variables in this page
For test is ok make sure your error.log does not contain errors.
SUPPORT AND DOCUMENTATION
After installing, you can find documentation for this module with the
perldoc command.
perldoc Nes
You can also look for information at:
RT, CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Nes
AnnoCPAN, Annotated CPAN documentation
http://annocpan.org/dist/Nes
CPAN Ratings
http://cpanratings.perl.org/d/Nes
Search CPAN
http://search.cpan.org/dist/Nes
Sample to use Nes;
http://nes.sourceforge.net/
Repository
http://github.com/Skriptke/nes
COPYRIGHT AND LICENCE
Copyright (C) 2009 - 2010 Enrique Castañón
This program is free software; you can redistribute itand/or modify it
under the same terms and conditions as GNU Public License (GPL).
This means that you can, at your option, redistribute it and/or modify
it under either the terms the GNU Public License (GPL), or under the
Perl Artistic License.
DISCLAIMER
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Use of this software in any way or in any form, source or binary, is
not allowed in any country which prohibits disclaimers of any implied
warranties of merchantability or fitness for a particular purpose or
any disclaimers of a similar nature.
IN NO EVENT SHALL I BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL,
INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS
SOFTWARE AND ITS DOCUMENTATION (INCLUDING, BUT NOT LIMITED TO, LOST
PROFITS) EVEN IF I HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAG.
