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

Шаблоны - это заранее подготовленный код, которой вставляется в редактор, после ввода имени шаблона и нажатия `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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sannybuilder.com/ru/edit-modes/code-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.