
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.
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.
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
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
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
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- public/search-index.jsonDiese Datei herunterladen
- public/search.jsDiese Datei herunterladen
- search-tests.txtDiese Datei herunterladen
- worksheet.htmlDiese Datei herunterladen
- reference/assignment-walkthrough.txtDiese Datei herunterladen
- reference/public/index.htmlDiese Datei herunterladen
- reference/public/blog/contact-anchor-check.htmlDiese Datei herunterladen
- reference/public/search-index.jsonDiese Datei herunterladen
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
- So erstellst du deine erste persönliche Website
- So veröffentlichst du deine Website über GitHub
- So verbindest du eine eigene Domain mit deiner Website
- So richtest du E-Mail auf deiner eigenen Domain ein
- So machst du deine Website auf Telefonen benutzbar
- So laden Bilder deiner Website schneller
- So erhältst du Website-Feedback in deinem Postfach
- So ergänzt du deine Website um E-Mail-Abonnements
- So sendest du automatisierte E-Mails von deiner Website
- So speicherst du Formulareingaben in einer Datenbank
- So können sich Menschen auf deiner Website anmelden
- So hältst du eine Seite privat
- So können Nutzer ihre Profilinformationen bearbeiten
- So können Nutzer Bilder hochladen
- So hältst du API-Schlüssel aus deinem Frontend heraus
- So zeigst du Daten einer externen API auf deiner Website
- So ergänzt du deine Website um einen KI-Chatbot
- So beantwortet ein Chatbot Fragen anhand deiner eigenen Inhalte
- So ergänzt du deine Website um einen Blog
- So ergänzt du deine Website um eine weitere Sprache
- So hilfst du Google, deine Website zu finden
- So reparierst du die Vorschau deiner Website beim Teilen eines Links
- So misst du Besuche und nützliche Aktionen auf deiner Website
- So können Besucher einen Termin buchen
- So nimmst du eine Zahlung auf deiner Website an
- So prüfst du Website-Änderungen vor dem Veröffentlichen
- So machst du ein fehlerhaftes Website-Deployment rückgängig
- So sicherst du deine Website-Daten und stellst sie wieder her
- So findest und behebst du Fehler auf deiner veröffentlichten Website