Corriger l'erreur "Must be a valid url" pour logo.href ou navbar.primary.href

Lorsque vous exécutez mint dev ou mint validate avec un chemin relatif tel que /contact dans les champs logo.href, navbar.links[].href ou navbar.primary.href de docs.json, une version obsolète de la CLI signale des erreurs comme celles-ci :

🚨 Invalid docs.json:
#.logo.href: Must be a valid url
#.navbar.primary.href: Must be a valid url

Les versions actuelles de la CLI Mintlify acceptent à la fois les URL absolues et les chemins relatifs commençant par / dans ces champs. Les chemins relatifs permettent aux liens de fonctionner dans les déploiements de prévisualisation, les domaines personnalisés et les prévisualisations locales sans coder en dur votre domaine de production.

Mettre à jour la CLI

Mettez à jour vers la dernière version de la CLI :

mint update

Si mint update n’est pas disponible dans votre version, réinstallez la CLI. Consultez Installer la CLI pour les commandes de réinstallation. Vérifiez ensuite votre version et relancez la validation :

mint version
mint validate

Exemple de configuration

docs.json

"logo": {
  "light": "/logo/light.svg",
  "dark": "/logo/dark.svg",
  "href": "/quickstart"
},
"navbar": {
  "links": [
    { "label": "Changelog", "href": "/changelog" }
  ],
  "primary": {
    "type": "button",
    "label": "Contact us",
    "href": "/contact"
  }
}

Les chemins relatifs doivent commencer par /. Une valeur comme contact sans barre oblique initiale échoue toujours à la validation. Les types de bouton github et discord nécessitent toujours une URL de dépôt GitHub ou une URL d’invitation Discord. Pour la référence complète des champs, consultez logo et navbar.

Sujets connexes

Dépannage Référence des commandes de la CLI Mintlify Navigation

⌘I

​Mettre à jour la CLI

​Exemple de configuration

Mettre à jour la CLI

Exemple de configuration