Aller au contenu
This is an unmaintained snapshot of the Astro v4 docs. View the latest docs.

Combinez des mises en page pour tirer le meilleur parti des deux mondes

Maintenant que vous avez ajouté une mise en page à chaque billet de blog, faisons en sorte que vos billets ressemblent au reste des pages de votre site web !

Préparez-vous à…

  • Imbriquez votre mise en page de billet de blog dans votre mise en page principale

Vous avez déjà une mise en page BaseLayout.astro pour définir la mise en page générale de vos pages.

MarkdownPostLayout.astro vous offre quelques modèles supplémentaires pour les propriétés courantes des billets de blog, telles que title et date, mais vos billets de blog ne ressemblent pas aux autres pages de votre site. Vous pouvez assortir l’apparence de vos billets de blog au reste de votre site en imbriquant des mises en page.

  1. Dans src/layouts/MarkdownPostLayout.astro, importez BaseLayout.astro et utilisez-le pour envelopper l’ensemble du contenu du modèle. N’oubliez pas de passer la propriété pageTitle :

    src/layouts/MarkdownPostLayout.astro
    ---
    import BaseLayout from './BaseLayout.astro';
    const { frontmatter } = Astro.props;
    ---
    <BaseLayout pageTitle={frontmatter.title}>
    <h1>{frontmatter.title}</h1>
    <p>{frontmatter.pubDate.toString().slice(0,10)}</p>
    <p><em>{frontmatter.description}</em></p>
    <p>Écrit par : {frontmatter.author}</p>
    <img src={frontmatter.image.url} width="300" alt={frontmatter.image.alt} />
    <slot />
    </BaseLayout>
  2. Vérifiez l’aperçu dans votre navigateur à l’adresse http://localhost:4321/posts/post-1. Vous devriez maintenant voir le contenu rendu par :

    • Votre mise en page principale, y compris vos styles, liens de navigation et pied de page social.
    • Votre mise en page de billet de blog, y compris les propriétés du frontmatter telles que la description, la date, le titre et l’image.
    • Votre contenu Markdown individuel de billet de blog, y compris uniquement le texte écrit dans ce billet.
  3. Remarquez que votre titre de page est maintenant affiché deux fois, une fois par chaque mise en page.

    Supprimez la ligne qui affiche votre titre de page dans MarkdownPostLayout.astro :

    src/layouts/MarkdownPostLayout.astro
    <BaseLayout pageTitle={frontmatter.title}>
    <h1>{frontmatter.title}</h1>
    <p>{frontmatter.pubDate.toString().slice(0,10)}</p>
    <p><em>{frontmatter.description}</em></p>
    <p>Écrit par : {frontmatter.author}</p>
    <img src={frontmatter.image.url} width="300" alt={frontmatter.image.alt} />
    <slot />
    </BaseLayout>
  4. Vérifiez à nouveau l’aperçu dans votre navigateur à http://localhost:4321/posts/post-1 et assurez-vous que cette ligne n’est plus affichée et que votre titre n’est affiché qu’une seule fois. Apportez les ajustements nécessaires pour vous assurer de ne pas avoir de contenu en double.

Assurez-vous que :

  • Chaque billet de blog affiche le même modèle de page, et aucun contenu ne manque. (Si l’un de vos billets de blog manque de contenu, vérifiez ses propriétés du frontmatter.)

  • Aucun contenu n’est dupliqué sur une page. (Si quelque chose est rendu deux fois, assurez-vous de le supprimer de MarkdownPostLayout.astro.)

Si vous souhaitez personnaliser votre modèle de page, vous pouvez.

  1. Cela vous permet d’imbriquer une mise en page à l’intérieur d’une autre et de tirer parti du travail avec des éléments modulaires.

  2. Les mises en page multiples sont particulièrement utiles pour les projets contenant des pages Markdown, comme un…

  3. Lequel de ces éléments fournit un modèle pour l’ensemble de vos pages ?

Contribuer

Comment pouvons-nous vous aider ?

Créer une issue GitHub

Le moyen le plus rapide d'alerter notre équipe d'un problème.

Communauté