> For AI agents: the complete documentation index is available at /rspress-russian/llms.txt, the full documentation bundle is available at /rspress-russian/llms-full.txt.

# Настройка тегов head / SEO

Добавление тегов head (например, мета-тегов) на веб-страницы крайне важно для оптимизации SEO и корректного отображения при шаринге в социальных сетях. Например, протокол [Open Graph](https://ogp.me/) управляет тем, как страница будет выглядеть при публикации в соцсетях.

На данный момент Rspress автоматически добавляет следующие теги head:

| Тег                                                            | Описание                                                                                                    |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `<meta name="generator" content="Rspress v${version}">`        | Указывает генератор сайта и его версию                                                                      |
| `<meta name="description" content="${description}">`           | Описание страницы, см. [Как определяется описание](#how-description-is-determined) ниже                     |
| `<meta property="og:type" content="website">`                  | Тип Open Graph, фиксированное значение `website`                                                            |
| `<meta property="og:title" content="${title}">`                | Заголовок Open Graph, используется заголовок текущей страницы (если доступен)                               |
| `<meta property="og:description" content="${description}">`    | Описание Open Graph, то же, что и выше                                                                      |
| `<link rel="alternate" hreflang="${lang}" href="${url}">`      | Альтернативные языковые версии текущей страницы на многоязычных сайтах                                      |
| `<link rel="preload" href="${currentRouteChunk}" as="script">` | Оптимизация производительности, предварительно загружающая асинхронный модуль маршрута для текущей страницы |

## Как определяется описание \{#how-description-is-determined}

По умолчанию Rspress извлекает первый содержательный абзац под заголовком `h1` в качестве описания страницы (см. [`markdown.extractDescription`](/rspress-russian/api/config/config-build.md#markdownextractdescription)). Если результат извлечения вас не устраивает, вы можете указать поле `description` в [метаданных](/rspress-russian/api/config/config-frontmatter.md#description), чтобы переопределить его:

```md title="example.mdx"
---
description: Пользовательское описание для этой страницы.
---
```

:::tip
Вы можете использовать навык агента [rspress-description-generator](https://github.com/rstackjs/agent-skills#rspress-description-generator) для автоматической генерации описаний для всех страниц. Подробнее см. [Навыки агентов](/rspress-russian/guide/start/ai.md#agent-skills).
:::

Если вы хотите добавить теги head, можно воспользоваться следующими способами:

## Глобальная конфигурация head \{#global-head-configuration}

В файле `rspress.config.ts` вы можете задать HTML-метаданные (теги head) для всех страниц. Подробности смотрите в разделе [Конфигурация - head](/rspress-russian/api/config/config-basic.md#head).

## Конфигурация через метаданные

Вы можете изменять поля [title](/rspress-russian/api/config/config-frontmatter.md#title) и [description](/rspress-russian/api/config/config-frontmatter.md#description) в блоке метаданных, чтобы задать заголовок и описание для отдельных страниц.

```md title="example.mdx"
---
title: Пользовательский заголовок страницы
description: Пользовательское описание страницы для мета-тега description и Open Graph.
---
```

Также можно использовать [метаданные - head](/rspress-russian/api/config/config-frontmatter.md#head), чтобы настроить пользовательские мета-теги страницы для оптимизации SEO.

Например, если вы хотите добавить `<meta property="og:description" content="Это описание">` в тег `<head>`, можно указать метаданные следующим образом:

```md title="example.mdx"
---
head:
  - - meta
    - property: og:title
      content: Это заголовок
  - - meta
    - property: og:description
      content: Это описание
---
```

Вы можете использовать то же поле `head` в метаданных, чтобы добавить тег `<meta name="keywords">`:

```md title="example.mdx"
---
head:
  - - meta
    - name: keywords
      content: Rspress, React, static site generator
---
```

## Компонент Head \{#head-component}

Если вам нужна более сложная настройка тегов head, вы можете использовать компонент [Head](/rspress-russian/ui/runtime-components/head.md), предоставляемый Rspress, чтобы динамически задавать теги head на страницах или в компонентах макета.

## Хук useHead \{#usehead-hook}

Если вы уже находитесь внутри React-компонента и предпочитаете декларацию в виде объекта, используйте [`useHead`](/rspress-russian/ui/hooks/use-head.md):

```tsx
import { useHead } from '@rspress/core/runtime';

export function PageMeta() {
  useHead({
    title: 'Пользовательский заголовок страницы',
    meta: [
      {
        name: 'description',
        content: 'Пользовательское описание страницы для SEO и социальных сетей.',
      },
    ],
  });

  return null;
}
```

По сравнению с `Head`, `useHead` обычно более удобен, когда итоговые теги зависят от пропсов, состояния или вспомогательных функций.

## Конфигурация html.tags в Rsbuild

Через `builderConfig.html.tags` вы можете внедрять пользовательский контент в HTML, например добавлять код аналитики, скрипты или стили:

```ts title="rspress.config.ts"
import { defineConfig } from '@rspress/core';

export default defineConfig({
  builderConfig: {
    html: {
      tags: [
        {
          tag: 'script',
          attrs: {
            src: 'https://cdn.example.com/analytics.js',
          },
        },
      ],
    },
  },
});
```

Подробности конфигурации см. в [документации Rsbuild html.tags](https://rsbuild.rs/config/html/tags).

:::tip Отличие от конфигурации head в Rspress

- **Конфигурация head в Rspress**: позволяет получать информацию о маршруте и динамически задавать теги head для разных страниц.
- **Rsbuild html.tags**: статическая конфигурация на этапе сборки, подходит для глобальной вставки одинаковых тегов, например кода аналитики.

Если вам нужно динамически изменять содержимое head в зависимости от маршрутов страницы, используйте [глобальную конфигурацию head](#global-head-configuration), [компонент Head](#head-component) или [хук useHead](#usehead-hook).

:::
