Mini ders · Türkçe

Web sitenize nasıl arama eklersiniz?

Asistanla verilen yeni bir yazı ekleyin; ziyaretçilerin hazır arama sayfasından bunu bulup açabildiğini doğrulayın.

Etkileşimli derse başlaDers notlarını oku

Bu ders kimler için?

Okurların küçük web sitesinde konu bulmasını isteyenler için. Arama projesi verilir; kodlama asistanı teknik dizinini güncel tutabilir.

Başlamadan önce

Verilen blog/arama atölyesi ve public klasörünü HTTP üzerinden başlatacak kodlama asistanı. Hazır yazıları kullanabilirsiniz; kişisel blogunuzun olması gerekmez.

Tahmini süre: 14–26 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Bu basit, herkese açık arama listesi az sayıda içerik için uygundur. Büyük arşivler ve birden fazla dilde sonuçları sıralamak için başka bir arama yaklaşımı gerekir.

Neler öğreneceksin?

  • Verilen içerikte arama yapıp gerçek sonucu açın.
  • Yeni yazı ekleyin ve aramayı onunla birlikte güncelleyin.
  • Eşleşme olmamasını aramanın kullanılamamasından ayırın.

Uygulama dosyaları

Adım 1

Hazır aramayı deneyin

Bir konu bulup gerçek yazıyı açın.

Sağlanan public klasörünü HTTP üzerinden açmasını asistandan isteyin. Hazır yazılardan bir konu arayın; sonra sonucu açıp vaat edilen başlık ve özetle karşılaştırın.

Aramada yalnızca herkese açık içerik görünmelidir. Taslağın menü bağlantısını gizlemek, dâhil edilen metnini özel yapmaz.

Somut bir örnek

Arama sonucu, boş sayfa yerine anlamlı yazıya götürdüğünde faydalıdır.

Verilen blog/arama projesini kullan. Taslakları özel, hedefleri güvenli tutarak verilen dördüncü yazıyı veya taslağımı ekle ve arama verilerini birlikte güncelle. Dizin kodunu benim için düzenle. Yazılara göz atma yolunu korurken ayırt edilebilir bir ifadeyi, bulunmayan konuyu ve başarısız arama verisi yüklemesini sınamama yardım et.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

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

How it works (optional)

Ziyaretçinin doğru yazıyı bulmasına yardım edin

Arama, ziyaretçiyi sorusuyla ilgili gerçek bir sayfaya ulaştırmalı; yalnızca hareketli bir arama kutusu göstermemeli.

Bu uygulama blog sitesine search.html, aranacak yazıları içeren bir JSON dosyası ve bir tarayıcı betiği ekler. Yazıların başlık ve metinlerinde arama yapıp var olan sayfalara bağlantı döndürür.

Arama listesinin tamamı herkese açıktır ve tarayıcıya indirilir. Özel taslakları veya gizli notları bu dosyaya koymayın. Buradaki arama, sayfalar arasında gezinmeye yarar; erişim izni veren bir sistem değildir.

Çözülmüş örnek

“image” araması, daha küçük görsel dosyalarını anlatan yazıyı bulur. İlgisiz bir sözcük arandığında eşleşme bulunmadığı açıkça söylenir ve bütün yazılara gitme bağlantısı kullanılabilir kalır.

Extra implementation exercise

Taslağın sayfa bağlantısını gizleyip bütün metnini search-index.json içine koyarsanız taslak özel kalır mı?

Çözülmüş örneği göster

Hayır. JSON dosyasını herkes indirebilir. Özel içeriği herkese açık aramaya eklemeyin; gerçekten özel veriyi sunan sunucuda da erişim iznini denetleyin.

  • Arama listesinin kendisinin herkese açık olduğunu fark eder.
  • Özel içeriği herkese sunulan dosyalardan uzak tutar.

Adım 2

Ayırt edilebilir bir ifade kullanın

Yazıda ve aramada tanıyabileceğiniz bir şey seçin.

Verilen veya yeni dördüncü yazı için kısa, ayırt edilebilir bir konu ifadesi seçin. Asistandan yazıyı yayımlamasını ve arama verilerini birlikte güncellemesini isteyin.

Sayfanın kaydedilmiş olması, aramanın onun varlığını otomatik bilmesini sağlamaz. Basit sözcük tabanlı arama, yazım hatalarını veya farklı ifadeleri de kaçırabilir.

Somut bir örnek

Tam eşleşen ifade, yeni yazının aramaya bağlanıp bağlanmadığını ayırt edebilir.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

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

How it works (optional)

Sözcükleri eşleştirin ve güvenli sonuçlar gösterin

Aramanın nasıl eşleşme bulduğunu açıklayabilecek ve deneyebilecek kadar basit tutun.

Betik aramayı küçük harfe çevirir, sözcüklere ayırır ve her sözcüğün başlıkta veya metinde bir yerde geçmesini ister. Metnin içinde aynı karakter dizisini arar; anlamı yorumlamaz ve yazım hatasını düzeltmez.

Bağlantıları DOM yöntemleri ve textContent ile oluşturur. Arama listesini kontrol eden kod, hedefleri beklenen blog dosya adı biçimiyle sınırlar. Listeyi siz hazırlasanız bile bu kontrol, yanlışlıkla bozuk veya güvenli olmayan adresler eklenmesini önler.

Aramadaki sözcükler AND, yani hepsi bulunmalı kuralıyla değerlendirilir; başlık ve metnin birleşimi içinde herhangi bir yerde geçebilirler. Sıra önemli değildir: 'image browser' ve 'browser image' aynı sonuçları verir. Birebir cümle araması yapılmaz. Sözcüğün yalnızca yazının içinde bulunması da yeterlidir; yazım hatası otomatik düzeltilmez.

Çözülmüş örnek

“image browser”, iki sözcüğü de içeren sayfayı bulur. “imagge” kendiliğinden “image” olarak yorumlanmaz. Daha sonra yazım hatası desteği istiyorsanız nasıl davranacağını belirleyip testlerini ekleyin.

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

Extra implementation exercise

Konuyla ilgili bir yazı, yanlış yazılmış sözcük içeren aramada neden bulunmayabilir?

Çözülmüş örneği göster

Aranan karakter dizisi metinde aynen geçmiyordur. Bu arama yazım hatası düzeltmez. Aramayı düzeltin veya doğruluğunu deneyebildiğiniz başka bir eşleştirme yöntemi ekleyin.

  • Kodun metni yazıldığı gibi eşleştirdiğini açıklar.
  • İsteğin bozulduğunu veya aramanın anlamı kavradığını iddia etmez.

Adım 3

Eşleşme olmamasını ve bozuk aramayı kontrol edin

Farklı durumlar farklı sonraki adımlar gerektirir.

Olmayan konu arayın ve eşleşme yok durumunu inceleyin. Veri kullanılamıyor kontrolünde yeni sayfa yüklemesi kullanın; ilk aramadan önce yerel arama verisi isteğini engellemesini veya başarısız yaptırmasını asistandan isteyin. Uygulama yüklenen veriyi tekrar kullanır; yalnızca sonraki isteği engellemek istenen hatayı üretmeyebilir.

Eşleşen yazı bulunmaması ve aramanın geçici olarak çalışmaması farklı mesajlar göstermeli. Sorgu düzeltme/tekrar deneme için kalsın; bütün yazıları gezme alternatifini deneyin. Bilerek engellenen isteği gerçek kesinti değil benzetim olarak etiketleyin.

Somut bir örnek

İstek hatası, ilgili yazının bulunmadığını kanıtlamaz.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

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

How it works (optional)

Sonuç bulunamamasıyla aramanın kullanılamamasını ayırın

Arama dosyasının indirilememesi, hiçbir yazının eşleşmediğini kanıtlamaz.

Verilen başarılı aramayı, bulunmayan konuyu ve boş aramayı deneyin. Sonra geliştirici araçlarıyla search-index.json isteğini engelleyin ve yeniden aramadan önce sayfayı yenileyin. Betik başarıyla yüklediği listeyi bellekte tutar.

Hata mesajı yazı listesine gitme seçeneği sunar. Arama bozulsa da ziyaretçi yazıları gezebilir. Her sonuç bağlantısını doğrulayın ve formu klavyeyle de deneyin.

Çözülmüş örnek

“No matching articles” (eşleşen yazı yok), kullanılabilir bir listede arama yapıldığını söyler. “Search unavailable” (arama kullanılamıyor), listenin alınamadığını veya doğrulanamadığını söyler. Bu iki mesaj farklı gözlemleri anlatır.

Extra implementation exercise

JSON isteği 500 döndürüyor. Sayfa eşleşen yazı bulunmadığını mı söylemeli?

Çözülmüş örneği göster

Hayır. Aramanın kullanılamadığını söyleyin ve yazı listesi bağlantısını koruyun. Ancak listeyi başarıyla yükleyip aradıktan sonra eşleşme bulunmadığını söyleyebilirsiniz.

  • Veriyi getirme hatasıyla sıfır eşleşmeyi birbirinden ayırır.
  • Yazılara ulaşmak için çalışan başka bir yol sunar.

Adım 4

Yeni yazıyı aranabilir tutun

Değişiklikten sonra okur görevini tekrarlayın.

Asistanınızla dördüncü yazıyı ve eşleşen arama girdisini tamamlayın. Çalışan sayfanın güncel veriyi kullanması için yeniden yükleyin; ayırt edilebilir ifadeyi arayıp dönen yazıyı açın.

Yüklenen sonucun gerçekten yeni içeriğe ulaştığını doğrulayın. Eşleşme olmaması, hata ve tümüne göz atma davranışı da çalışmaya devam etsin.

Somut bir örnek

Verilen turquoise-anchor örneği, zorunlu kişisel yazı konusu değil karşılaştırmadır.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

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

How it works (optional)

Ödeviniz: yeni yazıyı aramaya da ekleyin

Bu küçük sitede sayfayı yayımlamak ve aramada bulunmasını sağlamak ayrı adımlardır.

Dördüncü yazıyı ve arama listesindeki karşılığını ekleyin. Konuyu ayırt eden bir ifade seçip yeni sayfayı bulduğunu doğrulayın. Bağlantı hedefini izin verilen blog dosya adı biçiminde tutun.

Liste kaydını geçici olarak kaldırın. Sayfanın hâlâ var olduğunu ama aramada görünmediğini gözlemleyin. Bu deneme, daha büyük sitelerde arama listesini yazı kaynağından otomatik üretmenin neden yararlı olduğunu gösterir.

Dördüncü yazıda gerçek bir konu ve ayırt edici bir ifade seçebilirsiniz. contact-anchor-check.html ile “turquoise anchor check” yalnızca verilen karşılaştırma örneğidir; bunları tesliminizde kullanmanız gerekmez. Önemli olan kendi gerçek dosya adınızın ve aranan metnin, yazı ile yüklenen listede birbirine uymasıdır.

Çözülmüş örnek

Bir statik site üreticisi hem sayfaları hem arama listesini aynı kaynaktan oluşturabilir. Elle düzenlenen bu sürümde test kaydı, iki taraftan birini unutmadığınızı kontrol etmenizi sağlar.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

Extra implementation exercise

Dördüncü örnek yazıyı yayımlayın ve seçtiğiniz ayırt edici ifadeyle bulunabildiğini gösterin.

Çözülmüş örneği göster

Dördüncü referans yazıda 'turquoise anchor check' ifadesi kullanılır. search-index.json kaydı, gerçek blog dosya adını ve aranabilir özet/metni içerir. Tam referans dosyalarında yazı ile listeyi birlikte görebilirsiniz.

Bellekteki eski listeyi temizlemek için yenileyin, ifadeyi arayın ve bulunan yazıyı açın. Yüklenen JSON’u da inceleyin: ifadeyi yalnızca HTML’ye yazıp listeyi güncellemezseniz aramada bulunmaz.

Yeni sekmede veya yeniledikten sonra olmayan bir konuyu ve engellenmiş liste indirmesini tekrar deneyin. Eşleşme yokken ve arama çalışmazken farklı mesajlar görünmeli; Browse all articles (bütün yazıları görüntüle) bağlantısı ise çalışmaya devam etmeli.

  • Sonuç bağlantısı hedeflenen gerçek yazıyı açar.
  • Yeni içerik bulunurken hata ve boş arama davranışları bozulmaz.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin