Данный раздел устанавливает единые требования к визуальному представлению регламентов.
Соблюдение этих правил обязательно для всех документов в базе знаний.

1. Заголовки

  1. Начертание: Заголовки всех уровней (H1, H2, H3) никогда не выделяются жирным шрифтом. Для них используются встроенные стили платформы Confluence.

  2. Выравнивание: Все заголовки выравниваются строго по левому краю. Выравнивание по центру или правому краю не допускается.

  3. Оглавление:

    • Оглавление генерируется автоматически средствами Confluence.

    • В оглавлении отображаются заголовки уровня H1 и H2.

    • Заголовки уровня H3 не включаются в оглавление. Глубина вложенности настраивается в свойствах платформы.

2. Текст и абзацы

  1. Стиль: Используется безличный стиль (например, «Необходимо создать компанию», «Проверить наличие дублей»).

  2. Длина абзаца: Абзацы должны быть короткими. Рекомендуемая длина — 1–3 строки. Длинные «простыни» текста не допускаются.

3. Списки

  1. Маркер: Для списков используется символ «•» (точка). Дефис «-» в качестве маркера не используется.

  2. Пунктуация:

    • если пункты списка - короткие фразы, в конце каждого ставится точка с запятой;

    • в конце последнего пункта ставится точка;

    • если пункты - законченные предложения, в конце каждого ставится точка.

  3. Интервалы: Интервалы между пунктами списка не ставятся.

    • Правильно:
      • пункт;
      • пункт;
      • пункт.

    • Неправильно:
      • пункт;

      • пункт;

4. Нумерованные списки

Для нумерованных списков используется стандартная автоматическая нумерация Confluence.

Пунктуация применяется та же, что и для маркированных списков.

Пример:

  1. пункт;
  2. пункт;
  3. пункт.

5. Таблицы

  • Таблицы применяются для сроков, KPI и сравнения сценариев.

  • Оформление таблиц должно быть единообразным во всех документах.

6. Иконки и выделение

  • Иконки: Допускается использовать иконки для визуального акцента: 🎯 цель, 📞 звонок, ⚠️ важно, 📌 правило, 📊 контроль. Иконки не заменяют текст.

  • Выделение: Критические требования выделяются жирным шрифтом или маркерами: «Важно!», «Критично», «Обязательно», «Запрещено».

7. Изображения

  1. Форматы файлов:

    • PNG — для скриншотов интерфейсов;
    • JPG — для фотографий;
    • GIF — для анимации.

  2. Размер файла: Максимальный размер загружаемого файла — не более 1000 КБ (1 МБ). Тяжёлые изображения необходимо сжимать перед загрузкой.

  3. Выравнивание: Все изображения выравниваются по левому краю.

8. Настройка отображения изображений в Confluence

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

  • Маленький: ширина изображения уменьшается примерно до 25% от оригинала.

  • Средний: ширина изображения уменьшается примерно до 50% от оригинала.

  • Оригинальный: изображение отображается в исходном размере.

Как выбрать подходящий режим:

Тип изображенияРекомендуемый режимПояснение
Вертикальный скриншот (высокий)МаленькийВысокие изображения занимают много места. Уменьшение до 25% сделает их компактнее, не теряя читаемости.
Горизонтальный скриншот (широкий)Средний или оригинальныйЕсли на скриншоте много деталей по ширине, средний размер (50%) часто оптимален. Оригинал используется, когда важна каждая деталь.
GIF-анимацияМаленькийАнимированные изображения лучше смотрятся в компактном формате. Маленький размер (25% от оригинала) делает их аккуратными и не отвлекающими.
Схема процесса или таблицаОригинальныйСхемы и таблицы должны читаться без напряжения, поэтому рекомендуется оставлять оригинальный размер.
Фрагмент интерфейса (кнопка, поле)МаленькийДля показа мелких элементов интерфейса достаточно маленького размера.

Общие принципы:

  1. Никакой горизонтальной прокрутки. Изображение не должно заставлять пользователя прокручивать страницу вправо.
    Если оригинал слишком широкий, использовать средний или маленький режим.

  2. Читаемость важнее размера. Если при уменьшении изображение теряет детали (мелкий текст становится неразборчивым),
    оставлять оригинальный размер.

  3. Единообразие. В рамках одного документа использовать одинаковые режимы отображения 
    для однотипных изображений (например, все скриншоты интерфейса — средний размер).

8.1 Оформление изображений и гифок (макрос «Раскрыть»)

Для вставки изображений и гифок используется макрос «Раскрыть». 
Это позволяет скрыть медиафайл под сворачиваемым блоком.

8.2 Когда нужен заголовок в макросе

Заголовок внутри макроса «Раскрыть» используется только для гифок (анимаций).
Для обычных статичных изображений заголовок не заполняется.

  • Для гифок: в поле «Заголовок» макроса пишется краткое описание того, что показывает анимация.

    • Пример: «Добавление компании из карточки сделки (gif)»

  • Для изображений: поле «Заголовок» не редактируется.

8.3 Примеры оформления

Пример А (гифка):

Пример Б (статичное изображение):

9.Связанные статьи

Если регламент связан с другими документами, в конце
добавляется раздел с кликабельными ссылками на них с помощью макроса "Ссылка"

10. Блочная структура страницы

  • Использование блоков: Весь контент создаётся внутри отдельных блоков (макросов Confluence). Это позволяет перемещать, добавлять или удалять элементы.

  • Как это выглядит: При нажатии на кнопку "Разметка страницы", открывается меню действий.

  • Доступные действия:

    • Добавить раздел — вставить новый блок;

    • Удалить блок — убрать элемент;

    • Переместить блок вверх / вниз — изменить порядок блоков.

  • Зачем это нужно: Блочная структура позволяет быстро переформатировать документ без нарушения вёрстки.