Diagnostics
Tous les codes de contenu et de navigation, et comment les corriger.
Chaque diagnostic indique un emplacement, par exemple source/docs/guides/attachments.md:42:7, ou un chemin de config comme config#/navigation/1/items/0. Les messages ne citent jamais votre contenu. validate remonte tous les problèmes en une seule passe.
| Code | Niveau | Correction |
|---|---|---|
ROUTE_SLUG_INVALID | erreur | Renommer en minuscules-avec-tirets |
ROUTE_COLLISION | erreur | Garder page.md ou page.mdx |
CONTENT_FRONTMATTER_MISSING | erreur | Ajouter un bloc --- avec title |
CONTENT_FRONTMATTER_UNKNOWN_FIELD | erreur | Supprimer la clé |
CONTENT_FRONTMATTER_INVALID | erreur | Vérifier les types ; title non vide |
CONTENT_HEADING_H1 | erreur | Commencer le contenu à ## |
CONTENT_HEADING_SKIPPED | avertissement | Ne pas sauter de niveau |
CONTENT_HTML_FORBIDDEN | erreur | Markdown ou composant |
CONTENT_EXPRESSION_FORBIDDEN | erreur | Props en texte |
CONTENT_ESM_FORBIDDEN | erreur | Retirer import/export |
CONTENT_UNSUPPORTED | erreur | Notes, liens par référence, images en ligne |
CONTENT_COMPONENT_UNKNOWN | erreur | Vérifier nom et casse |
CONTENT_COMPONENT_PROP_INVALID | erreur | Retirer les props non prises en charge |
CONTENT_COMPONENT_NESTING_INVALID | erreur | Enfants autorisés / Hero en premier |
CONTENT_LINK_TARGET_MISSING | erreur | Corriger la route ou le slug |
CONTENT_LINK_ANCHOR_MISSING | avertissement | Corriger l’#ancre |
CONTENT_LINK_SCHEME_FORBIDDEN | erreur | https:, mailto: ou une route |
CONTENT_ASSET_NOT_FOUND | erreur | Vérifier le chemin relatif |
CONTENT_ASSET_UNSUPPORTED | erreur | PNG, JPEG, WebP ou GIF |
CONTENT_ASSET_TOO_LARGE | erreur | ≤ 2 Mio chacun, 20 Mio au total |
CONTENT_BUDGET_EXCEEDED | erreur | Découper la page |
NAVIGATION_PAGE_MISSING | erreur | Corriger le slug |
NAVIGATION_PAGE_DUPLICATE | erreur | Une seule mention par page |
NAVIGATION_PAGE_ORPHANED | avertissement | L’ajouter, ou la laisser cachée |
NAVIGATION_DEPTH_EXCEEDED | erreur | Deux niveaux de sections max |
NAVIGATION_API_DUPLICATE | erreur | Un seul { api: true } |
NAVIGATION_LINK_INVALID | erreur | https:// ou http:// |