LeçonsComment ajouter une recherche à votre site

Mini-leçon 20 sur 30 · Relier données et IA

Essayez la recherche prête à l’emploi

À qui s’adresse cette leçon ?

Pour les personnes souhaitant aider les lecteurs à trouver des sujets sur un petit site. Le projet de recherche est fourni ; l’assistant peut entretenir son index technique.

Trouvez un sujet et ouvrez le véritable article.

Objectif de cette leçon

  • Recherchez le contenu fourni et ouvrez un vrai résultat.
  • Ajoutez un article et gardez la recherche synchronisée.
  • Distinguez absence de résultats et recherche indisponible.
Explications, exemple détaillé et exercices

Avant de commencer

L’atelier blog/recherche et un assistant pour démarrer le dossier public sur HTTP. Utilisez les articles prêts ; aucun blog personnel existant n’est nécessaire.

Vérifiez vos acquis de départ

Ce sont des compétences utiles, pas des cours obligatoires bloquants. Si vous les maîtrisez, commencez ici ; sinon, ouvrez la préparation. Les fichiers fournis remplacent un site personnel préalable.

  1. Comment ajouter un blog à votre site

    Transformez un brouillon ordinaire en page d’article lisible.

Durée estimée: 14–26 min

Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. Cet index public simple convient à de petits ensembles de contenu. De grandes archives et un classement multilingue demandent une autre stratégie de recherche.

Comprendre le principe

Faites démarrer le dossier public sur HTTP. Recherchez un sujet d’un article fourni, ouvrez un résultat et comparez-le au titre/résumé promis.

Seul le contenu public doit apparaître dans la recherche. Masquer le lien de menu d’un brouillon ne rend pas privé son texte inclus.

Un exemple concret

Un résultat est utile s’il mène à un article substantiel, pas à une page vide.

Utilise le projet blog/recherche fourni. Ajoute le quatrième article fourni ou mon brouillon et mets à jour ses données de recherche en même temps, en gardant les brouillons privés et les destinations sûres. Gère le code de l’index. Aide à tester une expression distinctive, un sujet absent et un échec de chargement des données tout en préservant l’accès à la liste des articles.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Qu’a trouvé votre première recherche et où le résultat s’est-il ouvert ?

Afficher une solution détaillée

Exemple de première recherche : « J’ai cherché smaller image et trouvé Send a smaller image to a smaller screen. Le résultat ouvrait l’article expliquant la taille affichée et les octets téléchargés. »

Un titre correspondant ne suffirait pas si la destination était vide. Les brouillons privés restent hors des données publiques de recherche même si leurs liens sont masqués.

Éléments d’une réponse solide

  • Nomme une recherche issue des articles publics fournis et son résultat.
  • Ouvre le résultat et vérifie que sa destination contient l’article promis.
Comment ça marche (facultatif)

Aidez les visiteurs à trouver le bon article

La recherche doit relier une question à une vraie page, et pas simplement animer un champ de recherche.

L’atelier complète le blog avec search.html, un index JSON et un script de navigateur. Il recherche dans les titres et textes des articles et renvoie des liens vers les pages existantes.

L’index entier est public et téléchargé dans le navigateur. N’y mettez pas de brouillons privés ni de notes confidentielles. La recherche est ici une fonction de navigation, pas un système d’autorisation.

Exemple détaillé

Rechercher “image” renvoie l’article sur les sources d’images plus petites. Un mot sans rapport donne un message clair d’absence de résultats tout en laissant le lien de consultation disponible.

Exercice technique complémentaire

Un brouillon peut-il rester privé si vous masquez son lien mais incluez son texte intégral dans search-index.json ?

Afficher une solution détaillée

Non. Tout le monde peut télécharger le JSON. Excluez le contenu privé de la recherche publique et imposez un contrôle d’accès sur tout véritable serveur privé.

  • Reconnaît que l’index lui-même est public.
  • Exclut les informations privées des ressources publiques.

Étape 1 · Comment ajouter une recherche à votre site

Utilisez une expression distinctive

Choisissez quelque chose de reconnaissable dans l’article et la recherche.

Explications, exemple détaillé et exercices

Comprendre le principe

Choisissez une courte expression distinctive pour le quatrième article fourni ou nouveau. Demandez de publier l’article et d’actualiser les données de recherche ensemble.

La recherche ne découvre pas automatiquement une page simplement enregistrée. Une recherche simple par mots peut aussi manquer des fautes de frappe ou une formulation différente.

Un exemple concret

Une expression exacte peut isoler la question de savoir si le nouvel article a bien été relié à la recherche.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Quelle expression utiliserez-vous et la retrouvez-vous dans l’article voulu ?

Afficher une solution détaillée

Exemple de plan : « Mon quatrième article contiendra turquoise anchor check. Je demanderai de publier l’article et d’ajouter son entrée de recherche ensemble, puis chercherai la même expression. »

Trouver les mots dans un brouillon enregistré ne démontre pas un résultat consultable. Vérifiez d’abord leur présence dans le bon article public, puis testez la recherche en fonctionnement.

Éléments d’une réponse solide

  • Choisit une expression reconnaissable réellement présente dans le quatrième article.
  • Explique que l’article et son entrée de recherche doivent être mis à jour avant d’attendre un résultat.
Comment ça marche (facultatif)

Faites correspondre les mots et affichez des résultats sûrs

Gardez une règle de correspondance assez simple pour pouvoir l’expliquer et la tester.

Le script met la requête en minuscules, la sépare en mots et exige que chaque mot figure quelque part dans le titre ou le texte de l’article. Il recherche des sous-chaînes, sans recherche sémantique ni correction des fautes de frappe.

Il crée les liens avec les méthodes du DOM et textContent. Le validateur d’index limite les destinations au format attendu des noms de fichiers du blog. C’est utile même pour un index géré localement, car cela évite des destinations mal formées ou dangereuses par inadvertance.

La règle utilise AND entre les mots de la requête, n’importe où dans l’ensemble titre et corps. L’ordre ne compte pas : 'image browser' et 'browser image' donnent les mêmes correspondances. Ce n’est pas une recherche d’expression exacte. Un mot présent uniquement dans le corps compte aussi ; une faute d’orthographe n’est pas corrigée automatiquement.

Exemple détaillé

“image browser” correspond à une page contenant les deux mots. “imagge” ne devient pas automatiquement “image”. Si vous voulez gérer les fautes plus tard, ajoutez un comportement explicite et des tests.

const matches = entries.filter(entry =>
  words.every(word => (entry.title + ' ' + entry.text)
    .toLowerCase().includes(word))
);

Exercice technique complémentaire

Pourquoi un article pertinent peut-il ne pas correspondre à une requête contenant un mot mal orthographié ?

Afficher une solution détaillée

La sous-chaîne littérale ne figure pas dans son texte. La recherche actuelle ne corrige pas les fautes ; corrigez la requête ou implémentez une autre solution testée.

  • Décrit la correspondance littérale implémentée.
  • Ne prétend pas qu’une requête a échoué ou qu’il existe une compréhension sémantique.

Étape 2 · Comment ajouter une recherche à votre site

Vérifiez absence de correspondance et recherche en panne

Des états différents demandent des actions suivantes différentes.

Explications, exemple détaillé et exercices

Comprendre le principe

Cherchez un sujet absent et inspectez l’état sans correspondance. Pour tester les données indisponibles, rechargez une page neuve et faites bloquer ou échouer localement la requête avant la première recherche. L’application réutilise les données chargées ; bloquer seulement une requête ultérieure peut ne pas reproduire la panne voulue.

Aucun article correspondant et recherche temporairement en panne doivent avoir des messages différents. Gardez la requête corrigeable ou réessayable et testez le parcours de repli vers tous les articles. Identifiez un blocage volontaire comme simulation, pas comme panne réelle.

Un exemple concret

Une erreur de requête ne prouve pas l’absence d’article pertinent.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Qu’ont montré respectivement les tests sujet absent et recherche indisponible ?

Afficher une solution détaillée

Exemple à deux états : « Un sujet inventé a retourné No matching articles. Dans une page neuve avec la requête volontairement bloquée, la recherche était annoncée indisponible ; Browse all articles ouvrait toujours l’index. »

Le rechargement compte : cette recherche conserve en mémoire les données déjà reçues. Bloquer après leur chargement ne reproduit pas un nouvel échec de chargement ; consignez honnêtement cette limite de simulation.

Éléments d’une réponse solide

  • Distingue un sujet absent d’un échec de chargement des données de recherche.
  • Vérifie correction, nouvel essai ou liste complète dans chaque état et identifie toute simulation.
Comment ça marche (facultatif)

Distinguez l’absence de résultats d’une recherche indisponible

L’échec du téléchargement de l’index ne prouve pas qu’aucun article ne correspond.

Exécutez les cas fournis de réussite, de sujet absent et de requête vide. Bloquez ensuite search-index.json dans les outils de développement et rechargez avant de chercher ; le script conserve en mémoire un index chargé avec succès.

Le message d’échec propose l’index des articles. Le visiteur peut encore parcourir le site lorsque la recherche échoue. Vérifiez chaque URL de résultat et testez le formulaire au clavier.

Exemple détaillé

“No matching articles” (aucun article correspondant) signifie qu’un index utilisable a été interrogé. “Search unavailable” (recherche indisponible) signifie que l’index n’a pas pu être obtenu ou validé. Ces messages reposent sur des constats différents.

Exercice technique complémentaire

La requête JSON renvoie 500. La page doit-elle annoncer qu’aucun article ne correspond ?

Afficher une solution détaillée

Non. Signalez que la recherche est indisponible et conservez le lien de consultation. N’annoncez zéro correspondance qu’après avoir chargé et vérifié l’index avec succès.

  • Distingue un échec de transport d’une liste de correspondances vide.
  • Propose une autre voie de navigation fonctionnelle.

Étape 3 · Comment ajouter une recherche à votre site

Gardez un nouvel article trouvable

Répétez la tâche du lecteur après modification.

Explications, exemple détaillé et exercices

Comprendre le principe

Terminez le quatrième article et son entrée de recherche avec l’assistant. Rechargez pour utiliser les données actuelles, recherchez l’expression distinctive et ouvrez l’article renvoyé.

Vérifiez que le résultat mène vraiment au nouveau contenu. Préservez aussi les comportements sans résultat, en panne et de liste complète.

Un exemple concret

L’exemple turquoise-anchor fourni est une comparaison, pas un sujet personnel d’écriture imposé.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Fournissez le nouvel article et les résultats de recherche/échec observés.

Travail à rendre: Le nouvel article et son entrée, avec les contrôles observés trouvé, aucun résultat et indisponible.

Afficher une solution détaillée

Exemple final : « Après mise à jour de l’article et des données, turquoise anchor check renvoyait la nouvelle page. Son ouverture montrait l’expression et l’explication promises. Un sujet absent ne donnait toujours aucun résultat et la simulation d’échec au chargement proposait encore l’index. »

Si l’article enregistré existe sans être trouvé, le parcours de recherche reste incomplet. Faites inspecter les données actuelles et la page chargée au lieu de prendre le résultat de référence pour votre observation.

Éléments d’une réponse solide

  • Retrouve le nouvel article avec son expression et ouvre la bonne page au contenu réel.
  • Reteste l’absence de résultat et la reprise d’une recherche indisponible après mise à jour de l’index.
Comment ça marche (facultatif)

Votre devoir : synchroniser la recherche avec un nouvel article

Sur ce petit site, publier une page et la rendre consultable par recherche sont deux étapes distinctes.

Ajoutez un quatrième article et son entrée d’index correspondante. Choisissez une expression thématique distinctive et confirmez qu’elle retrouve la nouvelle page. Gardez la destination dans le format de nom de fichier de blog autorisé.

Retirez temporairement cette entrée et constatez que la page existe toujours, mais n’apparaît plus dans la recherche. Cela montre pourquoi un site plus vaste peut générer automatiquement son index à partir des sources des articles.

Votre quatrième article peut traiter n’importe quel sujet réel et utiliser une expression distinctive. contact-anchor-check.html et “turquoise anchor check” ne sont que le cas de comparaison fourni, pas le contenu imposé pour votre rendu. L’essentiel est que votre vrai nom de fichier et votre texte consultable concordent dans l’article et dans l’index chargé.

Exemple détaillé

Un générateur statique peut produire les pages et l’index à partir d’une seule source. Dans cette version gérée manuellement, le relevé de test vous protège contre l’oubli d’un des deux côtés.

Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.

Exercice technique complémentaire

Publiez le quatrième article d’exemple et prouvez que la recherche retrouve son expression distinctive.

Afficher une solution détaillée

Le quatrième article de référence utilise l’expression distinctive 'turquoise anchor check'. Son entrée search-index.json contient son véritable nom de fichier de blog et le résumé et corps consultables ; les fichiers de référence complets montrent les deux côtés.

Rechargez pour vider l’index gardé en mémoire, recherchez cette expression et ouvrez l’article renvoyé. Examinez aussi le JSON chargé : ajouter l’expression au HTML sans mettre l’index à jour ne la rendra pas recherchable.

Testez à nouveau un sujet absent et un téléchargement d’index bloqué dans un nouvel onglet ou après rechargement. L’absence de correspondances et la recherche indisponible doivent produire des messages distincts, tandis que Browse all articles (parcourir tous les articles) reste fonctionnel.

  • Le résultat ouvre le véritable article attendu.
  • Le nouveau contenu est indexé sans casser la gestion des échecs et des requêtes vides.

Cette leçon vous a-t-elle été utile ?

Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.