# Шаблоны кода

Шаблоны - это заранее подготовленный код, которой вставляется в редактор, после ввода имени шаблона и нажатия `F2`. Вызвать список шаблонов можно комбинацией `Ctrl+J`.

Например, напишите`for` и нажмите `F2`. Редактор вставит следующий код:

```
for  =  to  // step 1

end // for
```

## Типы шаблонов

Существует два типа шаблонов: *общие* и *эксклюзивные*. Общие доступны во всех [режимах редактирования](https://docs.sannybuilder.com/ru/edit-modes). Они содержатся в файле `data\templates.txt`. Эксклюзивные шаблоны разработаны под конкретный режим. Путь к файлу с эксклюзивными шаблонами задается через ключ [`template`](https://docs.sannybuilder.com/ru/edit-modes/..#templates) в конфигурации режима редактирования:

```
<templates type="default">@sb:\data\gta3\templates.txt</templates>
```

Редактор объединяет общие и эксклюзивные шаблоны в один список. Эксклюзивный шаблон имеет приоритет над общим шаблоном с такими же именем.

## Синтаксис файла

Каждый файл шаблонов имеет следующий синтаксис:\
Имя шаблона пишется отдельной строкой. После имени должен стоять знак `=`. После `=` можно добавить краткое описание шаблона. Поддерживаются только однострочные описания. После строки с именем записывается содержимое шаблона, каждая строка начинается знаком `=`. Место, куда должен быть помещен курсор после вставки, обозначается символом `|`.

## Добавление новых шаблонов <a href="#adding-a-new-template" id="adding-a-new-template"></a>

Можно сохранить новый шаблон прямо из редактора. Для этого нужно выделить нужный кусок текста и выбрать меню `Сервис->Добавить шаблон`.&#x20;

![](https://2633643746-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0dALM7uq5_eDYhSBjl%2F-MgCrKT6ITHrHRUkyrVl%2F-MgCs2j-tManhUJwfPwl%2Fadd-templates-ru.PNG?alt=media\&token=5e2ae050-1f70-412e-8799-fedbdff4498b)

Введите имя шаблона, описание (необязательно), выберите тип шаблона и нажмите кнопку `OK`. Новый шаблон будет сразу же готов к использованию.

Пользовательские шаблоны сохраняются либо в файл `data\templates.custom.txt` (*общие пользовательские шаблоны*) либо в файл `data\<режим редактирования>\templates.custom.txt`(*эксклюзивные пользовательские шаблоны*). Путь к файлу с эксклюзивными пользовательскими шаблонами может быть изменен в [настройках](https://docs.sannybuilder.com/ru/edit-modes/..#templates) режима редактирования.

{% hint style="info" %}
Сохранение шаблона только для текущего режима возможно, если файл `modes.xml`содержит тэг `<template type="custom">` с именем файла.
{% endhint %}

{% hint style="info" %}
Наличие шаблона с именем `CLEO` разблокирует пункт в главном меню "Новый CLEO скрипт...". Редактор использует этот шаблон для формирования содержимого нового файла.
{% endhint %}