Пропустить до содержимого

Страницы

Страницы это файлы, расположенные в директории src/pages/ вашего проекта. Они ответственны за роутинг, загрузку данных и общий макет страницы каждой страницы вашего сайта.

Поддерживаемые типы файлов страниц

Заголовок раздела Поддерживаемые типы файлов страниц

Astro поддерживает следующие типа файлов, в директории src/pages/:

Роутинг основанный на файлах

Заголовок раздела Роутинг основанный на файлах

Astro использует стратегию роутинга основанную на файлах. Каждый файл в вашей директории src/pages/ становится точкой доступа к вашему сайту, относительно расположения это файла.

Пишите стандартный HTML элемент <a> в вашем компоненте, чтобы связать страницы между собой.

📚 Прочитать больше о Роутинге в Astro.

Astro Страницы

Заголовок раздела Astro Страницы

Astro страницы используют расширение .astro для файлов и имеют те же возможности, что и Astro компоненты.

src/pages/index.astro
<html lang="en">
  <head>
    <title>Моя страница</title>
  </head>
  <body>
    <h1>Добро пожаловать на мою страницу!</h1>
  </body>
</html>

Чтобы избежать повторного использования HTML на каждой странице, вы можете поместить общий <head> и <body> в ваши макеты. Вы можете использовать столько макетов, сколько хотите.

src/pages/index.astro
---
import MySiteLayout from '../layouts/MySiteLayout.astro';
---
<MySiteLayout>
  <p>Мой контент, обернутый в макет!</p>
</MySiteLayout>

📚 Прочитать больше о макетах в Astro.

Markdown/MDX Страницы

Заголовок раздела Markdown/MDX Страницы

Astro также обрабатывает любые файлы Markdown (.md) внутри src/pages/ как страницы вашего сайта. Если у вас установлена интеграция MDX, она также обрабатывает файлы MDX (.mdx). Они обычно используются для страниц с большим объемом текста, таких как записи в блогах и документация.

Макеты страниц особенно полезны для Markdown файлов. Файлы Markdown могут использовать специальное свойство layout frontmatter для указания компонента макета это обернет их содержимое в <html>...</html>.

src/pages/page.md
---
layout: '../layouts/MySiteLayout.astro'
title: 'Моя Markdown страница'
---
# Заголовок


Это моя страница, написанная на **Markdown.**

📚 Прочитать больше о Markdown в Astro.

HTML страницы

Заголовок раздела HTML страницы

Файлы с расширением .html могут быть размещены в src/pages/ и использоваться непосредственно в качестве страниц на вашем сайте. Обратите внимание, что некоторые ключевые возможности Astro не поддерживаются в HTML компонентах.

Кастомная страница ошибки 404

Заголовок раздела Кастомная страница ошибки 404

Для кастомизации страницы ошибки 404 вы можете создать файл 404.astro или 404.md в /src/pages.

Это создаст страницу 404.html. Большинство сервисов деплоя будут использовать именно этот файл.