
Minilección 20 de 30 · Conectar datos e IA
Prueba la búsqueda lista
¿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.
Encuentra un tema y abre el artículo real.
Propósito de esta lección
- 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.
Explicación, ejemplo resuelto y práctica
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.
Comprueba tus habilidades iniciales
Son habilidades útiles, no cursos obligatorios bloqueados. Si ya las tienes, empieza aquí; si no, abre la preparación. Los archivos incluidos evitan necesitar un sitio personal previo.
- Cómo añadir un blog a tu sitio web
Convierte un borrador normal en un artículo legible.
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.
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué encontró la primera búsqueda y dónde abrió el resultado?
Mostrar una solución desarrollada
Ejemplo inicial: «Busqué smaller image y salió Send a smaller image to a smaller screen. Abrirlo llevó a la explicación de tamaño visible frente a bytes descargados».
Un título coincidente no basta con destino vacío. Los borradores privados deben quedar fuera del índice público aunque sus enlaces estén ocultos.
Qué incluye una respuesta adecuada
- Nombra una consulta de los artículos públicos y su resultado.
- Abre el resultado y comprueba que contiene el artículo prometido.
Cómo funciona (opcional)
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.
Ejercicio técnico adicional
¿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 1 · Cómo añadir búsqueda a tu sitio web
Usa una frase distintiva
Elige algo reconocible en artículo y búsqueda.
Explicación, ejemplo resuelto y práctica
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué frase usarás y la encuentras en el artículo previsto?
Mostrar una solución desarrollada
Ejemplo de plan de búsqueda: «Mi cuarto artículo de práctica contendrá la frase turquoise anchor check. Pediré al asistente que publique el artículo y añada su entrada de búsqueda correspondiente a la vez; después buscaré esa misma frase».
Encontrar palabras en un borrador guardado no demuestra un resultado buscable. Comprueba que la página pública las contenga y prueba después el buscador funcionando.
Qué incluye una respuesta adecuada
- Elige una frase distintiva realmente presente en el cuarto artículo.
- Explica que artículo y entrada de búsqueda deben actualizarse antes de esperar resultados.
Cómo funciona (opcional)
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))
);Ejercicio técnico adicional
¿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 2 · Cómo añadir búsqueda a tu sitio web
Comprueba ausencia y búsqueda rota
Distintos estados necesitan acciones diferentes.
Explicación, ejemplo resuelto y práctica
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué mostraron tema ausente y búsqueda no disponible?
Mostrar una solución desarrollada
Ejemplo de dos estados: «Un tema inventado devolvió No matching articles. En una página nueva con petición bloqueada, el buscador indicó indisponibilidad; Browse all articles aún abrió el índice».
La carga nueva importa porque este buscador mantiene en memoria los datos que ya obtuvo correctamente. Bloquear la solicitud cuando esos datos ya están cargados no reproduce un fallo nuevo de carga; explica con claridad ese límite de la simulación.
Qué incluye una respuesta adecuada
- Distingue tema ausente y fallo de carga de datos.
- Comprueba corrección, reintento o acceso al índice en cada estado y etiqueta simulaciones.
Cómo funciona (opcional)
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.
Ejercicio técnico adicional
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 3 · Cómo añadir búsqueda a tu sitio web
Mantén localizable un artículo nuevo
Repite la tarea del lector tras el cambio.
Explicación, ejemplo resuelto y práctica
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
- public/search-index.jsonDescargar este archivo
- public/search.jsDescargar este archivo
- search-tests.txtDescargar este archivo
- worksheet.htmlDescargar este archivo
- reference/assignment-walkthrough.txtDescargar este archivo
- reference/public/index.htmlDescargar este archivo
- reference/public/blog/contact-anchor-check.htmlDescargar este archivo
- reference/public/search-index.jsonDescargar este archivo
Pruébalo
Entrega artículo nuevo y resultados observados de búsqueda/fallo.
Qué debes entregar: El artículo/entrada nuevos y pruebas observadas encontrado, sin coincidencias y no disponible.
Mostrar una solución desarrollada
Ejemplo final: «Tras actualizar artículo y datos, turquoise anchor check devolvió la nueva página. Abrí el resultado y encontré frase y explicación. Un tema ausente siguió sin coincidencias y una simulación con carga nueva siguió ofreciendo el índice».
Si el artículo guardado existe pero el buscador no lo devuelve, la ruta de búsqueda sigue incompleta. Pide al asistente que inspeccione los datos actuales y la página cargada, en lugar de presentar el resultado de la referencia como una observación propia.
Qué incluye una respuesta adecuada
- Obtiene el nuevo artículo con su frase y abre la página correcta con contenido.
- Repite ausencia de coincidencias y recuperación de indisponibilidad tras actualizar el índice.
Cómo funciona (opcional)
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.
Ejercicio técnico adicional
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.