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.