Тема по умолчанию
Обновлено
Выбор и настройка
Откройте «База знаний → Темы дизайна» и настройки темы «База знаний». Это самостоятельная тема: ей не требуется родительская тема другого приложения.
Тема оформляет хаб, раздел, статью, поиск и страницу ошибки. На статье есть меню глав, оглавление по заголовкам второго и третьего уровней, переходы к соседним статьям и копирование блоков кода. На мобильном экране меню открывается кнопкой в шапке.
Настройки
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Основной цвет — светлая схема | Акцентный цвет светлой схемы | #2f6feb |
| Основной цвет — тёмная схема | Акцентный цвет тёмной схемы | #7aa2ff |
| Схема по умолчанию | Начальная схема: «Авто», «Светлая» или «Тёмная» | Тёмная |
| Логотип — светлая схема | Изображение логотипа для светлой схемы | Пусто |
| Логотип — тёмная схема | Изображение логотипа для тёмной схемы | Пусто |
| Название в шапке | Название рядом с логотипом | База знаний |
| Подпись меню документации | Подпись меню документации | Меню |
| Текст подвала | Текст внизу страницы | База знаний · Документация |
| Ссылки: Название|адрес, по одной в строке или через «;» | Ссылки шапки и мобильного меню | Документация|#<br>Проекты|#projects<br>Обновления|#updates<br>Поддержка|#support |
| Показывать первый экран | Включает соответствующий блок главной страницы | Включено |
| Часто ищут: по одному запросу в строке или через «;» | Готовые поисковые запросы на первом экране | Начало работы<br>Установка<br>Настройки |
| Показывать проекты | Включает соответствующий блок главной страницы | Включено |
| Показывать первые шаги | Включает соответствующий блок главной страницы | Включено |
| Карточка 1: заголовок | Содержание или ссылка карточки блока «С чего начать» | Знакомство с документацией |
| Карточка 1: описание | Содержание или ссылка карточки блока «С чего начать» | Выберите проект и найдите руководство. |
| Карточка 1: адрес | Содержание или ссылка карточки блока «С чего начать» | #projects |
| Карточка 2: заголовок | Содержание или ссылка карточки блока «С чего начать» | Следите за обновлениями |
| Карточка 2: описание | Содержание или ссылка карточки блока «С чего начать» | Узнайте о последних изменениях. |
| Карточка 2: адрес | Содержание или ссылка карточки блока «С чего начать» | #updates |
| Карточка 3: заголовок | Содержание или ссылка карточки блока «С чего начать» | Используйте хелпер |
| Карточка 3: описание | Содержание или ссылка карточки блока «С чего начать» | Добавьте документацию в свою тему. |
| Карточка 3: адрес | Содержание или ссылка карточки блока «С чего начать» | #developers |
| Показывать недавние статьи | Включает соответствующий блок главной страницы | Включено |
| Показывать блок для разработчиков | Включает соответствующий блок главной страницы | Включено |
| Показывать поддержку | Включает соответствующий блок главной страницы | Включено |
| Заголовок поддержки | Заголовок блока помощи | Нужна помощь? |
| Текст поддержки | Текст блока помощи | Опишите вопрос — поможем найти ответ. |
| Кнопка 1: подпись | Подпись или ссылка кнопки блока поддержки | Написать в поддержку |
| Кнопка 1: адрес | Подпись или ссылка кнопки блока поддержки | Пусто |
| Кнопка 2: подпись | Подпись или ссылка кнопки блока поддержки | Сообщество |
| Кнопка 2: адрес | Подпись или ссылка кнопки блока поддержки | Пусто |
Цвет задаётся в формате #RRGGBB. Некорректное значение заменяется стандартным цветом соответствующей схемы. Если загружен только один логотип, он используется в обеих схемах. Без логотипов показывается стандартный знак.
Посетитель может сменить цветовую схему кнопкой в шапке; сохранённый выбор посетителя имеет приоритет над настройкой темы. «Авто» учитывает предпочтение системы.
Ссылки и блоки главной
В поле «Ссылки: Название|адрес, по одной в строке или через «;»» используйте, например:
Документация|#
Проекты|#projects
Поддержка|#support
Магазин|https://example.com/shop/Якоря шапки ведут к хабу текущего поселения. Принимаются HTTP/HTTPS-адреса, адреса от корня сайта, якоря, строки запроса, mailto: и tel:. Строки без названия или адреса не показываются.
Тексты первого экрана берутся из «Настройки хаба», а его включение — из настроек темы. Плитки проектов также задаются в хабе.
Карточка «С чего начать» не выводится без заголовка или адреса. Кнопка поддержки не выводится без адреса, поэтому после установки укажите свои ссылки поддержки.
«Недавно обновлено» показывает до шести последних опубликованных статей доступных разделов; вступления _index исключены. Скрытие плитки проекта не скрывает его статьи из этого блока. В авторизованном предпросмотре могут отображаться черновики.
Свои шаблоны
Для оформления экранов используются index.html, docs.hub.html, docs.project.html, docs.article.html, docs.search.html и error.html. Меню находится в nav.html, оглавление — в toc.html, форма поиска — в search-form.html. Стили — base.css и docs.css, поведение — docs.js и scheme.js.
Редактируйте оформление через механизм тем Webasyst. Контракт $docs и примеры хелпера описаны в следующей статье.