Pages

Les pages sont des fichiers qui se trouvent dans le sous-répertoire src/pages/ de votre projet Astro. Ils sont responsables de la gestion du routage, du chargement des données et de la mise en page globale de chaque page de votre site Web.

Fichiers de page pris en charge

Section titled Fichiers de page pris en charge

Astro prend en charge les types de fichiers suivants dans le répertoire src/pages/ :

Routage basé sur les fichiers

Section titled Routage basé sur les fichiers

Astro utilise une stratĂ©gie de routage appelĂ©e routage basĂ© sur les fichiers. Chaque fichier de votre rĂ©pertoire src/pages/ devient un point d’accĂšs sur votre site en fonction de son chemin d’accĂšs.

Un seul fichier peut Ă©galement gĂ©nĂ©rer plusieurs pages en utilisant le routage dynamique. Cela vous permet de crĂ©er des pages mĂȘme si votre contenu se trouve en dehors du rĂ©pertoire spĂ©cial /pages/, par exemple dans une collection de contenu (EN) ou un CMS.

📚 En savoir plus sur Le routage dans Astro.

Lien entre les pages

Section titled Lien entre les pages

Écrivez des Ă©lĂ©ments HTML standard <a> dans vos pages Astro pour crĂ©er des liens vers d’autres pages de votre site.

Pages Astro

Section titled Pages Astro

Les pages Astro utilisent l’extension de fichier .astro et prennent en charge les mĂȘmes fonctionnalitĂ©s que les composants Astro.

src/pages/index.astro
---
---
<html lang="fr">
  <head>
    <title>Ma page d'accueil</title>
  </head>
  <body>
    <h1>Bienvenue sur mon site web !</h1>
  </body>
</html>

Pour Ă©viter de rĂ©pĂ©ter les mĂȘmes Ă©lĂ©ments HTML sur chaque page, vous pouvez dĂ©placer les Ă©lĂ©ments communs <head> et <body> dans vos propres composants de mise en page. Vous pouvez utiliser autant, ou aussi peu de composants de mise en page que vous le souhaitez.

src/pages/index.astro
---
import MySiteLayout from '../layouts/MySiteLayout.astro';
---
<MySiteLayout>
  <p>Le contenu de ma page, enveloppé dans une mise en page !</p>
</MySiteLayout>

📚 En savoir plus sur les composants de mise en page dans Astro.

Pages Markdown/MDX

Section titled Pages Markdown/MDX

Astro traite Ă©galement tous les fichiers Markdown (.md) contenus dans src/pages/ comme des pages de votre site Web final. Si vous avez installĂ© l’intĂ©gration MDX (EN), les fichiers MDX (.mdx) sont traitĂ©s de la mĂȘme maniĂšre. Ces fichiers sont gĂ©nĂ©ralement utilisĂ©s pour les pages contenant beaucoup de texte, comme les articles de blog et la documentation.

Les collections de contenu de pages Markdown ou MDX (EN) dans src/content/ peuvent ĂȘtre utilisĂ©es pour gĂ©nĂ©rer des pages dynamiquement.

Les mises en page sont particuliÚrement utiles pour les fichiers Markdown. Les fichiers Markdown peuvent utiliser la propriété frontmatter spéciale layout pour spécifier un composant de mise en page qui enveloppera leur contenu Markdown dans un document page complet <html>...</html>.

src/pages/page.md
---
layout: '../layouts/MySiteLayout.astro'
title: 'Ma page Markdown'
---
# Titre


Voici ma page, Ă©crite en **Markdown**.

📚 En savoir plus sur le Markdown dans Astro.

Pages HTML

Section titled Pages HTML

Les fichiers portant l’extension .html peuvent ĂȘtre placĂ©s dans le rĂ©pertoire src/pages/ et utilisĂ©s directement comme pages sur votre site. Notez que certaines fonctionnalitĂ©s clĂ©s d’Astro ne sont pas prises en charge dans les Composants HTML.

Page d’erreur 404 personnalisĂ©e

Section titled Page d’erreur 404 personnalisĂ©e

Pour une page d’erreur 404 personnalisĂ©e, vous pouvez crĂ©er un fichier 404.astro ou 404.md dans /src/pages.

Il sera construit en une page 404.html. La plupart des services de dĂ©ploiement le trouveront et l’utiliseront.