--- title: "Переход на шаблон читательского интерфейса Next" id: "perekhod-na-shablon-chitatelskogo-interfeysa-next" project: "Руководство пользователя Документерры" url: "https://docs.documenterra.ru/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next" updated: 2026-11-06T08:56:11Z --- # Переход на шаблон читательского интерфейса Next Переход на шаблон читательского интерфейса **Next** обеспечивает более высокую производительность, современный дизайн и множество встроенных возможностей. Его архитектура отличается от остальных шаблонов, поэтому часть существующих настроек (пользовательские скрипты, отдельные параметры интерфейса, футеры) потребуют корректировки. Подробнее о преимуществах и ограничениях читайте здесь: [Новый шаблон Читательского интерфейса Next](/articles/manual/novyy-shablon-chitatelskogo-interfeysa). В этом разделе описан процесс перехода, который поможет перевести портал на новый шаблон. * [Шаг 1. Выберите вариант тестирования](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2_990863898) * [Шаг 2. Очистите шаблон страницы](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2__891709693) * [Шаг 3. Настройте параметры и брендинг](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2__1791030930) * [Шаг 4. Перенесите футеры и обновите API документацию](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2_658652695) * [Шаг 5. Примените шаблон ко всему порталу](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2__1997229403) * [Часто задаваемые вопросы о переходе](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2__1308617134) ## Шаг 1. Выберите вариант тестирования Прежде чем применять новый шаблон к рабочей документации, протестируйте его. Выберите вариант, который подходит под ваш процесс: * **Одна публикация:** самый быстрый способ посмотреть, как выглядит контент. Шаблон можно [переопределить в настройках публикации](/articles/manual/shablony-interfeysa-chitatelya/a/h2_826909827), не затрагивая остальной проект. * **Один проект:** [переопределите шаблон портала для отдельного проекта](/articles/manual/shablony-interfeysa-chitatelya/a/h2_826909827), а затем обновите его публикации. * **Портал Sandbox:** если у вас подключён [портал Sandbox](/articles/manual/portal-sandbox), вы можете проверить работу шаблона на уровне целого портала без риска для рабочей документации. ## Шаг 2. Очистите шаблон страницы В шаблоне **Next** навигационные элементы встроены изначально. Если раньше вы добавляли для них скрипты или сниппеты в [Шаблон страницы](/articles/manual/shablon-stranitsy), удалите их, иначе элементы будут продублированы: * **Ссылки на предыдущую и следующую страницу:** создаются автоматически. * **Кнопка возврата к началу страницы:** встроена в шаблон. ## Шаг 3. Настройте параметры и брендинг В шаблоне **Next** реализован новый подход к настройкам: сам интерфейс остаётся легковесным, а более сложная кастомизация вынесена в CSS. 1. **Проверьте настройки читательского интерфейса:** шаблон Next поддерживает [только часть настроек читательского интерфейса](/articles/manual/novyy-shablon-chitatelskogo-interfeysa/a/h2_1117716371). Всё остальное оформление (например, шрифты, стили заголовка и боковой панели) нужно перенести в **Branding.css**. Смотрите: [Расширенный брендинг с помощью CSS](/articles/manual/rasshirennyy-brending-s-pomoschyu-css). 2. **Обновите CSS-селекторы:** HTML-разметка шаблона Next отличается от других шаблонов. Существующие CSS-правила и скрипты брендинга работать не будут — их придётся переписать. | При переходе на новый шаблон настройки интерфейса текущего шаблона не сохраняются. | | --- | ## Шаг 4. Перенесите футеры и обновите API документацию Два структурных элемента переносятся по особым правилам: * **Футер приложения:** шаблон Next не поддерживает [футер приложения](/articles/manual/nastroyki-interfeysa-chitatelya/a/h2_1563460863) на уровне портала. Его содержимое можно перенести в **нижний колонтитул страницы** — он по-прежнему применяется ко всему порталу или к отдельным проектам. Смотрите: [Индивидуальная настройка нижнего и верхнего колонтитулов страницы](/articles/manual/individualnaya-nastroyka-nizhnego-i-verkhnego-kolontitulov-stranitsy). * **API документация:** если в проектах есть [API документация](/articles/manual/api-dokumentatsiya), переключите режим рендеринга с **Классического** на **Современный**. ## Шаг 5. Примените шаблон ко всему порталу Когда результат в тестовом окружении вас устроит, примените шаблон **Next** глобально: 1. [Включите шаблон Next](/articles/manual/novyy-shablon-chitatelskogo-interfeysa/a/h2_865395336) на уровне портала. 2. Снимите переопределения шаблона, которые вы задали для тестовых проектов или публикаций на [шаге 1](/articles/manual/perekhod-na-shablon-chitatelskogo-interfeysa-next/a/h2_990863898), чтобы к ним применились новые настройки портала. В результате документация будет отображаться с импользованием шаблона **Next**: страницы загружаются быстрее, интерфейс соответствует стандарту WCAG 2.2 AA, URL без hashbang (#!) корректно индексируются поисковыми системами и ИИ-агентами, а навигация работает встроенными средствами, без пользовательских скриптов. ## Часто задаваемые вопросы о переходе Перестанут ли работать ссылки, которые читатели добавили в закладки? Нет. Шаблон **Next** не использует hashbang в URL, поэтому адреса страниц меняются, но Документерра автоматически перенаправляет старые адреса на новые. Ссылки из закладок и ссылки, встроенные в ваше приложение, продолжат открываться. Можно ли перевести на новый шаблон только часть документации? Да. Шаблон читательского интерфейса переопределяется на уровне проекта и на уровне публикации, поэтому во время перехода **Next** может работать параллельно с другим шаблоном. Смотрите: [Переопределение шаблона на уровне проекта или публикации](/articles/manual/shablony-interfeysa-chitatelya/a/h2_826909827). Можно ли вернуться обратно, если что-то пойдёт не так? Да, но настройки шаблона, с которого вы уходите, не сохраняются. При возврате на прежний шаблон настройки его читательского интерфейса придётся задать заново.