Aller au contenu

Choisir une portée du MCP Shamela : un livre ou tous

shamela_search_library nomme l'un de douze rayons. Ce que contient chacun, ce qu'ils omettent, et pourquoi cadrer la recherche compte, même facultatif.

Sur cette page

shamela_search_library exige une portée. Les recherches brutes shamela_* n’en exigent pas — mais la raison pour laquelle l’outil sélectionné y tient mérite d’être comprise avant de décider de s’en passer.

Pourquoi une portée est obligatoire

La recherche plein texte sur cette bibliothèque classe les résultats selon des statistiques de termes — grosso modo, à quel point vos mots sont rares et combien de fois ils apparaissent sur une page. C’est un défaut raisonnable pour un moteur de recherche et un mauvais choix pour une bibliothèque de textes religieux, car la fréquence des termes ignore tout de l’autorité savante.

Deux exemples réels, tous deux issus d’une recherche sur toute la bibliothèque :

  • التيمم (ablution sèche) renvoie 26 098 résultats, en tête une anthologie poétique de 710 AH. Tous les manuels de fiqh qui statuent réellement sur le sujet viennent en dessous.
  • إنما الأعمال بالنيات renvoie 6 815 résultats parmi lesquels Sahih al-Bukhari n’apparaît jamais — enseveli sous des recueils mineurs qui ne font que répéter le hadith plus souvent par page.

Un assistant à qui l’on remet ces résultats les citerait avec assurance.

shamela_search_library refuse donc de s’exécuter sans portée. shamela_search (match: 'words') le fait, et il a de vrais usages — mais si vous demandez « où ce texte est-il imprimé », cadrez la recherche.

Les douze portées

PortéeContenuLivres
hadith-primaryLes huit recueils primaires, chacun épinglé à une impression précise8
tafsir-canonicalIbn Kathir, al-Tabari, Ibn al-Jawzi et trois autres, lus dans cet ordre6
fiqh-hanafiFiqh hanafite, plus usul et fiqh général1 034
fiqh-malikiFiqh malikite, plus usul et fiqh général1 036
fiqh-shafiiFiqh chaféite, plus usul et fiqh général1 037
fiqh-hanbaliFiqh hanbalite, plus usul et fiqh général1 100
fiqh-comparativeLes quatre écoles, plus héritage, gouvernance et recueils de fatwas1 559
aqeedahCroyance et courants958
hadith-sciencesCommentaires de hadith, takhrij et sciences du hadith1 957
tafsirTout le rayon du tafsir et les sciences coraniques586
seerahBiographie prophétique, histoire et dictionnaires biographiques972
lughaLangue arabe, lexiques, grammaire et adab1 052

Les deux petites portées sont petites volontairement

hadith-primary (8 livres) et tafsir-canonical (6 livres) sont des listes choisies, pas des catégories.

hadith-primary épingle chaque recueil à une impression nommée : al-Bukhari est la Sultaniyya, Muslim suit la numérotation de ʿAbd al-Baqi, et ainsi de suite. Cela remplit deux fonctions à la fois. La recherche reste ciblée — la catégorie complète de la sunna compte 1 243 livres, et les parcourir tous fait remonter des ouvrages mineurs qui ne font que répéter un hadith. Et le numéro de page prend un sens : les impressions paginent différemment, donc un volume et une page sans édition nommée ne forment pas une citation qu’un lecteur puisse vérifier.

tafsir-canonical existe parce que l’index des versets sous-jacent lit les livres dans l’ordre du catalogue, ce qui est un accident de numérotation et non un jugement. Pour un verset, cela a fait remonter un ouvrage d’analyse grammaticale et un commentaire ésotérique tandis qu’Ibn Kathir et al-Tabari — tous deux indexés pour ce même verset — restaient non lus. La liste choisie corrige l’ordre.

Utilisez la portée large tafsir (586 livres) pour l’étendue ; utilisez tafsir-canonical pour les ouvrages que la plupart des lecteurs s’attendent à voir consultés en premier.

En choisir une

Si vous vous interrogez sur…Commencez par
L’existence d’un hadith, et où il est impriméhadith-primary
Ce qu’un commentateur reconnu a dit d’un versettafsir-canonical
Un avis au sein d’une écolefiqh-hanafi, fiqh-maliki, fiqh-shafii, fiqh-hanbali
En quoi les écoles diffèrent sur une questionfiqh-comparative
Une appréciation, une chaîne, ou la réception d’un hadithhadith-sciences
Un point de croyanceaqeedah
Un événement, une vie, ou la biographie d’un transmetteurseerah
Le sens d’un mot arabe ou son analyselugha

La portée restreint quels livres sont cherchés, jamais la manière dont les mots sont appariés. Une portée de 8 livres et une de 1 957 exécutent la même recherche — la petite donne moins de résultats, mieux placés.

Ce que les portées ne couvrent pas

Les douze portées couvrent 26 des 41 catégories du catalogue — 7 084 des 8 594 livres. Les 1 510 restants n’ont pas de portée propre et ne sont accessibles que par les outils bruts shamela_* :

Hors de toute portéeLivres
الأدب — littérature et belles-lettres406
كتب عامة — ouvrages généraux357
التجويد والقراءات — tajwīd et qirāʾāt152
الجوامع — recueils généraux137
فهارس الكتب والأدلة — index et guides102
البلدان والرحلات — géographie et voyages97
العلل والسؤلات الحديثية — défauts du hadith et questions78
الأنساب — généalogie52
البلاغة — rhétorique44
Six catégories plus petites (poésie, médecine, logique, prosodie, autres)85

Si votre question tombe sur l’un de ces rayons — un avis de qirāʾāt, la généalogie d’un transmetteur, un point de ʿilal — shamela_search_library reviendra vide alors que les livres existent. Utilisez plutôt shamela_search (match: 'words') avec une portée explicite category_ids, que vous pouvez trouver avec shamela_find (kind: 'category').

Si une portée ne renvoie rien, c’est une information et non une impasse. Essayez le voisin plus large — tafsir-canonical → tafsir, ou une école → fiqh-comparative — et notez que le rayon plus étroit est resté muet.

Étapes suivantes

Modifier cette page sur GitHub