Mini-Lektion · Deutsch

So ergänzt du deine Website um eine Suche

Ergänze mit einem Assistenten einen neuen bereitgestellten Artikel und prüfe, ob Besucher ihn über die fertige Suchseite finden und öffnen können.

Interaktive Lektion startenLektionsnotizen lesen

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.

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.

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.

Was du lernen wirst

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

Workshop-Dateien

Schritt 1

Probiere die fertige Suche aus

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

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

Start hereWorkshop-Dateien

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

How it works (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.

Extra implementation exercise

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 2

Nutze eine eindeutige Formulierung

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

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

Start hereWorkshop-Dateien

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

How it works (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))
);

Extra implementation exercise

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 3

Prüfe keine Treffer und eine defekte Suche

Unterschiedliche Zustände brauchen unterschiedliche nächste Schritte.

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

Start hereWorkshop-Dateien

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

How it works (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.

Extra implementation exercise

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 4

Halte einen neuen Artikel auffindbar

Wiederhole die Leseraufgabe nach der Änderung.

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

Start hereWorkshop-Dateien

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

How it works (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.

Extra implementation exercise

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.

Weiterlernen

Weitere Lektionen entdecken