Lewati ke konten

shamela_search_library: cari kitab Arab klasik dan kutipan

Parameter dan bidang hasil shamela_search_library, alat MCP yang mengembalikan kutipan Arab verbatim dengan edisi, halaman cetak, dan tautan Maktabah.

Di halaman ini

Tiga parameter. Ia mencari irisan perpustakaan yang disebutkan namanya dan mengembalikan kutipan beserta rujukannya.

Ini salah satu dari 15 alat, dan yang pertama layak dicoba — satu-satunya pencarian yang menolak berjalan tanpa cakupan dan yang memberi tahu cara mencocokkannya. Untuk semua yang tidak bisa dilakukannya, lihat seluruh alat.

Parameter

ParameterWajibTipeCatatan
queryyastringHanya teks Arab. Redaksi dalam tanda kutip paling baik; topik juga bisa.
scopeyastringSalah satu dari dua belas nama — lihat Memilih cakupan. Alat ini tidak akan berjalan tanpanya.
limittidakintegerJumlah kutipan yang dikembalikan, 1–10. Bawaan 5.

scope yang wajib adalah hal terpenting tentang alat ini, dan halaman cakupan menjelaskan alasannya selengkapnya: tanpa cakupan, perpustakaan ini mengurutkan berdasarkan seberapa sering sebuah kata muncul, yang mengubur kitab-kitab yang sebenarnya Anda cari.

Kueri harus berbahasa Arab

Perpustakaan ini berbahasa Arab, begitu pula indeksnya. Kueri tanpa kata Arab ditolak seketika — itu galat alat (isError), bukan hasil kosong, dan pesannya memberi tahu model apa yang harus dilakukan:

The library is Arabic, so the query must contain Arabic words. Translate the search terms into Arabic and call again, for example «إنما الأعمال بالنيات» for “actions are judged by intentions”.

Itu berlaku untuk bahasa Inggris (prayer intention) maupun transliterasi (innama al-a'mal bil-niyyat). Bila asisten Anda bertolak dari pertanyaan berbahasa Indonesia, ia harus menerjemahkan kata kunci ke bahasa Arab sebelum memanggil alat ini. Tidak ada yang menerjemahkannya untuknya. Alat search tanpa cakupan berperilaku sama.

Harakat tidak berpengaruh. انما الاعمال بالنيات dan إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ mengembalikan hasil yang sama, jadi tidak perlu memberi harakat pada kueri atau menghapusnya dari yang Anda salin.

Yang dikembalikan

Sebuah objek hasil berisi kutipan dan sedikit konteks tentang pencarian itu sendiri:

BidangArti
passagesTemuan, dijelaskan di bawah.
relaxedToTokenstrue bila frasa persis tidak ditemukan dan pencarian kata yang lebih longgar yang menjawab.
scopeCakupan yang dicari, dikembalikan apa adanya.
booksSearchedBerapa kitab dalam cakupan itu.
totalMatchesBerapa halaman cocok secara keseluruhan, yang Anda terima hingga limit. Bisa null pada putaran cadangan.
noteHadir hanya bila hasil memerlukan catatan peringatan — lihat di bawah.

Setiap entri dalam passages:

BidangArti
bookJudul termasuk cetakannya, mis. صحيح البخاري - ط السلطانية.
authorNama penulis.
authorDiedTahun wafat dalam H, atau null bila tidak diketahui.
printedPageJilid dan halaman sebagaimana cetakan itu memaginasinya, mis. 1/ 6.
arabicKutipannya sendiri, verbatim, dengan semua markup dihapus.
matchedInbody, footnote, both, atau unknown — di mana kata-kata itu ditemukan.
matchQualityCara kecocokan dibuat, mis. exact_phrase.
bookId, pageIdPengenal Syamilah untuk halaman tersebut.
edition, editor, publisherData bibliografis untuk cetakan itu. Hadir hanya bila perpustakaan memilikinya; tidak pernah ditebak.
sourceUrlhttps://qurangallery.com/maktabah/book/{bookId}/{pageId}, halaman yang sama di pembaca Maktabah. Sebutkan al-Maktaba al-Shamela saat Anda mengutip.

Dua putaran

Pencarian menjalankan putaran ketat dulu, lalu beralih ke cadangan:

  1. Frasa persis. Kata-kata Anda, berurutan, sebagaimana ditulis.
  2. Kata-kata bersama, bila frasa tidak menemukan apa pun — kata yang sama di mana saja pada sebuah halaman, dalam urutan apa pun.

Anda selalu diberi tahu putaran mana yang menjawab, lewat relaxedToTokens. Penanda itu bukan sekadar pembukuan; ia mengubah makna hasil, dan Membaca hasil membahas caranya.

Putaran cadangan ada karena redaksi yang diriwayatkan bervariasi antarcetakan. Mencari إنما الأعمال بالنيات sebagai frasa ketat menemukan satu kitab dan melewatkan Sahih al-Bukhari, yang mencetak بالنية. Putaran yang lebih longgar menemukan al-Bukhari, Ibnu Majah, Abu Dawud, dan an-Nasa’i. Hanya menjalankan putaran ketat akan mengubah hadis yang terkenal dan kuat riwayatnya menjadi “tidak ditemukan” — yang dalam pokok bahasan ini merupakan klaim palsu tersendiri.

Contoh kerja

Mencari إنما الأعمال بالنيات dalam cakupan hadith-primary mengembalikan, antara lain:

BidangNilai
bookصحيح البخاري - ط السلطانية
authorالبخاري
authorDied256
printedPage1/ 6
matchedInbody
matchQualityexact_phrase
arabic…عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ…

Dengan booksSearched: 8 dan relaxedToTokens: false — delapan kitab kumpulan yang terkunci pada cetakan tertentu, dan frasa persis ditemukan.

Tanda … di awal disengaja: ia menandai kutipan yang dimulai di tengah kalimat, karena kutipan itu adalah jendela ke halaman, bukan seluruh halaman.

Panjang kutipan

Kutipan dibatasi sekitar 1.600 karakter Arab dan dipotong dengan … di akhir bila lebih panjang. Alat ini mengembalikan kutipan, bukan kitab.

Bila Anda butuh seluruh halaman, bukan jendela yang cocok, ambil bookId dan pageId dari sebuah hasil dan berikan ke shamela_read (unit: 'page'). shamela_read (unit: 'range') dan shamela_read (unit: 'section') membaca lebih jauh — lihat seluruh alat.

Langkah berikutnya

Edit halaman ini di GitHub