Comment CyberToolBox utilise next-md-blog pour une documentation SEO
Vue d’ensemble de la stack de documentation CyberToolBox : URLs canoniques, hreflang, Open Graph, JSON-LD, sitemap, RSS et contenu localisé.
Ce template embarque chaque primitive SEO qu'on devrait normalement câbler à la main : URLs canoniques, hreflang pour chaque langue disposant de la traduction, balises OpenGraph + Twitter, JSON-LD avec un unique @graph combiné (Organization + BlogPosting + BreadcrumbList), un sitemap qui parcourt toutes les langues, robots.txt, et un flux RSS.
Ce qui est inclus
- Des pages App Router qui s'appuient sur
MarkdownContentde@next-md-blog/core. - Des dossiers de posts par langue sous
posts/{en,fr,es,de}. - Une image OG dynamique par post sur
/[lang]/blog/[slug]/opengraph-image. - Une table des matières auto-générée depuis les titres de votre markdown.
Démarrage rapide
Modifiez site.config.ts pour définir le nom du site, l'URL, les handles sociaux et le fournisseur d'analytics. Déposez de nouveaux articles dans posts/{locale}/your-slug.md — ils sont indexés automatiquement.
Et après
Ouvrez quelques articles, regardez la source, et confirmez :
- Exactement un
<script type="application/ld+json">par page. - Un
<link rel="canonical">pointant vers l'URL absolue. - Un
<link rel="alternate" hreflang="…">pour chaque langue disposant d'une traduction.
C'est tout — bonne écriture.
Notes de publication
Pour CyberToolBox, le blog n'est pas seulement une vitrine. C'est aussi un test régulier de la plateforme publique : chaque article vérifie le routage localisé, la génération des métadonnées, l'inclusion dans le sitemap, le flux RSS et les images Open Graph. En gardant ces éléments dans le flux de contenu normal, les régressions deviennent visibles avant la production.
Quand vous ajoutez un article, choisissez un slug clair, une description précise et, si possible, le même slug pour les traductions. Les liens canoniques et alternates restent ainsi faciles à contrôler, et les rapports analytics sont plus simples à comparer par langue. Si une traduction n'est pas prête, mieux vaut ne pas la publier que créer une page mince ou approximative. La carte hreflang est construite depuis les vrais fichiers, donc une traduction absente est plus propre qu'un doublon faible.
L'objectif est simple : écrire en Markdown, prévisualiser localement et laisser la plateforme gérer le SEO technique de façon fiable.