Comment générer des balises meta Open Graph

Comprendre l’usage des balises Open Graph

Les balises meta Open Graph décrivent une page lorsque celle-ci est partagée sur des services capables de les lire. Cet outil assemble un balisage à partir des informations que vous saisissez : titre, description, image, adresse de page, nom du site, type et locale. Il sert ainsi à préparer un bloc cohérent de métadonnées pour une page donnée, sans remplacer l’examen de son contexte éditorial. Le titre est le point de départ, car sa présence conditionne la production du résultat. Quand il est renseigné, le balisage comprend un élément de titre et un élément de description. Les champs d’image, d’adresse et de nom du site restent facultatifs et apparaissent selon les valeurs fournies. Les textes intégrés sont échappés pour le HTML, y compris lorsqu’ils contiennent des caractères spéciaux.

Saisir les métadonnées dans le bon ordre

1. Préparez les informations de la page concernée. Définissez un titre non vide et rédigez la description correspondante, puis prévoyez, si nécessaire, une valeur pour l’image, l’adresse de la page et le nom du site.

2. Saisissez le titre dans le champ prévu à cet effet. Cette donnée est indispensable à la production du balisage ; si elle est absente ou vide, le calcul peut aboutir sans produire de résultat.

3. Ajoutez la description, puis complétez les champs facultatifs utiles à votre page. L’élément d’image n’est inclus que lorsqu’une valeur d’adresse d’image est fournie, et le même principe s’applique à l’élément d’adresse de page ainsi qu’à celui du nom du site.

4. Consultez les champs du type et de la locale. Lorsqu’aucune autre valeur n’est saisie, le type utilise website et la locale utilise en_US. Ces deux paramètres sont proposés comme champs textuels facultatifs et peuvent recevoir une autre valeur.

5. Lancez la génération après avoir relu les informations. Examinez le balisage obtenu pour vérifier que les éléments correspondent aux champs effectivement renseignés et que le contenu décrit bien la page visée.

6. Portez une attention particulière aux signes réservés au HTML. Les valeurs insérées sont échappées dans le résultat ; leur écriture peut donc différer de la saisie tout en représentant les mêmes informations textuelles dans le balisage.

Lire le balisage produit avec discernement

Un résultat généré avec un titre contient un élément de titre et un élément de description, auxquels peuvent s’ajouter les éléments correspondant à l’image, à l’adresse de page et au nom du site. L’absence de l’un de ces éléments est donc compatible avec une valeur facultative non renseignée. Le type et la locale sont également présents lorsque le balisage est produit, avec website et en_US si vous n’avez pas modifié leurs valeurs par défaut. Si vous fournissez d’autres textes, ceux-ci servent d’entrées pour l’assemblage. Le résultat doit être lu comme un balisage construit à partir de vos données, et non comme une vérification de l’adresse, de la ressource image, de la compatibilité d’un service ou de l’affichage final lors d’un partage. Relisez donc chaque valeur avant de l’utiliser sur la page concernée. Les caractères spéciaux sont représentés sous une forme échappée adaptée au HTML.

Exemple pratique

Vous préparez les métadonnées Open Graph d’une page française consacrée aux déplacements à vélo en ville.

Saisissez le titre « Guide du vélo urbain », la description « Conseils pour préparer vos trajets » et une adresse de page, puis lancez la génération.

Le résultat attendu est un bloc comprenant les éléments de titre et de description, ainsi qu’un élément d’adresse puisque cette valeur est fournie. Il contient aussi les éléments de type et de locale avec leurs valeurs par défaut si elles ne sont pas changées, tandis que les textes spéciaux sont échappés pour le HTML.

Limites

• Le résultat assemble les métadonnées saisies et échappe leurs valeurs pour le HTML ; il ne fournit pas une vérification de l’adresse, de l’image ou du rendu sur un service de partage.

Erreurs fréquentes

• Cause : le titre est vide ou absent. Correction : saisissez un titre non vide avant de lancer la génération afin qu’un balisage puisse être produit.

Questions fréquentes

Que se passe-t-il si le titre est vide ?

Lorsque le titre est vide, le calcul peut aboutir sans produire de balisage. Saisissez donc un titre non vide pour obtenir l’élément de titre et l’élément de description.

L’adresse de l’image est-elle obligatoire ?

Non, cette donnée reste facultative. L’élément d’image est ajouté seulement si vous fournissez une valeur d’adresse d’image dans le champ correspondant.

Quelles valeurs sont utilisées par défaut ?

Sans modification, le type prend website et la locale prend en_US lorsque le balisage est généré. Vous pouvez saisir d’autres valeurs textuelles dans ces champs.