دليل استخدام ثواب

# دليل استخدام مكتبة ثواب

## البحث

### لمحة

تستخدم مكتبة ثواب فهرسًا لتسريع عملية البحث. الكتب غير المضافة للفهرس لا تظهر في نتائج البحث.

عندما تفتح كتابًا ما فإن صندوق البحث الصغير في صفحة الكتاب يبحث داخل ذاك الكتاب فقط، أما الصفحة الأولى فتبحث في كل الكتب ما لم تحدّد لها مجال البحث.

في الغالب لا تحتاج تحديد مجال البحث حيث يتم البحث في كل الكتب خلال ثانية أو أقل ولا يزيد الوقت اللازم للبحث كلما زادت حجم المكتبة كماً، والنتائج تكون مرتبة بحسب ارتباط النتيجة بالشيء الذي تبحث عنه (مثلا يعطى ورود الكلمة في العنوان وزنا أعلى من ورودها في المتن)

يتأخر البحث عند البحث عن أمور عامة تُخرِج الكثير من النتائج (في الزمن اللازم لتقييمها وترتيبها). حاليا المكتبة تظهر أوّل 500 نتيجة فقط (يمكن إعادة ضبط هذا الرقم إن احتجنا لذلك).

لتسريع البحث ابحث عن شيء مميز. مثلا: لا تبحث عن كلمات مثل حرف “في” بل ابحث عن كلمة مميزة.

البحث الموجود على الصفحة الرئيسة يقوم بالبحث في كل الكتب المفهرسة ما لم تقم بحصر مجال البحث بشكل صريح.

لا يتم البحث في الكتب غير المفهرسة.

عندما تفتح كتابًا فإنك تجد صندوق بحث مصغر في رأس الصفحة وبعكس صندوق البحث الرئيس لا يبحث هذا الصندوق إلا في الكتاب الحالي. الكلمات التي تكتبها فيه يتم تظليلها في الصفحة الحالية فور كتابتها ويتم النزول إليها لإظهارها عند النقر على زر الإدخال أي أن الإدخال له فائدتان: البحث في الصفحة الحالية والبحث في كل الكتاب الحالي.

### الملخص

الرمز | اسم العملية | شرح | مثال | معنى المثال
--- | --- | --- | --- | ---
& | و | تشترط تحقق ما قبلها وما بعدها معا | كتاب & قلم | أن يحتوي النص كلمتي “كتاب” و “قلم”
&~ | وربما | تشترط تحقق ما قبلها ويفضل أن يتحقق ما بعدها دون اشتراط ذلك | كتاب &~ قلم | أن يحتوي النص كلمة “كتاب” ويفضل أن يحتوي كلمة “قلم”
| | أو | تطابق سواء تحقق ما قبلها أو تحقق ما بعدها | عيسى | المسيح | أن يحتوي النص كلمة “عيسى” أو كلمة “المسيح”
! | النفي | تطابق إذا لم يتحقق ما بعدها | عيسى | المسيح ! الدجال | أن يحتوي النص كلمة “عيسى” أو كلمة “المسيح” لكن بشرط أن لا يحتوي كلمة “الدجال”
* | أي شيء | صفر أو أكثر من الحروف | استع* | يمكن أن تطابق ما يبدأ ب استع مثل استعان أو استعمل …إلخ
? | حرف واحد | حرف واحد تماما | ش؟ب | يمكن أن تطابق شرب أو شنب …إلخ
^ | قوة | زيادة وزن الكلمة عند ترتيب النتائج | أحمد ابن تيمية^3 | إعطاء كلمة تيمية 3 أضعاف وزن الأخرى عند الترتيب
كتاب: | تحديد المجال | البحث في الكتاب المذكور تاليا | التيمم كتاب:(“صحيح البخاري” | “صحيح مسلم”) | البحث عن التيمم في صحيح البخاري أو صحيح مسلم
عنوان: | البحث في العناوين | حصر البحث في عناوين الأبواب | عنوان:(بدء الوحي) | البحث عن كلمة بدء وكلمة وحي في عناوين الأبواب

يمكنك طباعة رمز ~ الذي يأتي بعد علامة & في استعلام “وربما” عبر الضغط على زر SHIFT+Z في لوحة المفاتيح العربية QWERTY

### الاستعلامات المتقدمة

عند كتابة أكثر من كلمة فإنه يتم ربطها معا ضمنيا عبر علاقة “و” (ورمزها “&”) أي أنه سيعطيك الوثائق التي تحتوي كل تلك الكلمات معا (دون اشتراط تتابع معين) مثلا عند كتابة كلمة خمر ثم مسافة ثم تحريم فإنه لن يعطيك الوثائق التي تحتوي واحدة من الكلمتين بل يجب أن ترد الكلمتين معا (أي كأنك كتبت خمر & تحريم) لكنه قد يعطيك وثائق تحتوي على عبارة “تحريم الخمر” أي بترتيب معكوس.

يمكنك استعمال العلاقة “أو” (ورمزها “|”) حتى تشترط ورود واحدة من تلك الكلمات مثلا لو كتبت كلمة عيسى ثم | ثم المسيح فإنه لن يشترط ورود الكلمتين معا فواحدة منهما تكفي.

يمكن نفي العمليات عبر علامة التعجب “!” وذلك لاستثناء شيء من النتائج مثلا المسيح ! الدجال تحضر الصفحات التي تحتوي كلمة المسيح لكنها في نفس الوقت لا تحتوي كلمة الدجال.

يمكن استعمال الأقواس كما في العمليات الحسابية مثلا (المسيح | عيسى) ! الدجال.

لاشتراط الترتيب عليك وضع علامة اقتباس مزدوجة مثلا “تحريم الخمر” وهذا يسمى البحث عن عبارة.

يمكنك اشتراط ورود الكلمة في العنوان عبر كتابة عنوان ثم علامة : مثلا عنوان:“بدء الوحي” للبحث عن عبارة “بدء الوحي” في العنوان أما البحث عن كلمات في العنوان دون اشتراط أن تكون عبارة يمكنك كتابة عنوان:(بدء الوحي)

البحث عن عنوان:بدء الوحي دون اقتباس أو أقواس تعني البحث عن عنوان به كلمة بدء أما كلمة وحي فلا يشترط أن تكون في العنوان

يمكنك تحديد مجال البحث عبر ذكر اسم الكتاب بعد كلمة كتاب ثم : مثلا

- بدء الوحي كتاب:صحيح_البخاري
- بدء الوحي كتاب:“صحيح البخاري”

البحث عن بدء الوحي كتاب:صحيح_البخاري دون اقتباس ولا علامة تحتية _ تعني أن اسم الكتاب هو صحيح أما البخاري فهي كلمة تريد البحث عنها

يمكنك البحث في أكثر من كتاب عبر استعمال أو مثلا بدء الوحي (كتاب:صحيح_البخاري | كتاب:صحيح_مسلم) كذلك يمكنك استثناء كتاب عبر ! مثلا بدء الوحي ! كتاب:صحيح_البخاري تبحث عن بدء الوحي في أي كتاب إلا صحيح البخاري

## الحصول على الكتب

قد تأتي بعض الكتب مع النظام (مثلا في نظام أعجوبة لينكس هناك عينة من الكتب المميزة تأتي مع التوزيعة) لكن الكتب ليست جزء من مكتبة ثواب بل يقوم باختيارها المستخدم حيث يمكنه الحصول عليها من أكثر من مصدر.

يمكن وضع الكتب في مجلد db داخل المجلدات الخاصة بمكتبة ثواب.

المجلدات الخاصة بثواب هي

1. مجلد .thawab داخل المجلد البيت الخاص بالمستخدم.
2. مجلد thawab-data المجاور للملف التنفيذي الذي يشغل ثواب
3. مجلد thawab-data في كل من أقراص ويندوز من C إلى Z

### الاستيراد من الشاملة

يمكن استيراد كتب الشاملة ذات الهيئة .bok والتي يمكن الحصول عليها بتصديرها من برنامج الشاملة أو بتنزيلها من الإنترنت 1). ويكون ذلك من خلال زر الاستيراد بالأعلى أو من خلال سحب ملفات bok وإفلاتها في برنامج ثواب، كما يمكنك إضافة الكتب عبر زر الإضافة Add وبعد الانتهاء من اختيار الكتب، اضغط الزر التحويل Convert.

### من موقع أعجوبة

يمكن جلب الكتب من هذا الرابط:

- http://www.ojuba.org/downloads/thawab/thawab-kutub/

## إنشاء فهرس البحث

بعد إضافة المزيد من الكتب إلى ثواب لا تكون مفهرسة مما يعني أنه لا يمكن البحث فيها. لإضافتها إلى فهرس البحث في تطبيق ثواب انقر على زر فهرس البحث Index ثم تضغط على زر دفع الكتب الجديدة queue new books كي يتم التعرف على الكتب غير الموجودة في الفهرس وإضافتها إليه.

## التخلص من فهرس لا يعمل

إن توقف الفهرس عن العمل لأي سبب (مثل تلف الملف بسبب انقطاع التيار الكهربائي أو ترقية إصدار محرك البحث whoosh إلى إصدار أحدث غير متوافق مع الذي قبله) عليك حذف مجلد index ثم إعادة فهرسة الملفات.

1) يمكن تنزيلها من موقع الشاملة الجديد أو القديم أو من موقع islamport