Синтаксис SPINTAX: Вариации и Вложенные Функции
🎯 Назначение документа
Этот документ описывает все поддерживаемые синтаксические конструкции для создания вариативного текста в сообщениях. Используя эти конструкции, вы можете создавать разнообразные уникальные сообщения из одного шаблона.
📋 Базовые Конструкции
1. Выбор одного из вариантов: {вариант1|вариант2|…}
Синтаксис: {вариант1|вариант2|вариант3}
Что делает: Случайно выбирает ОДИН вариант из списка
Примеры:
{Привет|Здравствуйте}→ «Привет» ИЛИ «Здравствуйте»{Доброе утро|Добрый день|Добрый вечер}→ выбирается один из трех вариантов{как дела|как поживаете|что нового}→ один из вариантов вопроса
Зачем использовать: Создает естественную вариативность приветствий, вопросов, завершений
2. Перестановка всех вариантов: [+X+A|B|C|D|…]
Синтаксис: [+X+A|B|C|D|...]
Что делает: Переставляет все варианты через разделитель X. X может быть любым символом или текстом между плюсами.
Примеры:
[+, +яблоко|груша|банан]→ «яблоко, груша, банан» (X = «, «)[+ +первый|второй|третий]→ «первый второй третий» (X = » «)[+ и +первый|второй]→ «первый и второй» (X = » и «)[+ / +один|два|три]→ «один / два / три» (X = » / «)[+-+дата1|дата2|дата3]→ «дата1-дата2-дата3» (X = «-«)
Зачем использовать: Когда нужно перечислить несколько элементов в одном сообщении
🔄 Вложенные Конструкции
Вложенный выбор {вариант1|вариант2{подвариант1|подвариант2}}
Синтаксис: Фигурные скобки внутри фигурных скобок
Примеры:
{Добрый {утро|день|вечер}|Здравствуйте}
→ «Добрый утро» ИЛИ «Добрый день» ИЛИ «Добрый вечер» ИЛИ «Здравствуйте»{Привет {мир|вселенная}|Здравствуйте, друзья}
→ «Привет мир» ИЛИ «Привет вселенная» ИЛИ «Здравствуйте, друзья»
Зачем использовать: Создание более сложных и естественных комбинаций
Вложенное объединение [+разделитель+вариант1|{подвариант1|подвариант2}]
Синтаксис: Фигурные скобки внутри квадратных скобок
Примеры:
[+ +я|ты|он]→ «я ты он»[+, +{Привет|Здравствуйте}|Добрый день]
→ «Привет, Добрый день» ИЛИ «Здравствуйте, Добрый день»
Зачем использовать: Объединение элементов, среди которых есть варианты
🎨 Комбинированные Примеры
Пример 1: Личное письмо
{Привет|Здравствуйте}, {{Имя}}! {Как дела|Что нового}? Хочу предложить вам [+, +выгодное предложение|интересную услугу|отличное решение].Результат (один из вариантов):
Здравствуйте, Иван! Что нового? Хочу предложить вам интересную услугу, отличное решение.Пример 2: Приглашение на событие
{Доброе утро|Добрый день}, {{Имя}}! Приглашаем вас на [+, +конференцию|выставку|семинар]. Даты: [+-+17.03|18.03|19.03].Результат (один из вариантов):
Добрый день, Ольга! Приглашаем вас на выставку, семинар. Даты: 17.03-18.03-19.03.Пример 3: Маркетинговое предложение
{{Имя}}, у нас {новая акция|специальное предложение}! Скидка {20|30|50}% на [+, +мужскую одежду|женскую одежду|детскую одежду].Результат (один из вариантов):
Иван, у нас специальное предложение! Скидка 30% на мужскую одежду, детскую одежду.📊 Сравнение Конструкций
| Конструкция | Результат | Когда использовать |
|---|---|---|
{А|Б|В} | ОДИН вариант случайно | Приветствие, вопрос, завершение |
[+, +А|Б|В] | ВСЕ варианты через запятую | Перечисление, список |
{А{Б|В}|Г} | ОДИН из: «АБ», «АВ» или «Г» | Сложные варианты |
[+, +{А|Б}|{В|Г}] | Объединение случайных вариантов | Гибкое перечисление |
⚙️ Технические Детали
Обработка в Коде
Порядок обработки:
- Сначала подставляются плейсхолдеры
{{KEY}}из таблицы Excel - Затем обрабатываются конструкции
{вариант1|вариант2}— выбор случайного варианта (выбирается ОДИН) - После обрабатываются конструкции
[+X+Y]— перестановки (все варианты через разделитель X) - Процесс повторяется до 50 раз для вложенных конструкций
Как работает [+X+Y]:
X— это разделитель (может быть любой символ или текст: запятая, пробел, слово и т.д.)Y— это варианты, разделенные через|- Все варианты из
Yпереставляются (перемешиваются) и объединяются через разделительX - Пример:
[+, +А|Б|В]→ разделитель,, результат: «А, Б, В» (или другая перестановка после перемешивания)
Ограничения
⚠️ Важно:
- Максимум 50 итераций для вложенных конструкций
- Рекомендуется не более 3 уровней вложенности
- Пустые варианты автоматически удаляются
- Незакрытые скобки могут привести к неожиданным результатам
💡 Практические Советы
Совет 1: Используйте правильную конструкцию
❌ Неправильно: {Привет, яблоко, груша, банан} — это не перечисление, а выбор
✅ Правильно: {Привет|Здравствуйте}, [+, +яблоко|груша|банан]
Совет 2: Избегайте излишней вложенности
❌ Слишком сложно: {А{Б{В{Г|Д}|Е}|Ж}|И}
✅ Проще и понятнее: {А|Б|В|Г} или разбить на несколько блоков
Совет 3: Выбирайте правильный разделитель
Разделителем может быть любой символ или текст между плюсами:
[+, +]— через запятую и пробел («, «)[+ +]— через пробел (» «)[+ и +]— через » и «[+-+]— через дефис («-«)[+ / +]— через » / «[+ любое слово +]— через ваше слово
Совет 4: Комбинируйте с плейсхолдерами
{Привет|Здравствуйте}, {{Имя}}! {Как дела|Что нового}?
Ваш {номер|телефон}: {{Телефон}}.Совет 5: Вариации в Excel
Можно указывать вариации {A|B|C} прямо в столбцах Excel — это повышает уникальность каждого сообщения
🔍 Примеры с Объяснениями
Пример A: Перечисление объектов
Шаблон: У нас есть [+, +яблоки|груши|бананы]
Результат: У нас есть яблоки, груши, бананыПочему: [+, +] объединяет ВСЕ варианты через запятую и пробел
Пример B: Один вариант из списка
Шаблон: Лучший выбор - {яблоки|груши|бананы}
Результат: Лучший выбор - яблоки (случайно)Почему: {...} выбирает ОДИН вариант случайно
Пример C: Комбинация выбора и перестановок
Шаблон: У вас [+, +{стол|письменный стол}|{стул|кресло}|{лампа|светильник}]
Результат: У вас письменный стол, стул, лампа (из каждого {} выбирается ОДИН вариант, потом все объединяются через запятую)Почему: Внутри [+, +] можно использовать {...} для выбора случайного варианта в каждой позиции
🎯 Типичные Ошибки
Ошибка 1: Путаница между {|} и [+ +]
❌ {яблоко, груша, банан} → выберет ОДНО целое
✅ [+, +яблоко|груша|банан] → перечислит ВСЕ
Ошибка 2: Незакрытые скобки
❌ {Привет|Здравствуйте
✅ {Привет|Здравствуйте}
Ошибка 3: Неправильный синтаксис объединения
❌ [+А|Б|В] — нет второго +
✅ [+, +А|Б|В] — правильный формат
💡 Максимальная Уникальность с Excel
Комбинация выбора {A|B|C} и перестановок [+X+A|B|C] в Excel:
- Можно указывать вариации прямо в столбцах Excel:
{Привет|Здравствуйте},{20%|30%|50%} - Каждый столбец может содержать уникальные вариации для выбора и перестановок
- Комбинация всех вариаций создает невероятно высокую вариативность — вплоть до полной уникальности каждого сообщения