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 )