Nette Documentation Preview

syntax 
Migración de Twig a Latte
*************************

.[perex]
¿Está convirtiendo a Latte, más moderno, un proyecto escrito en Twig? Tenemos una herramienta que le facilitará la migración. [Pruébela en línea |https://fiddle.nette.org/twig2latte/].

Puede descargar la herramienta desde [GitHub|https://github.com/nette/latte-tools] o instalarla con Composer:

```shell
composer create-project latte/tools
```

El conversor no usa simples sustituciones con expresiones regulares, sino el analizador real de Twig, lo que le permite manejar una sintaxis arbitrariamente compleja.

Para convertir de Twig a Latte se usa el script `twig-to-latte.php`:

```shell
php twig-to-latte.php input.twig.html [output.latte]
```


Conversión
----------

La conversión exige editar el resultado a mano, porque no se puede realizar de forma inequívoca. Twig usa la sintaxis de punto, donde `{{ a.b }}` puede significar `$a->b`, `$a['b']` o `$a->getB()`, algo que no se puede distinguir durante la compilación. Por eso el conversor lo traduce todo a `$a->b`.

Algunas funciones, filtros o etiquetas de Twig pueden no tener equivalente directo en Latte, o comportarse de forma ligeramente distinta.


Ejemplo
-------

Un archivo de entrada podría tener este aspecto:

```twig
{% use "blocks.twig" %}
<!DOCTYPE html>
<html>
	<head>
		<title>{{ block("title") }}</title>
	</head>
	<body>
		<h1>{% block title %}My Web{% endblock %}</h1>
		<ul id="navigation">
		{% for item in navigation %}
			{% if not item.active %}
				<li>{{ item.caption }}</li>
			{% else %}
				<li><a href="{{ item.href }}">{{ item.caption }}</a></li>
			{% endif %}
		{% endfor %}
		</ul>
	</body>
</html>
```

Tras convertirlo a Latte obtenemos esta plantilla:

```latte
{import 'blocks.latte'}
<!DOCTYPE html>
<html>
	<head>
		<title>{include title}</title>
	</head>
	<body>
		<h1>{block title}My Web{/block}</h1>
		<ul id="navigation">
		{foreach $navigation as $item}
			{if !$item->active}
				<li>{$item->caption}</li>
			{else}
				<li><a href="{$item->href}">{$item->caption}</a></li>
			{/if}
		{/foreach}
		</ul>
	</body>
</html>
```

Migración de Twig a Latte

¿Está convirtiendo a Latte, más moderno, un proyecto escrito en Twig? Tenemos una herramienta que le facilitará la migración. Pruébela en línea.

Puede descargar la herramienta desde GitHub o instalarla con Composer:

composer create-project latte/tools

El conversor no usa simples sustituciones con expresiones regulares, sino el analizador real de Twig, lo que le permite manejar una sintaxis arbitrariamente compleja.

Para convertir de Twig a Latte se usa el script twig-to-latte.php:

php twig-to-latte.php input.twig.html [output.latte]

Conversión

La conversión exige editar el resultado a mano, porque no se puede realizar de forma inequívoca. Twig usa la sintaxis de punto, donde {{ a.b }} puede significar $a->b, $a['b'] o $a->getB(), algo que no se puede distinguir durante la compilación. Por eso el conversor lo traduce todo a $a->b.

Algunas funciones, filtros o etiquetas de Twig pueden no tener equivalente directo en Latte, o comportarse de forma ligeramente distinta.

Ejemplo

Un archivo de entrada podría tener este aspecto:

{% use "blocks.twig" %}
<!DOCTYPE html>
<html>
	<head>
		<title>{{ block("title") }}</title>
	</head>
	<body>
		<h1>{% block title %}My Web{% endblock %}</h1>
		<ul id="navigation">
		{% for item in navigation %}
			{% if not item.active %}
				<li>{{ item.caption }}</li>
			{% else %}
				<li><a href="{{ item.href }}">{{ item.caption }}</a></li>
			{% endif %}
		{% endfor %}
		</ul>
	</body>
</html>

Tras convertirlo a Latte obtenemos esta plantilla:

{import 'blocks.latte'}
<!DOCTYPE html>
<html>
	<head>
		<title>{include title}</title>
	</head>
	<body>
		<h1>{block title}My Web{/block}</h1>
		<ul id="navigation">
		{foreach $navigation as $item}
			{if !$item->active}
				<li>{$item->caption}</li>
			{else}
				<li><a href="{$item->href}">{$item->caption}</a></li>
			{/if}
		{/foreach}
		</ul>
	</body>
</html>