Как устроены тексты чата

Приветствие для новичков, правила чата и поздравление с днём рождения вы задаёте сами. Все три текста меняются одной командой, где сначала идёт раздел, а потом действие.

1-тексты<что><действие>[текст]

<параметр> — обязательный[параметр] — необязательный

Без раздела или с опечаткой в нём бот пришлёт памятку со списком разделов и действий. Памятку видит любой участник, а менять тексты смогут только те, у кого есть права.

[скриншот: памятка команды -тексты]

Короткая формаСкопировать ссылку

Раздел работает и как самостоятельная команда, тогда слово тексты не нужно: -приветствие2, -правила1 и -поздравление2.

1-приветствие показать

1-правила установить<текст>

<параметр> — обязательный

У -правила и -приветствие действие обязательно. Без него -правила остаётся командой участника и просто показывает правила, а -приветствие бот пропустит. У -поздравление такого ограничения нет, там можно сразу писать текст.

В длинной форме слово установить разрешено опустить: -тексты правила и сразу текст бот тоже поймёт.

Как написать текстСкопировать ссылку

Текст пишется в одном сообщении с командой, в том числе в несколько строк. Второй способ: ответить командой на готовое сообщение, тогда бот возьмёт его вместе с форматированием, а если в нём есть картинка, то и её. Третий: отправить картинку и написать команду в подписи к ней.

Обычное сообщение вмещает около 4000 символов, подпись под картинкой около 1000. Если текст не влезает, бот скажет, насколько он длиннее нужного.

В приветствии и поздравлении работает подстановка {имя}: на это место встанет упоминание новичка или именинника. В правилах подстановки нет, там {имя} останется словом в тексте.

Оформление и разметкаСкопировать ссылку

Жирный, курсив, ссылки и скрытый текст переносятся сами, если отправить команду ответом на уже оформленное сообщение. Когда текст пишется прямо в команде, оформление задаётся разметкой.

Разметка включается блоками. Как только в тексте появляется заголовок, таблица, блок кода или скрываемый блок, бот отправляет всё сообщение оформленным: заголовки становятся заголовками, таблица таблицей, а внутри работает и остальное, от жирного и ссылок до цитат, списков и спойлеров. В такое сообщение влезает намного больше текста, чем в обычное. Если блоков нет, текст останется обычным сообщением, а звёздочки и теги будут видны как есть.

Разметку бот понимает в двух видах, и у каждого есть справка телеграма с готовыми примерами:

• Markdown, привычные ## Заголовок, **жирный** и | таблица |: примеры разметки.
• HTML, теги вида <h2>, <b>, <table> и <details>: примеры разметки.

Смешивать их не нужно, вид бот определяет сам по тому, что нашёл в тексте.

Если нужна подсказка под рукой, действие помощь коротко напоминает про разметку и способы передать текст: -правила помощь или -приветствие помощь.