Minilição · Português

Como adicionar busca ao seu site

Adicione um novo artigo fornecido com um assistente e verifique se visitantes conseguem encontrá-lo e abri-lo pela página de busca pronta.

Começar a aula interativaLer as notas da aula

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.

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.

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.

O que você vai aprender

  • 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.

Arquivos da oficina

Etapa 1

Experimente a busca pronta

Encontre um tema e abra o artigo real.

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 2

Use uma expressão distinta

Escolha algo que consiga reconhecer no artigo e na busca.

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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))
);

Extra implementation exercise

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 3

Verifique ausência de resultados e busca com falha

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

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 4

Mantenha um novo artigo pesquisável

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

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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.

Continue aprendendo

Explore as outras lições