Nette Documentation Preview

syntax 
Міграція з Twig на Latte
************************

.[perex]
Переносите проєкт, написаний на Twig, на сучасніший Latte? Ми маємо для вас інструмент, який полегшить міграцію. [Спробуйте онлайн |https://twig2latte.nette.org].

Інструмент можна завантажити з [GitHub|https://github.com/nette/latte-tools] або встановити за допомогою Composer:

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

Конвертер не використовує прості заміни за допомогою регулярних виразів, навпаки, використовує безпосередньо Twig-парсер, тому впорається з будь-яким складним синтаксисом.

Для перетворення з Twig на Latte служить скрипт `twig-to-latte.php`:

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


Конвертація
-----------

Перетворення передбачає ручне редагування результату, оскільки конвертацію неможливо виконати однозначно. Twig використовує крапковий синтаксис, де `{{ a.b }}` може означати `$a->b`, `$a['b']` або `$a->getB()`, що неможливо розрізнити під час компіляції. Тому конвертер все перетворює на `$a->b`.

Деякі функції, фільтри або теги не мають аналогів у Latte, або можуть поводитися трохи інакше.


Приклад
-------

Вхідний файл може виглядати, наприклад, так:

```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>
```

Після конвертації в Latte ми отримаємо цей шаблон:

```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>
```

{{leftbar: /@left-menu}}

Міграція з Twig на Latte

Переносите проєкт, написаний на Twig, на сучасніший Latte? Ми маємо для вас інструмент, який полегшить міграцію. Спробуйте онлайн.

Інструмент можна завантажити з GitHub або встановити за допомогою Composer:

composer create-project latte/tools

Конвертер не використовує прості заміни за допомогою регулярних виразів, навпаки, використовує безпосередньо Twig-парсер, тому впорається з будь-яким складним синтаксисом.

Для перетворення з Twig на Latte служить скрипт twig-to-latte.php:

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

Конвертація

Перетворення передбачає ручне редагування результату, оскільки конвертацію неможливо виконати однозначно. Twig використовує крапковий синтаксис, де {{ a.b }} може означати $a->b, $a['b'] або $a->getB(), що неможливо розрізнити під час компіляції. Тому конвертер все перетворює на $a->b.

Деякі функції, фільтри або теги не мають аналогів у Latte, або можуть поводитися трохи інакше.

Приклад

Вхідний файл може виглядати, наприклад, так:

{% 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>

Після конвертації в 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>