Aller au contenu principal
Version : 3.7.0

MĂ©tadonnĂ©es d'entĂȘte

Personnalisation des mĂ©tadonnĂ©es d'entĂȘte​

Docusaurus dĂ©finit automatiquement les mĂ©tadonnĂ©es de page utiles dans <html>, <head> et <body> pour vous. Il est possible d'ajouter des mĂ©tadonnĂ©es supplĂ©mentaires (ou de remplacer celles existantes) avec la balise <head> dans les fichiers Markdown :

markdown-features-head-metadata.mdx
---
id: head-metadata
title: MĂ©tadonnĂ©es d'entĂȘte
---

<head>
  <html className="some-extra-html-class" />
  <body className="other-extra-body-class" />
  <title>Titre personnalisĂ© de mĂ©tadonnĂ©es d'entĂȘte !</title>
  <meta charSet="utf-8" />
  <meta name="twitter:card" content="summary" />
  <link rel="canonical" href="https://docusaurus.io/docs/markdown-features/head-metadata" />
</head>

# MĂ©tadonnĂ©es d'entĂȘte

Mon texte

Cette déclaration <head> a été ajoutée au doc courant Markdown, en tant que démo. Ouvrez les DevTools de votre navigateur et vérifiez comment les métadonnées de cette page ont été affectées.

remarque

Cette fonctionnalité s'appuie sur le composant Docusaurus <Head>. Reportez-vous vers react-helmet pour une documentation exhaustive.

Vous n'avez pas besoin de cela pour le référencement normal

Les plugins de contenu (par exemple, docs et blog) fournissent des options de front matter comme description, keywords et image, qui seront automatiquement appliquées à la fois à description et og:description, alors que vous devriez déclarer manuellement deux balises de métadonnées lorsque vous utilisez la balise <head>.

Description de la page Markdown​

Les mĂ©tadonnĂ©es de description des pages Markdown peuvent ĂȘtre utilisĂ©es Ă  d'autres endroits que dans les mĂ©tadonnĂ©es d'entĂȘte. Par exemple, l'index de catĂ©gorie gĂ©nĂ©rĂ© par le plugin docs utilise les mĂ©tadonnĂ©es de description des fiches de doc.

Par défaut, la description est la premiÚre ligne pleine de contenu, avec quelques efforts pour la convertir en texte brut. Par exemple, le fichier suivant...

# Titre

Contenu principal... Peut contenir quelques [liens](./file.mdx) ou des **mises en Ă©vidence**.

... aura la description par dĂ©faut « Contenu principal... Peut contenir des liens ou des mises en Ă©vidence Â». Cependant, il n'est pas conçu pour ĂȘtre entiĂšrement fonctionnel. Lorsqu'il ne parvient pas Ă  produire des descriptions raisonnables, vous pouvez en fournir une explicitement par le biais du frontmatter :

---
description: Cette description remplacera la valeur par défaut.
---

# Titre

Contenu principal... Peut contenir quelques [liens](./file.mdx) ou des **mises en Ă©vidence**.