search_library: klasik Arapça kitaplarda atıflı arama

Üç parametre. Kütüphanenin adlandırılmış bir dilimini arar ve atıfları eklenmiş pasajlar döndürür.

Bu, 39 araçtan biridir ve ilk denenmesi gerekendir — kapsamsız çalışmayı reddeden ve nasıl eşleştirdiğini söyleyen tek aramadır. Yapamadığı her şey için araçların tam listesine bakın.

Parametreler

Parametre	Zorunlu	Tür	Notlar
query	evet	string	Yalnızca Arapça metin. Tırnak içinde bir ifade en iyi sonucu verir; bir konu da çalışır.
scope	evet	string	On iki addan biri — bkz. Kapsam seçimi. Bu araç kapsam olmadan çalışmaz.
limit	hayır	integer	Döndürülecek pasaj sayısı, 1–10. Varsayılan 5.

scope değerinin zorunlu olması bu aracın en önemli özelliğidir ve kapsamlar sayfası nedenini tam olarak açıklar: kapsamsız olarak bu kütüphane, bir kelimenin ne sıklıkla geçtiğine göre sıralar ve bu, gerçekten istediğiniz kitapları gömer.

Sorgu Arapça olmalıdır

Kütüphane Arapçadır ve dizin de öyle. Hiç Arapça kelime içermeyen bir sorgu doğrudan reddedilir — boş sonuç değil, bir hatadır:

Query has no searchable Arabic words.

Bu hem İngilizce (prayer intention) hem de transliterasyon (innama al-a'mal bil-niyyat) için geçerlidir. Asistanınız İngilizce bir sorudan çalışıyorsa bu aracı çağırmadan önce arama terimlerini Arapçaya çevirmelidir. Onları onun yerine çeviren bir şey yoktur.

Harekeler önemli değildir. انما الاعمال بالنيات ve إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ aynı sonuçları döndürür; bu yüzden bir sorguyu harekelemeye veya kopyaladığınız bir sorgudan harekeleri silmeye gerek yoktur.

Ne geri gelir

Pasajları ve aramanın kendisi hakkında bazı bağlamı içeren bir sonuç nesnesi:

Alan	Anlamı
passages	Aşağıda açıklanan sonuçlar.
relaxedToTokens	Tam ifade bulunamadığında ve bunun yerine daha gevşek bir kelime araması yanıt verdiğinde true.
scope	Aranan kapsam, aynen geri gönderilir.
booksSearched	O kapsamda kaç kitap vardı.
totalMatches	Toplamda kaç sayfanın eşleştiği; bunların limit‘e kadarını aldınız. Yedek geçişte null olabilir.
note	Yalnızca sonucun bir uyarıya ihtiyacı olduğunda bulunur — aşağıya bakın.

passages içindeki her giriş:

Alan	Anlamı
book	Baskı dahil başlık, örn. صحيح البخاري - ط السلطانية.
author	Yazarın adı.
authorDied	Hicrî vefat yılı, bilinmiyorsa null.
printedPage	O baskının sayfalamasına göre cilt ve sayfa, örn. 1/ 6.
arabic	Pasajın kendisi, birebir, tüm işaretleme kaldırılmış.
matchedIn	body, footnote, both veya unknown — kelimelerin nerede bulunduğu.
matchQuality	Eşleşmenin nasıl yapıldığı, örn. exact_phrase.
bookId, pageId	Sayfanın Şamile tanımlayıcıları.
edition, editor, publisher	O baskının bibliyografik verisi. Yalnızca kütüphanede varsa bulunur; asla tahmin edilmez.
sourceUrl	https://shamela.ws/book/{bookId}/{pageId}, shamela.ws üzerindeki aynı sayfa. Alıntı yaparken shamela.ws’yi belirtin.

İki geçiş

Arama önce katı geçişi çalıştırır, sonra yedeğe düşer:

1. Tam ifade. Kelimeleriniz, sırasıyla, yazdığınız gibi.
2. İfade hiçbir şey bulmadıysa kelimeler bir arada — aynı kelimeler bir sayfanın herhangi bir yerinde, herhangi bir sırada.

Hangisinin yanıt verdiği size her zaman relaxedToTokens ile söylenir. Bu bayrak bir kayıt tutma ayrıntısı değildir; sonucun anlamını değiştirir ve nasıl değiştirdiğini Bir sonucu okumak anlatır.

Yedek geçiş vardır, çünkü nakledilen ifade baskılar arasında değişir. إنما الأعمال بالنيات ifadesini katı bir ifade olarak aramak bir kitap bulur ve بالنية basan Sahîh-i Buhârî’yi kaçırır. Daha gevşek geçiş Buhârî’yi, İbn Mâce’yi, Ebû Dâvûd’u ve Nesâî’yi bulur. Yalnızca katı geçişi çalıştırmak, meşhur ve iyi sabit bir hadisi “bulunamadı”ya çevirirdi — bu konuda bu, kendi türünden yanlış bir iddiadır.

Çalışılmış bir örnek

hadith-primary kapsamında إنما الأعمال بالنيات aramak, diğerlerinin yanı sıra şunu döndürür:

Alan	Değer
book	صحيح البخاري - ط السلطانية
author	البخاري
authorDied	256
printedPage	1/ 6
matchedIn	body
matchQuality	exact_phrase
arabic	…عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ…

booksSearched: 8 ve relaxedToTokens: false ile — baskıya sabitlenmiş sekiz derleme ve tam ifade bulundu.

Baştaki … bilerek konmuştur: cümlenin ortasında başlayan bir pasajı gösterir, çünkü alıntı sayfanın tamamı değil, sayfaya açılan bir penceredir.

Alıntı uzunluğu

Pasajlar yaklaşık 1.600 Arapça karakterle sınırlıdır ve daha uzunsa sondaki … ile kesilir. Bu araç kitap değil, alıntı döndürür.

Eşleşen pencere yerine sayfanın tamamına ihtiyacınız varsa bir sonuçtan bookId ve pageId değerlerini alıp shamela_get_page aracına verin. shamela_get_pages_range ve shamela_get_book_section daha ileriyi okur — bkz. araçların tam listesi.