Документерра предоставляет широкие возможности для настройки как внешнего вида портала, так и оформления контента. В этом разделе описаны настройки, связанные с брендированием и стилизацией портала, отдельных статей, страниц 404 и настройкой доменного имени.
В Документерре внешний вид контента и внешний вид портала настраиваются независимо друг от друга. Контент оформляется с помощью стилей, а читательский интерфейс — с помощью инструментов брендинга. В этой статье объясняется, чем отличаются эти подходы и какие настройки используются в каждом случае.
Ниже показаны авторский и читательский интерфейсы, а также элементы, которые можно настроить с помощью стилизации или брендинга.
| Авторский интерфейс |  |
| Читательский интерфейс |  |
Стилизация
Стилизация отвечает за внешний вид контента, который создают авторы: заголовков, таблиц, изображений, списков и других элементов страницы.
Так как контент в Документерре хранится в формате HTML, оформление задаётся с помощью CSS.
Стилизация через Редактор страниц
В режиме дизайна в Редакторе страниц можно изменять оформление отдельных элементов, такие как размер шрифта или цвет текста в верхней панели. При этом в контент добавляются встроенные (inline) стили, поэтому изменения применяются только к выбранному элементу и не затрагивают остальные элементы такого же типа в документации.
| Например, если изменить цвет и размер одного заголовка второго уровня, остальные заголовки второго уровня останутся без изменений. |
Стилизация через CSS
Этот способ позволяет централизованно управлять оформлением и применять единые стили ко всей документации. CSS-правила для документации задаются в связанном с проектом файле Style.css, он находится в настройках проекта.
Как работает Style.css:
- При создании проекта автоматически создаётся файл Style.css.
- Начальное содержимое файла зависит от выбранного шаблона проекта — он автоматически заполняется CSS-правилами для таблиц, экспресс-блоков, элементов навигации и других элементов.
- Также возможно использование общего файла Style.css, который будет доступен для нескольких проектов сразу.
Изменения в CSS-файлах попадают в опубликованную документацию только после обновления публикации. При этом внутри проекта изменения видны сразу — иногда достаточно обновить страницу браузера. |
Брендинг
Брендинг определяет внешний вид читательского интерфейса, а не контента страниц. К элементам брендинга относятся:
- логотип компании,
- цвета портала,
- строка поиска,
- заголовок и футер,
- раскладка читательского интерфейса,
- и т.д.
Брендирование через настройки
Большинство параметров настраиваются в разделе Настройки читательского интерфейса. Там можно выбрать шаблон читательского интерфейса, определить стандартные заголовки и футеры, настроить цвета и внести другие изменения.
| Каждый проект может использовать собственный шаблон читательского интерфейса. |
Брендирование через CSS и JS
Для более глубокой настройки можно использовать расширенные возможности брендинга:
- Branding.css — CSS-стили для изменения внешнего вида элементов интерфейса.
- Branding.js — JavaScript-файл дя изменения поведения интерфейса.
Изменения затрагивают только читательский интерфейс, они не отображаются в авторском интерфейсе. Поэтому, чтобы увидеть, что поменялось, нужно открыть публикацию как читатель.
Стилизация домашней страницы
Домашняя страница — единственная страница с собственными настройками оформления. Её стиль настраивается отдельно в редакторе домашней страницы, на странице настроек домашней страницы портала.
Если вы хотите воспользоваться услугами по брендингу, обратитесь к нашей команде.
Подробнее о настройке внешнего вида портала и стилизации контента читайте в следующих разделах.
- Работа со стилями контента страниц
- Брендинг: Общая информация
- Часто задаваемые вопросы о брендинге и стиле