Переход на шаблон читательского интерфейса Next обеспечивает более высокую производительность, современный дизайн и множество встроенных возможностей. Его архитектура отличается от остальных шаблонов, поэтому часть существующих настроек (пользовательские скрипты, отдельные параметры интерфейса, футеры) потребуют корректировки. Подробнее о преимуществах и ограничениях читайте здесь: Новый шаблон Читательского интерфейса Next.
В этом разделе описан процесс перехода, который поможет перевести портал на новый шаблон.
- Шаг 1. Выберите вариант тестирования
- Шаг 2. Очистите шаблон страницы
- Шаг 3. Настройте параметры и брендинг
- Шаг 4. Перенесите футеры и обновите API документацию
- Шаг 5. Примените шаблон ко всему порталу
- Часто задаваемые вопросы о переходе
Шаг 1. Выберите вариант тестирования
Прежде чем применять новый шаблон к рабочей документации, протестируйте его. Выберите вариант, который подходит под ваш процесс:
- Одна публикация: самый быстрый способ посмотреть, как выглядит контент. Шаблон можно переопределить в настройках публикации, не затрагивая остальной проект.
- Один проект: переопределите шаблон портала для отдельного проекта, а затем обновите его публикации.
- Портал Sandbox: если у вас подключён портал Sandbox, вы можете проверить работу шаблона на уровне целого портала без риска для рабочей документации.
Шаг 2. Очистите шаблон страницы
В шаблоне Next навигационные элементы встроены изначально. Если раньше вы добавляли для них скрипты или сниппеты в Шаблон страницы, удалите их, иначе элементы будут продублированы:
- Ссылки на предыдущую и следующую страницу: создаются автоматически.
- Кнопка возврата к началу страницы: встроена в шаблон.
Шаг 3. Настройте параметры и брендинг
В шаблоне Next реализован новый подход к настройкам: сам интерфейс остаётся легковесным, а более сложная кастомизация вынесена в CSS.
- Проверьте настройки читательского интерфейса: шаблон Next поддерживает только часть настроек читательского интерфейса. Всё остальное оформление (например, шрифты, стили заголовка и боковой панели) нужно перенести в Branding.css. Смотрите: Расширенный брендинг с помощью CSS.
- Обновите CSS-селекторы: HTML-разметка шаблона Next отличается от других шаблонов. Существующие CSS-правила и скрипты брендинга работать не будут — их придётся переписать.
| При переходе на новый шаблон настройки интерфейса текущего шаблона не сохраняются. |
Шаг 4. Перенесите футеры и обновите API документацию
Два структурных элемента переносятся по особым правилам:
- Футер приложения: шаблон Next не поддерживает футер приложения на уровне портала. Его содержимое можно перенести в нижний колонтитул страницы — он по-прежнему применяется ко всему порталу или к отдельным проектам. Смотрите: Индивидуальная настройка нижнего и верхнего колонтитулов страницы.
- API документация: если в проектах есть API документация, переключите режим рендеринга с Классического на Современный.
Шаг 5. Примените шаблон ко всему порталу
Когда результат в тестовом окружении вас устроит, примените шаблон Next глобально:
- Включите шаблон Next на уровне портала.
-
Снимите переопределения шаблона, которые вы задали для тестовых проектов или публикаций на шаге 1, чтобы к ним применились новые настройки портала.
В результате документация будет отображаться с импользованием шаблона Next: страницы загружаются быстрее, интерфейс соответствует стандарту WCAG 2.2 AA, URL без hashbang (#!) корректно индексируются поисковыми системами и ИИ-агентами, а навигация работает встроенными средствами, без пользовательских скриптов.