Справочник API для файлов метаданных
Этот раздел документации посвящён соглашениям о файлах метаданных. Файловые метаданные могут быть определены путём добавления специальных файлов метаданных в сегменты маршрутов.
Каждое соглашение о файлах может быть определено либо с помощью статического файла (например, opengraph-image.jpg
), либо с использованием динамического варианта, где файл генерируется кодом (например, opengraph-image.js
).
После определения файла Next.js автоматически обслуживает этот файл (в production-сборке с хешами для кеширования) и обновляет соответствующие элементы head с правильными метаданными, такими как URL ресурса, тип файла и размер изображения.
Полезно знать:
- Специальные обработчики маршрутов, такие как
sitemap.ts
,opengraph-image.tsx
иicon.tsx
, а также другие файлы метаданных, кешируются по умолчанию.- При использовании вместе с
middleware.ts
настройте matcher, чтобы исключить файлы метаданных.
favicon, icon и apple-icon
Справочник API для соглашений по файлам Favicon, Icon и Apple Icon.
manifest.json
Справочник API для файла manifest.json.
opengraph-image и twitter-image
Справочник API для файловых конвенций Open Graph Image и Twitter Image.
robots.txt
Справочник API для файла robots.txt.
sitemap.xml
API-справочник для файла sitemap.xml.