LiçõesComo adicionar busca ao seu site

Minilição 20 de 30 · Conectar dados e IA

Experimente a busca pronta

Para quem é esta lição?

Para quem quer que leitores encontrem temas num pequeno site. O projeto de busca é fornecido; um assistente de programação pode manter seu índice técnico.

Encontre um tema e abra o artigo real.

Objetivo desta lição

  • Pesquise no conteúdo fornecido e abra um resultado real.
  • Adicione um novo artigo e mantenha a busca alinhada a ele.
  • Distinga ausência de resultados de busca indisponível.
Explicação, exemplo resolvido e prática

Antes de começar

A oficina fornecida de blog e busca e um assistente de programação para iniciar a pasta public por HTTP. Você pode usar seus artigos prontos; não precisa de um blog pessoal existente.

Confira os conhecimentos iniciais

São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.

  1. Como adicionar um blog ao seu site

    Transforme um rascunho comum numa página de artigo legível.

Tempo estimado: 14–26 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. Este índice público simples serve para pequenos conjuntos de conteúdo. Acervos grandes e classificação multilíngue precisam de outra estratégia de busca.

Entenda a ideia

Peça ao assistente para iniciar a pasta public fornecida por HTTP. Pesquise um tema de um dos textos prontos, abra um resultado e compare com título e resumo prometidos.

Só conteúdo público deve aparecer na busca. Esconder o link de um rascunho no menu não torna privado seu texto incluído.

Um exemplo concreto

Um resultado de busca é útil quando leva ao artigo com conteúdo substancial, não a uma página vazia.

Use o projeto de blog e busca fornecido. Adicione o quarto artigo fornecido ou meu rascunho e atualize os dados de busca junto com ele, mantendo rascunhos privados e destinos seguros. Cuide do código do índice para mim. Ajude a testar uma expressão distinta, um tema ausente e uma falha ao carregar os dados de busca, preservando um caminho para navegar pelos artigos.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O que sua primeira consulta encontrou e onde o resultado abriu?

Mostrar uma solução comentada

Primeira busca ilustrativa: “Pesquisei smaller image e obtive Send a smaller image to a smaller screen. Abrir o resultado levou ao artigo sobre tamanho de exibição e bytes baixados.”

Um título correspondente não basta se seu destino estiver vazio. Rascunhos privados devem ficar fora dos dados públicos de busca, mesmo que seus links de navegação estejam escondidos.

O que uma boa resposta inclui

  • Identifica uma consulta dos artigos públicos fornecidos e o resultado retornado.
  • Abre o resultado e verifica que o destino contém o artigo prometido.
Como funciona (opcional)

Ajude os visitantes a encontrar o artigo certo

A busca deve ligar uma pergunta a uma página real, não apenas animar um campo de pesquisa.

A oficina amplia o blog com search.html, um índice JSON e um script de navegador. Ela pesquisa títulos e textos dos artigos e retorna links para as páginas existentes.

O índice inteiro é público e baixado para o navegador. Não inclua rascunhos privados nem notas confidenciais. A busca aqui é um recurso de navegação, não um sistema de permissões.

Exemplo resolvido

Pesquisar “image” retorna o artigo sobre fontes de imagens menores. Uma palavra sem relação retorna uma mensagem clara de ausência de resultados e mantém disponível o link para navegar pelos artigos.

Exercício técnico complementar

Um rascunho pode continuar privado se você esconder seu link, mas incluir o texto completo em search-index.json?

Mostrar uma solução comentada

Não. Qualquer pessoa pode baixar o JSON. Exclua o conteúdo privado da busca pública e aplique controle de acesso em qualquer backend realmente privado.

  • Reconhece que o próprio índice é público.
  • Mantém o material privado fora dos recursos públicos.

Etapa 1 · Como adicionar busca ao seu site

Use uma expressão distinta

Escolha algo que consiga reconhecer no artigo e na busca.

Explicação, exemplo resolvido e prática

Entenda a ideia

Escolha uma expressão curta e distinta sobre o tema do quarto artigo fornecido ou novo. Peça ao assistente para publicar o artigo e atualizar os dados de busca juntos.

A busca não sabe automaticamente que uma página existe só porque foi salva. Uma busca simples por palavras também pode não encontrar erros de digitação ou expressões pouco familiares.

Um exemplo concreto

Uma expressão exata pode ajudar a isolar se o novo artigo foi conectado à busca.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Qual expressão você usará e consegue encontrá-la no artigo pretendido?

Mostrar uma solução comentada

Plano ilustrativo: “Meu quarto artigo terá a expressão turquoise anchor check. Pedirei ao assistente que publique o texto e adicione sua entrada de busca juntos; depois pesquisarei a mesma expressão.”

Encontrar as palavras em um rascunho salvo não comprova um resultado pesquisável. Primeiro confira que o artigo público as contém, depois teste a busca em execução.

O que uma boa resposta inclui

  • Escolhe uma expressão identificável realmente presente no quarto artigo.
  • Explica que artigo e entrada de busca precisam ser atualizados antes de esperar um resultado.
Como funciona (opcional)

Encontre correspondências de palavras e exiba resultados seguros

Mantenha a regra de correspondência simples o suficiente para explicar e testar.

O script converte a consulta para minúsculas, separa em palavras e exige que todas apareçam em algum ponto do título ou texto do artigo. É correspondência de substrings, não busca semântica nem correção de erros de digitação.

Ele cria links com métodos do DOM e textContent. O validador do índice limita os destinos ao formato esperado dos nomes de arquivo do blog. Isso é útil mesmo em um índice mantido localmente, pois evita destinos malformados ou inseguros por acidente.

A regra aplica AND às palavras da consulta em qualquer ponto do título e do corpo combinados. A ordem não importa: 'image browser' e 'browser image' têm as mesmas correspondências. Não é busca de frase exata. Uma palavra encontrada só no corpo também conta; um erro ortográfico não é corrigido automaticamente.

Exemplo resolvido

“image browser” encontra uma página que contém as duas palavras. “imagge” não vira “image” automaticamente. Se depois quiser tratar erros de digitação, acrescente um comportamento explícito e testes.

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

Exercício técnico complementar

Por que um artigo relevante pode não corresponder a uma consulta que contém uma palavra escrita errado?

Mostrar uma solução comentada

A substring literal não ocorre no texto. A busca atual não corrige erros de digitação; corrija a consulta ou implemente uma alternativa testada.

  • Descreve a correspondência literal implementada.
  • Não afirma que uma solicitação falhou nem que existe compreensão semântica.

Etapa 2 · Como adicionar busca ao seu site

Verifique ausência de resultados e busca com falha

Estados diferentes precisam de próximas ações diferentes.

Explicação, exemplo resolvido e prática

Entenda a ideia

Pesquise um tema ausente e confira o estado sem resultados. Para testar dados indisponíveis, comece com uma página recém-carregada e peça ao assistente que bloqueie ou faça falhar a solicitação de dados localmente antes da primeira busca. A aplicação reutiliza dados já carregados; bloquear só uma solicitação posterior pode não reproduzir a falha esperada.

Nenhum artigo correspondente e busca temporariamente com falha devem ter mensagens diferentes. Mantenha a consulta disponível para corrigir ou repetir e teste o caminho alternativo para todos os artigos. Identifique um bloqueio intencional como simulação, não queda real.

Um exemplo concreto

Um erro na solicitação não comprova que não existe artigo relevante.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O que os testes de tema ausente e busca indisponível mostraram, cada um?

Mostrar uma solução comentada

Registro ilustrativo dos dois estados: “Um tema inventado retornou No matching articles. Em uma página nova com a solicitação de dados bloqueada de propósito, a busca informou indisponibilidade; Browse all articles continuou abrindo o índice.”

Recarregar importa porque a busca mantém os dados carregados na memória. Bloquear depois não reproduziria uma nova falha de carregamento; registre honestamente esse limite da simulação.

O que uma boa resposta inclui

  • Distingue um tema sem correspondência de uma falha ao carregar dados da busca.
  • Testa correção/nova tentativa ou acesso a todos os artigos em cada estado e identifica as simulações.
Como funciona (opcional)

Separe ausência de resultados de busca indisponível

Uma falha ao baixar o índice não prova que nenhum artigo corresponde.

Execute os casos fornecidos de sucesso, assunto ausente e consulta vazia. Depois use as ferramentas de desenvolvimento para bloquear search-index.json e recarregue antes de pesquisar; o script guarda em memória um índice carregado com sucesso.

A mensagem de falha oferece o índice de artigos. O visitante ainda consegue navegar quando a busca falha. Verifique cada URL de resultado e teste o formulário com o teclado.

Exemplo resolvido

“No matching articles” (nenhum artigo correspondente) significa que um índice utilizável foi pesquisado. “Search unavailable” (busca indisponível) significa que o índice não pôde ser obtido ou validado. Essas mensagens descrevem evidências diferentes.

Exercício técnico complementar

A solicitação JSON retorna 500. A página deve dizer que não há artigos correspondentes?

Mostrar uma solução comentada

Não. Informe que a busca está indisponível e mantenha o link para navegar. Só afirme que há zero correspondências depois de carregar e verificar o índice com sucesso.

  • Distingue uma falha de transporte de um conjunto vazio de correspondências.
  • Oferece uma alternativa funcional de navegação.

Etapa 3 · Como adicionar busca ao seu site

Mantenha um novo artigo pesquisável

Repita a tarefa do leitor após a alteração.

Explicação, exemplo resolvido e prática

Entenda a ideia

Conclua o quarto artigo e a entrada de busca correspondente com seu assistente. Recarregue para que a página use dados atuais, pesquise a expressão distinta e abra o artigo retornado.

Verifique se o resultado carregado chega ao conteúdo novo real. Mantenha também funcionando os comportamentos de nenhum resultado, falha e navegação por todos.

Um exemplo concreto

O exemplo fornecido da âncora turquesa é uma comparação, não um tema pessoal obrigatório para escrever.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Apresente o novo artigo e os resultados observados de busca e falha.

O que entregar: O novo artigo e entrada de busca e as verificações observadas de encontrado, nenhum resultado e indisponível.

Mostrar uma solução comentada

Registro final ilustrativo: “Depois de atualizar o quarto artigo e a busca, turquoise anchor check retornou sua nova página. Abri o resultado e encontrei a expressão e a explicação prometidas. Um tema ausente continuou sem resultados e uma simulação de falha ao carregar ainda ofereceu o índice.”

Se o artigo salvo existe, mas a busca não o retorna, o caminho continua incompleto. Peça ao assistente para conferir os dados atuais e a página carregada, em vez de usar o resultado da referência como sua observação.

O que uma boa resposta inclui

  • Retorna o artigo novo pela expressão identificável e abre a página correta com conteúdo completo.
  • Repete os testes de ausência e recuperação de indisponibilidade depois de atualizar o índice.
Como funciona (opcional)

Sua tarefa: manter a busca sincronizada com um artigo novo

Publicar uma página e torná-la pesquisável são etapas separadas neste site pequeno.

Acrescente um quarto artigo e uma entrada correspondente no índice. Escolha uma expressão temática distinta e confirme que ela encontra a nova página. Mantenha o destino dentro do padrão permitido de nomes de arquivo do blog.

Remova temporariamente essa entrada e observe que a página continua existindo, mas deixa de aparecer na busca. Isso mostra por que um site maior pode gerar o índice automaticamente a partir da fonte dos artigos.

Seu quarto artigo pode usar qualquer assunto real e expressão distinta. contact-anchor-check.html e “turquoise anchor check” são apenas o caso de comparação fornecido, não conteúdo obrigatório para a entrega. O importante é que seu nome real de arquivo e seu texto pesquisável correspondam no artigo e no índice carregado.

Exemplo resolvido

Um gerador estático pode produzir as páginas e o índice a partir de uma única fonte. Nesta versão mantida à mão, o registro de teste protege você de esquecer um dos lados.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Exercício técnico complementar

Publique o quarto artigo de exemplo e prove que a busca encontra sua expressão distinta.

Mostrar uma solução comentada

O quarto artigo de referência usa a expressão distinta 'turquoise anchor check'. A entrada correspondente em search-index.json tem seu nome real de arquivo de blog e o resumo e corpo pesquisáveis; os arquivos completos de referência mostram os dois lados.

Recarregue para limpar o índice guardado em memória, pesquise a expressão e abra o artigo retornado. Examine também o JSON carregado: colocar a expressão apenas no HTML sem atualizar o índice não a torna pesquisável.

Teste novamente um assunto ausente e um download bloqueado do índice em uma nova aba ou após recarregar. Ausência de correspondências e busca indisponível devem produzir mensagens diferentes, enquanto Browse all articles (ver todos os artigos) continua funcionando.

  • O resultado abre o artigo real pretendido.
  • O conteúdo novo é indexado sem quebrar o tratamento de falhas e consultas vazias.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.