LektionenSo ergänzt du deine Website um eine Suche

Mini-Lektion 20 von 30 · Daten und KI anbinden

Probiere die fertige Suche aus

Für wen ist das gedacht?

Für alle, deren Leser Themen auf einer kleinen Website finden sollen. Das Suchprojekt wird bereitgestellt; ein Programmierassistent kann seinen technischen Index pflegen.

Finde ein Thema und öffne den tatsächlichen Artikel.

Ziel dieser Lektion

  • Durchsuche die bereitgestellten Inhalte und öffne ein echtes Ergebnis.
  • Ergänze einen neuen Artikel und halte die Suche damit auf dem aktuellen Stand.
  • Unterscheide keine Treffer von nicht verfügbarer Suche.
Erklärung, ausgearbeitetes Beispiel und Übung

Bevor du beginnst

Der bereitgestellte Blog- und Suchworkshop und ein Programmierassistent zum Starten des Ordners public über HTTP. Du kannst die fertigen Artikel verwenden; ein eigener bestehender Blog ist nicht nötig.

Prüfe deine Vorkenntnisse

Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.

  1. So ergänzt du deine Website um einen Blog

    Mache aus einem normalen Entwurf eine gut lesbare Artikelseite.

Geschätzte Dauer: 14–26 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Dieser einfache öffentliche Index eignet sich für kleine Inhaltsbestände. Große Archive und mehrsprachige Relevanzsortierung benötigen eine andere Suchstrategie.

Die Idee verstehen

Lass den Assistenten den bereitgestellten Ordner public über HTTP starten. Suche nach einem Thema aus einem fertigen Beitrag, öffne ein Ergebnis und vergleiche es mit angekündigtem Titel und Zusammenfassung.

Nur öffentliche Inhalte sollen in der Suche erscheinen. Das Verstecken eines Menülinks zu einem Entwurf macht seinen enthaltenen Text nicht privat.

Ein konkretes Beispiel

Ein Suchergebnis ist nützlich, wenn es zum gehaltvollen Artikel führt und nicht zu einer leeren Seite.

Nutze das bereitgestellte Blog- und Suchprojekt. Ergänze den bereitgestellten vierten Artikel oder meinen Entwurf und aktualisiere gemeinsam damit die Suchdaten; halte Entwürfe privat und Linkziele sicher. Übernimm den Indexcode für mich. Hilf beim Testen einer eindeutigen Formulierung, eines fehlenden Themas und fehlschlagenden Ladens der Suchdaten und erhalte einen Weg zum Durchsehen der Artikel.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Was fand deine erste Suche, und wo öffnete sich das Ergebnis?

Ausgearbeitete Lösung anzeigen

Veranschaulichende erste Suche: „Ich suchte smaller image und erhielt Send a smaller image to a smaller screen. Das Öffnen führte zu dem Artikel über Anzeigegröße und heruntergeladene Bytes.“

Ein passender Titel allein reicht nicht, wenn sein Ziel leer ist. Private Entwürfe dürfen auch dann nicht in öffentlichen Suchdaten stehen, wenn ihre Navigationslinks versteckt sind.

Was eine gute Antwort enthält

  • Benennt eine Suchanfrage aus den mitgelieferten öffentlichen Artikeln und ihr Ergebnis.
  • Öffnet das Ergebnis und prüft, dass das Ziel den versprochenen Artikel enthält.
So funktioniert es (optional)

Hilf Besuchern, den richtigen Artikel zu finden

Die Suche sollte eine Frage mit einer echten Seite verbinden und nicht bloß ein Suchfeld animieren.

Der Workshop erweitert die Blogwebsite um search.html, einen JSON-Index und ein Browserskript. Er durchsucht Artikeltitel und Texte und liefert Links zu den bestehenden Seiten.

Der gesamte Index ist öffentlich und wird in den Browser heruntergeladen. Trage keine privaten Entwürfe oder vertraulichen Notizen ein. Die Suche ist hier eine Navigationsfunktion und kein Berechtigungssystem.

Ausgearbeitetes Beispiel

Die Suche nach „image“ liefert den Artikel über kleinere Bildquellen. Ein sachfremdes Wort erzeugt eine klare Kein-Treffer-Meldung, während der Link zum Durchstöbern verfügbar bleibt.

Zusätzliche technische Übung

Kann ein Entwurf privat bleiben, wenn du seinen Seitenlink verbirgst, aber seinen gesamten Text in search-index.json aufnimmst?

Ausgearbeitete Lösung anzeigen

Nein. Jeder kann das JSON herunterladen. Schließe private Inhalte aus der öffentlichen Suche aus und setze Zugriffskontrolle bei jedem tatsächlich privaten Backend durch.

  • Erkennt, dass der Index selbst öffentlich ist.
  • Hält private Inhalte aus öffentlichen Dateien heraus.

Schritt 1 · So ergänzt du deine Website um eine Suche

Nutze eine eindeutige Formulierung

Wähle etwas, das du im Artikel und in der Suche wiedererkennst.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Wähle eine kurze eindeutige Themenformulierung für den vierten bereitgestellten oder neuen Artikel. Bitte den Assistenten, Artikelveröffentlichung und Suchdatenaktualisierung gemeinsam durchzuführen.

Die Suche weiß nicht automatisch von einer Seite, nur weil sie gespeichert wurde. Eine einfache wortbasierte Suche kann auch Tippfehler oder ungewohnte Formulierungen übersehen.

Ein konkretes Beispiel

Eine genaue Formulierung kann zeigen, ob der neue Artikel überhaupt mit der Suche verbunden wurde.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Welche Formulierung nutzt du, und findest du sie im vorgesehenen Artikel?

Ausgearbeitete Lösung anzeigen

Veranschaulichender Suchplan: „Mein vierter Übungsartikel enthält die Formulierung turquoise anchor check. Ich bitte den Assistenten, den Artikel zu veröffentlichen und gleichzeitig den passenden Sucheintrag zu ergänzen; danach suche ich dieselbe Formulierung.“

Wörter in einem gespeicherten Entwurf zu finden belegt kein Suchergebnis. Prüfe zuerst, dass der vorgesehene öffentliche Artikel sie enthält, und teste dann die laufende Suche.

Was eine gute Antwort enthält

  • Wählt eine eindeutig erkennbare Formulierung, die tatsächlich im vierten Artikel vorkommt.
  • Erklärt, dass Artikel und Sucheintrag aktualisiert werden müssen, bevor ein Ergebnis erwartet wird.
So funktioniert es (optional)

Gleiche Wörter ab und stelle sichere Ergebnisse dar

Halte die Vergleichsregel so einfach, dass sie erklärbar und testbar bleibt.

Das Skript wandelt die Anfrage in Kleinbuchstaben um, zerlegt sie in Wörter und verlangt, dass jedes Wort irgendwo im Artikeltitel oder -text vorkommt. Das ist Teilzeichenkettenvergleich und weder semantische Suche noch Tippfehlerkorrektur.

Es erzeugt Links mit DOM-Methoden und textContent. Der Indexvalidator beschränkt Ziele auf das erwartete Blog-Dateinamenformat. Das hilft auch bei einem lokal gepflegten Index, weil es versehentlich fehlerhafte oder unsichere Ziele verhindert.

Die Regel verknüpft die Suchwörter mit AND über den kombinierten Titel und Haupttext. Die Reihenfolge ist egal: „image browser“ und „browser image“ haben dieselben Treffer. Es ist keine Suche nach der exakten Wortfolge. Ein Wort nur im Artikeltext zählt ebenfalls; Tippfehler werden nicht automatisch korrigiert.

Ausgearbeitetes Beispiel

„image browser“ findet eine Seite mit beiden Wörtern. „imagge“ wird nicht automatisch zu „image“. Willst du später Tippfehler behandeln, ergänze ausdrückliches Verhalten und Tests.

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

Zusätzliche technische Übung

Warum kann ein relevanter Artikel bei einer Anfrage mit einem falsch geschriebenen Wort ausbleiben?

Ausgearbeitete Lösung anzeigen

Die wörtliche Teilzeichenkette kommt im Text nicht vor. Die aktuelle Suche hat keine Tippfehlerkorrektur; korrigiere die Anfrage oder implementiere eine getestete Alternative.

  • Beschreibt den implementierten wörtlichen Vergleich.
  • Behauptet weder Anfragefehler noch semantisches Verständnis.

Schritt 2 · So ergänzt du deine Website um eine Suche

Prüfe keine Treffer und eine defekte Suche

Unterschiedliche Zustände brauchen unterschiedliche nächste Schritte.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Suche ein nicht vorhandenes Thema und prüfe den Zustand ohne Treffer. Verwende für den Test nicht verfügbarer Daten eine frisch geladene Seite. Lass den Assistenten die Suchdatenanfrage lokal vor der ersten Suche blockieren oder fehlschlagen lassen. Die App verwendet geladene Daten weiter; nur eine spätere Anfrage zu blockieren reproduziert den vorgesehenen Fehler möglicherweise nicht.

Kein passender Artikel und eine vorübergehend gescheiterte Suche sollten verschiedene Meldungen haben. Die Anfrage muss zum Korrigieren oder Wiederholen erhalten bleiben; probiere auch den Ausweichweg zur Übersicht aller Artikel. Kennzeichne eine absichtlich blockierte Anfrage als Simulation, nicht als echten Ausfall.

Ein konkretes Beispiel

Ein Anfragefehler beweist nicht, dass kein passender Artikel existiert.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Was zeigten die Tests für fehlendes Thema und nicht verfügbare Suche jeweils?

Ausgearbeitete Lösung anzeigen

Veranschaulichendes Protokoll beider Zustände: „Ein erfundenes Thema lieferte No matching articles. Auf einer frisch geladenen Seite mit absichtlich blockierter Suchdatenanfrage meldete die Suche Nichtverfügbarkeit; Browse all articles öffnete weiterhin den Index.“

Das frische Laden ist wichtig, weil diese Suche erfolgreich geladene Daten im Speicher behält. Eine nach dem Laden blockierte Anfrage würde keinen neuen Ladefehler reproduzieren. Halte diese Simulationsgrenze ehrlich fest.

Was eine gute Antwort enthält

  • Unterscheidet ein fehlendes Thema von einem fehlgeschlagenen Laden der Suchdaten.
  • Prüft je Zustand einen Korrektur-, Wiederholungs- oder Alle-Artikel-Weg und kennzeichnet jede Simulation.
So funktioniert es (optional)

Unterscheide fehlende Treffer von nicht verfügbarer Suche

Ein fehlgeschlagener Indexdownload beweist nicht, dass kein Artikel passt.

Führe die mitgelieferten Fälle Erfolg, fehlendes Thema und leere Anfrage aus. Blockiere dann in den Entwicklertools search-index.json und lade vor der Suche neu; das Skript speichert einen erfolgreich geladenen Index im Arbeitsspeicher zwischen.

Die Fehlermeldung bietet die Artikelübersicht an. Besucher können bei einem Suchausfall weiterhin stöbern. Prüfe jede Ergebnis-URL und teste das Formular mit der Tastatur.

Ausgearbeitetes Beispiel

„No matching articles“ bedeutet, dass ein benutzbarer Index durchsucht wurde. „Search unavailable“ bedeutet, dass der Index nicht geladen oder validiert werden konnte. Die Meldungen beschreiben unterschiedliche Belege.

Zusätzliche technische Übung

Die JSON-Anfrage liefert 500. Sollte die Seite behaupten, dass keine Artikel passen?

Ausgearbeitete Lösung anzeigen

Nein. Melde die Suche als nicht verfügbar und behalte den Link zum Stöbern. Behaupte null Treffer erst nach erfolgreichem Laden und Prüfen des Index.

  • Unterscheidet Übertragungsfehler von leeren Treffern.
  • Bietet einen funktionierenden alternativen Navigationsweg.

Schritt 3 · So ergänzt du deine Website um eine Suche

Halte einen neuen Artikel auffindbar

Wiederhole die Leseraufgabe nach der Änderung.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Stelle mit deinem Assistenten den vierten Artikel und den passenden Sucheintrag fertig. Lade neu, damit die laufende Seite aktuelle Daten nutzt, suche die eindeutige Formulierung und öffne den zurückgegebenen Artikel.

Prüfe, ob das geladene Ergebnis zu den tatsächlichen neuen Inhalten führt. Erhalte auch das Verhalten bei fehlenden Treffern, Fehlern und beim Durchsehen aller Artikel.

Ein konkretes Beispiel

Das bereitgestellte Beispiel mit dem türkisfarbenen Anker dient zum Vergleich und ist kein vorgeschriebenes persönliches Schreibthema.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Lege den neuen Artikel und die beobachteten Such- und Fehlerergebnisse vor.

Dein Ergebnis: Der neue Artikel mit Sucheintrag und beobachtete Prüfungen für gefunden, keine Treffer und nicht verfügbar.

Ausgearbeitete Lösung anzeigen

Veranschaulichendes Abschlussprotokoll: „Nach der Aktualisierung des vierten Artikels und der Suchdaten lieferte turquoise anchor check dessen neue Seite. Ich öffnete das Ergebnis und fand die versprochene Formulierung und Erklärung. Ein nicht vorhandenes Thema lieferte weiter keine Treffer; eine simulierte Störung beim frischen Laden bot weiter den Artikelindex an.“

Existiert der gespeicherte Artikel, erscheint aber nicht in der Suche, ist der Suchweg unvollständig. Bitte den Assistenten, aktuelle Suchdaten und geladene Seite zu prüfen, statt das Referenzergebnis als eigene Beobachtung zu behandeln.

Was eine gute Antwort enthält

  • Findet den neuen Artikel über seine eindeutige Formulierung und öffnet die richtige vollständige Seite.
  • Prüft nach der Indexaktualisierung erneut fehlende Treffer und die Erholung bei unverfügbarer Suche.
So funktioniert es (optional)

Deine Aufgabe: halte die Suche mit einem neuen Artikel synchron

Eine Seite zu veröffentlichen und sie durchsuchbar zu machen sind auf dieser kleinen Website getrennte Schritte.

Ergänze einen vierten Artikel und den passenden Indexeintrag. Wähle einen unverwechselbaren Themenausdruck und prüfe, ob er die neue Seite findet. Halte das Ziel im erlaubten Blog-Dateinamenmuster.

Entferne diesen Eintrag vorübergehend und beobachte, dass die Seite weiter existiert, aber nicht mehr in der Suche erscheint. Das zeigt, warum größere Websites ihren Index automatisch aus den Artikelquellen erzeugen können.

Dein vierter Artikel kann jedes echte Thema und einen eigenen unverwechselbaren Ausdruck verwenden. contact-anchor-check.html und „turquoise anchor check“ sind nur der mitgelieferte Vergleichsfall und keine vorgeschriebenen Abgabeinhalte. Entscheidend ist, dass dein tatsächlicher Dateiname und durchsuchbarer Text in Artikel und geladenem Index übereinstimmen.

Ausgearbeitetes Beispiel

Ein statischer Generator kann Seiten und Index aus derselben Quelle erzeugen. In dieser manuell gepflegten Version schützt dein Testprotokoll davor, eine der beiden Aktualisierungen – Artikelseite oder Indexeintrag – zu vergessen.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Zusätzliche technische Übung

Veröffentliche den vierten Beispielartikel und belege, dass die Suche seinen unverwechselbaren Ausdruck findet.

Ausgearbeitete Lösung anzeigen

Der vierte Referenzartikel verwendet den unverwechselbaren Ausdruck „turquoise anchor check“. Sein Eintrag in search-index.json enthält den tatsächlichen Blogdateinamen und durchsuchbare Zusammenfassungs-/Haupttexte; die vollständigen Referenzdateien zeigen beide Seiten.

Lade neu, um den Indexcache im Arbeitsspeicher zu leeren, suche den Ausdruck und öffne den gelieferten Artikel. Prüfe auch das geladene JSON: Den Ausdruck nur ins HTML einzutragen, ohne den Index zu aktualisieren, macht ihn nicht durchsuchbar.

Teste ein fehlendes Thema und einen blockierten Indexdownload erneut in einem neuen Tab oder nach Neuladen. Fehlende Treffer und nicht verfügbare Suche müssen unterschiedliche Meldungen erzeugen, während Browse all articles weiter funktioniert.

  • Das Ergebnis öffnet den vorgesehenen echten Artikel.
  • Neue Inhalte sind indexiert, ohne Fehlerbehandlung und Behandlung leerer Anfragen zu beschädigen.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.