الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Tinysearch

TinySearch هو محرك بحث خفيف الوزن وسريع ونص كامل. وهي مصممة لمواقع الويب الثابتة.

تتم كتابة Tinysearch في الصدأ ، ثم تم تجميعها إلى Webassembly لتشغيل في متصفح.
يمكن استخدامه مع مولدات الموقع الثابتة مثل Jekyll أو Hugo أو Zola أو Cobalt أو Pelican.

العرض التوضيحي

هل هو صغير؟

يقوم ملف فهرس الاختبار الخاص بمدونتي التي تضم حوالي 40 مشاركة بإنشاء حمولة WASM تبلغ 99 كيلو بايت (49 كيلو بايت Gzipped ، 40 كيلو بايت بروتلي).
هذا أصغر من الصورة التجريبية أعلاه ؛ لذلك نعم.

كيف تعمل

TinySearch هو منفذ Rust/WASM لرمز Python من المقالة "كتابة محرك بحث كامل النص باستخدام مرشحات Bloom". يمكن اعتباره بديلاً لـ Lunr.JS و SulectionLunr ، والتي هي ثقيلة جدًا بالنسبة لمواقع الويب الأصغر وتحميل الكثير من JavaScript.

تحت غطاء محرك السيارة ، يستخدم مرشح XOR - بنية بيانات لتقريب سريع للعضوية المحددة أصغر من مرشحات Bloom و Cuckoo. يتم تحويل كل منشور مدونة إلى مرشح سيتم بعد ذلك تسلسله إلى نقطة ثنائية باستخدام Bincode. يرجى ملاحظة أن التقنيات الأساسية تخضع للتغيير.

القيود

  • يجد فقط كلمات كاملة. نتيجة لذلك ، لا توجد اقتراحات بحث (حتى الآن). هذا هو مفاضلة ضرورية لتقليل استخدام الذاكرة. كانت بنية بيانات Trie حوالي 10x أكبر من مرشحات XOR. قد يرفع هذا القيد في المستقبل في المستقبل في المستقبل.
  • نظرًا لأننا نحمل جميع مؤشرات البحث لجميع المقالات في ثنائي ثابت واحد ، فإننا نوصي باستخدامها فقط لمواقع الويب الصغيرة إلى المتوسطة. توقع حوالي 2 كيلو بايت غير مضغوط لكل مقالة (حوالي 1 كيلو بايت مضغوط).

تثبيت

WASM-Pack مطلوب لبناء وحدة WASM. تثبيته مع 

cargo install wasm-pack

لتحسين إخراج JavaScript ، ستحتاج أيضًا إلى terser: 

 npm install terser -g

إذا كنت ترغب في جعل مجموعة WebAssembly صغيرة قدر الإمكان ، فإننا نوصي بتثبيت ثنائي أيضًا. على MacOS ، يمكنك تثبيته باستخدام Homebrew: 

brew install binaryen

بدلاً من ذلك ، يمكنك تنزيل الثنائي من صفحة الإصدار أو استخدام مدير حزمة نظام التشغيل الخاص بك.

بعد ذلك ، يمكنك تثبيت TinySearch نفسه: 

 cargo install tinysearch

الاستخدام

ملف JSON ، الذي يحتوي على المحتوى للفهرس ، مطلوب كمدخل. يرجى إلقاء نظرة على ملف المثال.

يعد حقل body في مستند JSON اختياريًا ويمكن تخطيه إلى فهرس العناوين فقط.

بمجرد إنشاء الفهرس ، يمكنك التشغيل 

 tinysearch fixtures/index.json

سيؤدي ذلك إلى إنشاء وحدة WASM ورمز الغراء JavaScript لدمجها في موقع الويب الخاص بك. يمكنك فتح demo.html من أي خادم ويب لرؤية النتيجة.

على سبيل المثال ، يحتوي Python على خادم ويب مدمج يمكن استخدامه للاختبار السريع: 

 python3 -m http.server

ثم تصفح إلى http://0.0.0.0:8000/demo.html لتشغيل العرض التوضيحي.

يمكنك أيضًا إلقاء نظرة على أمثلة الكود لمولدات الموقع الثابتة المختلفة هنا.

استخدام متقدم

لخيارات الاستخدام المتقدم ، قم بتشغيل 

 tinysearch --help

يرجى التحقق من ما هو مطلوب لاستضافة Webassembly في الإنتاج - ستحتاج إلى تعيين أنواع GZIP MIME بشكل صريح.

عامل ميناء

إذا لم يكن لديك إعداد كامل للصدأ متاح ، فيمكنك أيضًا استخدام صور Docker التي تم إنشاؤها ليلا.

إليك كيفية تجربة TinySearch بسرعة مع Docker: 

 # Download a sample blog index from endler.dev
curl -O https://raw.githubusercontent.com/tinysearch/tinysearch/master/fixtures/index.json
# Create the WASM output
docker run -v $PWD :/app tinysearch/cli --engine-version path= " /engine " --path /app/wasm_output /app/index.json

بشكل افتراضي ، يتم استخدام أحدث صورة لصدأ جبال الألب المستقرة. للحصول على ليلا ، ركض 

docker build --build-arg RUST_IMAGE=rustlang/rust:nightly-alpine -t tinysearch/cli:nightly .

Advanced Docker Build Args

  • WASM_REPO : الكتابة فوق مستودع حزمة WASM
  • WASM_BRANCH : الكتابة فوق فرع المستودع للاستخدام
  • TINY_REPO : مستودع الكتابة فوق tinysearch
  • TINY_BRANCH : فرع Tinysearch في الكتابة فوق

عمل جيثب

لدمج TinySearch في خطوط أنابيب النشر المستمرة ، يتوفر إجراء GitHub. 

- name : Build tinysearch
  uses : leonhfr/tinysearch-action@v1
  with :
    index : public/index.json
    output_dir : public/wasm
    output_types : |
      wasm

المستخدمون

تستخدم المواقع التالية TinySearch:

  • مدونة ماتياس إنلر
  • OutofcheerEerror
  • متحف أبرشية وارسو

هل تستخدم TinySearch أيضًا؟ أضف موقعك هنا!

المشرفون

  • ماتياس إنلر (mre)
  • Jorge-Luis Betancourt (jorgelbg)
  • Mad Mike (@fluential)

رخصة

تم ترخيص TinySearch تحت أي من

  • Apache License ، الإصدار 2.0 ، (ترخيص-apache أو http://www.apache.org/licenses/license-2.0)
  • ترخيص معهد ماساتشوستس للتكنولوجيا (ترخيص-mit أو http://opensource.org/licenses/mit)

في خيارك.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل