تسليط الضوء على البحث متعدد النصوص

ابحث وتسليط الضوء على عدة نصوص. يدعم إدارة المجموعات وألوان متعددة

# دليل المستخدم لملحق Multi-Text Search Highlight ## 1. المقدمة **Multi-Text Search Highlight** هو ملحق لمتصفح ويب حديث يسمح بالبحث عن نصوص متعددة وإبرازها في وقت واحد. يوفر إدارة المجموعات والبحث التلقائي والبحث بالتعبيرات العادية و 14 لونًا للبروز. ## 2. الميزات الرئيسية ### 2.1 البحث والإبراز متعدد النصوص - البحث عن نصوص متعددة في وقت واحد، بحث تلقائي عند كتابة كل سطر - يستخدم واجهة برمجة التطبيقات CSS Highlight دون تعديل هيكل HTML - 14 لونًا للبروز متاح لتجنب الصدام - عرض عدد التطابقات على الأيقونة (يعرض "99+" لأكثر من 99) ### 2.2 إدارة المجموعات - حفظ النصوص المستخدمة بانتظام كمجموعات - عرض وتعديل وحذف المجموعات - تحديد جميع المجموعات بنقرة واحدة - البحث في عدة مجموعات في وقت واحد - **يتم حفظ حالة تحديد المجموعات تلقائيًا** - إغلاق الملحق يحافظ على تحديدك - 14 خيارًا للألوان للمجموعات - **استيراد/تصدير المجموعات**: يدعم تصدير المجموعات إلى ملف Excel أو استيرادها من ملف Excel، ويدعم استبدال المجموعات الموجودة بنفس الاسم ### 2.3 البحث التلقائي - البحث التلقائي عند فتح صفحات جديدة - يمكن تمكينه/تعطيله باستخدام المبدل - البحث بناءً على المجموعات المختارة - يدعم الاختصار `Ctrl+Shift+S` للبحث التلقائي السريع (بدون فتح popup) ### 2.4 إعدادات البحث - **تجاهل الحروف الكبيرة والصغيرة** : لا يميز بين الحروف الكبيرة والصغيرة عند التحديد - **كلمة كاملة** : يطابق السلاسل الكاملة فقط (متعارض مع regex) - **التعبيرات العادية** : بحث متقدم باستخدام regex (متعارض مع كلمة كاملة) - صفحة مساعدة regex المدمجة مع أمثلة وأنماط شائعة ### 2.5 اختصارات لوحة المفاتيح - **Ctrl+Shift+F** : فتح popup الملحق والبحث التلقائي - **Ctrl+Shift+S** : بحث تلقائي سريع (بدون فتح popup) - **Ctrl+Shift+X** : مسح جميع البروزات ### 2.6 الدعم الدولي - يدعم الإنجليزية والصينية والفرنسية والإسبانية والروسية والعربية - التغيير التلقائي حسب لغة المتصفح، أو الاختيار اليدوي في الإعدادات ## 3. الاستخدام ### 3.1 البحث الأساسي 1. انقر على أيقونة الملحق، أو استخدم الاختصار `Ctrl+Shift+F` 2. أدخل النصوص للبحث، واحد لكل سطر 3. كل سطر يبدأ البحث تلقائيًا 4. ستتم إبراز النصوص المتطابقة، ويظهر العدد على الأيقونة 5. انقر على "مسح الإبراز" أو استخدم `Ctrl+Shift+X` ### 3.2 إدارة المجموعات #### إنشاء مجموعة 1. أدخل النصوص في حقل الإدخال 2. انقر على "حفظ كمجموعة" 3. أدخل اسم المجموعة (حد أقصى 15 حرف) 4. اختر لون البروز (14 لون متاح) 5. انقر على موافق للحفظ #### استخدام المجموعات 1. اختر المجموعات التي ترغب في استخدامها 2. انقر على "بحث المجموعات المختارة"، أو استخدم `Ctrl+Shift+S` 3. سيتم البحث عن جميع النصوص في المجموعات المختارة وإبرازها #### إدارة المجموعات - **عرض** : انقر على "عرض" لرؤية جميع النصوص - **تعديل** : انقر على "تعديل" لتغيير الاسم والمحتوى واللون - **حذف** : انقر على "حذف" لحذف المجموعة #### اختيار لون المجموعة 14 لونًا للبروز متاح: - أصفر، أخضر، أزرق، برتقالي، وردي، بنفسجي - سماوي، بني، رمادي مزرق، برتقالي داكن، أحمر - أخضر فاتح، أزرق سماوي، عنبري #### استيراد/تصدير المجموعات ##### تصدير المجموعات 1. في قسم إدارة المجموعات، انقر على "تصدير المجموعات" 2. سيتم تنزيل ملف Excel يحتوي جميع المجموعات الخاصة بك 3. الملف يحتوي على: اسم المجموعة، اللون، والنصوص ##### استيراد المجموعات 1. في قسم إدارة المجموعات، انقر على "استيراد المجموعات" 2. اختر ملف Excel الذي يحتوي على المجموعات 3. سيتم استيراد المجموعات تلقائيًا 4. إذا كان اسم المجموعة موجودًا بالفعل، سيتم استبدالها ### 3.3 إعدادات البحث 1. انقر على "إعدادات البحث" للتوسيع (مطوي افتراضيًا) 2. اختر الخيارات المطلوبة: - **تجاهل الحروف الكبيرة والصغيرة** : لا يميز بين الحروف - **كلمة كاملة** : يطابق السلاسل الكاملة فقط - **التعبيرات العادية** : استخدم regex (حصرية مع كلمة كاملة) 3. انقر على "? مساعدة" لرؤية دليل regex ### 3.4 البحث التلقائي 1. اختر "البحث التلقائي" للتمكين 2. تأكد من تحديد مجموعة على الأقل 3. يقوم الملحق بالبحث التلقائي عند فتح تبويبات جديدة ### 3.5 اختصارات لوحة المفاتيح | الاختصار | الوظيفة | | ------------ | ---------------------------- | | Ctrl+Shift+F | فتح popup والبحث التلقائي | | Ctrl+Shift+S | بحث تلقائي سريع (بدون popup) | | Ctrl+Shift+X | مسح جميع البروزات | > **ملاحظة**: على Mac، استبدل Ctrl بـ Command ### 3.6 ميزات الواجهة - **طي/توسيع**: منطقة نص البحث وإدارة المجموعات تدعم الطي - **حول**: عرض اسم الملحق والإصدار والبريد الإلكتروني في أسفل إعدادات البحث ## 4. دليل التعبيرات العادية ### 4.1 البنية الأساسية - `.` - أي حرف - `\d` - أي رقم (0-9) - `\D` - أي غير رقم - `\w` - حرف أو رقم أو شرطة سفلية - `\W` - غير حرف وغير رقم وغير شرطة سفلية - `\s` - مسافة فارغة (مسافة، tab، سطر جديد) ### 4.2 الكميات - `*` - 0 أو أكثر مرات - `+` - 1 أو أكثر مرات - `?` - 0 أو 1 مرة - `{n}` - بالضبط n مرات - `{n,}` - n أو أكثر مرات - `{n,m}` - n إلى m مرات ### 4.3 الأنماط الشائعة - `1[3-9]\d{9}` - أرقام الهواتف الصينية - `[\u4e00-\u9fa5]+` - أحرف صينية - `\b\w+\b` - كلمات كاملة - `.*` - أي محتوى (للمحتوى بين بداية ونهاية ثابتين) - `^https?://` - بداية URL - `\d{4}-\d{2}-\d{2}` - صيغة التاريخ ### 4.4 الأحرف الخاصة - `^` - بداية السطر - `$` - نهاية السطر - `|` - عامل OR (مثال: cat|dog يطابق "cat" أو "dog") - `()` - تجميع (للالتقاط والتجميع) - `[]` - مجموعة أحرف (مثال: \[abc] يطابق a أو b أو c) - `[^]` - مجموعة منفية (مثال: \[^0-9] يطابق غير الرقم) ### 4.5 أمثلة | النمط | الوصف | مثال | | -------------- | -------------------------------------- | -------------------------- | | `hello` | تطابق تام "hello" | يطابق نص يحتوي على "hello" | | `hello.*world` | "hello" في البداية، "world" في النهاية | "hello, how are you world" | | `^word` | "word" في البداية | "word123" | | `end$` | "end" في النهاية | "the end" | | `file\d+\.txt` | "file"، أرقام، ".txt" | "file001.txt" | ## 5. ملاحظات هامة 1. **الاستخدام الأول**: قم بتحديث الصفحة بعد التثبيت أو التحديث 2. **البحث التلقائي**: يحتاج مجموعة مختارة على الأقل 3. **أسماء المجموعات**: مقيدة بـ 15 حرفًا 4. **اختيار اللون**: 14 لون متاح عند الإنشاء أو التعديل 5. **Regex**: متعارض مع كلمة كاملة، لا يمكن استخدام كليهما 6. **عدد التطابقات**: يعرض "99+" لأكثر من 99 7. **البحث التلقائي عند الكتابة**: كل سطر يبدأ البحث تلقائيًا 8. **حفظ التحديد**: يتم حفظ المجموعات المختارة تلقائيًا 9. **استيراد/تصدير**: يدعم تصدير المجموعات إلى ملف Excel أو استيرادها من ملف Excel، ما يسهل النسخ الاحتياطي ومشاركة المجموعات 10. **استبدال عند الاستيراد**: عند الاستيراد، إذا كان اسم المجموعة موجودًا بالفعل، سيتم استبدال المجموعة، ويتم استخدام اللون من السجل الأول