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.