Conversation
Nouveau plugin `plugins/og-images` : au postBuild, une image 1200x630 par page de doc, de glossaire, d'article de blog et pour les pages marketing, à partir du titre localisé et de l'icône de la fonctionnalité (chiffre clé sur l'accueil, points mis en avant sur premium et business). Injecte og:image, og:image:width/height, og:image:alt, twitter:image et twitter:card dans le HTML, et tourne par locale (fr/en/de/es/pt). Ajoute aussi twitter:site et twitter:creator dans les métas globales. Rendu Satori (HTML/CSS vers SVG) puis resvg (SVG vers PNG) puis sharp pour la compression, avec un cache persistant dans node_modules/.cache pour des rebuilds rapides. Les polices TTF/OTF vivent dans le dossier du plugin (build-time uniquement, non servies). Vérifié sur un build FR : 43 images, ~26 ko chacune.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Ce que ça fait
Nouveau plugin Docusaurus
plugins/og-imagesqui génère au build une image Open Graph 1200x630 par page, puis injecte les métas correspondantes dans le HTML.Couverture :
/learnpremium,business,communities/games,communities/creators)Sur
premiumetbusiness, l'image affiche un pill + les points mis en avant plutôt que le simple titre.Métas injectées
og:image,og:image:width,og:image:height,og:image:alt,twitter:image,twitter:card: summary_large_image. La config gagne aussitwitter:siteettwitter:creator.Comment
Satori (HTML/CSS vers SVG), resvg (SVG vers PNG), sharp (compression). Tourne dans le hook
postBuild, une passe par locale pour récupérer les titres localisés (fr/en/de/es/pt). Cache persistant dansnode_modules/.cache/og-images, clé dérivée du contenu +TEMPLATE_VERSION, donc les rebuilds sont quasi gratuits tant que les titres ne changent pas.Les polices TTF/OTF vivent dans
plugins/og-images/fonts/: Satori ne lit pas le woff2 déjà auto-hébergé dansstatic/fonts/. Elles sont build-time uniquement, jamais servies.Vérification
Build FR complet : 43 images générées, ~26 ko chacune (1,1 Mo au total), métas bien présentes dans le HTML sur l'accueil et sur les pages de doc.
tscpasse.Note
Les 5 locales multiplient le nombre d'images au build : compter ~215 images sur un build complet à froid, ensuite le cache prend le relais.