Passer au contenu principal
Configurez le comportement de la barre de recherche sur votre site de documentation hébergé par Mintlify. Ces paramètres n’affectent que la recherche intégrée. Ils ne changent pas la façon dont les moteurs de recherche externes indexent vos pages.

Booster le classement de la recherche

Utilisez boost pour orienter le classement de la recherche intégrée pour des pages ou sections spécifiques. La valeur est un multiplicateur numérique appliqué au score de pertinence de chaque fragment : boost: 3 rend un fragment trois fois plus pertinent qu’il ne le serait sans boost.

Booster une seule page

Définissez boost dans le frontmatter d’une page pour multiplier son classement dans la recherche.

Booster un groupe de navigation

Définissez boost sur un groupe dans la navigation de votre docs.json pour appliquer le multiplicateur à chaque page qu’il contient.
Une page hérite du facteur de boost de son ancêtre le plus proche qui en définit un. Une page enfant ou un groupe imbriqué peut remplacer le boost hérité en définissant sa propre valeur boost. Le boost du frontmatter d’une page l’emporte toujours sur une valeur héritée de la navigation.

Dé-prioriser du contenu

Utilisez une valeur inférieure à 1 pour reléguer les pages plus bas dans les résultats de recherche. Par exemple, boost: 0.5 réduit de moitié le score de pertinence d’une page par rapport aux autres pages. Un boost de 1 équivaut à l’absence de boost.
Les facteurs de boost se combinent avec le score de pertinence existant. Utilisez-les avec parcimonie. Des multiplicateurs élevés peuvent faire en sorte que des pages moins pertinentes dominent les résultats de recherche et dégradent la qualité globale de la recherche.
boost accepte tout nombre positif. En pratique, maintenez les valeurs entre 0.1 et 10 :
  • 0.1–0.9 : dé-prioriser le contenu hérité, déprécié ou de support.
  • 1 : aucun changement (équivalent à ne pas définir boost).
  • 2–5 : prioriser une page d’atterrissage clé, un quickstart ou une référence très consultée.
  • 5–10 : à réserver à une poignée de pages de premier niveau qui doivent presque toujours apparaître en premier.
Évitez les valeurs supérieures à 10. Des multiplicateurs très élevés écrasent le score de pertinence sous-jacent et font remonter les pages boostées même lorsqu’elles ne correspondent pas bien à la requête.

Interaction entre boost et les correspondances dans le titre

La recherche ordonne les résultats en deux étapes :
  1. La recherche regroupe les résultats selon leur degré de correspondance avec la requête. Les pages dont le titre correspond à la requête forment les groupes les plus élevés, suivies des correspondances dans les titres de section et des correspondances exactes d’expression dans le texte. Les pages qui ne correspondent que partiellement à la requête forment le groupe le plus bas.
  2. Au sein de chaque groupe, la recherche ordonne les résultats selon le score de pertinence, que boost multiplie.
Un boost réordonne les résultats au sein d’un groupe, mais ne fait pas passer un résultat dans un groupe plus élevé. Une page boostée dont le titre ne contient pas le terme recherché reste classée sous une page sans boost dont le titre le contient. Pour qu’une page apparaisse en premier pour un terme, incluez ce terme dans le title de la page. Ajouter le terme à keywords améliore le score de pertinence de la page, mais ne compte pas comme une correspondance dans le titre. Les pages sont consultables par défaut. Le champ searchable est facultatif et vaut true par défaut. Définissez searchable: false dans le frontmatter d’une page pour l’exclure des résultats de recherche de votre site de documentation. searchable est un champ qui ne s’applique qu’au niveau de la page : pour exclure toutes les pages situées sous un onglet ou un groupe de navigation, masquez plutôt l’onglet ou le groupe. Consultez Pages masquées pour les contrôles au niveau de l’onglet et du groupe.
Contrairement à noindex, searchable: false n’affecte pas le référencement externe. La page reste :
  • Explorable par les moteurs de recherche externes
  • Listée dans votre sitemap.xml
Elle est exclue des résultats de recherche de votre site de documentation et du contexte de l’assistant IA. Utilisez searchable: false pour les pages qui doivent rester accessibles via des liens directs ou des moteurs de recherche externes, mais qui ne devraient pas apparaître lorsque les utilisateurs effectuent une recherche dans vos docs. C’est utile pour les pages de référence approfondies, le contenu hérité ou les supports complémentaires qui pourraient sinon éclipser des résultats plus pertinents. Pour exclure une page à la fois de la recherche intégrée et de l’indexation externe, utilisez plutôt noindex: true.

Maximum de résultats de recherche

Contrôlez le nombre de résultats que la barre de recherche renvoie par requête depuis votre dashboard. La valeur par défaut est 6 résultats. Vous pouvez définir n’importe quelle valeur entre 1 et 100. Accédez à la page de paramètres Site dans votre dashboard. Dans la section “Recherche”, définissez Results per query sur la valeur souhaitée. Des valeurs plus élevées font apparaître davantage de correspondances par requête, ce qui est utile pour les sites avec une couverture thématique large où les utilisateurs s’attendent à examiner de nombreux candidats. Des valeurs plus basses gardent le panneau de résultats compact et orientent les utilisateurs vers la correspondance la mieux classée.

Extraits de résultats

Activez Result snippets pour afficher un aperçu d’une seule ligne du contenu correspondant sous chaque résultat de recherche, en plus du titre de la page et du fil d’Ariane. L’extrait se centre sur la première correspondance de la requête de l’utilisateur et met en surbrillance les termes correspondants. Lorsqu’un résultat ne contient aucune correspondance, ou que l’utilisateur n’a pas encore saisi de requête, l’extrait affiche le début du contenu de la page. Les extraits de résultats aident les utilisateurs à distinguer des résultats aux titres similaires en montrant où la requête apparaît dans son contexte. Laissez-les désactivés si vous préférez un panneau de résultats plus compact. Activez ou désactivez les extraits de résultats sur la page de paramètres Site dans votre dashboard. Ce paramètre est désactivé par défaut.

Résultats de recherche en pleine page

Activez Full-page search results pour doter votre site d’une page de résultats de recherche dédiée à l’adresse /search. Lorsque ce paramètre est activé, la barre de recherche affiche une option Search for “query” qui ouvre la page de résultats pour la requête en cours. La page affiche jusqu’à 50 résultats, 10 par page, et l’URL inclut la requête (par exemple, /search?q=authentication) afin que les utilisateurs puissent l’ajouter à leurs favoris ou la partager. Sur les sites comportant plusieurs langues, chaque langue autre que la langue par défaut dispose de sa propre page de résultats à l’adresse /{language}/search, par exemple /fr/search. Activez ou désactivez les résultats de recherche en pleine page sur la page de paramètres Site dans votre dashboard. Ce paramètre est désactivé par défaut.
L’activation des résultats de recherche en pleine page réserve le chemin /search. Si votre site possède déjà une page à l’adresse /search ou /{language}/search, la page de résultats intégrée la remplace. Déplacez cette page vers un autre chemin avant d’activer ce paramètre.
Mintlify exclut la page de résultats des moteurs de recherche externes grâce à noindex.

Filtres de recherche

Les filtres de recherche nécessitent un plan Enterprise.
Les filtres de recherche ajoutent des listes déroulantes de produit et de version aux résultats de recherche pour que les utilisateurs puissent restreindre les résultats à un seul produit ou à une seule version. Les filtres sont utiles pour les sites qui maintiennent des produits ou des versions distincts, où une requête pourrait autrement renvoyer des correspondances sur du contenu que l’utilisateur ne recherche pas. Activez ou désactivez les filtres de recherche sur la page de paramètres Site de votre dashboard. Les listes déroulantes affichées dépendent de la configuration de votre navigation.
  • Le filtre produit apparaît lorsque votre navigation définit plusieurs produits.
  • Le filtre version apparaît lorsque votre navigation définit des versions.
Si votre navigation n’a ni produits ni versions, activer les filtres de recherche n’a aucun effet visible.