#Введение

Система плагинов — это ключевая часть Rspress. Она позволяет расширять Rspress в процессе сборки сайта. Сначала рассмотрим общую архитектуру Rspress.

Общая архитектура Rspress показана на рисунке ниже:

Rspress состоит из двух основных частей: Node-часть и браузерный runtime. Система плагинов позволяет расширять обе части. В частности, плагины могут:

• Расширять компиляцию Markdown/MDX, добавляя плагины remark или rehype.
• Добавлять пользовательские страницы поверх стандартной маршрутизации Rspress, например маршрут /blog с собственным списком публикаций.
• Настраивать поведение сборщика, изменяя конфигурацию Rsbuild или подключая плагины Rspack/Rsbuild.
• Расширять метаданные страниц. Rspress вычисляет метаданные вроде title и description для каждой страницы; плагины могут расширять эту логику, а тема может получать результат через usePageData.
• Выполнять пользовательскую логику до и после сборки, например закрытие обработчиков событий после завершения сборки.
• Добавлять глобальные компоненты. Поскольку Rspress рендерится на React, плагины могут добавлять глобальные компоненты, например кнопку «наверх» или глобальные компоненты с побочными эффектами.