Шаблоны страниц

Страница чаще всего заводится не с чистого листа, а по форме, которая у команды и так есть в голове: постмортем, заметки со встречи, план работ. Шаблон — эта форма, записанная один раз.

Что даёт шаблон

Заготовку тела с разделами, а также название по умолчанию, значок и теги. Разделы заполняете вы — шаблон отвечает за то, какие вопросы задать, а не за то, что на них ответить.

В новом проекте сразу есть встроенный набор из четырнадцати: бриф, встреча, дежурство, дизайн-док, описание API, описание сервиса, планирование, постмортем, распорядок дня, регламент, релиз, ретроспектива, решение, статус проекта. У датированных — встречи, постмортема, релиза и других — сегодняшняя дата уже стоит в названии.

Где взять

• Строка «Пустая страница — начните с шаблона» под названием пустой страницы. Исчезает с первым введённым символом.
• Слэш-меню, группа «Шаблоны» — пункт на каждый шаблон проекта.
• Агент: у него есть list_templates и get_template, а create_page принимает шаблон; в клиентах, которые это умеют, каждый шаблон проекта ещё и появляется слэш-командой. Заведённый вами шаблон агент видит в тот же день — просить нас о новой команде не нужно (клиент может держать старый список до переподключения сервера). См. Что агент умеет.

Как применяется

К нетронутой странице шаблон применяется целиком: название, значок, цвет, теги и тело. К исписанной — вставляется одно тело, по месту курсора: то, что вы уже написали, шаблон не затирает.

Применение — обычная правка страницы, поэтому у него есть и ревизия, и запись в журнале, и откат.

Подстановки

В названии и в теле шаблона можно оставить токены, которые считаются в момент применения:

Остальные фигурные скобки остаются текстом как есть.

Часовой пояс берётся у проекта, а не у браузера: «сегодня» у команды в разных городах должно означать один и тот же день. Пояс задаёт владелец — Настройки → Проект → Общее.

Свои шаблоны

Настройки → Проект → «Шаблоны страниц» — раздел видит владелец проекта. Шаблон — это название, описание, значок, теги и тело; тело правится тем же редактором, что и обычная страница.

Описание — это не подпись для красоты. По нему шаблон выбирает агент: «разбор инцидента» и «заметки со встречи» он сопоставляет именно с описанием. Напишите, когда этот шаблон применять, а не что в нём лежит.

Удалили встроенный шаблон и передумали — там же есть кнопка «Восстановить стандартные»: вернутся недостающие из встроенного набора, ваши свои шаблоны останутся как были.

Шаблон — не страница: он не попадает ни в дерево, ни в поиск, ни в граф, ни в корзину.