Open Graph

Les balises Open Graph font que vos pages se rendent joliment quand quelqu'un les partage sur Facebook, X, LinkedIn, Slack, et services similaires. Chinaski écrit toutes les balises Open Graph et les balises Twitter (X) correspondantes pour vous quand il construit votre site.

Ce que Chinaski balise automatiquement

Chaque page et post dans la sortie statique porte :

• og:title: votre titre OG, retombant sur votre meta titre, puis le titre de la page
• og:description: votre description OG, retombant sur votre meta description, puis la tagline du site
• og:image: l'URL de votre image OG, retombant sur l'image mise en avant, puis l'image de partage par défaut
• og:type: article pour les posts de blog, website pour tout le reste (pages, la page d'accueil, et les pages de listing)
• og:locale: le code de langue de la page (par ex. en)
• og:url et og:site_name : seulement quand il y a une URL canonique et que le site a un nom

Les balises sans valeur sont entièrement laissées de côté ; rien n'émet de vide. Les balises Twitter équivalentes (titre, description, image) sont émises à côté, avec une carte grande-image quand il y a une image de partage et une carte summary sinon, et twitter:site est défini depuis le handle X/Twitter sur l'onglet de réglages Integrations.

Définir les champs OG par page ou post

L'éditeur de chaque page et post a trois champs : OG Title, OG Description, et OG Image URL.

• Laissez OG Title vide pour hériter du Meta Title (ou du titre de la page/post).
• Laissez OG Description vide pour hériter de la Meta Description.
• OG Image URL accepte n'importe quelle URL d'image.

Tout prend effet après le prochain build du site.

Mettre en cache une image de repli : l'image de partage par défaut

Au lieu de définir une image OG sur chaque élément, choisissez un repli unique à l'échelle du site sous Settings → General : le réglage *Default Site Image*. Il est utilisé comme image de partage sur toute page ou post sans image OG ni image mise en avant. Laissez-le vide pour omettre le repli.

Gérer les URL d'images

Si vous définissez une image OG (ou l'image de partage par défaut) comme un chemin relatif à la racine de votre site (un chemin commençant par un /) Chinaski la résout contre votre réglage Site URL pendant le build, pour que les plateformes sociales voient une URL complète. Les URL absolues (comme https://…) et les valeurs sans URL de site configurée sont transmises inchangées.

Les templates de thème

Si vous construisez des thèmes vous-même, le contexte de template inclut og_title, og_description, og_image_url, et l'image de site par défaut (relative et absolue), pour que le balisage personnalisé puisse réutiliser les mêmes valeurs. Inclure le snippet partagé de balises meta dans votre thème garde la sortie Open Graph cohérente avec le site de base.