Страницы
Страницы это файлы, расположенные в директории src/pages/
вашего проекта.
Они ответственны за роутинг, загрузку данных и общий макет страницы каждой страницы вашего сайта.
Поддерживаемые типы файлов страниц
Astro поддерживает следующие типа файлов, в директории src/pages/
:
.astro
.md
.mdx
(с Установленной интеграцией MDX (EN)).html
- [
.js
/.ts
] (как API точки (EN))
Роутинг основанный на файлах
Astro использует стратегию роутинга основанную на файлах.
Каждый файл в вашей директории src/pages/
становится точкой доступа к вашему сайту, относительно расположения это файла.
Пишите стандартный HTML элемент <a>
в вашем компоненте, чтобы связать страницы между собой.
📚 Прочитать больше о Роутинге в Astro.
Astro Страницы
Astro страницы используют расширение .astro
для файлов и имеют те же возможности, что и Astro компоненты.
Чтобы избежать повторного использования HTML на каждой странице, вы можете поместить общий <head>
и <body>
в ваши макеты.
Вы можете использовать столько макетов, сколько хотите.
📚 Прочитать больше о макетах в Astro.
Markdown/MDX Страницы
Astro также обрабатывает любые файлы Markdown (.md
) внутри src/pages/
как страницы вашего сайта.
Если у вас установлена интеграция MDX (EN), она также обрабатывает файлы MDX (.mdx
).
Они обычно используются для страниц с большим объемом текста, таких как записи в блогах и документация.
Макеты страниц особенно полезны для Markdown файлов.
Файлы Markdown могут использовать специальное свойство layout
frontmatter для указания компонента макета
это обернет их содержимое в <html>...</html>
.
📚 Прочитать больше о Markdown в Astro.
HTML страницы
Файлы с расширением .html
могут быть размещены в src/pages/
и использоваться непосредственно в качестве страниц на вашем сайте.
Обратите внимание, что некоторые ключевые возможности Astro не поддерживаются в HTML компонентах.
Кастомная страница ошибки 404
Для кастомизации страницы ошибки 404 вы можете создать файл 404.astro
или 404.md
в /src/pages
.
Это создаст страницу 404.html
. Большинство сервисов деплоя будут использовать именно этот файл.