Nes

 view release on metacpan or  search on metacpan

lib/Nes/Tutorial.es.pod  view on Meta::CPAN

 
Configurar Nes

Nes requiere la configuración de cgi-bin y del archivo .htaccess del 
directorio donde residen plantillas Nes.

Para activar y configurar Nes usa la utilidad: set_nes_site

Ejemplos:

  Activar Nes en /usr/lib/cgi-bin:
    set_nes_site --cgi_dir=/usr/lib/cgi-bin
    
  Configurar Nes para el directorio /var/www/myweb:
    set_nes_site --dir_cfg=/var/www/myweb
    
  Configurar Nes para todo el sitio:
    set_nes_site --dir_cfg=/var/www  
   
  Instalar los test y ejemplos en /var/www/test_nes:
    set_nes_site --from_exam=hello_nes --to_exam=/var/www/test_nes
    
  Más ayuda:
    set_nes_site --help    
    
  * Cambia /usr/lib/cgi-bin and /var/www por tu ruta.
 
Por favor lee el archivo README.

=head1 Crear el espacio de trabajo para el Tutorial

Asumimos que ya está instalado Nes y activado para cgi-bin.

Según tu distribución el 'web root directory' puede ser /var/www/html, 
/var/www/htdocs, etc.

Para este Tutorial asumimos que el 'web root directory' es /var/www, si
en tu caso no es así, cambialo por el tuyo a lo largo del tutorial.

Crear el directorio de trabajo en tu web root director con el 
nombre nes_tutorial:

    mkdir /var/www/nes_tutorial

El siguiente paso es hacer que en este directorio puedan ejecutarse
plantillas Nes, se hace con el comando:

    set_nes_site

Configurar:

    set_nes_site --dir_cfg=/var/www/nes_tutorial

Con esto hemos creado un archivo .htaccess con la configuración
para que las plantillas Nes se pueden ejecutar en este directorio.

El archivo .nes.cfg sirve para configurar Nes y también para tu propio
script o aplicación Perl. Hay un valor que necesita ser cambiado,
de lo contrario Nes lanzará una advertencia:

    private_key

Es una contraseña utilizada para cifrar los datos tales como cookies, 
así que es muy importante dar un valor a private_key.

Cera un arcivo en /var/www/nes_tutorial con el nombre .nes.cfg, con
el siguiente contenido.

/var/www/nes_tutorial/.nes.cfg:

    private_key      = ChangeIt
    nes_tutorial_var = test variable

Cambia 'ChangeIt' por la contraseña que tu quieras. Y con esto 
nes_tutorial está preparado para funcionar.

=head1 Crear la primera plantilla Nes

Las plantillas Nes tienen la extensión .nhtml, cualquier archivo con esta 
extensión en el directorio nes_tutorial, será tratada como una plantilla de Nes.

Crea un archivo llamado 'nes_01.nhtml' en 'nes_tutorial' con el siguiente 
contenido:

    <html>
      <head>
        <title>Nes Tutorial</title>
      </head>
      <body>
      <b>Hello Nes Tutorial</b>
      </body>
    </html>

Para ver si funciona:

    http://yousite/nes_tutorial/nes_01.nhtml

* Cambia 'yousite' por tu dominio o por 'localhost'

'nes_01.nhtml' no tiene ninguna característica especial, es sólo HTML. 
Para incluir contenido dinámico, debe informar a Nes que ejecute un script 
para esta plantilla.

Por tanto, necesitamos un script en Perl. Crea un archivo llamado 
'script_02.pl' en 'nes_tutorial' con el siguiente contenido:

    #!/usr/bin/perl

    use Nes;
    my $nes = Nes::Singleton->new();

    $nes->out();

    1; 

Es muy importante que los scripts Nes devuelvan 1, o dará un error.
Otra característica es que no necesitas permiso de ejecución para ejecutar
el script, a menos que desees ejecutar el script y no la plantilla.

Ahora le decimos a la plantilla que el script es 'script_02.pl' con el
Tag '{: NES 1.0 ( 'script_02.pl' ) :}'

Por lo tanto, crea una nueva plantilla con el nombre 'nes_02.nhtml' y
el siguiente contenido:

    {: NES 1.0 ( 'script_02.pl' ) :}
    <html>
      <head>
        <title>Nes Tutorial</title>
      </head>
      <body>



( run in 1.582 second using v1.01-cache-2.11-cpan-39bf76dae61 )