Minilección · Español

Cómo añadir búsqueda a tu sitio web

Añade otro artículo proporcionado con el asistente y verifica que los visitantes lo encuentren y abran desde la búsqueda lista.

Comenzar la lección interactivaLeer los apuntes

¿Para quién es esta lección?

Para quienes quieren que los lectores encuentren temas en un sitio pequeño. Se proporciona el proyecto de búsqueda; un asistente de programación puede mantener su índice técnico.

Antes de empezar

El taller de blog/búsqueda y un asistente para servir public sobre HTTP. Puedes usar sus artículos; no necesitas blog previo.

Tiempo estimado: 14–26 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. Este índice público sencillo sirve para conjuntos pequeños de contenido. Los archivos grandes y la clasificación multilingüe necesitan otra estrategia de búsqueda.

Qué aprenderás

  • Busca en el contenido y abre un resultado real.
  • Añade un artículo y mantén sincronizada la búsqueda.
  • Distingue cero coincidencias y búsqueda no disponible.

Archivos del taller

Paso 1

Prueba la búsqueda lista

Encuentra un tema y abre el artículo real.

Pide iniciar public sobre HTTP. Busca un tema de los artículos, abre un resultado y compáralo con título/resumen prometidos.

Solo debe aparecer contenido público. Ocultar el enlace de un borrador no hace privado su texto incluido.

Un ejemplo concreto

El resultado es útil si lleva a un artículo sustancial, no vacío.

Usa el blog/búsqueda. Añade el cuarto artículo o mi borrador y actualiza juntos los datos, conservando borradores privados y destinos seguros. Gestiona el índice. Ayuda a probar una frase distintiva, un tema ausente y fallo de carga de datos manteniendo una vía para explorar artículos.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Ayuda al visitante a encontrar el artículo adecuado

La búsqueda debe conectar una pregunta con una página real, no limitarse a animar una caja de búsqueda.

El taller amplía el sitio del blog con search.html, un índice JSON y un script del navegador. Busca en títulos y textos de artículos y devuelve enlaces a páginas existentes.

Todo el índice es público y se descarga al navegador. No incluyas borradores privados ni notas confidenciales. Aquí la búsqueda es una función de navegación, no un sistema de permisos.

Ejemplo resuelto

Buscar “image” devuelve el artículo sobre recursos de imagen más pequeños. Una palabra no relacionada devuelve un mensaje claro sin resultados y mantiene disponible el enlace para explorar.

Extra implementation exercise

¿Puede seguir siendo privado un borrador si ocultas su enlace pero incluyes el texto completo en search-index.json?

Mostrar una solución desarrollada

No. Cualquiera puede descargar el JSON. Excluye el contenido privado de la búsqueda pública y aplica control de acceso en cualquier backend realmente privado.

  • Reconoce que el propio índice es público.
  • Mantiene el material privado fuera de los recursos públicos.

Paso 2

Usa una frase distintiva

Elige algo reconocible en artículo y búsqueda.

Elige una frase temática breve para el cuarto artículo proporcionado o nuevo. Pide publicar y actualizar la búsqueda juntos.

Guardar una página no hace que la búsqueda sepa automáticamente que existe. Una búsqueda por palabras también puede fallar con erratas o formulaciones distintas.

Un ejemplo concreto

Una frase exacta permite aislar si se conectó el artículo a la búsqueda.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Busca coincidencias de palabras y muestra resultados seguros

Haz que la regla de coincidencia sea lo bastante sencilla para explicarla y probarla.

El script convierte la consulta a minúsculas, la divide en palabras y exige que todas aparezcan en algún lugar del título o texto del artículo. Es coincidencia de subcadenas, no búsqueda semántica ni corrección de erratas.

Crea enlaces mediante métodos del DOM y textContent. El validador del índice limita los destinos al formato previsto de nombres de archivo del blog. Esto también resulta útil para un índice mantenido localmente porque evita destinos mal formados o inseguros por accidente.

La regla utiliza AND entre las palabras de consulta, en cualquier punto del título y cuerpo combinados. El orden no importa: 'image browser' y 'browser image' tienen las mismas coincidencias. No es una búsqueda de frase exacta. Una palabra que solo aparece en el cuerpo también cuenta; un error ortográfico no se corrige automáticamente.

Ejemplo resuelto

“image browser” coincide con una página que contiene ambas palabras. “imagge” no se convierte automáticamente en “image”. Si después quieres gestionar erratas, añade un comportamiento explícito y pruebas.

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

Extra implementation exercise

¿Por qué podría un artículo relevante no coincidir con una consulta que contiene una palabra mal escrita?

Mostrar una solución desarrollada

La subcadena literal no aparece en su texto. La búsqueda actual no corrige erratas; corrige la consulta o implementa una alternativa probada.

  • Describe la coincidencia literal implementada.
  • No afirma que haya fallado una solicitud ni que exista comprensión semántica.

Paso 3

Comprueba ausencia y búsqueda rota

Distintos estados necesitan acciones diferentes.

Busca un tema ausente y examina ese estado. Para datos indisponibles, recarga una página nueva y pide bloquear o hacer fallar la petición local antes de la primera búsqueda. La aplicación reutiliza los datos cargados; bloquear una petición posterior quizá no reproduzca ese fallo.

Sin artículo coincidente y buscador temporalmente averiado deben mostrar mensajes distintos. Conserva la consulta para corregir o repetir y prueba explorar todos los artículos. Identifica el bloqueo deliberado como simulación, no caída real.

Un ejemplo concreto

Un error de petición no demuestra que no exista un artículo pertinente.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Distingue entre ausencia de resultados y búsqueda no disponible

Que falle la descarga del índice no demuestra que ningún artículo coincida.

Ejecuta los casos proporcionados de búsqueda correcta, tema ausente y consulta vacía. Después bloquea search-index.json con las herramientas de desarrollo y recarga antes de buscar; el script guarda en memoria el índice cargado correctamente.

El mensaje de error ofrece el índice de artículos. El visitante puede seguir explorando aunque falle la búsqueda. Verifica cada URL de resultado y prueba el formulario con el teclado.

Ejemplo resuelto

“No matching articles” (no hay artículos coincidentes) significa que se buscó en un índice utilizable. “Search unavailable” (búsqueda no disponible) significa que el índice no pudo obtenerse o validarse. Los mensajes expresan pruebas distintas.

Extra implementation exercise

La solicitud JSON devuelve 500. ¿Debe decir la página que no hay artículos coincidentes?

Mostrar una solución desarrollada

No. Indica que la búsqueda no está disponible y conserva el enlace para explorar. Afirma que hay cero coincidencias solo después de cargar y comprobar correctamente el índice.

  • Distingue un fallo de transporte de un conjunto de coincidencias vacío.
  • Ofrece una vía alternativa de navegación funcional.

Paso 4

Mantén localizable un artículo nuevo

Repite la tarea del lector tras el cambio.

Completa cuarto artículo y entrada con ayuda. Recarga para usar datos actuales, busca la frase y abre el resultado.

Verifica que llegue al nuevo contenido real. Conserva también ausencia, fallos y exploración completa.

Un ejemplo concreto

El ejemplo turquoise-anchor sirve para comparar, no es un tema personal obligatorio.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Tu tarea: mantener la búsqueda al día con un artículo nuevo

Publicar una página e incluirla en la búsqueda son pasos distintos en este pequeño sitio.

Añade un cuarto artículo y su entrada de índice correspondiente. Elige una frase temática distintiva y confirma que permite encontrar la nueva página. Mantén el destino dentro del patrón permitido de nombres de archivo del blog.

Elimina temporalmente esa entrada y observa que la página sigue existiendo pero deja de aparecer en la búsqueda. Esto muestra por qué un sitio mayor puede generar el índice automáticamente desde la fuente de los artículos.

Tu cuarto artículo puede tratar cualquier tema genuino y usar una frase distintiva. contact-anchor-check.html y “turquoise anchor check” son solo el caso de comparación proporcionado, no contenido obligatorio para la entrega. Lo importante es que tu nombre real de archivo y tu texto de búsqueda coincidan en el artículo y en el índice cargado.

Ejemplo resuelto

Un generador estático puede producir las páginas y el índice desde una sola fuente. En esta versión mantenida a mano, el registro de pruebas te protege de olvidar uno de los lados.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

Extra implementation exercise

Publica el cuarto artículo de muestra y demuestra que la búsqueda encuentra su frase distintiva.

Mostrar una solución desarrollada

El cuarto artículo de referencia utiliza la frase distintiva 'turquoise anchor check'. Su entrada correspondiente en search-index.json contiene el nombre real de archivo del blog y el resumen y cuerpo que se pueden buscar; los archivos completos de referencia muestran ambos lados.

Recarga para borrar el índice guardado en memoria, busca esa frase y abre el artículo devuelto. Examina también el JSON cargado: incluir la frase solo en el HTML sin actualizar el índice no hará que aparezca en la búsqueda.

Vuelve a probar un tema ausente y una descarga del índice bloqueada en una pestaña nueva o tras recargar. La ausencia de coincidencias y la búsqueda no disponible deben producir mensajes distintos, mientras Browse all articles (explorar todos los artículos) sigue funcionando.

  • El resultado abre el artículo real previsto.
  • El contenido nuevo queda indexado sin romper el tratamiento de fallos ni de consultas vacías.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones