Aller au contenu principal
Version : Ancienne (v3.x)

DocSearch et Algolia Crawler

Traduction Bêta Non Officielle

Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →

Si vous ne trouvez pas la réponse à votre question sur ce site, cette page vous aidera. Si vous avez toujours des doutes, n'hésitez pas à nous contacter sur Discord ou à en informer notre équipe de support.

Vous pouvez également consulter notre FAQ du Crawler pour comprendre son fonctionnement :

Pour les questions relatives au programme DocSearch, consultez notre FAQ du programme DocSearch.

À quelle fréquence mon site est-il crawlé ?

Les crawls sont planifiés à un moment aléatoire chaque semaine. Vous pouvez configurer cette planification via le fichier de configuration ou en déclencher un manuellement depuis l'interface du Crawler.

Pourquoi ai-je du contenu dupliqué dans mes résultats ?

Cela survient lorsque plusieurs URL pointent vers le même contenu, par exemple ./docs, ./docs/ et ./docs/index.html.

Nous recommandons de configurer des URL canoniques sur votre site. Vous trouverez plus d'informations dans le guide Google « Consolider les URL en double ».

En dernier recours, vous pouvez définir les exclusionPatterns pour exclure les motifs indésirables.

Les dépôts docsearch-scraper et docsearch-configs sont-ils toujours maintenus ?

Notre infrastructure historique est obsolète, mais vous pouvez toujours l'utiliser pour exécuter votre propre instance et la connecter à DocSearch v3 !

Comment migrer

Tous les propriétaires auraient dû recevoir un e-mail de migration d'Algolia avec les détails. Si vous n'étiez pas propriétaire précédent de l'index, ou si le mainteneur a changé, vous pouvez demander l'accès via notre page de support.

Toutes les étapes sont détaillées dans l'e-mail que vous avez reçu, mais pour utiliser la nouvelle infrastructure vous devez :

  • Rejoindre l'application Algolia via l'invitation contenue dans l'e-mail

  • Mettre à jour votre intégration frontend avec les identifiants reçus dans l'e-mail.

docsearch({
container: '#docsearch',
appId: 'YOUR_NEW_ALGOLIA_APP_ID',
apiKey: 'YOUR_NEW_ALGOLIA_SEARCH_API_KEY',
indexName: 'YOUR_INDEX_NAME', // it does not change
});

Que faire de ma configuration et identifiants historiques ?

Vous pouvez les oublier : nous effectuerons le nettoyage une fois que tous nos utilisateurs auront migré vers la nouvelle infrastructure !

Utilisez l'interface web dédiée pour modifier votre index.

Pourquoi vois-je deux applications Algolia dans mon tableau de bord ?

Nous n'avons pas supprimé l'accès à l'application historique DocSearch (BH4D9OD16A) pour vous laisser le temps de découvrir notre nouvelle infrastructure. BH4D9OD16A restera disponible jusqu'à la fin de la migration pour tous les utilisateurs DocSearch.

La recherche ne renvoie aucun résultat

Si votre recherche ne donne aucun résultat sans erreur dans les outils de développement de votre navigateur, il pourrait y avoir un problème avec votre index.

Vérifiez que :

  1. Votre configuration du Crawler correspond à la structure de votre site

Nous fournissons des modèles de configuration pour de nombreux générateurs de sites, mais vous pouvez également les utiliser comme base. Pour déboguer vos sélecteurs, nous recommandons d'utiliser le testeur d'URL.

  1. Vos paramètres d'index sont à jour (un bandeau s'affichera dans l'aperçu de la recherche dans le cas contraire)

Le Crawler n'applique les index settings qu'à la création initiale de l'index, afin de conserver le tableau de bord Algolia comme source de vérité. Si vous avez radicalement modifié votre configuration ou migré vers un autre générateur de site, nous vous recommandons de supprimer votre index du tableau de bord Algolia avant de lancer un nouveau crawl.

Puis-je supprimer mon crawler ?

Non. Enfin, vous le pouvez techniquement mais les fonctionnalités cesseront de fonctionner correctement. Nous créons automatiquement un crawler par défaut associé à votre application DocSearch. Le supprimer pour en créer un nouveau ne produira pas le résultat attendu.

Que se passe-t-il si je supprime mon DocSearch Crawler ?

La solution la plus rapide est de nous contacter sur Discord. Vous pouvez également nous écrire à l'adresse ci-dessous et nous traiterons votre demande dès que possible.

Puis-je utiliser le Crawler sur des sites protégés par mot de passe ?

Le Crawler utilisé avec les applications DocSearch ne fonctionne pas sur les sites protégés par mot de passe nécessitant une authentification. Pour cette fonctionnalité, vous devez utiliser un plan Algolia standard https://www.algolia.com/pricing et y ajouter un crawler. Bien qu'il soit gratuit d'ajouter un crawler en mode "pay-as-you-go", la version gratuite comporte des limitations.

Liens relatifs à la migration