Esta sección cubrirá sólo unos pocos aspectos básicos de la escritura de las plantillas de mason, especialmente aquellos detalles relacionados con eBox. Si necesita información concreta acerca de algún aspecto debería revistar la documentación de mason o el libro de mason. Más ejemplos se pueden encontrar en Capítulo 7.

La primera cosa que la plantilla de mason debe tener es la declaración de los argumentos que espera. Únicamente se ha de escribir el nombre de las variables, una por línea y nada más. Los argumentos declarados como arrays en la plantilla serán pasados como la referencia a un array por el CGI.

En nuestro ejemplo vamos a enviar un array con nombres a la plantilla, y la plantilla saludará a cada uno de ellos por separado. Utilizamos un array vacío como valor por defecto para la variable, aunque los valores por defecto son opcionales. Si no se le da nada y ni se le pasa ese argumento a la plantilla, se lanzará una excepción.

<%args>
	@people => ()
</%args>

La siguiente parte es la sección de inicialización. En esta sección podemos escribir código perl normal. Es opcional y la mayor parte de las veces no necesario. Sin embargo, todas las plantillas de eBox tienen uno, porque siempre está la necesidad de tener i18n, por lo que importaremos EBox::Gettext:

<%init>
use EBox::Gettext;
</%init>

Ahora podemos escribir el cuerpo de la plantilla. La idea es escribir únicamente HTML y utilizar un par de características sintácticas para insertar código de perl cuando es necesario. Primero, aprenderemos a controlar el flujo de la plantilla. Todas las lineas que comiencen por % son interpretadas como código de perl.

<ul>
% foreach my $person (@people) {
	<li>Hello</li>
% }
</ul>

Queremos imprimir el nombre de una persona por cada elemento de la lista. Incluir expresiones de perl en las marcas especiales <% %> imprime el valor de la expresión en la salida de la plantilla. Vamos a utilizar esta característica para imprimir el nombre de la persona y traducir la cadena "Hola" (internacionalización es explicada en Sección 2.4).

<ul>
% foreach my $person (@people) {
	<li><% __('Hola ') %> <% $person %></li>
% }
</ul>

La macro m4 de ebox exporta la ruta de instalación para las plantillas de mason como TEMPLATESPATH, por lo que deberían instalarse bajo ese directorio, posiblemente creando un subdirectorio para el módulo. Cuando se necesite referenciar una plantilla en el código, se puede usar una ruta relativa a TEMPLATESPATH. Siguiendo nuestro ejemplo, se usará un subdirectorio llamado hello para nuestras plantillas, y colocaremos una plantilla denominada world.mas en él.

<div class='class-name'>
	Mensaje para el usuario.
</div>

<table class='dataTable'>
	<caption><% __('Object List') %></caption>
	<thead>
		<tr>
			<th class='tleft'><% __('Name') %></th>
			<th class='thOptions'><% __('Action') %></th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td></td>
			<td class='tcenter'>
				<a href='Del?objectname=<% $obj->{'name'} %>'>
						<img src='/data/images/delete.gif'
						     title="<% __('Delete') %>"
						     alt="<% __('Delete') %>"/>
				</a>
			</td>
		</tr>
	</tbody>
</table>

<table class='formTable'>
	<tr>
		<td class='tright'>
			<span class='ftitle'><% __('Name') %>:</span>	
		</td>
		<td>
			<input class='inputText' type='text' name='name' />
		</td>
	</tr>
	<tr>
		<td></td>
		<td>
			<input class='inputButton' type='submit' />
		</td>
	</tr>
</table>