Translate

Enabling Search

Docusaurus prend en charge la recherche en utilisant Algolia DocSearch. Une fois que votre site est en ligne, vous pouvez le soumettre à DocSearch. Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre siteConfig.js.

DocSearch travaille en explorant le contenu de votre site Web toutes les 24 heures et en mettant tout le contenu dans un index Algolia. Ce contenu est ensuite interrogé directement depuis votre front-end en utilisant l'API Algolia. Note that your website needs to be publicly available for this to work (ie. not behind a firewall). Ce service est gratuit.

Activation de la barre de recherche

Entrez votre clé API et le nom de l'index (envoyé par Algolia) dans siteConfig.js dans la section algolia pour activer la recherche de votre site.

const siteConfig = {
  ...
  algolia: {
    apiKey: 'my-api-key',
    indexName: 'my-index-name',
    appId: 'app-id', // Optional, if you run the DocSearch crawler on your own
    algoliaOptions: {} // Optional, if provided by Algolia
  },
  ...
};

Options de recherche supplémentaires

Vous pouvez également spécifier des options de recherche supplémentaires utilisées par Algolia en utilisant un champ algoliaOptions dans algolia. Cela peut être utile si vous voulez fournir des résultats de recherche différents pour les différentes versions ou langues de vos docs. Toutes les occurrences de "VERSION" ou "LANGUAGE" seront remplacées respectivement par la version ou la langue de la page courante. Plus de détails sur les options de recherche peuvent être trouvés ici.

const siteConfig = {
  ...
  algolia: {
    ...
    algoliaOptions: {
      facetFilters: [ "language:LANGUAGE", "version:VERSION" ]
    }
  },
};

Algolia peut vous fournir des options de recherche supplémentaires. Si c'est le cas, vous devriez les ajouter à l'objet algoliaOptions.

Contrôle de l'emplacement de la barre de recherche

Par défaut, la barre de recherche sera l'élément le plus à droite de la barre de navigation supérieure.

Si vous voulez changer l'emplacement par défaut, ajoutez l'option searchBar dans le champ headerLinks de siteConfig.js à l'emplacement souhaité. Par exemple, vous souhaitez peut-être que la barre de recherche se trouve entre vos liens internes et externes.

const siteConfig = {
  ...
  headerLinks: [
    {...}
    {...}
    { search: true }
    {...}
    {...}
  ],
  ...
};

Personnalisation du placeholder

If you want to change the placeholder (which defaults to Search), add the placeholder field in your config. For example, you may want the search bar to display Ask me something:

const siteConfig = {
  ...
  algolia: {
    ...
    placeholder: 'Demandez-moi quelque chose'
  },
};

Désactivation de la barre de recherche

Pour désactiver la barre de recherche, commentez (recommandé) ou supprimez la section algolia dans le fichier siteConfig.js.

Aussi, si vous avez personnalisé l'emplacement de la barre de recherche dans headerLinks, définissez search: false.