Boost de recherche

Orientez le classement de la recherche intégrée à votre site de documentation vers des pages ou sections spécifiques en définissant un multiplicateur de boost dans le frontmatter ou dans la navigation de votre docs.json.

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.

boost n’affecte que la barre de recherche de votre site de documentation hébergé par Mintlify. Cela ne change pas la façon dont les moteurs de recherche externes indexent vos pages.

​

Booster une seule page

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

---
title: "Custom domain"
description: "Connect your custom domain to your Mintlify documentation."
boost: 3
---

​

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.

{
  "navigation": {
    "groups": [
      {
        "group": "Get started",
        "boost": 5,
        "pages": [
          "quickstart",
          "concepts"
        ]
      }
    ]
  }
}

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.

---
title: "Deprecated API"
description: "Documentation for the deprecated v1 API."
boost: 0.25
---

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.

​

Ajuster le nombre de résultats de recherche

Par défaut, la barre de recherche de votre site de documentation renvoie jusqu’à 6 résultats par requête. Pour renvoyer plus (ou moins) de résultats, modifiez le paramètre Maximum search results dans votre tableau de bord.

1. Allez dans Project Settings → Search dans votre tableau de bord.
2. Utilisez le sélecteur pour choisir une valeur entre 1 et 100.
3. Sélectionnez Save changes.

La nouvelle limite s’applique à chaque requête de recherche depuis votre site de documentation. Renvoyer plus de résultats augmente la probabilité que la bonne page soit visible, mais des valeurs très élevées peuvent rendre le panneau de recherche plus difficile à parcourir.

Vous avez besoin de l’autorisation deployment.update pour modifier ce paramètre. Ce paramètre n’est pas disponible sur les déploiements Atlas (auto-hébergés).